טבלאות תצוגה ודפי רשימה

כל טבלה שמשתמש רואה במוצר היא אותו ווידג’ט — simbla-table — בשתי אריזות:

הצורה	איפה היא חיה	מי יוצר אותה	מה מקבלים כברירת מחדל
דף רשימה	דף עצמאי על CRMmaster — apps/mybusiness/Cases, apps/mybusiness/Suppliers	Create-Table-View-Page	טופס חיפוש, עימוד, כפתור “חדש”
טבלה משובצת	שורה בתוך דף כרטיס — המכירות בכרטיס הלקוח	Add-Table-View-to-Form-Page	בלי טופס חיפוש, עריכה inline, וסינון אוטומטי לרשומה הפתוחה

Edit-Table-View מגדיר את שתיהן, באותם פרמטרים בדיוק. Get-Optional-Fields מזין את שתיהן — ואת הדוחות.

Get-Optional-Fields

הכלי הקטן שמונע את רוב התקלות בעמוד הזה.

הפרמטר	טיפוס	חובה	המשמעות
className	String	✔	המחלקה

מחזיר מתאר מוכן לכל שדה — כולל הרחבה של כל Pointer ברמה אחת (וגם createdBy / updatedBy), עם התוויות בעברית מהסכימה:

JSON

[
  { "aggrField": "Name",                        "field": "Name",            "type": "String",        "text": "שם" },
  { "aggrField": "StatusId.CaseStatuses.Name",  "field": "StatusId.Name",   "type": "String",        "text": "סטאטוס- שם" },
  { "aggrField": "OwnerId._User.name",          "field": "OwnerId.name",    "type": "String",        "text": "אחראי- שם" },
  { "aggrField": "AccountId.Accounts.Name",     "field": "AccountId.Name",  "type": "String",        "text": "לקוח- שם" },
  { "aggrField": "Number",                      "field": "Number",          "type": "AutoIncrement", "text": "מספר" }
]

מעתיקים מכאן מילה במילה את field, aggrField ו‑type. אל תחברו מסלולים ביד.

מגבלה ידועה — text בטבלאות מותאמות

בטבלה שנוצרה ב‑Create-Table, ה‑text של שדה שמורחב דרך Pointer חוזר כ‑"סטטוס - undefined" — התווית של שדה היעד לא נמצאת. field / aggrField / type תקינים; את התווית כתבו בעצמכם. בטבלאות המערכת (Cases, Accounts…) הטקסט תקין.

דוקטרינת aggrField

זה השדה שנופלים עליו יותר מכל אחר, כי הוא נראה כמו כפילות מיותרת של field — והוא לא:

• field קובע מה מוצג. מסלול Pointer בנקודה אחת: AccountId.Name.
• aggrField הוא מה שצינור הצבירה — מיון, סינון, סכימה — באמת שואל. מסלול Pointer עם שם המחלקה באמצע: AccountId.Accounts.Name.

field	aggrField
Name	Name
AccountId.Name	AccountId.Accounts.Name
StatusId.Name	StatusId.SupplierStatuses.Name — שם טבלת ה‑lookup האמיתי
OwnerId.name	OwnerId._User.name
createdBy.name	createdBy._User.name

שדות _User הם באותיות קטנות

name, email, phone — לא Name. מסלול OwnerId._User.Name נכשל בשקט: העמודה מוצגת, המיון לא עובד, ואף שגיאה לא מופיעה.

aggrField חסר = data-aggr-field="undefined"

עמודה בלי aggrField מרונדרת עם הערך undefined, והצבירה (שורת הסיכום) ומיון על מסלול Pointer עליה שבורים. הטבלה תיראה תקינה — היא תציג נתונים. זו ההצדקה היחידה שצריך ל‑Get-Optional-Fields לפני כל בניית טבלה.

היסטוריה — מיון בלחיצה על כותרת בעמודות שנכתבו בכלי

בגרסאות שרת ישנות, Edit-Table-View ו‑Create-Table-View-Page כתבו את כותרות העמודות בלי class="sort-able" ובלי אייקון המיון <i class="fa fa-sort"> — וקוד הריצה מתעלם מלחיצה על כותרת בלי אייקון, כך שאי אפשר היה למיין בדפים שנבנו בכלים.

