מישהו נותן לך תבנית Word ולוח זמנים. איזה נתונים היא דורשת? התשובה הרגילה היא לפתוח אותה, לגלול, לנחש, להריץ, לקרוא את השגיאה, ולהריץ שוב. עם GroupDocs.Assembly.Mcp הפועל מקומית (dnx GroupDocs.Assembly.Mcp --yes), Claude Desktop, Cursor או Copilot שואלים את התבנית ישירות: get_template_fields מחזיר כל תג, את שמות הנתונים שהיא משתמשת בהם ושלד JSON למילוי, ללא הרצת המנוע, וכאשר הרצה נכשלת, השגיאה אומרת מה לשנות:

איזה נתונים צריך order-lines.docx? אם הוא לא ייווצר, תגיד לי למה ואיך לתקן את התבנית.

הגרסה הצעד‑אחר‑צעד עם תצורה ופתרון בעיות נמצאת בתיעוד: How to find out what a template needs and why it failed.

למה לבדוק לפני שממלאים?

כי ניסוי וטעייה הוא הדרך היקרה ללמוד סכימה. סוכן שמנחש שמות שדות מהטקסט הגלוי של מסמך ינחש CustomerName כאשר בתבנית כתוב customer.Name, וכל ניחוש שגוי עולה בטיול נוסף ובשגיאה מבלבלת. תבנית איננה פרוזה; היא תוכנית עם חוזה נתונים, והחוזה ניתן לקריאה.

זה כל מה ש‑get_template_fields עושה. הוא מנתח את התגים <<…>>, מוצא את השמות ובונה את השלד:

-> get_template_fields {"template":{"filePath":"order-lines.docx"}}
<- { "tagCount": 3,
     "dataSourceNames": [ "lines" ],
     "fields": [ "lines[].Title", "lines[].Quantity" ],
     "dataSkeleton": { "lines": [ { "Title": "", "Quantity": "" } ] },
     "notes": [ "fields and dataSkeleton are inferred from the tags,
       not from the engine; values computed by Select/GroupBy
       projections are not followed." ] }

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

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

שלוש כשלונות, שלוש תשובות

template problem          what the server says          the fix
------------------------  ----------------------------  -------------------
{{name}} placeholders     "2 '{{...}}' placeholder(s).  write <<[name]>>
                          ... does not process that
                          syntax"
<<foreach>> never closed  "Unexpected end of template.  add <</foreach>>
                          A block tag is not closed"
data lacks a field        "The template reads 'Email',  add it, or
                          which the data does not have" allowMissingMembers

התחביר השגוי. הרבה תבניות בטבע נכתבו למנועים אחרים ומשתמשות ב‑{{name}}. GroupDocs.Assembly משאיר אותם כטקסט, והבדיקה מודיעה על כך לפני שמישהו מבזבז הרצה:

-> get_template_fields {"template":{"filePath":"shipping-notice.docx"}}
<- { "tagCount": 0, "notes": [ "No <<…>> tags were found: ...",
     "The template contains 2 '{{…}}' placeholder(s). GroupDocs.Assembly
      does not process that syntax and leaves it as text; write
      <<[name]>> instead." ] }

הבלוק שלא נסגר. ה‑order-lines.docx שלנו פותח <<foreach>> ולעולם לא סוגר אותו. הבדיקה מציינת את התגים בשמחה; ההרכבה לא:

-> assemble_document {"template":{"filePath":"order-lines.docx"},
     "dataJson":"{\"lines\":[{\"Title\":\"Cable\",\"Quantity\":2}]}"}
<- Document assembly failed for 'order-lines.docx': ...
   Unexpected end of template. A block tag is not closed: every
   <<foreach>> needs <</foreach>> and every <<if>> needs <</if>>.

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

כאשר התבנית מלאה בטעויות

חלק מהתבניות מכילות כמה שגיאות, ותיקונן ריצה אחרי ריצה הוא תהליך איטי. inlineErrors: true הופך את התבנית לדוח שגיאות משלה: המסמך נוצר וכל תג פגום מקבל את הודעתו כתובה לידו. על תבנית הדוגמה מהדוגמאות של GroupDocs.Assembly:

-> assemble_document {"template":{"filePath":"inline-error.docx"},
     "dataJson":"{\"name\":\"x\"}","inlineErrors":true}
<- Assembled 'inline-error.docx' ... The template has errors: each one
   is written into the output next to its tag, starting with 'Error!'

הפלט מכיל << var [name] Error! An assignment operator is expected. >>, במקום במסמך שבו נמצא התג. פתחו את הקובץ, תקנו כל תג מסומן, הריצו שוב ללא הדגל.

מה הבדיקה לא יכולה לראות

תבניות Outlook בינריות הן היוצא מן הכלל. לא ניתן לקרוא את התגים של קובץ .msg ללא יצירתו, והשרת מודיע על כך במקום להחזיר רשימה ריקה שנראית כמו “אין שדות”:

-> get_template_fields {"template":{"filePath":"contracts-table.msg"}}
<- { "readable": false, "notes": [ "Tags cannot be read from a .msg
     template without generating it. Save the template as DOCX, XLSX,
     PPTX or EML to inspect it, or generate it with assemble_document
     and inlineErrors=true to see which fields fail." ] }

מלכודת נוספת שנתקלנו בה: רשימה ריקה בנתונים אין לה סוגי חברים. תבנית החוזה שלנו מכפילה item.Quantity * item.UnitPrice; עם "items": [] ו‑allowMissingMembers: true, ההרכבה עדיין נכשלה עם “Can not apply operator ‘’ to operands of type ‘System.Object’ and ‘System.Object’”*. ההגנה הברורה, <<if [items.Any()]>> סביב הטבלה, לא עזרה: המנוע בודק כל ביטוי לפני שהוא מריץ משהו. מה שעבד היה להוציא את החישוב מהשורה. עם הסכום שכבר בנתונים (<<[item.Amount]>>), אותה רשימה ריקה ו‑allowMissingMembers: true ייצרו את המסמך, ו‑<<if [items.Count() == 0]>>No services ordered.<</if>> הדפיסו את השורה. אחרת, תנו לסוכן לבדוק שהרשימה אינה ריקה לפני ההרכבה, ושאלו מה צריך להיראות בחוזה ריק.

מגבלות כנות

  • הבדיקה היא סטטית: פרויקטים של Select ו‑GroupBy אינם נעקפים, ותבניות .msg אינן ניתנות לקריאה.
  • תבניות הן קלט מהימן; תגים של תמונות ומסמכים טוענים את הנתיבים וה‑URL שהביטויים שלהם מחזירים.
  • מצב הערכה: כל פלט מתחיל ב‑“Evaluation Only. Created with GroupDocs.Assembly 26.7…”.
  • תאריכים: העבירו 2026-11-12T00:00:00 ועצבו בתבנית עם :"d MMMM yyyy"; מחרוזת תאריך‑רק הוזזה ביום אחד במכונה UTC+2, ו‑"12.11.2026" נקראה כ‑11 בדצמבר.

שאלות נפוצות

איך אני רואה אילו שדות תבנית Word דורשת?
תבקשו מהסוכן לקרוא get_template_fields עליה. תקבלו את התגים, שמות הנתונים ושלד JSON, מקומית, ללא יצירת דבר.

למה התבנית שלי מדפיסה {{name}} במקום הערך?
כי תגים של GroupDocs.Assembly הם <<[name]>>. בדיקת השרת מדגישה תחליפי {{…}} ומציינת מה לכתוב במקום.

האם Markdown יכול להיות תבנית?
כן. הקובץ product-readme.md שלנו עם תגים <<[product]>> ו‑<<[description]>> נבדק כמו קובץ Word ונוצר ישירות ל‑DOCX.

להעמיק יותר