클라우드에서 프로그래밍 방식으로 Word 문서에 쉽게 주석을 달 수 있습니다. 이미지, 댓글, 메모 또는 기타 유형의 외부 설명을 문서에 주석으로 추가할 수 있습니다. 이 기사에서는 Node.js에서 REST API를 사용하여 Word 문서에 주석을 추가하는 방법을 배웁니다.
이 문서에서는 다음 항목을 다룹니다.
- Word 문서 주석 REST API 및 Node.js SDK
- Node.js에서 REST API를 사용하여 Word 문서에 주석 달기
- Node.js에서 REST API를 사용하여 Word 문서에 이미지 주석 추가
- REST API Node.js를 사용하여 Word 문서에 텍스트 필드 주석 추가
- Node.js에서 REST API를 사용하는 Word 문서의 워터마크 주석
Word 문서 주석 REST API 및 Node.js SDK
DOC 또는 DOCX 파일에 주석을 추가하려면 GroupDocs.Annotation Cloud의 Node.js SDK API를 사용합니다. 콘솔에서 다음 명령을 사용하여 설치하십시오.
npm install groupdocs-annotation-cloud
언급된 단계를 따르기 전에 대시보드에서 클라이언트 ID와 암호를 가져오십시오. ID와 시크릿이 있으면 아래와 같이 코드를 추가합니다.
global.clientId = "659fe7da-715b-4744-a0f7-cf469a392b73";
global.clientSecret = "b377c36cfa28fa69960ebac6b6e36421";
global.myStorage = "";
const configuration = new groupdocs_annotation_cloud.Configuration(clientId, clientSecret);
configuration.apiBaseUrl = "https://api.groupdocs.cloud";
Node.js에서 REST API를 사용하여 Word 문서에 주석 달기
아래에 언급된 간단한 단계에 따라 DOCX 파일에 주석을 추가할 수 있습니다.
- 업로드 클라우드에 DOCX 파일 업로드
- Node.js의 DOCX 파일에 여러 주석 추가
- 다운로드 주석 파일
문서 업로드
먼저 아래 제공된 코드 예제를 사용하여 DOCX 파일을 클라우드에 업로드합니다.
// API 초기화
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// 로컬/디스크에서 IOStream의 파일을 엽니다.
var resourcesFolder = 'C:\\Files\\Annotation\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
// 업로드 요청 만들기
var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
// 파일 업로드
fileApi.uploadFile(request);
});
결과적으로 업로드된 DOCX 파일은 클라우드 대시보드의 파일 섹션에서 사용할 수 있습니다.
Node.js의 DOCX 파일에 여러 주석 추가
아래 단계에 따라 프로그래밍 방식으로 Word 문서에 여러 주석을 추가할 수 있습니다.
- 먼저 AnnotateApi의 인스턴스를 만듭니다.
- 다음으로 AnnotationInfo의 첫 번째 인스턴스를 만듭니다.
- 그런 다음 첫 번째 인스턴스에 대한 주석 속성(예: 위치, 유형, 텍스트 등)을 설정합니다.
- AnnotationInfo의 여러 인스턴스를 추가하려면 위의 단계를 반복합니다. 여러 주석을 추가하기 위해 인스턴스마다 다른 주석 유형 및 기타 속성을 설정합니다.
- 다음으로 FileInfo의 인스턴스를 만들고 입력 파일 경로를 설정합니다.
- 그런 다음 AnnotateOptions의 인스턴스를 만듭니다.
- 이제 FileInfo 및 정의된 주석 인스턴스를 AnnotateOptions에 할당합니다.
- 또한 출력 파일 경로를 설정합니다.
- 그런 다음 AnnotateOptions를 사용하여 AnnotateRequest 메서드를 호출합니다.
- 마지막으로 AnnotateRequest로 AnnotateApi.annotate() 메서드를 호출하여 결과를 얻습니다.
다음 코드 샘플은 Node.js에서 REST API를 사용하여 Word 문서에 여러 주석을 추가하는 방법을 보여줍니다.
// API 초기화
let annotateApi = groupdocs_annotation_cloud.주석 달기Api.fromKeys(clientId, clientSecret);
// 거리 주석 정의
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 100
a1.box.y = 100
a1.box.width = 200
a1.box.height = 100
a1.pageNumber = 0
a1.penColor = 1201033
a1.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a1.penWidth = 3
a1.opacity = 1
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Distance;
a1.text = "This is distance annotation";
a1.creatorName = "Anonym A.";
// 영역 주석 정의
let a2 = new groupdocs_annotation_cloud.AnnotationInfo();
a2.annotationPosition = new groupdocs_annotation_cloud.Point();
a2.annotationPosition.x = 1;
a2.annotationPosition.y = 1;
a2.box = new groupdocs_annotation_cloud.Rectangle();
a2.box.x = 80
a2.box.y = 400
a2.box.width = 200
a2.box.height = 100
a2.penColor = 1201033;
a2.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a2.pageNumber = 0;
a2.penWidth = 3;
a2.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Area;
a2.text = "This is area annotation";
a2.creatorName = "Anonym A.";
// 화살표 주석 정의
let a3 = new groupdocs_annotation_cloud.AnnotationInfo();
a3.annotationPosition = new groupdocs_annotation_cloud.Point();
a3.annotationPosition.x = 1;
a3.annotationPosition.y = 1;
a3.box = new groupdocs_annotation_cloud.Rectangle();
a3.box.x = 100;
a3.box.y = 100;
a3.box.width = 200;
a3.box.height = 100;
a3.pageNumber = 0;
a3.penColor = 1201033;
a3.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a3.penWidth = 1;
a3.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Arrow;
a3.text = "This is arrow annotation";
a3.creatorName = "Anonym A.";
// 타원 주석 정의
let a4 = new groupdocs_annotation_cloud.AnnotationInfo();
a4.annotationPosition = new groupdocs_annotation_cloud.Point();
a4.annotationPosition.x = 1;
a4.annotationPosition.y = 1;
a4.box = new groupdocs_annotation_cloud.Rectangle();
a4.box.x = 350;
a4.box.y = 350;
a4.box.width = 200;
a4.box.height = 100;
a4.pageNumber = 0;
a4.penColor = 1201033;
a4.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a4.penWidth = 4;
a4.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Ellipse;
a4.text = "This is ellipse annotation";
a4.creatorName = "Anonym A.";
// 입력 파일 경로
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// 주석 옵션 정의
let options = new groupdocs_annotation_cloud.주석 달기Options();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "AddMultipleAnnotations.docx";
// 주석 요청 만들기
let request = new groupdocs_annotation_cloud.주석 달기Request(options);
// 주석 달기
let result = await annotateApi.annotate(request);
Node.js의 DOCX 파일에 여러 주석 추가
주석이 달린 파일 다운로드
위의 코드 샘플은 주석이 달린 Word 문서(DOCX)를 클라우드에 저장합니다. 다음 코드 샘플을 사용하여 다운로드할 수 있습니다.
// FileApi 구성
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// 다운로드 파일 요청 생성
let request = new groupdocs_annotation_cloud.DownloadFileRequest("AddMultipleAnnotations.docx", myStorage);
// 파일 다운로드
let response = await fileApi.downloadFile(request);
// 작업 디렉토리에 파일 저장
fs.writeFile("C:\\Files\\Annotation\\AddMultipleAnnotations.docx", response, "binary", function (err) { });
Node.js에서 REST API를 사용하여 Word 문서에 이미지 주석 추가
아래 단계에 따라 프로그래밍 방식으로 Word 문서에 이미지 주석을 추가할 수 있습니다.
- 먼저 AnnotateApi의 인스턴스를 만듭니다.
- 다음으로 AnnotationInfo의 인스턴스를 만듭니다.
- 그런 다음 사각형을 정의하고 위치, 높이 및 너비를 설정합니다.
- 그런 다음 위치, 텍스트, 높이, 너비 등과 같은 주석 속성을 설정합니다.
- 그런 다음 주석 유형을 이미지로 설정합니다.
- 다음으로 FileInfo의 인스턴스를 만들고 입력 파일 경로를 설정합니다.
- 그런 다음 AnnotateOptions의 인스턴스를 만듭니다.
- 이제 FileInfo 개체와 주석을 AnnotateOptions에 할당합니다.
- 또한 출력 파일 경로를 설정합니다.
- 그런 다음 AnnotateOptions 개체를 인수로 사용하여 AnnotateRequest 메서드를 호출하여 요청을 생성합니다.
- 마지막으로 AnnotateRequest 객체로 AnnotateApi.annotate() 메서드를 호출하여 결과를 얻습니다.
다음 코드 샘플은 Node.js에서 REST API를 사용하여 Word 문서에 이미지 주석을 추가하는 방법을 보여줍니다. 앞에서 언급한 단계에 따라 파일을 업로드하고 다운로드하십시오.
// API 초기화
let annotateApi = groupdocs_annotation_cloud.주석 달기Api.fromKeys(clientId, clientSecret);
// 이미지 주석 정의
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 300;
a1.box.y = 320;
a1.box.width = 200;
a1.box.height = 40;
a1.pageNumber = 0;
a1.penColor = 1201033;
a1.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a1.penWidth = 1;
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Image;
a1.text = "This is image annotation";
a1.creatorName = "Anonym A.";
a1.imagePath = "JohnSmith.png";
// 입력 파일 경로
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// 주석 옵션 정의
let options = new groupdocs_annotation_cloud.주석 달기Options();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddImageAnnotation.docx";
// 주석 요청 만들기
let request = new groupdocs_annotation_cloud.주석 달기Request(options);
// 주석 달기
let result = await annotateApi.annotate(request);
Node.js에서 REST API를 사용하여 Word 문서에 이미지 주석 추가
Node.js에서 REST API를 사용하여 Word 문서에 텍스트 필드 주석 추가
앞에서 언급한 단계에 따라 프로그래밍 방식으로 Word 문서에 텍스트 필드 주석을 추가할 수 있습니다. 그러나 주석 유형을 TextField로 설정해야 합니다.
다음 코드 샘플은 Node.js에서 REST API를 사용하여 Word 문서에 텍스트 필드 주석을 추가하는 방법을 보여줍니다. 앞에서 언급한 단계에 따라 파일을 업로드하고 다운로드하십시오.
// API 초기화
let annotateApi = groupdocs_annotation_cloud.주석 달기Api.fromKeys(clientId, clientSecret);
// 텍스트 필드 주석 정의
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 300;
a1.box.y = 310;
a1.box.width = 200;
a1.box.height = 50;
a1.pageNumber = 0;
a1.fontColor = 3093151;
a1.fontSize = 12;
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.TextField;
a1.text = "Text field text";
a1.creatorName = "Anonym A.";
// 입력 파일 경로
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// 주석 옵션 정의
let options = new groupdocs_annotation_cloud.주석 달기Options();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddTextFieldAnnotation.docx";
// 주석 요청 만들기
let request = new groupdocs_annotation_cloud.주석 달기Request(options);
// 주석 달기
let result = await annotateApi.annotate(request);
Node.js에서 REST API를 사용하여 Word 문서에 텍스트 필드 주석 추가
Node.js에서 REST API를 사용하는 Word 문서의 워터마크 주석
앞에서 언급한 단계에 따라 프로그래밍 방식으로 Word 문서에 워터마크 주석을 추가할 수 있습니다. 그러나 주석 유형을 워터마크로 설정해야 합니다.
다음 코드 샘플은 Node.js에서 REST API를 사용하여 Word 문서에 워터마크 주석을 추가하는 방법을 보여줍니다. 앞에서 언급한 단계에 따라 파일을 업로드하고 다운로드하십시오.
// API 초기화
let annotateApi = groupdocs_annotation_cloud.주석 달기Api.fromKeys(clientId, clientSecret);
// 워터마크 주석 정의
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 100;
a1.box.y = 700;
a1.box.width = 500;
a1.box.height = 100;
a1.pageNumber = 0;
a1.penColor = 1201033;
a1.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a1.penWidth = 2;
a1.fontSize = 24;
a1.angle = 75;
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Watermark;
a1.text = "This is a watermark annotation";
a1.creatorName = "Anonym A.";
// 입력 파일 경로
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// 주석 옵션 정의
let options = new groupdocs_annotation_cloud.주석 달기Options();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddWatermarkAnnotation.docx";
// 주석 요청 만들기
let request = new groupdocs_annotation_cloud.주석 달기Request(options);
// 주석 달기
let result = await annotateApi.annotate(request);
Node.js에서 REST API를 사용하는 Word 문서의 워터마크 주석
온라인 시도
위의 API를 사용하여 개발된 다음 무료 온라인 DOCX 주석 도구를 사용해 보십시오. https://products.groupdocs.app/annotation/docx
결론
이 기사에서는 클라우드의 Word 문서에 주석을 추가하는 방법을 배웠습니다. 또한 Node.js에서 REST API를 사용하여 DOCX 파일에 이미지 및 텍스트 필드 주석을 추가하는 방법도 살펴보았습니다. 이 기사에서는 프로그래밍 방식으로 DOCX 파일을 클라우드에 업로드한 다음 클라우드에서 편집된 파일을 다운로드하는 방법도 설명했습니다. 그 외에도 문서를 사용하여 GroupDocs.Annotation Cloud API에 대해 자세히 알아볼 수 있습니다. 또한 브라우저를 통해 직접 API를 시각화하고 상호 작용할 수 있는 API 참조 섹션을 제공합니다. 모호한 점이 있으면 언제든지 포럼에 문의해 주십시오.