בגרסאות עדכניות שני הכלים כותבים sort-able + fa-sort על כל הכותרות, ולחיצה על כותרת ממיינת בפועל (לחיצה שנייה הופכת את הסדר). מול שרת ישן, המעקף היה מיון ברירת מחדל דרך שאילתה שמורה (Create-or-Update-Report עם Sort ו‑Default: true — ראו דוחות). שימו לב למגבלה נפרדת שנשארה: Create-Table-View-Page הופך את סדר העמודות.

Create-Table-View-Page

יוצר דף רשימה חדש כהעתק עמוק של דף קיים.

הפרמטר	טיפוס	חובה	המשמעות
tableName	String	✔	המחלקה
pageName	String	✔	הנתיב. מוסכמה: רבים, apps/mybusiness/Suppliers
copyFromPageId	String	✔	הדף שממנו מעתיקים. נהוג apps/mybusiness/Cases. נאכף בוולידציה — בלעדיו הקריאה נדחית
title	String	✔	הכותרת בעברית
menuName	String		הכותרת בתפריט הראשי — הכלי מוסיף את הפריט אוטומטית
createNewEntityTitle	String		כותרת כפתור היצירה, “ספק חדש”
editEntityPageName	String		הדף שאליו עוברים בעריכה — בדרך כלל הכרטיס
editEntityTitle	String		“עריכת ספק”
mainSearchTitle	String		“חיפוש ספקים”
searchFields	Array<Object>		שדות טופס החיפוש
tableColumns	Array<Object>		עמודות הטבלה
siteId	String		האתר

searchFields[]: { field ✔, equesition ✔, label, type (String|Number|Pointer), defaultValue, targetClass } tableColumns[]: { field ✔, label, type (String|Number|Boolean|Date|PrivateFile|File), aggrField }

JSON

{
  "tableName": "Suppliers",
  "pageName": "apps/mybusiness/Suppliers",
  "copyFromPageId": "<ה-_id של דף Cases מ-Get-Site-Pages>",
  "title": "ספקים",
  "menuName": "ספקים",
  "createNewEntityTitle": "ספק חדש",
  "editEntityPageName": "Supplier",
  "editEntityTitle": "עריכת ספק",
  "mainSearchTitle": "חיפוש ספקים",
  "searchFields": [
    { "field": "Name", "label": "שם הספק מכיל", "type": "String", "equesition": "contains" },
    { "field": "StatusId", "label": "סטטוס", "type": "Pointer", "equesition": "equalTo",
      "targetClass": "SupplierStatuses" }
  ],
  "tableColumns": [
    { "field": "Name",           "label": "שם",    "type": "String", "aggrField": "Name" },
    { "field": "StatusId.Name",  "label": "סטטוס", "type": "String", "aggrField": "StatusId.SupplierStatuses.Name" },
    { "field": "AccountId.Name", "label": "לקוח",  "type": "String", "aggrField": "AccountId.Accounts.Name" },
    { "field": "createdAt",      "label": "נוצר",  "type": "Date" }
  ]
}

הכלי מחזיר { "newPageId": "<_id>" }.

מגבלה ידועה — tableColumns נכתבות בסדר הפוך

הכלי כותב את העמודות מהאחרונה לראשונה: מערך [שם, יתרה, פעיל, נוצר] מתרנדר כ‑“נוצר, פעיל, יתרה, שם”. Edit-Table-View שומר על הסדר שנשלח — ומכיוון שממילא צריך אותו לניקוי השאריות בהמשך העמוד, שלחו בו את columns המלא מיד אחרי היצירה.

copyFromPageId — למה זו לא תבנית אלא העתק

הכלי לא מייצר דף מאפס: הוא משכפל את דף המקור על כל תוכנו, ואז ממקד אותו מחדש. שלוש השלכות:

1. המאסטר נורש מהמקור. זו הידית היחידה במוצר לבחירת מאסטר לדף חדש — ראו דפי מאסטר.
2. גם דשבורד נוצר כך. דשבורד הוא דף רגיל על CRMmaster עם מונים וגרפים; שכפול דשבורד קיים ומיקוד מחדש של האלמנטים הוא המסלול המהיר. אז searchFields ו‑tableColumns הם placeholders מינימליים שאתם חייבים לספק. ראו אלמנטי דשבורד.
3. כל מה שהיה בדף המקור עבר איתו — כולל דברים שאתם לא רוצים.

ניקוי שאריות אחרי יצירה מתבנית

זה לא אופציונלי. דף שהועתק מ‑Cases נושא שאריות של Cases:

