عملیات ساده Mail Merge

یک Mail Merge ساده برای پر کردن فیلدهای Mail Merge داخل قالب شما با داده های مورد نیاز از منبع داده شما (نمایش جدول واحد) استفاده می شود. پس شبیه به کلاسیک Mail Merge در Microsoft Word است.

شما می توانید یک یا چند فیلد ادغام را در قالب خود اضافه کنید و سپس عملیات ساده Mail Merge را اجرا کنید. توصیه می شود از آن استفاده کنید اگر قالب شما شامل هیچ منطقه ادغام نیست.

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

چگونه یک عملیات ساده Mail Merge را اجرا کنیم

وقتی قالب شما آماده شد، می توانید عملیات ساده Mail Merge را شروع کنید. Aspose.Words به شما اجازه می دهد تا یک عملیات ساده Mail Merge را با استفاده از روش های مختلف Execute که اشیاء داده های مختلف را به عنوان منبع داده قبول می کنند، اجرا کنید.

مثال کد زیر نشان می دهد که چگونه یک عملیات ساده Mail Merge را با استفاده از یکی از روش Execute اجرا کنیم:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
auto doc = MakeObject<Document>();
auto builder = MakeObject<DocumentBuilder>(doc);
        
builder->InsertField(u" MERGEFIELD CustomerName ");
builder->InsertParagraph();
builder->InsertField(u" MERGEFIELD Item ");
builder->InsertParagraph();
builder->InsertField(u" MERGEFIELD Quantity ");

auto boxHelper = [](const char16_t* value) { return System::ObjectExt::Box<String>(value); };

// Fill the fields in the document with user data.
doc->get_MailMerge()->Execute(
    MakeArray<String>({u"CustomerName", u"Item", u"Quantity"}),
    MakeArray<SharedPtr<System::Object>>(
        { boxHelper(u"John Doe"), boxHelper(u"Hawaiian"), boxHelper(u"2")}));

doc->Save(ArtifactsDir + u"BaseOperations.SimpleMailMerge.docx");

شما می توانید تفاوت بین سند را قبل از اجرای ساده متوجه شوید mail merge:

و بعد از اجرای ساده mail merge:

چگونه چندین سند ادغام شده ایجاد کنیم

در Aspose.Words، عملیات استاندارد Mail Merge تنها یک سند را با محتوای منبع داده شما پر می کند. بنابراین، شما باید عملیات Mail Merge را بارها اجرا کنید تا چند سند ادغام شده به عنوان خروجی ایجاد کنید.

مثال کد زیر نشان می دهد که چگونه چند سند ادغام شده را در طول یک عملیات Mail Merge با SQLiteCpp:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
void MultipleDocumentsMailMerge()
{
    auto doc = MakeObject<Document>();
    auto builder = MakeObject<DocumentBuilder>(doc);

    builder->InsertField(u" MERGEFIELD FullName ");
    builder->InsertParagraph();
    builder->InsertField(u" MERGEFIELD Address ");

    // Fill the fields in the document with user data.
    SQLite::Database database{ (std::string)(DatabaseDir + u"customers.db3") };
    SQLite::Statement query{ database, "SELECT * FROM Customers" };
    auto dataSource = MakeObject<CustomersRowMailMergeDataSource>(query);

    int32_t counter = 1;
    while (query.executeStep())
    {
        dataSource->Reset();
        doc->get_MailMerge()->Execute(dataSource);
        doc->Save(ArtifactsDir + u"BaseOperations.MultipleDocumentsMailMerge_" + counter++ + u".docx");
    }
}

class CustomersRowMailMergeDataSource : public MailMerging::IMailMergeDataSource
{
public:
    CustomersRowMailMergeDataSource(SQLite::Statement& query) : mQuery(query) {}

    String get_TableName() override
    {
        return u"Customers";
    }

    bool GetValue(String fieldName, SharedPtr<Object>& fieldValue) override
    {
        auto boxHelper = [](const std::string& value) { return System::ObjectExt::Box<String>(String::FromUtf8(value)); };

        if (fieldName == u"FullName")
        {
            fieldValue = boxHelper(mQuery.getColumn(1).getString());
            return true;
        }

        if (fieldName == u"Address")
        {
            fieldValue = boxHelper(mQuery.getColumn(2).getString());
            return true;
        }

        fieldValue.reset();
        return false;
    }

    bool MoveNext() override
    {
        if (!isInitialized)
        {
            isInitialized = true;
            return true;
        }
        return false;
    }

    SharedPtr<IMailMergeDataSource> GetChildDataSource(String tableName) override
    {
        return nullptr;
    }

    void Reset()
    {
        isInitialized = false;
    }

private:
    SQLite::Statement& mQuery;
    bool isInitialized = false;
};