
메일 병합 워드 문서 온라인
메일 병합은 수신자의 이름과 주소와 같은 특정 정보를 제외하고는 동일한 문서 세트를 생성하는 가장 쉬운 방법입니다. 많은 조직이 편지, 뉴스레터, 홍보 자료를 통해 고객/회원과 소통하며, 메일 병합을 사용하므로 이 문서에서는 C# REST API를 사용하여 Word 문서를 메일 병합하는 방법에 대한 세부 정보를 설명합니다.
메일 병합 API
Aspose.Words Cloud는 새 Word 문서를 만들고, 기존 문서를 열거나 PDF, XPS, SVG, EPUB 및 기타 다양한 형식으로 변환하는 기능을 제공합니다. API는 REST 아키텍처에 따라 개발되었으므로 언어나 플랫폼 제한에 대해 걱정할 필요가 없습니다. 이제 C# .NET 애플리케이션에서 API를 사용하려면 다음 명령을 사용하여 Aspose.Words Cloud SDK for .NET을 설치하세요.
Install-Package Aspose.Words-Cloud
설치 후에는 GitHub 또는 Google 계정을 사용하여 Aspose.Cloud 대시보드에서 무료 계정을 등록해야 하거나 간단히 가입하여 클라이언트 자격 증명을 받아야 합니다.
C#에서 메일 병합 템플릿 채우기
데이터 파일을 사용하여 메일 병합 템플릿을 채우려면 아래 단계를 따르세요.
String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get MyClientID from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get MyClientSecret from https://dashboard.aspose.cloud/
// Configuration 클래스 인스턴스를 생성하고 개인화된 클라이언트 ID 및 클라이언트 비밀번호 세부 정보를 제공합니다.
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// Configuration 인스턴스를 사용하여 WordsAPI 객체를 초기화합니다.
var wordsApi = new WordsApi(config);
// 첫 번째 입력 문서
string inputDocument = "SampleMailMergeTemplate.docx";
string inputDataFile = "SampleMailMergeTemplateData.txt";
// 결과 파일의 이름
string resultantFile = "TestPostDocumentExecuteMailMerge.docx";
// 데이터 파일의 내용을 읽다
string data = File.ReadAllText("/Downloads/" + inputDataFile, System.Text.Encoding.UTF8);
// 입력 파일, 데이터 파일 및 결과 출력 세부 정보를 제공하여 ExecuteMailMergeRequest 객체를 만듭니다.
Requests.ExecuteMailMergeRequest request = new Requests.ExecuteMailMergeRequest(inputDocument, data, null, null, null, null, null, null, null, null, resultantFile);
// 메일 병합 작업을 수행하다
DocumentResponse result = wordsApi.ExecuteMailMerge(request);
cURL 명령을 사용하여 Word에서 메일 병합
cURL 명령은 REST API에 액세스하는 편리한 방법이기도 합니다. Aspose.Words Cloud는 REST API 아키텍처를 기반으로 개발되었으므로 cURL 명령을 통해 API에 쉽게 액세스할 수 있습니다. 이제 전제 조건으로 클라이언트 ID와 클라이언트 비밀 정보를 기반으로 JWT 액세스 토큰을 생성해야 합니다.
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"
자세한 내용은 클라이언트ID와 클라이언트 비밀키를 이용하여 JWT 토큰을 얻는 방법을 참조하세요.
JWT 액세스 토큰이 있으면 다음 cURL 명령을 사용하여 메일 병합 템플릿을 채울 수 있습니다. 텍스트 파일에서 데이터를 로드합니다.
- ExecuteMailMerge API는 주요 작업을 수행합니다.
- SampleMailMergeTemplate.docx는 클라우드 저장소에서 사용할 수 있는 입력 메일 병합 템플릿입니다.
- -F 매개변수를 사용하면 SampleMailMergeTemplateData.txt 파일에서 입력 데이터를 업로드할 수 있습니다.
- destFileName 매개변수에 대해 주어진 결과 파일은 클라우드 스토리지에 저장됩니다.
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>"

이미지 1: 메일 병합 작업 후 문서 미리보기.
위 예제의 샘플 파일은 다음 링크에서 사용할 수 있습니다.
결론
이 문서에서는 C# 코드 조각을 사용하여 Word 문서에서 메일 병합을 수행하는 방법에 대한 세부 정보를 논의했습니다. 동시에 cURL 명령을 사용하여 메일 병합 단계도 알아보았습니다. SDK는 MIT 라이선스에 따라 빌드되었으므로 전체 소스 코드는 GitHub 저장소에서 다운로드할 수 있습니다. 제품 설명서를 탐색하고 API에서 지원하는 다른 흥미로운 기능에 대해 알아보는 것이 좋습니다.
관련기사
자세한 내용을 알아보려면 다음 링크를 방문해 보세요.