گزارش های اتوماتیک با C# Mail Merge و Aspose.Words Mail Merge Plugin

اتوماسیون ایجاد اسناد سفارشی – مانند گزارش ها، نامه ها و صورتحساب ها – می تواند به طور قابل توجهی بهبود بهره وری در جریان کار شما را افزایش دهد. با C# Mail Merge که توسط Aspose.Words برای .NET تغذیه می شود، شما می توانید این کار را بدون هیچ مشکلی انجام دهید. این راهنمای شما از طریق استفاده از پلاگین ادغام ایمیل ASPOSE. Word برای انجام یک تولید مستند کارآمد و قابل مقیاس در برنامه های شما در داخل .Net – بدون نیاز به 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: به راحتی با API های مدرن ادغام می شود.
• CSV: جمع آوری داده های جدول برای تولید اسناد جمعی.
• DataTable/DataSet: برای ادغام داده ها از ADO.NET استفاده کنید.

آماده سازی قالب برای Mail Merge {#پرداخت قالب برای Mail Merge}

قالب پیوستن ایمیل، سندی است که حاوی میدان پیوستن است که در طول اجرای با داده های منبع داده مشخص شده شما جمع آوری می شود. قالب می تواند در فرمت DOC یا DOCX باشد و نیازی به یک سبک خاص ندارد.

• اسناد خود را باز کنید یا یک اسناد جدید در MS Word ایجاد کنید.
• مسیر را در جایی قرار دهید که می خواهید یک میدان ادغام را وارد کنید.
• از منوی وارد کنید، گزینه میدان را انتخاب کنید.
• از لیست نام میدان، MergeField را انتخاب کنید.
• یک نام برای میدان ادغام را در جعبه نام میدان مشخص کنید و روی OK کلیک کنید.
• اسناد را ذخیره کنید.

تصویر زیر نشان می دهد که یک نمونه نمونه اسناد .

.NET Mail Merge API - نصب

شما می توانید Aspose.Words برای .NET را از طریق روش های مختلف نصب کنید:

• دانلود DLL
• نصب از طریق NuGet Package Manager

انجام پیوست پیوست در سند Word با استفاده از C#

هنگامی که قالب شما آماده است، می توانید پیوند ایمیل را برای تولید اسناد اجرا کنید.در اینجا مراحل پیوند ایمیل در قالب آماده شما وجود دارد:

• قالب را با استفاده از قالب اسناد کلاس ها
• تنظیم گزینه های ادغام ایمیل مورد نیاز، مانند بایگانی برچسب ها:TrimWhitespaces.
• پیوستن به ایمیل با استفاده از بایگانی برچسب ها: دایرکتوری روش، انتقال منبع داده به عنوان پارامتر.
• اسناد تولید شده را با استفاده از بایگانی برچسب ها: String روش است.

در اینجا یک نمونه کد نشان می دهد که چگونه تولید گزارش اتوماتیک در C# با استفاده از مجموعه ای از ارزش ها:

کلمه پس از پیوستن ایمیل

انجام 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 مالکیت اجازه می دهد تا شما را به تنظیم رفتار پیوند ایمیل به عنوان هر میدان پیونگ ملاقات می شود. بایگانی برچسب ها: بایگانی برچسب ها: بایگانی برچسب ها: بایگانی برچسب ها: بایگانی برچسب ها و بایگانی برچسب ها: ImageFieldMerging روش ها امکان سفارشی سازی عملیات ادغام ایمیل را فراهم می کند.

در زیر یک نمونه کد نشان می دهد که چگونه برای استفاده از فرمت سفارشی در طول پیوند ایمیل از طریق قالب نمونه ارائه شده:

در این بخش از کلاس HandleMergeFieldAlternatingRows استفاده می شود.

ایمیل ترکیب با مناطق با استفاده از C#

در بعضی موارد ممکن است نیاز به جمع آوری و تکرار یک منطقه خاص در سند کلمه داشته باشید.برای چنین سناریوه ای، از ادغام ایمیل با مناطق استفاده کنید.به منظور ایجاد منطقه، هر دو شروع و پایان منطقه را مشخص کنید؛ ادعای ایمیل برای هر رکورد در منبع داده تکراری خواهد شد.نمونه نمونه زیر شامل دو منطقه است – دستورالعمل ها و جزئیات سفارش – با استفاده از میدان های ادعا «TableStart:OrderDetails» و «تصاویر جدول: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 فراهم می کند.با چند خط کد، شما می توانید گزارش های ساده یا پیچیده از منابع داده های مختلف را بدون هیچ مشکلی توسعه دهید.برای راهنمایی در مورد .NET گزارش به صورت اتوماتیک بهترین شیوه ها را ارائه می دهد، لطفا با ما تماس بگیرید. مستندات. برای شروع با Aspose.Words برای .NET، گزینه های موجود را بررسی کنید. راهنمای توسعه دهنده و کد نمونه در GitHub. Aspose Plugin همچنین قابلیت های پیشرفته برای تولید گزارش را فراهم می کند.

سعی کنید Aspose.Words برای .NET برای رایگان

شما می توانید یک مجوز موقت رایگان برای امتحان کردن Aspose.Words برای .NET بدون محدودیت دریافت کنید. اکنون مجوز موقت خود را دریافت کنید.

More in this category

• تبدیل Word DOC/DOCX به PDF در C# .NET و Aspose.Words' Document Converter Plugin
• تولید بارکد در اسناد ورد (.NET, C#) | خواندن بارکد از ورد (.NET)
• استخراج تصاویر از اسناد کلمه در پردازش تصویر اتوماتیک C#
• یافتن و جایگزین کردن متن در اسناد کلمه با استفاده از C# کلمه خودکار ویرایش
• ایجاد اسناد کلمه سفارشی با استفاده از C# .NET Aspose.Words Mail Merge Plugin