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

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

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

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 יציב — וזו כל התכונה: אחרי הקישור הראשוני, כל שינוי קוד הוא העלאה מחדש בלבד — הדף טוען את הגרסה החדשה מאותו 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;} מסתיר את כפתור “הוספת שורה” הירוק שדולף לדפים מסוימים.

גרסאות דף

שלושה כלים, ושילוב אחד שהוא מנגנון ה‑undo היחיד של הדפים.

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
• אינדקס הכלים המלא