Limpeza antes ou durante um Mail Merge Operação

Aspose.Words permite que você aplique diferentes opções de limpeza e remoção, como excluir campos de mesclagem antes de executar um Mail Merge operação ou remoção de regiões não utilizadas durante um Mail Merge operação. Esta seção explicará como excluir campos mesclados e como configurar uma opção de remoção.

Excluir Campos Mesclados

Quando estiver a utilizar um modelo longo criado por outra pessoa, poderá querer eliminar todos os campos de mesclagem que já existem nesse modelo antes de executar um Mail Merge operação. Você pode usar o DeleteFields método se você deseja excluir todos os campos de mesclagem de um documento sem executar um Mail Merge operação. Este método não é afectado por quaisquer opções de remoção do CleanupOptions propriedade e executá-lo apenas remove campos mesclados, Não quaisquer campos contendo ou parágrafos vazios.

O exemplo de código a seguir mostra como excluir todos os campos de mesclagem do modelo sem executar um Mail Merge operação:

Criação de um Removing Opção

Aspose.Words permite remover campos, regiões e parágrafos não misturados de um modelo durante um Mail Merge operação usando opções de remoção.

Use o CleanupOptions propriedade juntamente com o MailMergeCleanupOptions enumeração para definir a opção de remoção. Especifique quais itens você deseja remover escolhendo as seguintes opções (você pode combinar mais de um):

• Remover parágrafos vazios
• Remover regiões não utilizadas
• Remover campos não utilizados
• Remover os campos que contêm
• Remover campos estáticos
• Remover linhas vazias da tabela

É possível considerar um campo de mesclagem como não mesclado em uma das seguintes condições:

1. Se o campo de mesclagem na fonte de dados não tiver uma coluna ou um campo de mapeamento.
2. Se o campo de mesclagem na fonte de dados contiver um campo de mapeamento, mas os dados forem nulos.

Se você estiver mesclando dados usando fontes de dados separadas, essas opções de remoção serão ativadas apenas com a última chamada do Mail Merge método de execução.

Remover Parágrafos Vazios

Um parágrafo que inclua apenas campos de mesclagem estará vazio quando o Mail Merge process remove todos os seus campos de mesclagem como não mesclados. Esses parágrafos vazios podem adicionar espaço indesejado e alterar a aparência do relatório gerado. Você pode enfrentar duas situações com parágrafos durante um Mail Merge operação:

1. O Mail Merge campo será mesclado com os dados vazio.
2. O campo de mesclagem não é utilizado e será removido.

Em ambas as situações, o RemoveEmptyParagraphs a opção removerá automaticamente parágrafos vazios do documento. Além disso, removerá o TableStart e TableEnd mesclar campos se o restante do parágrafo estiver vazio.

O exemplo de código a seguir mostra como remover os parágrafos vazios:

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

Remover Campos Não Utilizados

Aspose.Words permite que você remova qualquer não utilizado Mail Merge campos atribuindo o RemoveUnusedFields bandeira para CleanupOptions. Esta opção removerá os campos de mesclagem que não possuem os dados correspondentes na fonte de dados.

O exemplo de código a seguir mostra como remover quaisquer campos de mesclagem não utilizados de um documento automaticamente Mail Merge operação:

Removendo Os Campos Que Contêm

Um campo de mesclagem pode estar contido em outro campo, como um IF campo ou um campo de Fórmula. Remova este campo externo quando o campo de mesclagem for mesclado ou removido do documento.

O exemplo de código a seguir mostra como remover campos que contêm campos de mesclagem de um documento:

Nota

Remover Linhas Vazias Da Tabela

Aspose.Words permite remover linhas de tabela vazias atribuindo o RemoveEmptyTableRows bandeira para CleanupOptions. Esta opção removerá as linhas da tabela que contêm campos de mesclagem vazios.

O exemplo de código a seguir mostra como remover linhas de tabela vazias que contêm Mail Merge regiões de um documento: