แทรก Checkboxการป้อนข้อความหรือรูปภาพ

เครื่องมือผสานใช้เอกสารเป็นอินพุต,มองหา MERGEFIELD ในนั้นและแทนที่พวกเขาด้วยข้อมูลที่ได้รับจากแหล่งข้อมูล โดยปกติแล้วข้อความธรรมดาและ HTML จะแทรกแต่ Aspose.Words ผู้ใช้ยังสามารถสร้างเอกสารที่จัดการกับสถานการณ์ที่ผิดปกติมากขึ้นสำหรับ Mail Merge สนาม.

ทรงพลัง Aspose.Words ฟังก์ชั่นช่วยให้คุณสามารถขยาย Mail Merge กระบวนการ:

• แทรกช่องทำเครื่องหมายและฟิลด์แบบฟอร์มการป้อนข้อความลงในเอกสารในระหว่าง mail merge
• แทรกภาพจากการจัดเก็บข้อมูลที่กำหนดเองใดๆ(ไฟล์, BLOB สนามฯลฯ)

แทรก Checkboxและป้อนข้อความในช่วง Mail Merge

บางครั้งก็เป็นสิ่งจำเป็นที่จะดำเนินการ Mail Merge การดำเนินการเพื่อให้ข้อความไม่ถูกแทนที่ในฟิลด์ผสานแต่ช่องทำเครื่องหมายหรือฟิลด์ป้อ แม้ว่านี้ไม่ได้เป็นสถานการณ์ที่พบบ่อยที่สุดก็จะมีประโยชน์มากสำหรับงานบางอย่าง.

ภาพหน้าจอต่อไปนี้ของเอกสารคำแสดงแม่แบบที่มีเขตข้อมูลผสาน:

ภาพหน้าจอของเอกสารคำด้านล่างนี้แสดงเอกสารที่สร้างขึ้นแล้ว:

โปรดทราบว่าบางเขตข้อมูลถูกแทนที่ด้วยข้อความธรรมดาบางเขตข้อมูลถูกแทนที่ด้วยช่องท Subject ฟิลด์ถูกแทนที่ด้วยช่องป้อนข้อความ.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการแทรกกล่องกาเครื่องหมายและฟิลด์ป้อนข้อความลงในเอก mail merge:

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
auto doc = MakeObject<Document>(MyDir + u"Mail merge destinations - Fax.docx");

// Setup mail merge event handler to do the custom work.
doc->get_MailMerge()->set_FieldMergingCallback(MakeObject<WorkingWithFields_::HandleMergeField>());
// Trim trailing and leading whitespaces mail merge values.
doc->get_MailMerge()->set_TrimWhitespaces(false);

ArrayPtr<String> fieldNames =
    MakeArray<String>({u"RecipientName", u"SenderName", u"FaxNumber", u"PhoneNumber", u"Subject", u"Body", u"Urgent", u"ForReview", u"PleaseComment"});

ArrayPtr<SharedPtr<System::Object>> fieldValues = MakeArray<SharedPtr<System::Object>>(
    {System::ObjectExt::Box<String>(u"Josh"), System::ObjectExt::Box<String>(u"Jenny"), System::ObjectExt::Box<String>(u"123456789"),
     System::ObjectExt::Box<String>(u""), System::ObjectExt::Box<String>(u"Hello"), System::ObjectExt::Box<String>(u"<b>HTML Body Test message 1</b>"),
     System::ObjectExt::Box<bool>(true), System::ObjectExt::Box<bool>(false), System::ObjectExt::Box<bool>(true)});

doc->get_MailMerge()->Execute(fieldNames, fieldValues);

doc->Save(ArtifactsDir + u"WorkingWithFields.MailMergeFormFields.docx");

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
class HandleMergeField : public IFieldMergingCallback
{
private:
    SharedPtr<DocumentBuilder> mBuilder;

    /// <summary>
    /// This handler is called for every mail merge field found in the document,
    /// for every record found in the data source.
    /// </summary>
    void FieldMerging(SharedPtr<FieldMergingArgs> e) override
    {
        if (mBuilder == nullptr)
        {
            mBuilder = MakeObject<DocumentBuilder>(e->get_Document());
        }

        // We decided that we want all boolean values to be output as check box form fields.
        if (System::ObjectExt::Is<bool>(e->get_FieldValue()))
        {
            // Move the "cursor" to the current merge field.
            mBuilder->MoveToMergeField(e->get_FieldName());

            String checkBoxName = String::Format(u"{0}{1}", e->get_FieldName(), e->get_RecordIndex());

            mBuilder->InsertCheckBox(checkBoxName, System::ObjectExt::Unbox<bool>(e->get_FieldValue()), 0);

            return;
        }

        if (e->get_FieldName() == u"Body")
        {
            mBuilder->MoveToMergeField(e->get_FieldName());
            mBuilder->InsertHtml(System::ObjectExt::Unbox<String>(e->get_FieldValue()));
        }
        else if (e->get_FieldName() == u"Subject")
        {
            mBuilder->MoveToMergeField(e->get_FieldName());
            String textInputName = String::Format(u"{0}{1}", e->get_FieldName(), e->get_RecordIndex());
            mBuilder->InsertTextInput(textInputName, TextFormFieldType::Regular, u"", System::ObjectExt::Unbox<String>(e->get_FieldValue()), 0);
        }
    }

    void ImageFieldMerging(SharedPtr<ImageFieldMergingArgs> args) override
    {
        args->set_ImageFileName(u"Image.png");
        args->get_ImageWidth()->set_Value(200);
        args->set_ImageHeight(MakeObject<MergeFieldImageDimension>(200, MergeFieldImageDimensionUnit::Percent));
    }
};

