Tambahkan Anotasi di Dokumen Word menggunakan REST API di Node.js

Kami dapat dengan mudah membuat anotasi dokumen Word secara terprogram di cloud. Kami dapat menambahkan gambar, komentar, catatan, atau jenis komentar eksternal lainnya ke dokumen sebagai anotasi. Pada artikel ini, kita akan mempelajari cara menambahkan anotasi pada dokumen Word menggunakan REST API di Node.js.

Topik-topik berikut akan dibahas dalam artikel ini:

API REST Anotasi Dokumen Word dan SDK Node.js

Untuk menganotasi file DOC atau DOCX, kami akan menggunakan Node.js SDK dari GroupDocs.Annotation Cloud API. Silakan instal menggunakan perintah berikut di konsol:

npm install groupdocs-annotation-cloud

Harap dapatkan ID dan Rahasia Klien Anda dari dasbor sebelum mengikuti langkah-langkah yang disebutkan. Setelah Anda memiliki ID dan rahasia Anda, tambahkan kode seperti yang ditunjukkan di bawah ini:

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";

Anotasi Dokumen Word menggunakan REST API di Node.js

Kami dapat menambahkan anotasi ke file DOCX dengan mengikuti langkah-langkah sederhana yang disebutkan di bawah ini:

Unggah Dokumen

Pertama, kami akan mengunggah file DOCX ke Cloud menggunakan contoh kode di bawah ini:

// Inisialisasi API
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// Buka file di IOStream dari local/disc.
var resourcesFolder = 'C:\\Files\\Annotation\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // Buat permintaan unggah
  var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  // Unggah data
  fileApi.uploadFile(request);
});

Akibatnya, file DOCX yang diunggah akan tersedia di bagian file dasbor di cloud.

Tambahkan Banyak Anotasi ke File DOCX di Node.js

Kami dapat menambahkan beberapa anotasi ke dokumen Word secara terprogram dengan mengikuti langkah-langkah di bawah ini:

  • Pertama, buat instance dari AnnotateApi.
  • Selanjutnya, buat instance pertama dari AnnotationInfo.
  • Kemudian, setel properti anotasi untuk contoh pertama misalnya, posisi, jenis, teks, dll.
  • Ulangi langkah di atas untuk menambahkan beberapa contoh AnnotationInfo. Kami akan menetapkan jenis anotasi yang berbeda dan properti lainnya untuk setiap instance untuk menambahkan beberapa anotasi.
  • Selanjutnya, buat instance FileInfo dan atur jalur file input.
  • Kemudian, buat instance dari AnnotateOptions.
  • Sekarang, tetapkan FileInfo dan instance anotasi yang ditentukan ke AnnotateOptions.
  • Juga, atur jalur file keluaran.
  • Setelah itu, panggil metode AnnotateRequest dengan AnnotateOptions.
  • Terakhir, dapatkan hasil dengan memanggil metode AnnotateApi.annotate() dengan AnnotateRequest.

Contoh kode berikut menunjukkan cara menambahkan beberapa anotasi ke dokumen Word menggunakan REST API di Node.js.

// Inisialisasi API
let annotateApi = groupdocs_annotation_cloud.Membubuhi keteranganApi.fromKeys(clientId, clientSecret);

// Tentukan anotasi Jarak
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.";

// Tentukan anotasi Area
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.";

// Tentukan anotasi Panah
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.";

// Tentukan anotasi Ellipse
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.";

// Jalur file masukan
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Tentukan opsi anotasi
let options = new groupdocs_annotation_cloud.Membubuhi keteranganOptions();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "AddMultipleAnnotations.docx";

// Buat permintaan anotasi
let request = new groupdocs_annotation_cloud.Membubuhi keteranganRequest(options);

// Membubuhi keterangan
let result = await annotateApi.annotate(request);
Tambahkan Banyak Anotasi ke File DOCX di Node.js

Tambahkan Banyak Anotasi ke File DOCX di Node.js

Unduh File Beranotasi

Contoh kode di atas akan menyimpan dokumen Word beranotasi (DOCX) di cloud. Itu dapat diunduh menggunakan contoh kode berikut:

// Membangun FileApi
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);

// Buat permintaan file unduhan
let request = new groupdocs_annotation_cloud.DownloadFileRequest("AddMultipleAnnotations.docx", myStorage);
// Unduh berkas
let response = await fileApi.downloadFile(request);

// Simpan file di direktori kerja
fs.writeFile("C:\\Files\\Annotation\\AddMultipleAnnotations.docx", response, "binary", function (err) { });

Tambahkan Anotasi Gambar di Dokumen Word menggunakan REST API di Node.js