מה נורש	איך מתקנים
optionalFields של Cases — סוגי פנייה בבורר העמודות	Edit-Table-View עם optionalFields שלכם
classPointers בצורת Cases — מיון שבור על שדות Pointer	Edit-Table-View עם classPointers מלא
כותרת SEO “Cases” בלשונית הדפדפן	Set-Page-Settings(pageId, title)
קובץ ה‑JS של Cases (jsFile: …/cases.js, בהגדרות הדף) עם עקיפות עברית של Cases	Set-Page-Settings(pageId, removeJSFile: true) — או jsFile משלכם. ב‑jsCode של הדף עצמו יושבת רק שורת editEntityTitle שהכלי כתב
טופס החיפוש נשאר קשור ל‑data-simbla-class="Cases"	לא ניתן לתיקון מ‑Edit-Table-View (tableClassName משנה את הטבלה בלבד) — JS בדף, או שכפול דף שכבר תקין
כותרת הכפתור “פניה חדשה” ואייקון האוזניות בכותרת הדף	JS בדף
כפתור “הוספת שורה” ירוק שדולף (אם מופיע)	CSS: .db-form-add{display:none !important;}

שאילתות שמורות נקשרות לדף לפי PageId + FormName

השאילתות השמורות בדף (הרשימה הנפתחת “שאילתות”) הן רשומות ב‑_DynamicQueries עם PageId ו‑FormName (כאן dynamic-table-formP113, שנורש מ‑Cases). שאילתה שתיצרו לדף החדש חייבת ShowFields — שאילתת ברירת מחדל בלי ShowFields מסתירה את כל עמודות הטבלה. ראו דוחות.

Edit-Table-View

שליטה מלאה בטבלה קיימת.

הפרמטר	טיפוס	חובה	המשמעות
pageId	String	✔	הדף
tableId	String	✔	מזהה אלמנט הטבלה
tableClassName	String		המחלקה שממנה נשלפים הנתונים
columns	Array		העמודות המוצגות
optionalFields	Array		השדות שהמשתמש יכול להוסיף כעמודה
classPointers	Object		מפת שדה → מחלקה
filterAndSort	Object		סינון, חיפוש, מיון וגריד
editView	Object		איך נפתחת עריכת שורה
tablePermissions	Object		יצירה / עריכה / מחיקה בטבלה
summaryOptions	Object		שורת הסיכום
conditionalFormattingRules	Array		עיצוב מותנה
advancedOptions	Object		ייצוא, עריכה מרובה, ותצוגה
siteId	String		האתר

כותב מצב שלם — כל קבוצה שנשלחת מוחלפת במלואה

columns, optionalFields, classPointers, filterAndSort.criteria ו‑conditionalFormattingRules — כל אחת מהן מוחלפת בכל מה שהעברתם. מה שלא כללתם בתוך קבוצה שנשלחה, נעלם. קריאה שנועדה “רק להוסיף עמודה” ושולחת columns בלי שאר העמודות — מוחקת אותן. תמיד בונים את המצב הרצוי המלא בכל קריאה, מתוך הקריאה של Get-Page-Content. מה שהכלי לא נוגע בו: ה‑HTML של טופס החיפוש, קוד ה‑JS/CSS, ה‑HTML של המודאל, והגדרות הדף — לכל אחד מהם כלי משלו.

איך מוצאים tableId

• דף שנוצר ב‑Create-Table-View-Page נושא כמעט תמיד את המזהה P113, בירושה מדף Cases.
• אחרת: Get-Page-Content(pageId, minimal: false) — הצומת עם המחלקות simblaEL simbla-table dynamic-table (דף רשימה) או simblaEL simbla-table (טבלה משובצת). ה‑id שלו הוא ה‑tableId.
• אם ב‑minimal: true לא מצאתם את הצומת — עברו ל‑minimal: false.
• tableId שגוי מחזיר Error: Table not found in page.

columns

המפתח	הערכים	המשמעות
field ✔		מסלול התצוגה. Pointer בנקודה אחת: AccountId.Name
label		כותרת העמודה
type	String · Number · Boolean · Date · PrivateFile · File · HTML/XML · Pointer · Array · AutoIncrement	טיפוס העמודה
aggrField		מסלול הצבירה
dateFormat	datetime · date · time · year · q/yy · mm/yy · month · quarter	לעמודות תאריך
summary	"" · sum · avg · min · max · count	פונקציית הסיכום לעמודה
inlineOptions		עורך inline לעמודה
subclassPointers		מטא‑דאטה לעריכת Pointer inline

