Mail Merge תבנית מ Mustache תחביר

Aspose.Words מאפשר לך ליצור תבניות עם mustache תחביר בנוסף לתבניות המוכרות. Mustache הוא גרסה חלופית של סינטקסי תבנית המורכבת משמות תגיות המוקפים על ידי אובייקט מודל המכיל את הנתונים עבור התבנית.

התחביר Mustache הוא האפשרות היחידה לשימוש עם תבניות שאינן מכילות שדות, כגון HTML ו TXT תבניות. עם Word תבניות, יש לך שתי אפשרויות להשתמש בשדות או Mustache תחביר.

הסינטקסה Mustache תומכת בתג foreach, שהיא חלופה לשימוש Mail Merge עם אזורים. אז היתרון הוא שאתה יכול להשתמש mustache תחביר אם מסיבה כלשהי אתה לא מסוגל או פשוט אתה לא רוצה להשתמש מיזוג שדות ומיזוג אזורים.

ניתן גם לשלב שדות Mail Merge עם כמה שדות נוספים באמצעות התג foreach כפי שמוצג בתמונה למטה.

mustache_syntax

צור תבנית Mustache

הנקודה החשובה הראשונה שיש להבהיר היא ש Mustache אינו מנוע תבניות. Mustache הוא גרסה סינטקסית נוספת הזמינה עבור כל תבנית ב load format נתמכת על ידי Aspose.Words. לכן, אתה יכול ליצור תבנית כזו הן באופן תכנותי והן באמצעות ממשק, אתה רק צריך לכלול תחביר מסוים ולעמוד במפרט Mustache.

נניח שעליך לשלוח את אותו אימייל ל -50 נמענים כדי להתאים אישית את הברכה עם שמותיהם הפרטיים המתאימים. תוכל להחליף את שמו הפרטי של הנמען במציין מיקום כלשהו כדלקמן:

Dear {{FirstName}}

I hereby…

השאלה כאן: איך אתה יכול ליצור 50 מיילים מ 1 יחיד Mustache תבנית? כדי לענות על כך, עליך לבצע Mail Merge עם אזורים כדי למלא את הפלטה המתולתלת עבור מצייני מיקום בתבנית בנתונים בפועל וליצור מסמך פלט.

mustache_template

עבודה עם תחביר Mustache

Mustache מיוצג כסדר ללא לוגיקה מכיוון שהוא חסר כל הצהרות זרימת בקרה ספציפיות כגון for לולאות ו if ו else תנאים. אבל אתה יכול להשתמש בסעיף תגיות עיבוד רשימות ולמבדות כדי להשיג הערכה ולולאה מותנית. אז כדי לכלול את תחביר Mustache בתוך פעולת Mail Merge, יהיה עליך להשתמש במאפיין UseNonMergeFields ולהגדיר את ערכו ל True.

דוגמת הקוד הבאה מראה כיצד להחליף את התגים Mustache בנתונים ספציפיים:

אתה יכול להבחין בהבדל בין המסמך לפני ביצוע Mail Merge עם אזורים יחד עם החלת המאפיין UseNonMergeFields:

mustache_syntax

ולאחר החלת Mail Merge עם אזורים:

mustache_syntax_result

השתמש בשדות IF כדי ליצור Mail Merge אינטליגנטי

Aspose.Words מאפשר לך להשתמש בשדות Mail Merge ותגים Mustache עם ההצהרה IF. ניתן להשתמש בשדות IF בכל מסמך Mail Merge כדי לדכא רווחים ופסיקים לא רצויים אם שדה ריק.

נוסחת השדה IF מוצגת להלן:

{ IF [Condition] [Display Result 1] [Display Result 2] }

כאן, התנאי יכול להיות שדה מיזוג או תג Mustache.

לדוגמה, אתה יכול להשתמש בשדות IF אם אתה צריך להוסיף “שלו”, “שלה”, “הוא” או “היא” בהתאם למין כדלקמן:

{ IF { MERGEFIELD Gender } = “MALE” “טקסט אמיתי” “טקסט כוזב”}

{ IF “{{ GENDER }}” = “MALE” “טקסט אמיתי” “טקסט כוזב”}

דוגמת הקוד הבאה מראה כיצד לבצע פעולה Mail Merge עם תגיות Mustache ושדות IF:

ניתן להבחין בהבדל בין המסמך לפני החלת המאפיין UseNonMergeFields:

mustache_if_field

ולאחר החלת המאפיין UseNonMergeFields:

mustache-if-field-2.png