סוגי Mail Merge פעולה
הרעיון המרכזי של Mail Merge הוא ליצור באופן אוטומטי מסמך או מספר מסמכים המבוססים על התבנית והנתונים שנלקחו ממקור הנתונים שלך. Aspose.Words מאפשר לך לבצע שני סוגים שונים של פעולות Mail Merge: פשוט Mail Merge ו Mail Merge עם אזורים.
הדוגמה הנפוצה ביותר לשימוש פשוט Mail Merge היא כאשר ברצונך לשלוח מסמך ללקוחות שונים על ידי הכללת שמותיהם בתחילת המסמך. לשם כך, עליך ליצור שדות מיזוג כגון First Name ו Last Name בתבנית שלך, ולאחר מכן למלא אותם בנתונים ממקור הנתונים שלך. ואילו הדוגמה הנפוצה ביותר לשימוש Mail Merge עם אזורים היא כאשר ברצונך לשלוח מסמך הכולל הזמנות ספציפיות עם רשימת כל הפריטים בכל הזמנה. לשם כך, יהיה עליך ליצור מיזוג אזורים בתוך אזור התבנית שלך עבור כל הזמנה, על מנת למלא אותו עם כל הנתונים הנדרשים עבור הפריטים.
ההבדל העיקרי בין שתי פעולות המיזוג הוא שפשוט Mail Merge (ללא אזורים) חוזר על המסמך כולו לכל רשומת מקור נתונים, ואילו Mail Merge עם אזורים חוזר רק על אזורים ייעודיים לכל רשומה. אתה יכול לחשוב על פעולה פשוטה Mail Merge כמקרה מסוים של מיזוג עם אזורים שבהם האזור היחיד הוא המסמך כולו.
פשוט Mail Merge פעולה
Mail Merge פשוט משמש למילוי השדות Mail Merge בתוך התבנית שלך בנתונים הנדרשים ממקור הנתונים שלך (ייצוג טבלה אחת). אז זה דומה לקלאסיקה Mail Merge ב Microsoft Word.
אתה יכול להוסיף שדה מיזוג אחד או יותר בתבנית שלך ואז לבצע את הפעולה הפשוטה Mail Merge. מומלץ להשתמש בו אם התבנית שלך אינה מכילה אזורי מיזוג.
המגבלה העיקרית בשימוש בסוג זה היא שכל תוכן המסמך יחזור על עצמו עבור כל רשומה במקור הנתונים.
כיצד לבצע פעולה פשוטה Mail Merge
לאחר שהתבנית שלך מוכנה, תוכל להתחיל לבצע את הפעולה הפשוטה Mail Merge. Aspose.Words מאפשר לך לבצע פשוט Mail Merge פעולה באמצעות שונה Execute methods שמקבלים אובייקטי נתונים שונים כמקור הנתונים.
דוגמת הקוד הבאה מראה כיצד לבצע פעולה פשוטה Mail Merge באמצעות אחת מהשיטות Execute:
אתה יכול להבחין בהבדל בין המסמך לפני ביצוע פשוט mail merge:
ואחרי ביצוע פשוט mail merge:
כיצד ליצור מסמכים ממוזגים מרובים
ב Aspose.Words, הפעולה הסטנדרטית Mail Merge ממלאת רק מסמך אחד בתוכן ממקור הנתונים שלך. לכן, יהיה עליך לבצע את פעולת Mail Merge מספר פעמים כדי ליצור מסמכים ממוזגים מרובים כפלט.
דוגמת הקוד הבאה מראה כיצד ליצור מסמכים מרובים הממוזגים במהלך פעולת Mail Merge:
Mail Merge עם אזורים
אתה יכול ליצור אזורים שונים בתבנית שלך כדי שיהיו לך אזורים מיוחדים שאתה יכול פשוט למלא בנתונים שלך. השתמש ב Mail Merge עם אזורים אם ברצונך להוסיף טבלאות, שורות עם נתונים חוזרים כדי לגרום למסמכים שלך לצמוח באופן דינמי על ידי ציון אזורים אלה בתבנית שלך.
ניתן ליצור אזורים מקוננים (ילד) וכן למזג אזורים. היתרון העיקרי של שימוש בסוג זה הוא להגדיל באופן דינמי חלקים בתוך מסמך. ראה פרטים נוספים במאמר הבא"מקונן Mail Merge עם אזורים".
כיצד לבצע Mail Merge עם אזורים
אזור Mail Merge הוא חלק ספציפי בתוך מסמך שיש לו נקודת התחלה ונקודת סיום. שתי הנקודות מיוצגות כשדות Mail Merge שיש להם שמות ספציפיים “TableStart:XXX” ו “TableEnd:XXX”. כל התוכן הכלול באזור Mail Merge יחזור על עצמו באופן אוטומטי עבור כל רשומה במקור הנתונים.
Aspose.Words מאפשר לך לבצע Mail Merge עם אזורים המשתמשים ב Execute methods שונים המקבלים אובייקטי נתונים שונים כמקור הנתונים.
כצעד ראשון, עלינו ליצור את DataSet כדי להעביר אותו מאוחר יותר כפרמטר קלט לשיטת ExecuteWithRegions:
דוגמת הקוד הבאה מראה כיצד לבצע Mail Merge עם אזורים באמצעות שיטת ExecuteWithRegions(DataSet):
אתה יכול להבחין בהבדל בין המסמך לפני ביצוע Mail Merge עם אזורים:
ואחרי ביצוע Mail Merge עם אזורים:
מגבלות של Mail Merge עם אזורים
יש כמה נקודות חשובות שעליך לקחת בחשבון בעת ביצוע Mail Merge עם אזורים:
- נקודת ההתחלה TableStart:Orders ונקודת הסיום TableEnd:Orders שניהם צריכים להיות באותה שורה או תא. לדוגמה, אם אתה מפעיל אזור מיזוג בתא בטבלה, עליך לסיים את אזור המיזוג באותה שורה כמו התא הראשון.
- שם שדה המיזוג חייב להתאים לשם העמודה שלך DataTable. אלא אם כן ציינת שדות ממופים, Mail Merge עם אזורים לא יצליח עבור כל שדה מיזוג שיש לו שם שונה משם העמודה.
אם אחד הכללים האלה נשבר, תקבל תוצאות בלתי צפויות או חריג עשוי להיות נזרק.