עמודת תצוגה של Pointer היא String, לא Pointer

עמודה שמציגה AccountId.Name חייבת להיות type: "String" — היא מציגה מחרוזת. type: "Pointer" על מסלול כזה מייצר Cannot create property 'Name' on string, ואף שורה לא מרונדרת. הטבלה נראית ריקה לגמרי. type: "Pointer" שמור לעמודה שמציגה את שדה ה‑Pointer עצמו — בדרך כלל בהקשר של עריכת inline.

inlineOptions — { type: text|number|date|select|autocomplete, info, placeholder, required, readonly, parentSelect }. autocomplete לטבלאות גדולות (Accounts, _User), select ל‑lookups קטנים. parentSelect יוצר רשימות נפתחות תלויות, ואז צריך גם subclassPointers.

classPointers

מפה של { "שם השדה": "שם המחלקה" }.

JSON

"classPointers": {
  "createdBy": "_User", "updatedBy": "_User",
  "StatusId": "SupplierStatuses", "AccountId": "Accounts", "OwnerId": "_User"
}

תמיד לכלול את createdBy ואת updatedBy

המפה הזו נדרסת במלואה. קריאה ששולחת classPointers בלי createdBy ו‑updatedBy הורגת בשקט את המיון לפי “נוצר על ידי” ו“עודכן על ידי” — כולל בעמודות שלא נגעתם בהן. העתיקו את המפה הקיימת, הוסיפו את שלכם, שלחו את השלם.

filterAndSort

המפתח	הערכים	המשמעות
criteria	מבנה תנאי B + condOr	סינון ברירת מחדל, לפני שהמשתמש חיפש משהו
queryForm		שם טופס החיפוש, למשל dynamic-table-formP113
queryGridSize	"12" · "6" · "4" · "3" · "2"	כמה רוחב לכל שדה חיפוש
queryType	hard-code · form	מצב סינון (מאפיין ישן)
sortBy / sortOrder	· ascending / descending	נכתבים כ‑data-sort-by / data-sort-order — ללא השפעה על טבלה (ראו המגבלה)
sortLimit	Number	נכתב כ‑data-sort-limit — ללא השפעה על טבלה (ראו המגבלה)
waitForFirstSubmit	Boolean	הטבלה ריקה עד החיפוש הראשון

מגבלה ידועה — sortBy / sortOrder / sortLimit אינם פועלים על טבלאות

ווידג’ט הטבלה קורא את המיון רק מהכותרת שנלחצה ואת גודל העמוד מבורר 10/25/50/100; את שלושת המאפיינים האלה קוראים רק ווידג’טים אחרים (רשימה דינמית, גלריה). הם נשמרים ב‑HTML ולא משנים דבר. מיון ברירת מחדל לדף רשימה: שאילתה שמורה עם Sort ו‑Default: true ב‑Create-or-Update-Report.

האופרטורים ב‑criteria של הכלי הזה הם הרשימה הרחבה ביותר במוצר — שישה‑עשר:

contains · startsWith · endsWith · equalTo · greaterThan · lessThan · greaterThanOrEqualTo · lessThanOrEqualTo · notEqualTo · containedIn · notContainedIn · exists · doesNotExist · AuthorizedOn · underMyHierarchy · notUnderMyHierarchy

שלושת האחרונים ייחודיים למוצר: “רשומות שהמשתמש מורשה עליהן”, ו“בעלים הוא אני או מי שכפוף לי”. שני האחרונים אינם עושים דבר במערכת שלא הוגדרה בה היררכיית תפקידים (הכתיבה מתקבלת). empty אינו ברשימה — הוא נדחה.

JSON

"filterAndSort": {
  "queryForm": "dynamic-table-formP113", "queryGridSize": "3",
  "criteria": [ { "F": "Active", "C": "equalTo", "T": "Boolean", "V": true } ]
}

ערכי תאריך ב‑V מקבלים גם מילות מפתח: "today", "year ago", "beginning of this month", "30 days period", "end of this year", "year ahead", או מספר ימים (שלילי מותר). ערך Pointer ל‑_User יכול להיות "currentUser".

editView — מצבי העריכה

openFrom	ההתנהגות	מתי
inline	העיפרון הופך את השורה לשדות	רשימות עריכה מהירה. ברירת המחדל כשאין כרטיס
modal	חלון קופץ ממורכז	כרטיסים עשירים
modal-left / modal-right	סרגל צד נשלף	חוויית הכרטיס הסטנדרטית במוצר
newwindow	ניווט לדף	זרימות שצריכות URL משלהן — דורש כרטיס על MasterTicket
row	הטופס נפתח מתחת לשורה	נדיר
hidetable	הטבלה מתחלפת בטופס	זרימות אשף

JSON

"editView": { "openFrom": "modal-left", "useIframe": true,
              "page": "apps/mybusiness/Supplier", "popupWidthPercent": 45 }

page הוא הנתיב של דף הכרטיס (apps/mybusiness/Supplier); הסרגל נפתח עם iframe של <page>?oid=<id>&cls=<class>&Mode=iframe. אם useIframe: true ו‑page חסר או שבור — החלון נתקע על ספינר.

tablePermissions ו‑summaryOptions

JSON

"tablePermissions": { "allowCreate": true, "allowEdit": true, "allowDelete": false },
"summaryOptions":   { "showSum": true, "sumTitle": "סה\"כ" }

tablePermissions שולט בעיפרון, בפח ובכפתור “חדש” — ברמת התצוגה בלבד. זו לא הרשאה; משתמש עם delete ב‑CLP עדיין יכול למחוק ב‑API. ההגנה האמיתית: Set-Table-Permissions.

שורת סיכום דורשת את שניהם: summaryOptions.showSum: true וגם summary על העמודות שרוצים לסכם.

summary: "sum" על עמודה שאינה Number מפיל את כל שורת הסיכום

הכלי שומר את הערך כפי שנשלח, ושאילתת הסיכום נכשלת ב‑400: the type of the group aggregate field (Website) must be "Number" — שום סיכום לא מוצג, גם לא של עמודות תקינות. sum/avg/min/max רק על Number; על מחרוזות מותר count בלבד.

conditionalFormattingRules — עיצוב מותנה

JSON

"conditionalFormattingRules": [
  { "name": "פעיל ירוק",
    "conditions": [ { "field": "StatusId.Name", "fieldType": "String",
                      "equesition": "equalTo", "value": "פעיל" } ],
    "actions":    [ { "action": "cell-color", "field": "StatusId.Name", "value": "#28a745" },
                    { "action": "cell-background-color", "field": "StatusId.Name", "value": "#d4edda" } ] },
  { "name": "חוב אדום מודגש",
    "conditions": [ { "field": "Balance", "fieldType": "Number",
                      "equesition": "lessThan", "value": 0 } ],
    "actions":    [ { "action": "row-color",       "value": "#dc3545" },
                    { "action": "row-font-weight", "value": "bold" } ] }
]

• התנאים כאן במבנה A (field / equesition / value) והם מתחברים ב‑AND. ה‑enum של הכלי: equalTo · notEqualTo · greaterThan · lessThan · greaterThanOrEqualTo · lessThanOrEqualTo · containedIn · notContainedIn · empty. בזמן ריצה empty משמעותי רק ל‑fieldType: "Date", ו‑containedIn / notContainedIn ממומשים רק ל‑Pointer.
• דקדוק הפעולות: action הוא row-<מאפיין CSS> או cell-<מאפיין CSS> (עם field) — הקידומת מוסרת והשאר נכתב כמאפיין CSS על השורה/התא: row-color (צבע טקסט), row-background-color, row-font-weight, cell-color, cell-background-color, cell-border-color. שמות שאינם מאפיין CSS — למשל row-text-color — לא עושים דבר, ו‑hide-row אינו קיים.
• כלל מאוחר דורס כלל מוקדם על אותו מאפיין. סדרו מהכללי לספציפי.
• לצביעת סטטוסים בהיקף גדול עדיף שדה Color על טבלת ה‑lookup ו‑JS שמצייר תגיות — כלל לכל סטטוס אינו מתרחב יפה.

מגבלה ידועה — העיצוב המותנה אינו נראה בערכת ה‑CRM

החוקים נשמרים ומופעלים (השורה/התא מקבלים מחלקה conditions-format-* וסגנון inline), אבל ה‑CSS של ערכת MyBusiness דורס צבעי טקסט ורקע של תאים — בפועל לא רואים שום שינוי בטבלה. עד לתיקון: שדה Color בטבלת ה‑lookup + JS בדף, או CSS משלכם על .conditions-format-* עם !important.

advancedOptions

המפתח	המשמעות
allowExportToExcel	הפריט “ייצא לאקסל” בתפריט “…” שבכותרת עמודת העריכה. מכבד את הסינון הפעיל
exportToExcelRoles	הגבלת הייצוא לתפקידים. מערך ריק = כל המשתמשים
enableMultiRowsEdit	הפריט “Multi rows edit” באותו תפריט — תיבות סימון לעריכת שורות מרובות
enableMultiRowsRoles	הגבלת העריכה המרובה. מערך ריק = אף אחד — חובה לציין תפקידים
showUrlAsLink	הצגת URL כקישור
showLoaderAnimation	אנימציית טעינה
noResultsImageUrl	תמונה כשאין תוצאות

JSON

"advancedOptions": {
  "allowExportToExcel": true, "exportToExcelRoles": ["Admin"],
  "enableMultiRowsEdit": true, "enableMultiRowsRoles": ["Admin", "Managers"],
  "showLoaderAnimation": true
}

תקרת ייצוא: לטבלה רגילה אין תקרה — הייצוא עובר על כל התוצאות במנות. ייצוא של דוח מקובץ מוגבל ל‑10,000 שורות. הייצוא רץ בדפדפן, ולכן טבלה גדולה מאוד תהיה איטית.

Add-Table-View-to-Form-Page

משבץ טבלת רשומות מקושרות בתוך דף כרטיס — הזמנות הרכש בכרטיס הספק, המכירות בכרטיס הלקוח.

הפרמטר	טיפוס	חובה	המשמעות
pageId	String	✔	דף הכרטיס
tableName	String	✔	מחלקת הבן. חייבת להחזיק Pointer למחלקה של הטופס
insertAfterRow	String	✔	מזהה השורה שאחריה משבצים
fields	Array<Object>	✔	{ fieldName ✔, label ✔, type ✔, aggrField, summary }
tableTitle	String		כותרת הטבלה. הכלי יוצר לה שורה משלו
createBtnTitle	String		כותרת כפתור ההוספה
allowCreate	Boolean		ברירת מחדל true
allowInlineEdit	Boolean		ברירת מחדל true
showSummary	String		כותרת שורת הסיכום. בהשמטה — אין שורת סיכום
siteId	String		האתר

JSON

{ "pageId": "<cardPageId>", "tableName": "SupplierOrders",
  "insertAfterRow": "P319", "tableTitle": "הזמנות רכש",
  "createBtnTitle": "הוסף הזמנה", "allowCreate": true, "allowInlineEdit": true,
  "showSummary": "Total",
  "fields": [
    { "fieldName": "Name",          "label": "הזמנה", "type": "String", "aggrField": "Name" },
    { "fieldName": "StatusId.Name", "label": "סטטוס", "type": "String",
      "aggrField": "StatusId.OrderStatuses.Name" },
    { "fieldName": "Amount",        "label": "סכום",  "type": "Number",
      "aggrField": "Amount", "summary": "sum" },
    { "fieldName": "createdAt",     "label": "נוצר",  "type": "Date", "aggrField": "createdAt" }
  ] }

חמישה כללים שאסור לפספס

