אוטומט דוחות עם מיזוג דואר C# | תוסף מיזוג הדואר של Aspose.Words

אוטומציה של יצירת מסמכים מותאמים אישית – כגון דוחות, מכתבים וחשבוניות – יכולה להגדיל באופן משמעותי את היעילות בתהליך העבודה שלך.עם C# Mail Merge המופעל על ידי Aspose.Words עבור .NET, אתה יכול להשיג את זה בקלות.המדריך הזה יעבור אותך באמצעות התוסף Azpo.Sword Mail merge Plugin כדי לבצע ליצירת תיעוד יעילה ומסובכת בתוך היישומים שלך - ללא הצורך ב- MS Word או Office Interop.

תוכן

• מה זה Mail Merge?
• מקורות נתונים עבור Mail Merge
• להכין דואר שילוב תבניות
• להתחיל עם Aspose.Words עבור .NET
• ביצוע דואר מתמזג עם נתוני דוגמה
• הדואר מתמזג עם נתונים XML
• פורמט שדה מותאם אישית
• דואר מתמזג עם אזורים
• הדואר האלקטרוני מתמזג
• מסקנה

מה זה Mail Merge?

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

• ליצור מכתבים אישיים וחשבוניות.
• יצירת דיווחים המוניים באמצעות פורמטים מבוססים כגון XML, JSON, או מסדי נתונים, המאפשרים ליצירת דיווחים דינמיים עם C# ו- Aspose.Words.

מקורות נתונים עבור Mail Merge

Aspose.Words תומכת במגוון מקורות נתונים, כולל:

• אובייקטים: תבניות פופולריות באמצעות דוגמאות בכיתה.
• XML: טעינה נתונים מבוססים עבור שדות דינמיים.
• JSON: קל לשלב עם APIs המודרניים.
• CSV: מחיקת נתוני טבלה ליצירת מסמך המוני.
• DataTable/DataSet: השתמש ADO.NET לאינטגרציה של נתונים.

