Inserisci Checkboxes, Testo o immagini

Il motore di unione prende un documento come input, cerca i campi MERGEFIELD e li sostituisce con i dati ottenuti dall’origine dati. In genere vengono inseriti testo normale e HTML, ma gli utenti di Aspose.Words possono anche generare un documento che gestisce scenari più insoliti per i campi mail merge.

La potente funzionalità Aspose.Words consente di estendere il processo mail merge:

• inserire caselle di controllo e campi modulo di immissione testo nel documento durante un mail merge
• inserire immagini da qualsiasi archivio personalizzato (file ,campi BLOB, ecc.)

Inserisci Checkbox es e Input di testo durante Mail Merge

A volte è necessario eseguire un’operazione Mail Merge in modo che non venga sostituito il testo nel campo Unione, ma una casella di controllo o un campo di immissione del testo. Anche se questo non è lo scenario più comune, è molto utile per alcune attività.

La seguente schermata di un documento Word mostra un modello con campi di unione:

Questa schermata del documento di Word qui sotto mostra il documento già generato:

Si noti che alcuni campi sono stati sostituiti con testo normale, alcuni campi sono stati sostituiti con campi modulo casella di controllo e il campo Subject è stato sostituito con un campo di immissione del testo.

L’esempio di codice seguente mostra come inserire caselle di controllo e campi di testo in un documento durante un 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));
    }
};

Inserire immagini durante Mail Merge

Quando si esegue un’operazione mail merge, è possibile inserire immagini dal database nel documento utilizzando campi immagine speciali mail merge. Il campo image Mail Merge è un campo di unione denominato Image: MyFieldName.

Inserire immagini da un database

Durante un mail merge, quando viene rilevato un campo immagine Mail Merge in un documento, viene attivato l’evento FieldMergingCallback. È possibile rispondere a questo evento per restituire un nome file, un flusso o un oggetto immagine al motore Mail Merge in modo che possa essere inserito nel documento.

L’esempio di codice seguente mostra come inserire le immagini memorizzate in un campo database BLOB in un report:

//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");

Impostare le proprietà dell’immagine durante Mail Merge

Durante l’unione di un campo Unione immagine, a volte potrebbe essere necessario controllare varie proprietà dell’immagine, ad esempio WrapType.

Attualmente, usando ImageFieldMergingArgs è possibile impostare solo le proprietà larghezza immagine o altezza, rispettivamente. Per ovviare a questo problema, Aspose.Words fornisce la proprietà Shape, che facilita il controllo completo sull’immagine inserita o su qualsiasi altra forma.

Il seguente esempio di codice mostra come impostare varie proprietà dell’immagine:

//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>();
    }
};