Mail Merge Modelo

É comum usar um modelo de mesclagem como documento base para uma operação Mail Merge se for um simples Mail Merge ou Mail Merge com regiões. Mail merge com regiões é mais poderoso e popular do que o simples mail merge. Simples Mail Merge é considerado como um caso particular de Mail Merge com regiões onde a região é o documento completo. Tudo é explicado no próximo artigo" Tipos de Mail Merge operação " em mais detalhes.

O modelo garante que o texto no documento mesclado de saída seja formatado corretamente e a operação Mail Merge garante que o texto da fonte de dados seja inserido corretamente no modelo de mesclagem.

Aspose.Words fornece a capacidade de criar um modelo Mail Merge para definir conteúdo fixo e, em seguida, gerar documentos de mesclagem usando os campos de mesclagem. Assim, o modelo de mesclagem terá o texto necessário, que é o mesmo em todos os documentos de saída, e os campos de mesclagem para preencher o conteúdo em mudança. Como resultado, as informações da fonte de dados especificada serão adicionadas ao modelo de mesclagem por meio desses campos durante a geração do documento mesclado.

O que é um modelo Mail Merge

Um modelo Mail Merge é um documento personalizado que contém os dados fixos e os campos mesclados onde você deseja que o texto da variável esteja. Um modelo de mesclagem pode estar em qualquer formato que suporte campos, por exemplo, DOC, DOCX, DOT, DOTX, RTF. Além disso, você também pode usar o modelo mustache explicado no artigo “sintaxe do ModeloMustache” em mais detalhes.

Você pode criar um modelo de mesclagem para ser um modelo para novos documentos e deve incluir o texto principal que precisa ser o mesmo para cada versão do documento mesclado. A adição de campos de mesclagem dentro do modelo representará os dados de personalização, como nomes ou endereços obtidos de uma fonte de dados. Uma operação Mail Merge irá inserir automaticamente os dados de personalização da sua fonte de dados no documento do modelo de mesclagem.

Além disso, pode adicionar uma região Mail Merge ao seu modelo inserindo dois campos Mail Merge para marcar o início e o fim da região de correio. O próximo artigo" Tipos de operação Mail Merge " explica isso com mais detalhes.

Criar um modelo Mail Merge

Você pode criar um modelo e adicionar campos de mesclagem específicos a ele, que serão substituídos pelos valores da fonte de dados manualmente, por exemplo, usando Microsoft Word ou programaticamente usando Aspose.Words. Neste artigo, veremos a maneira programática de criar um modelo.

Use a classe DocumentBuilder para criar o modelo de mesclagem necessário usando Aspose.Words. É possível incluir um texto, um campo de mesclagem e uma quebra de linha nesse modelo usando os métodos InsertTextInput, InsetField e InsertParagraph.

O exemplo de código a seguir mostra como criar um modelo Mail Merge:

A figura abaixo mostra o modelo criado:

Personalizar as propriedades de um modelo Mail Merge

Aspose.Words permite-lhe personalizar o seu modelo através de muitas propriedades. A personalização do modelo será descrita abaixo através de um exemplo de personalização de algumas propriedades de imagens e texto.

Personalizar As Propriedades Da Imagem

Você pode especificar as propriedades da imagem usando a classe ImageFieldMergingArgs. Observe que você pode inserir uma imagem de um banco de dados conforme descrito em Aspose.Words GitHub.

O exemplo de código a seguir mostra como especificar o nome do arquivo de imagem e o tamanho da imagem:

Personalizar As Propriedades Do Texto

Você pode usar a propriedade Text para inserir texto no documento para o campo de mesclagem atual. Além disso, você pode alterar a formatação de textos e parágrafos dentro do seu modelo usando as classes Font e ParagraphFormat. Você pode manipular o texto a ser inserido antes ou depois do campo de mesclagem usando as propriedades TextBefore e TextAfter incluídas na classe FieldMergeField.

O exemplo de código a seguir mostra como inserir Caixas de seleção ou HTML durante a operação Mail Merge:

Você pode baixar o arquivo de exemplo deste exemplo em Aspose.Words GitHub.

Você também pode verificar a implementação da classe HandleMergeField de Aspose.Words GitHub.

Ver Também

• Para obter mais detalhes sobre como criar modelos em Microsoft Word manualmente, verifique o Criar um modelo artigo na documentação Microsoft