Kami dapat menambahkan anotasi gambar dalam dokumen Word secara terprogram dengan mengikuti langkah-langkah berikut:

  • Pertama, buat instance dari AnnotateApi.
  • Selanjutnya, buat instance dari AnnotationInfo.
  • Kemudian, tentukan persegi panjang dan atur posisi, tinggi, dan lebarnya.
  • Setelah itu, atur properti anotasi misalnya, posisi, teks, tinggi, lebar, dll.
  • Kemudian, atur jenis anotasi sebagai Gambar.
  • Selanjutnya, buat instance FileInfo dan atur jalur file input.
  • Kemudian, buat instance dari AnnotateOptions.
  • Sekarang, tetapkan objek FileInfo dan anotasi ke AnnotateOptions.
  • Juga, atur jalur file keluaran.
  • Setelah itu, buat permintaan dengan memanggil metode AnnotateRequest dengan objek AnnotateOptions sebagai argumen.
  • Terakhir, dapatkan hasil dengan memanggil metode AnnotateApi.annotate() dengan objek AnnotateRequest.

Contoh kode berikut menunjukkan cara menambahkan anotasi gambar ke dokumen Word menggunakan REST API di Node.js. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah dan mengunduh file.

// Inisialisasi API
let annotateApi = groupdocs_annotation_cloud.Membubuhi keteranganApi.fromKeys(clientId, clientSecret);

// Tentukan anotasi gambar
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";

// Jalur file masukan
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Tentukan opsi Anotasi
let options = new groupdocs_annotation_cloud.Membubuhi keteranganOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddImageAnnotation.docx";

// Buat permintaan anotasi
let request = new groupdocs_annotation_cloud.Membubuhi keteranganRequest(options);

// Membubuhi keterangan
let result = await annotateApi.annotate(request);
Tambahkan Anotasi Gambar di Dokumen Word menggunakan REST API di Node.js

Tambahkan Anotasi Gambar di Dokumen Word menggunakan REST API di Node.js

Tambahkan Anotasi Bidang Teks dalam Dokumen Word menggunakan REST API di Node.js

Kita dapat menambahkan anotasi bidang teks dalam dokumen Word secara terprogram dengan mengikuti langkah-langkah yang disebutkan sebelumnya. Namun, kita perlu menyetel jenis anotasi sebagai TextField.

Contoh kode berikut menunjukkan cara menambahkan anotasi kolom teks ke dokumen Word menggunakan REST API di Node.js. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah dan mengunduh file.

// Inisialisasi API
let annotateApi = groupdocs_annotation_cloud.Membubuhi keteranganApi.fromKeys(clientId, clientSecret);

// Tentukan anotasi bidang teks
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.";

// Jalur file masukan
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Tentukan opsi Anotasi
let options = new groupdocs_annotation_cloud.Membubuhi keteranganOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddTextFieldAnnotation.docx";

// Buat permintaan anotasi
let request = new groupdocs_annotation_cloud.Membubuhi keteranganRequest(options);

// Membubuhi keterangan
let result = await annotateApi.annotate(request);
Tambahkan Anotasi di Dokumen Word menggunakan REST API di Node.js

Tambahkan Anotasi Bidang Teks dalam Dokumen Word menggunakan REST API di Node.js

Anotasi Tanda Air dalam Dokumen Word menggunakan REST API di Node.js

Kita dapat menambahkan anotasi watermark pada dokumen Word secara terprogram dengan mengikuti langkah-langkah yang disebutkan sebelumnya. Namun, kita perlu menyetel jenis anotasi sebagai Watermark.

Contoh kode berikut menunjukkan cara menambahkan anotasi watermark ke dokumen Word menggunakan REST API di Node.js. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah dan mengunduh file.

// Inisialisasi API
let annotateApi = groupdocs_annotation_cloud.Membubuhi keteranganApi.fromKeys(clientId, clientSecret);

// Tentukan anotasi tanda air
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.";

// Jalur file masukan
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Tentukan opsi Anotasi
let options = new groupdocs_annotation_cloud.Membubuhi keteranganOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddWatermarkAnnotation.docx";

// Buat permintaan anotasi
let request = new groupdocs_annotation_cloud.Membubuhi keteranganRequest(options);

// Membubuhi keterangan
let result = await annotateApi.annotate(request);
Anotasi Tanda Air dalam Dokumen Word menggunakan REST API di Node.js

Anotasi Tanda Air dalam Dokumen Word menggunakan REST API di Node.js

Coba Daring

Silakan coba alat anotasi DOCX online gratis berikut, yang dikembangkan menggunakan API di atas. https://products.groupdocs.app/annotation/docx

Kesimpulan

Pada artikel ini, kami telah mempelajari cara menambahkan anotasi ke dokumen Word di cloud. Kami juga telah melihat cara menambahkan anotasi bidang gambar dan teks ke file DOCX menggunakan REST API di Node.js. Artikel ini juga menjelaskan cara mengunggah file DOCX ke cloud secara terprogram dan kemudian mengunduh file yang diedit dari Cloud. Selain itu, Anda dapat mempelajari lebih lanjut tentang GroupDocs.Annotation Cloud API menggunakan dokumentasi. Kami juga menyediakan bagian Referensi API yang memungkinkan Anda memvisualisasikan dan berinteraksi dengan API kami secara langsung melalui browser. Jika ada ambiguitas, jangan ragu untuk menghubungi kami di forum.

Lihat juga