הגדרות דף, קוד וגרסאות

המעטפת של הדף: הכתובת, הכותרת, מי רשאי לפתוח, איזה קוד רץ, ואיך חוזרים אחורה.

שתי סמנטיקות דריסה — לקרוא לפני שכותבים

1. קוד מוטבע נדרס במלואו ולא מתווסף. Edit-Page-CSS-JS עם jsCode מחליף את כל בלוק ה‑JS של הדף. אין append, אין merge.
2. שחזור גרסה דורס את התוכן הנוכחי ואינו הפיך. Set-Page-Version כותב את הגרסה הישנה על מה שיש עכשיו, בלי גיבוי אוטומטי ובלי דרך חזרה.

Get-Page-Settings

הפרמטר	טיפוס	חובה	המשמעות
pageId	String	✔	הדף
siteId	String		האתר

מחזיר את הערכים הנוכחיים של מה ש‑Set-Page-Settings יודע לכתוב: name, title, description, keywords, metaTags, loginOnly, allowedRoles, dynamicTable, ובנוסף isMasterPage, masterPageId, publishedAt ו‑createdAt. המפתחות jsFile ו‑cssFile מופיעים רק כשקובץ מקושר. dynamicFields אינו מוחזר לעולם (ראו מגבלה).

JSON

{ "name": "apps/mybusiness/Supplier", "title": "", "description": "", "keywords": "",
  "metaTags": "", "dynamicTable": "", "isMasterPage": false,
  "masterPageId": "6a8a95b63cd0a41edaebed4e", "loginOnly": false, "allowedRoles": "any",
  "publishedAt": "2026-08-23T12:07:42.517Z", "createdAt": "2026-08-23T12:07:42.517Z" }

זו הקריאה שמייצרת את הבסיס למיזוג: הגדרות שלא תשלחו בכתיבה נשארות כפי שהן.

Set-Page-Settings

הפרמטר	טיפוס	חובה	המשמעות
pageId	String	✔	הדף
name	String		הנתיב וה‑URL של הדף. חייב להיות ייחודי באתר
title	String		כותרת הדף (לשונית הדפדפן, SEO)
description	String		תיאור
keywords	String		מילות מפתח
metaTags	String		תגי מטא כ‑HTML
loginOnly	Boolean		true = רק משתמשים מחוברים
allowedRoles	String		רשימת תפקידים מופרדת בפסיקים. שליחה שלו מדליקה גם loginOnly: true
jsFile	String (URL)		קובץ ה‑JS החיצוני של הדף. דורס קוד קיים
cssFile	String (URL)		קובץ ה‑CSS החיצוני של הדף. דורס קוד קיים
removeJSFile	Boolean		מנתק את קובץ ה‑JS
removeCSSFile	Boolean		מנתק את קובץ ה‑CSS
dynamicTable	String		דף דינמי — שם הטבלה
dynamicFields	String		דף דינמי — השדות שיתאימו לנתיב ב‑URL. לא נשמר — ראו מגבלה למטה
siteId	String		האתר

התשובה: { "success": true }. קריאה שלא שינתה כלום מחזירה Error: no changes to save.

מחרוזת ריקה אינה מנקה ערך

בניגוד ל‑Edit-Page-CSS-JS, כאן "" נחשב “לא נשלח”: description: "" מחזיר no changes to save והערך הישן נשאר. אין דרך לרוקן description / keywords / metaTags דרך הכלי, רק בממשק הניהול. קבצי קוד מנתקים עם removeJSFile / removeCSSFile.

name — הנתיב שחייב להיות ייחודי

name הוא גם השם וגם הכתובת. שינוי שלו מזיז את הדף לכתובת אחרת:

• קישורים קיימים נשברים. פריט תפריט שמצביע לדף לפי page (מזהה) שורד; קישור שנכתב כ‑path טקסטואלי לא.
• הפניית טבלת תצוגה נשברת. דף רשימה שפותח כרטיס מפנה אליו לפי הנתיב (editView.page ב‑Edit-Table-View) — עדכנו גם אותו.
• זה תחליף המחיקה היחיד. אין Delete-Page. דף שיצא משימוש מקבל שם כמו apps/mybusiness/_old_Supplier ויורד מהתפריט.
• הייחודיות נאכפת כאן — שם תפוס מחזיר Error: page name already exists. ב‑Create-Form-Page היא לא נאכפת.

title — ומלכודת ה‑“Cases”

דף שנוצר ב‑Create-Table-View-Page הוא העתק עמוק של דף המקור ויורש את ה‑title שלו. דף המקור המקובל הוא apps/mybusiness/Cases, ולכן לשונית הדפדפן של דף הספקים החדש תכריז “Cases”. Set-Page-Settings עם title מתקן זאת, והוא לא אופציונלי — ראו ניקוי שאריות.

הרשאות פתיחת הדף

loginOnly ו‑allowedRoles הם שער גס ברמת הדף: מי יכול לפתוח את הכתובת.

JSON

{ "pageId": "<id>", "loginOnly": true, "allowedRoles": "Admin,Report Admin" }

שער דף אינו תחליף להרשאות טבלה

allowedRoles מונע פתיחה של הדף. הוא אינו מונע קריאה של הנתונים: משתמש עם הרשאת find על הטבלה יראה אותם בכל דף אחר, ב‑API, וב‑MCP. ההגנה האמיתית היא CLP: Set-Table-Permissions. שמות התפקידים כאן הם בדיוק כפי שהם ב‑Get-Roles, כולל רישיות ורווחים, והכלי לא מאמת אותם: allowedRoles: "NoSuchRole" מתקבל ב‑success, והתוצאה היא שער שאיש לא עובר. ברירת המחדל היא any; הערך נשמר מנורמל עם רווח אחרי הפסיק ("Admin, Report Admin"). שליחת allowedRoles מדליקה גם loginOnly: true; לחזרה לדף פתוח — loginOnly: false ו‑allowedRoles: "any".

קבצי קוד חיצוניים

לכל דף קובץ JS אחד וקובץ CSS אחד. הערך הוא URL של קובץ שהועלה קודם.

1. Upload-Public-File  { file: { name: "supplier.js", mimeType: "text/javascript",
                                 data: "<base64>", codeFile: true } }
                       → { success, filePath: "<URL>", file: { _id, path, name, type, size } }
2. Set-Page-Settings   { pageId, jsFile: "<filePath>" }
3. גרסה הבאה: Upload-Public-File עם file._id  →  ה-URL לא משתנה, אין צורך לגעת בדף שוב

הסכימה מקבלת אובייקט אחד בשם file (קריאה עם name/data ברמה העליונה נכשלת ב‑Input validation error … file: expected object), וה‑URL חוזר ב‑filePath (וגם ב‑file.path). codeFile: true הופך את הקובץ לניתן לעריכה בעורך הקוד של הפלטפורמה. שימוש חוזר ב‑_id שומר על URL יציב: כל שינוי קוד הוא העלאה מחדש בלבד. כלי קבצים.

jsFile / cssFile נשמרים כפי שנשלחו, בלי ולידציה: גם _id או שם קובץ יתקבלו ב‑success, והדף לא יטען כלום. תמיד URL מלא.

removeJSFile / removeCSSFile מנתקים את הקובץ, והדף חוזר לרשת שהוא יורש מהמאסטר.

מתי קובץ חיצוני ומתי קוד מוטבע

קוד מוטבע (Edit-Page-CSS-JS) — תיקון קטן וייחודי לדף אחד; נדרס בקלות. קובץ חיצוני — קוד שמתוחזק לאורך זמן, קוד שחוזר בכמה דפים, וכל מה שמעל כמה עשרות שורות. כך מנוהלת מערכת העיצוב של המוצר: קובץ CSS אחד מחובר לשני דפי המאסטר, ודפים רגילים יורשים אותו בלי cssFile משלהם.

דפים דינמיים — dynamicTable + dynamicFields

דף אחד משרת תוכן שונה לפי הנתיב ב‑URL: dynamicTable היא טבלת המקור, ו‑dynamicFields הם שמות השדות שיותאמו לחלקי הנתיב.

מגבלה ידועה — dynamicFields לא נשמר דרך ה‑MCP

dynamicTable נשמר ומוחזר כרגיל. dynamicFields מתעלמים ממנו לחלוטין: לבד הוא מחזיר no changes to save, יחד עם dynamicTable הקריאה “מצליחה” אבל הערך לא נכתב, ו‑Get-Page-Settings לעולם לא מחזיר אותו. דף דינמי אי אפשר להשלים מה‑MCP: את השדות מגדירים בממשק הניהול, ושם גם רואים את הפורמט לריבוי שדות.

מה לא ניתן להגדרה

masterPageId. אין פרמטר כזה בסכימה החיה ואין כלי אחר שמשנה מאסטר של דף קיים. ראו דפי מאסטר.

Edit-Page-CSS-JS

מחליף את בלוק ה‑CSS ו/או ה‑JS המוטבע של הדף.

הפרמטר	טיפוס	חובה	המשמעות
pageId	String	✔	הדף
cssCode	String		קוד CSS. דורס את הקוד הקיים
jsCode	String		קוד JavaScript. דורס את הקוד הקיים
siteId	String		האתר

דריסה, לא מיזוג

תיאור הסכימה: “CSS code for the page. Overwrites existing code”, ואותו משפט ל‑JS. פרמטר שלא נשלח — לא נוגעים בו. פרמטר שנשלח כמחרוזת ריקה — מנקה את הבלוק.

1. Get-Page-Content(pageId)        → קוראים את ה-CSS/JS הקיים
2. שומרים אותו בצד                  → זה הגיבוי שלכם
3. מרכיבים את הבלוק המלא: הישן + החדש
4. Edit-Page-CSS-JS(pageId, jsCode: <הבלוק המלא>)

כתיבה של “רק הפונקציה שהתבקשה” מוחקת את כל מה שהיה שם, כולל תיקוני עברית שנורשו מדף התבנית וקוד שלקוח הוסיף ביד.

שני דפוסי ה‑JS הקנוניים

(א) שדה טקסט ארוך. add-new-field מציב כל שדה String כ‑<input type="text"> של שורה אחת, בלי המרה אוטומטית לפי שם השדה (גם Notes נשאר input; ה‑Comment בכרטיסים המובנים הוא ווידג’ט textarea שהגיע עם התבנית). להחלפה ל‑textarea:

JavaScript

$(document).ready(function() {
  ['Resolution','RootCause','TechnicianNotes'].forEach(function(f) {
    var $i = $('input[name="'+f+'"]');
    if ($i.length && $i.attr('type') === 'text') {
      $i.replaceWith($('<textarea>')
        .attr({ name: f, id: $i.attr('id'), rows: 3 })
        .addClass($i.attr('class'))
        .val($i.val()));
    }
  });
});

(ב) עמודת Name לחיצה בטבלת רשומות מקושרות — פותחת את עריכת השורה.

JavaScript

$('.simbla-table').on('data-loaded', function() {
  var i = $(this).find('thead th').index($(this).find('thead th[data-field="Name"]'));
  if (i < 0) return;
  $(this).find('tbody tr td:nth-child(' + (i + 1) + ')')
    .css({ cursor: 'pointer', color: '#299ff2' })
    .on('click', function() { $(this).closest('tr').find('.fa-pencil').click(); });
});

שני hooks נוספים שחוזרים: מיון אפשרויות ברשימה נפתחת — $('[name=StatusId]').on('before-select-options', (e,d) => d.query.ascending("Order")) — והרכבה אוטומטית של Name משדות אחרים באירוע change.

CSS שכדאי להכיר: .db-form-add{display:none !important;} מסתיר את כפתור “הוספת שורה” הירוק שדולף לדפים מסוימים.

גרסאות דף

Get-Page-Versions

הפרמטר	טיפוס	חובה	המשמעות
pageId	String	*	הדף לפי מזהה
pageName	String	*	או לפי נתיב
siteId	String		האתר

* אחד מהשניים. מחזיר versions: [{ _id, date }].

Get-Page-Version

הפרמטר	טיפוס	חובה	המשמעות
pageId	String	✔	הדף
versionId	String	✔	הגרסה
siteId	String		האתר