1. ה‑Pointer הוא הסינון. כשמחלקת הבן מחזיקה שדה Pointer למחלקת הטופס, הפלטפורמה מסננת את הווידג’ט לרשומה הפתוחה אוטומטית, בלי criteria (דרך classPointers). הכלי אינו בודק זאת: מחלקה בלי Pointer מתקבלת, והווידג’ט מציג את כל הרשומות בכל כרטיס.
2. aggrField על כל שדה. אחרת data-aggr-field="undefined" והצבירה שבורה. (שדה בלי summary מקבל data-summary="undefined" — רעש לא מזיק.)
3. ל‑type כאן אין Pointer — רק String · Number · Boolean · Date · PrivateFile · File; Pointer נדחה בולידציה. "StatusId.Name" + String = טקסט לקריאה; "StatusId" + String = רשימה נפתחת שניתנת לעריכה, בזיהוי אוטומטי.
4. בלי גרשיים ב‑showSummary. באג escaping ידוע: "סה\"כ" נכתב כ‑data-sum-text="סה" כ"="" — attribute שבור וכותרת “סה”. שלחו placeholder נקי, ואז Edit-Table-View עם summaryOptions.sumTitle: "סה\"כ" — שם זה נשמר נכון (").
5. המיקום הוא הכול. ראו האזהרה הבאה.

בדקו שהווידג’ט לא קינן בתוך ווידג’ט אחר

בחרו insertAfterRow שהשורה שאחריה היא שורת שדות או כותרת רגילה. אם השורה הבאה היא רצועת לשוניות (simbla-nav) או טבלה אחרת (simbla-table) — הווידג’ט עלול להיכנס לתוכה ולאבד את הסינון האוטומטי. בדף Account של מערכת vanilla, השורה שלפני הלשוניות מתנהגת תקין. אחרי ההצבה: קראו את הדף מחדש וטפסו על שרשרת האבות של הווידג’ט. אף אחד מהם לא יכול להיות simbla-nav או simbla-table. עוד שתי מלכודות באותו פרמטר: מזהי אלמנטים חוזרים על עצמם בדפי כרטיס (בדף Account: P7, P39, P44, P46, P122), והכלי תופס את הראשון שמצא; וכמה טבלאות שמשובצות באותו insertAfterRow נערמות בסדר הפוך — הכניסו בסדר הפוך מהרצוי. insertAfterRow שאינו קיים מחזיר No place to add fields.

הזזת שורת ווידג’ט

בגרסאות שרת ישנות, move-existing-object על שורה שיש בה simbla-table הרסה את הווידג’ט. בגרסאות עדכניות ההזזה הרגילה עובדת ואין צורך למחוק ולהוסיף מחדש. עדיין: גבו עם Get-Page-Content לפני, ובדקו אחרי שהווידג’ט במקומו. מול שרת ישן יותר, מחיקה והוספה מחדש. ראו עריכת דפים.

הרצף המלא לטבלה משובצת

1. Get-Optional-Fields(childClass)          → field / aggrField / type / text מדויקים
2. Get-Page-Content(cardPage, minimal:false) → בוחרים insertAfterRow בטוח
3. Add-Table-View-to-Form-Page               → ההצבה
4. Get-Page-Content שוב                      → מאמתים את האבות ולוקחים את ה-tableId
5. Edit-Table-View                           → classPointers מלא, סיכומים, מצב עריכה, עיצוב מותנה

מתכונים

• עמודת כסף עם סיכום: עמודה {type:"Number", summary:"sum"} + summaryOptions:{showSum:true, sumTitle:"סה\"כ"}.
• תצוגת “פעילים בלבד” שעדיין ניתנת לחיפוש: filterAndSort.criteria:[{F:"Active",C:"equalTo",T:"Boolean",V:true}].
• עריכה מרובה למנהלים בלבד: advancedOptions:{enableMultiRowsEdit:true, enableMultiRowsRoles:["Admin","Managers"]}.
• “המשימות שלי”: criteria:[{F:"OwnerId",C:"equalTo",T:"Pointer",V:"currentUser",P:{targetClass:"_User"}}].
• רשימה נפתחת תלויה בעריכת inline: בעמודת הבן inlineOptions:{type:"select", parentSelect:"CaseTypes"} + subclassPointers שמונה את ה‑Pointer של האב.

מגבלות

• טופס החיפוש מחוץ להיקף הכלי. אי אפשר להוסיף או לערוך שדה חיפוש דרך Edit-Table-View — רק JS בדף או שכפול דף שכבר יש בו את הטופס הנכון. אין כלי ליצירת טופס חיפוש.
• summary: "sum" על עמודה שאינה Number מפיל את כל שורת הסיכום (400 מהשרת). ראו האזהרה ב‑summaryOptions.
• AutoIncrement מרונדר רק אם השדה ב‑DB באמת מספר רץ. ראו כלי סכימה.
• מזהי אלמנטים הם פר סביבה. P113 יציב בין שכפולים של אותו מקור, ולא בין לקוחות.
• המוסכמה היא טופס חיפוש אחד לדף. שתי טבלאות בדף אחד דורשות queryForm נפרד לכל אחת — עדיף שני דפים.

המשך

• דוחות — אותה גרמטיקה של שדות, במנוע אחר
• אלמנטי דשבורד — המונים והגרפים שיושבים לצד הטבלה
• עריכת דפים ואלמנטים · הגדרות דף, קוד וגרסאות
• כלי סכימה — טבלאות ושדות · תפקידים והרשאות
• אינדקס הכלים המלא