הכנת תבנית עבור Mail Merge {#הכנת תבנית עבור Mail Merge}

תבנית שילוב הדואר הוא המסמך המכיל שדות שילוב אשר יפורסמו עם נתונים ממקור הנתונים המיועד שלך במהלך ביצוע.התבנית יכולה להיות בפורמט DOC או DOCX ואינה דורשת סגנון ספציפי.

• פתח את המסמך שלך או ליצור אחד חדש ב- MS Word.
• הניחו את הקורס שבו ברצונכם להזין שדה שילוב.
• מתוך התפריט הצטרף, בחר את האפשרות מגרש.
• מתוך רשימת שמות שדות , בחר MergeField.
• הקלד שם עבור שדה השילוב בתיבה שם השדה ולחץ על OK.
• שמור את המסמך

תמונת המסך הבאה מציינת את דוגמאות Template מסמך

.NET Mail Merge API - התקנה

ניתן להתקין Aspose.Words עבור .NET באמצעות שיטות שונות:

• הורד DLL
• עקבו אחרי NuGet Package Manager NuGet

Perform Mail Merge in Word Document using C#

ברגע שהתבנית שלך מוכנה, אתה יכול לבצע את שילוב הדואר כדי ליצור מסמכים.הנה השלבים לבצע שילוב הדואר על התבנית המוכנה שלך:

• הורד את המסמך באמצעות מסמך בכיתה
• הגדרת אפשרויות שילוב הדואר הנדרש, כגון מסמך.MailMerge.TrimWhitespaces.
• הפעל את הדואר האלקטרוני באמצעות דואר אלקטרוני .Execute() שיטה, העברת מקור הנתונים כמדד.
• שמור את המסמך שנוצר באמצעות ארכיון הכתבות על Save (String) שיטת

הנה דגימה של קוד המראה כיצד להגדיר את הדו"ח באופן אוטומטי ב- C# באמצעות מגוון של ערכים:

מסמך Word לאחר הדואר מתמזג

ביצוע Mail Merge באמצעות XML Data Source ב- C#

קבצי XML משמשים בדרך כלל לאחסון ושידור נתונים. Aspose.Words עבור .NET תומך ב- XML כמקור הנתונים עבור פעולות שילוב הדואר. DataSet למטה הוא דגימה של קובץ XML למקרה השימוש שלנו.

<customers>
    <customer Name="John Ben Jan" ID="1" Domain="History" City="Boston"/>
    <customer Name="Lisa Lane" ID="2" Domain="Chemistry" City="LA"/>
    <customer Name="Dagomir Zits" ID="3" Domain="Heraldry" City="Milwaukee"/>
    <customer Name="Sara Careira Santy" ID="4" Domain="IT" City="Miami"/>
</customers>

הדגימה הבאה של קוד מקבלת נתונים ממקור נתונים XML ומבצעת את שילוב הדואר באמצעות C#.

למטה מופיע הדואר הנייד בית המקדש זה יהיה פופולרי עם נתונים מהקובץ XML.

תמונה זו מייצגת את הדף הראשון של מסמך Word המתקבל לאחר ביצוע שילוב הדואר.

צורה מותאמת אישית של שדות התערבות

Aspose.Words עבור .NET מספק שליטה משופרת על תהליך שילוב הדואר. תגית: FieldMergingCallback הנכס מאפשר לך להגדיר התנהגות שילוב דואר כמו כל שדה שילובים נפגשים. תגיות קשורות Callback.FieldMerging ו IFieldMergingCallback.ImageFieldMerging שיטות מאפשרות התאמה אישית של פעולת שילוב הדואר.

להלן דוגמה של קוד המראה כיצד ליישם פורמט מותאם אישית במהלך הדואר המשלב באמצעות הדוגמה המוצעת:

הבא מיישם את הכיתה HandleMergeFieldAlternatingRows.

Mail Merge with Regions באמצעות C#

במקרים מסוימים, ייתכן שתצטרך להציב ולחזור על אזור מסוים בתוך מסמך המילה.במקרים כאלה, השתמשו בשילוב דואר עם אזורים.כדי ליצור שטח, ציין את ההתחלה והסוף של האזור; לאחר מכן, השילובים בדואר יפגשו את האזורים האלה עבור כל רשומה במקור הנתונים.הדוגמה למטה כוללת שתי אזורי – סדרות ופרטים של סדר – המשתמשים בשדות “TableStart:OrderDetails” ו"TablesStarts:Orders".

הנה דגימה של קוד המבצעת שילוב דואר מבוסס על אזורים עבור מה שהוזכר קודם לכן בית המקדש.

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

הדואר האלקטרוני מתערבב

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

הבא הוא מקור נתונים XML עבור דוגמה של שילוב הדואר הנייד שלנו.

<?xml version="1.0" encoding ="utf-8"?>
<Orders xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="OrdersSchema.xsd">
    <Order>
        <Number>23</Number>
        <Address>Nelson Street</Address>
        <Suburb>Howick</Suburb>
        <City>Auckland</City>
        <Phonenumber>543 1234</Phonenumber>
        <Date>03/01/2010</Date>
        <Total>14.00</Total>
        <Item>
            <Name>BBQ Chicken Pizza</Name>
            <Price>6.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>6.00</ItemTotal>
        </Item>
        <Item>
            <Name>1.5 Litre Coke</Name>
            <Price>4.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>8.00</ItemTotal>
        </Item>
    </Order>
    <Order>
        <Number>10</Number>
        <Address>Parkville Avenue</Address>
        <Suburb>Pakuranga</Suburb>
        <City>Auckland</City>
        <Phonenumber>548 7342</Phonenumber>
        <Date>05/03/2010</Date>
        <Total>6.00</Total>
        <Item>
            <Name>Hawaiian Pizza</Name>
            <Price>4.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>4.00</ItemTotal>
        </Item>
        <Item>
            <Name>Fries</Name>
            <Price>1.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>2.00</ItemTotal>
        </Item>
    </Order>
</Orders>

הקובץ המתאים OrderSchema.xsd עבור XML זה הוא:

<?xml version="1.0" encoding ="utf-8"?>
<xs:schema id="OrdersSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="Orders">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="Order">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="Number"/>
                            <xs:element name="Address"/>
                            <xs:element name="Suburb"/>
                            <xs:element name="City"/>
                            <xs:element name="Phonenumber"/>
                            <xs:element name="Date"/>
                            <xs:element name="Total"/>
                            <xs:element name="Item">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element name="Name"/>
                                        <xs:element name="Price"/>
                                        <xs:element name="Quantity"/>
                                        <xs:element name="ItemTotal"/>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

הדגימה הבאה של הקוד מבצעת את שילוב הדואר הנזרק באמצעות C#.

מסמך Word לאחר הדואר מתמזג

למטה נמצא הדף הראשון של מסמך המילה המתקבל לאחר ביצוע שילוב הדואר הנמצא.

מסקנה

Aspose.Words עבור .NET הוא API של שילוב דואר מקיף המספק תכונות סטנדרטיות והרחבות המתאימות ליישומים .Net. עם רק כמה שורות של קוד, אתה יכול לפתח דיווחים פשוטים או מורכבים ממקורות נתונים שונים בקלות. מסמכיםכדי להתחיל עם Aspose.Words עבור .NET, לחקור את זמין מדריך המפתחים דוגמאות קוד על GitHub. התוסף Aspose מציע גם פונקציונליות מתקדמת ליצירת דיווחים.

נסה Aspose.Words עבור .NET בחינם

אתה יכול לקבל רישיון זמני חינם כדי לנסות Aspose.Words עבור .NET ללא הגבלות. קבל את הרישיון הזמני שלך עכשיו.

More in this category

• המרת קובצי Word DOC/DOCX ל-PDF ב-C# .NET | תוסף הממיר של Aspose.Words
• יצירת ברקוד במסמכי וורד (.NET, C#) | קריאת ברקוד מוורד (.NET)
• חלץ תמונות ממסמכי וורד ב-C# | אוטומט תהליכי עיבוד תמונה
• מצא והחלף טקסט במסמכי וורד באמצעות C# | אוטומט עריכת וורד
• צור מסמכי Word מותאמים אישית באמצעות C# .NET | תוסף מיזוג הדואר של Aspose.Words