מחזיר את התוכן של הגרסה, ורק את החלק שהכתיבה שיצרה אותה שינתה (ראו מגבלה): content לגרסה שנוצרה מעריכת HTML, jsCode או cssCode לגרסה מ‑Edit-Page-CSS-JS. זה גם הכלי שבו קוראים גרסה בלי לשחזר אותה.

Set-Page-Version

הפרמטר	טיפוס	חובה	המשמעות
pageId	String	✔	הדף
versionId	String	✔	הגרסה לשחזור
overrideHTML	Boolean		לשחזר את ה‑HTML
overrideCSS	Boolean		לשחזר את ה‑CSS
overrideJS	Boolean		לשחזר את ה‑JS
siteId	String		האתר

שחזור גרסה דורס את הנוכחי — ואינו הפיך

• בלי אף דגל override* — הקריאה נכשלת עם Error: No update to perform, והדף נשאר כפי שהיה.
• עם דגל — התוכן הנוכחי של אותו חלק נמחק. השחזור עצמו יוצר גרסה חדשה ברשימה, אבל היא מכילה את מה ששוחזר, לא את מה שדרסתם. אין undo.
• versionId שאינו קיים מחזיר שגיאת parse ("Not Found" is not valid JSON) — זה “לא נמצא”, לא תקלה בשרת.

לפני כל שחזור: Get-Page-Content(pageId) ושמירת התוצאה בצד. זה הגיבוי היחיד שיהיה לכם.

מתכון שחזור

התרחיש: עריכה שברה את ה‑HTML של הדף (למשל Edit-Table-View שמתלונן page.savedContent[key].includes), אבל ה‑JS וה‑CSS תקינים.

1. Get-Page-Content(pageId)               → גיבוי של המצב הנוכחי, כולל ה-JS/CSS
2. Get-Page-Versions(pageId)              → בוחרים גרסה — הרשימה מהחדשה לישנה;
                                            האחרונה ברשימה היא צילום היצירה
3. Get-Page-Version(pageId, versionId)    → מוודאים שהגרסה באמת מכילה content
4. Set-Page-Version(pageId, versionId, overrideHTML: true)
                                          → מחזיר את ה-HTML בלבד, לא נוגע ב-JS/CSS
5. מריצים מחדש את העריכה שנכשלה

מתי נוצרת גרסה

בכל כתיבה דרך ה‑MCP: Edit-Page, Add-Container-to-Page, Duplicate-Element, כלי האלמנטים, Set-Page-Settings, Edit-Page-CSS-JS וגם Set-Page-Version עצמו מוסיפים גרסה אחת כל אחד, עם date של רגע הכתיבה. דף שנבנה ב‑30 קריאות מגיע עם 30 גרסאות.

מה גרסה באמת מכילה

מגבלה ידועה — גרסה היא דלתא, לא צילום מלא

כל גרסה שומרת רק את החלק שהכתיבה שיצרה אותה שינתה:

• גרסה מ‑Edit-Page / מיכל / שכפול / אלמנט — content (ה‑HTML) בלבד, בלי JS ו‑CSS.
• גרסה מ‑Edit-Page-CSS-JS — jsCode או cssCode בלבד, בלי HTML.
• גרסה מ‑Set-Page-Settings — ריקה; Get-Page-Version עליה נכשל ב‑Cannot read properties of undefined (reading 'content').

לכן Set-Page-Version עם overrideHTML על גרסה של קוד נכשל ב‑cheerio.load() expects a string; לשחזור HTML בוחרים גרסה שנוצרה מעריכת HTML, ולשחזור JS גרסה מ‑Edit-Page-CSS-JS עם overrideJS. הגיבוי המלא היחיד הוא Get-Page-Content שתעשו לפני השינוי.

המשך

• עריכת דפים ואלמנטים — מה שקורה בתוך הדף
• אתרים ודפים — קריאה — למצוא את הדף ולקרוא את מבנהו
• טבלאות תצוגה ודפי רשימה — למה title ו‑jsCode דורשים ניקוי אחרי יצירה מתבנית
• תפקידים, הרשאות טבלה וחבילות — ההגנה שמתחת לשער הדף
• כלי קבצים — Upload-Public-File ו‑codeFile
• אינדקס הכלים המלא