Insertar Checkbox es, Entrada de texto o Imágenes

El motor de combinación toma un documento como entrada, busca los campos MERGEFIELD en él y los reemplaza con los datos obtenidos del origen de datos. Normalmente, se insertan texto sin formato y HTML, pero Aspose.Words los usuarios también pueden generar un documento que maneje escenarios más inusuales para Mail Merge campos.

La potente funcionalidad Aspose.Words le permite extender el proceso mail merge:

• inserte casillas de verificación y campos de formulario de entrada de texto en el documento durante un mail merge
• inserte imágenes desde cualquier almacenamiento personalizado (archivos, campos BLOB, etc.)

Inserte Checkbox es y entrada de texto durante Mail Merge

A veces es necesario realizar una operación Mail Merge para que no se sustituya texto en el campo de combinación, sino una casilla de verificación o un campo de entrada de texto. Aunque este no es el escenario más común, es muy útil para algunas tareas.

La siguiente captura de pantalla de un documento de Word muestra una plantilla con campos de combinación:

Esta captura de pantalla del documento de Word a continuación muestra el documento ya generado:

Tenga en cuenta que algunos campos se reemplazaron con texto sin formato, algunos campos se reemplazaron con campos de formulario de casilla de verificación y el campo Subject se reemplazó con un campo de entrada de texto.

El siguiente ejemplo de código muestra cómo insertar casillas de verificación e ingresar campos de texto en 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));
    }
};

Insertar imágenes durante Mail Merge

Al realizar una operación mail merge, puede insertar imágenes de la base de datos en el documento utilizando campos especiales de image mail merge. El campo image Mail Merge es un campo de combinación denominado Image:MyFieldName.

Insertar imágenes desde una base de datos

Durante un mail merge, cuando se encuentra un campo image Mail Merge en un documento, se activa el evento FieldMergingCallback. Puede responder a este evento para devolver un nombre de archivo, secuencia u objeto de imagen al motor Mail Merge para que pueda insertarse en el documento.

El siguiente ejemplo de código muestra cómo insertar imágenes almacenadas en un campo BLOB de la base de datos en un informe:

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

Establecer Propiedades de imagen durante Mail Merge

Al combinar un campo de combinación de imágenes, a veces es posible que deba controlar varias propiedades de la imagen, como WrapType.

Actualmente, al usar ImageFieldMergingArgs solo puede establecer las propiedades de ancho o alto de la imagen, respectivamente. Para superar este problema, Aspose.Words proporciona la propiedad Shape, que facilita obtener un control total sobre la imagen insertada o cualquier otra forma.

El siguiente ejemplo de código muestra cómo establecer varias propiedades de imagen:

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