แทรกภาพในระหว่าง Mail Merge

เมื่อดำเนินการ Mail Merge คุณสามารถแทรกภาพจากฐานข้อมูลลงในเอกสารโดยใช้ภาพพิเศษ Mail Merge สนาม ภาพ Mail Merge ฟิลด์เป็นฟิลด์ผสานชื่อภาพ:MyFieldName.

แทรกภาพจากฐานข้อมูล

ในช่วง Mail Merge เมื่อภาพ Mail Merge ฟิลด์จะพบในเอกสาร FieldMergingCallback เหตุการณ์ถูกยิง คุณสามารถตอบสนองต่อเหตุการณ์นี้เพื่อส่งคืนชื่อแฟ้มสตรีมหรือวัตถุรูปภาพไปยัง Mail Merge เครื่องยนต์เพื่อที่จะสามารถแทรกลงในเอกสาร.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการแทรกรูปภาพที่เก็บไว้ในฐานข้อมูล BLOB ฟิลด์ลงในรายงาน:

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

// MERGEFIELDs with "Image:" tags will receive an image during a mail merge.
// The string after the colon in the "Image:" tag corresponds to a column name
// in the data source whose cells contain URIs of image files.
builder->InsertField(u"MERGEFIELD  Image:logo_FromWeb ");
builder->InsertField(u"MERGEFIELD  Image:logo_FromFileSystem ");

// Create a data source that contains URIs of images that we will merge.
// A URI can be a web URL that points to an image, or a local file system filename of an image file.
ArrayPtr<String> columns = MakeArray<String>({u"logo_FromWeb", u"logo_FromFileSystem"});
ArrayPtr<SharedPtr<System::Object>> URIs =
    MakeArray<SharedPtr<System::Object>>({System::ObjectExt::Box<String>(ImageUrl), System::ObjectExt::Box<String>(ImageDir + u"Logo.jpg")});

// Execute a mail merge on a data source with one row.
doc->get_MailMerge()->Execute(columns, URIs);

doc->Save(ArtifactsDir + u"MailMergeEvent.ImageFromUrl.docx");

ตั้งค่าคุณสมบัติของภาพในระหว่าง Mail Merge

ในขณะที่การผสานฟิลด์ผสานรูปภาพบางครั้งคุณอาจจำเป็นต้องควบคุมคุณสมบัติของรูปภาพต่ WrapType.

ปัจจุบันใช้ ImageFieldMergingArgs คุณสามารถตั้งค่าความกว้างของภาพหรือคุณสมบัติความสูงตามลำดับ เพื่อเอาชนะปัญหานี้, Aspose.Words ให้ Shape อำนวยความสะดวกในการที่จะได้รับการควบคุมเต็มรูปแบบผ่านภาพแทรกหรือรูปร่างอื่นๆ.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการตั้งค่าคุณสมบัติของรูปภาพต่างๆ:

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

builder->Writeln(u"{{#foreach example}}");
builder->Writeln(u"{{Image(126pt;126pt):stempel}}");
builder->Writeln(u"{{/foreach example}}");

doc->get_MailMerge()->set_UseNonMergeFields(true);
doc->get_MailMerge()->set_TrimWhitespaces(true);
doc->get_MailMerge()->set_UseWholeParagraphAsRegion(false);
doc->get_MailMerge()->set_CleanupOptions(MailMergeCleanupOptions::RemoveEmptyTableRows | MailMergeCleanupOptions::RemoveContainingFields |
                                         MailMergeCleanupOptions::RemoveUnusedRegions | MailMergeCleanupOptions::RemoveUnusedFields);

doc->get_MailMerge()->set_FieldMergingCallback(MakeObject<WorkingWithFields_::ImageFieldMergingHandler>());
doc->get_MailMerge()->ExecuteWithRegions(MakeObject<WorkingWithFields_::DataSourceRoot>());

doc->Save(ArtifactsDir + u"WorkingWithFields.MailMergeImageField.docx");

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
class ImageFieldMergingHandler : public IFieldMergingCallback
{
private:
    void FieldMerging(SharedPtr<FieldMergingArgs> args) override
    {
        ASPOSE_UNUSED(args);
        //  Implementation is not required.
    }

    void ImageFieldMerging(SharedPtr<ImageFieldMergingArgs> args) override
    {
        auto shape = MakeObject<Shape>(args->get_Document(), ShapeType::Image);
        shape->set_Width(126);
        shape->set_Height(126);
        shape->set_WrapType(WrapType::Square);

        shape->get_ImageData()->SetImage(MyDir + u"Mail merge image.png");

        args->set_Shape(shape);
    }
};

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
class DataSourceRoot : public IMailMergeDataSourceRoot
{
private:
    class DataSource : public IMailMergeDataSource
    {
    public:
        bool MoveNext() override
        {
            bool result = next;
            next = false;
            return result;
        }

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

        bool GetValue(String fieldName, SharedPtr<System::Object>& fieldValue) override
        {
            ASPOSE_UNUSED(fieldName);
            fieldValue.reset();
            return false;
        }

        DataSource() : next(true)
        {
        }

    private:
        bool next;

        String get_TableName() override
        {
            return TableName();
        }

        String TableName()
        {
            return u"example";
        }
    };

public:
    SharedPtr<IMailMergeDataSource> GetDataSource(String s) override
    {
        ASPOSE_UNUSED(s);
        return MakeObject<WorkingWithFields_::DataSourceRoot::DataSource>();
    }
};