Documento Word de mala direta

Documento do Word de mala direta online

A Mala Direta é a maneira mais fácil de gerar um conjunto de documentos que são idênticos, exceto por certas informações, como nome e endereço do destinatário. Muitas organizações se comunicam com seus clientes/membros por meio de cartas, boletins informativos e peças promocionais usando mala direta, então neste artigo, vamos discutir os detalhes sobre como fazer Mala Direta de documentos do Word usando a API REST do C#.

API de mala direta

O Aspose.Words Cloud oferece os recursos para criar um novo documento do Word, abrir um documento existente ou convertê-lo para PDF, XPS, SVG, EPUB e vários outros formatos. Como nossa API é desenvolvida de acordo com a arquitetura REST, você não precisa se preocupar com limitações de linguagem ou plataforma. Agora, para usar a API no aplicativo C# .NET, instale o Aspose.Words Cloud SDK para .NET usando o seguinte comando:

 Install-Package Aspose.Words-Cloud

Após a instalação, precisamos registrar uma conta gratuita no painel do Aspose.Cloud usando o GitHub ou a conta do Google ou simplesmente se inscrever e obter suas credenciais de cliente.

Preencher modelo de mala direta em C#

Siga as etapas abaixo para preencher o modelo de mala direta usando um arquivo de dados.

String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get MyClientID from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get MyClientSecret from https://dashboard.aspose.cloud/

// crie uma instância da classe Configuration e forneça seus detalhes personalizados de ID do cliente e segredo do cliente
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// inicializar objeto WordsAPI usando instância de configuração
var wordsApi = new WordsApi(config);
// primeiro documento de entrada
string inputDocument = "SampleMailMergeTemplate.docx";
string inputDataFile = "SampleMailMergeTemplateData.txt";
// nome do arquivo resultante
string resultantFile = "TestPostDocumentExecuteMailMerge.docx";
// leia o conteúdo do arquivo de dados
string data = File.ReadAllText("/Downloads/" + inputDataFile, System.Text.Encoding.UTF8);
// Crie o objeto ExecuteMailMergeRequest fornecendo o arquivo de entrada, o arquivo de dados e os detalhes da saída resultante
Requests.ExecuteMailMergeRequest request = new Requests.ExecuteMailMergeRequest(inputDocument, data, null, null, null, null, null, null, null, null, resultantFile);
// executar a operação de mala direta
DocumentResponse result = wordsApi.ExecuteMailMerge(request);

Mala direta Word usando comando cURL

Os comandos cURL também são uma maneira conveniente de acessar APIs REST. Como o Aspose.Words Cloud é desenvolvido sobre a arquitetura REST API, podemos acessar facilmente as APIs por meio dos comandos cURL. Agora, como pré-requisito, precisamos gerar um token de acesso JWT com base nos detalhes do Client ID e do Client Secret.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Para mais detalhes, visite Como obter um token JWT usando um ID de cliente e uma chave secreta de cliente.

Assim que tivermos o token de acesso JWT, podemos usar o seguinte comando cURL para preencher o modelo Mail Merge. Carregamos os dados de um arquivo de texto.

  • A API ExecuteMailMerge executa a operação principal.
  • SampleMailMergeTemplate.docx é o modelo de mala direta de entrada disponível no armazenamento em nuvem.
  • Usamos o parâmetro -F para carregar dados de entrada do arquivo SampleMailMergeTemplateData.txt.
  • O arquivo resultante fornecido em relação ao parâmetro destFileName será armazenado no armazenamento em nuvem.
curl -v "https://api.aspose.cloud/v4.0/words/SampleMailMergeTemplate.docx/MailMerge?withRegions=false&destFileName=TestPostDocumentExecuteMailMerge.docx" \
-X PUT  \
-F data=@/Downloads/SampleMailMergeTemplateData.txt \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"
Visualização de mala direta

Imagem 1:- Visualização do documento após uma operação de mala direta.

Os arquivos de amostra do exemplo acima estão disponíveis nos seguintes links

Conclusão

Neste artigo, discutimos os detalhes sobre como executar a mala direta em documentos do Word usando um snippet de código C#. Ao mesmo tempo, também aprendemos as etapas da mala direta usando comandos cURL. Observe que nosso SDK é criado de acordo com a licença MIT, portanto, seu código-fonte completo está disponível para download no repositório GitHub. Sugerimos que você explore a Documentação do produto e aprenda sobre outros recursos interessantes suportados pela API.

Artigos relacionados

Recomendamos também que você visite os seguintes links para saber mais sobre: