Node.js'de bir REST API kullanarak Word Belgelerine Ek Açıklamalar ekleyin

Word belgelerine programlı olarak bulutta kolayca açıklama ekleyebiliriz. Belgelere açıklamalar olarak resimler, yorumlar, notlar veya diğer türde harici açıklamalar ekleyebiliriz. Bu yazımızda, Node.js’de bir REST API kullanarak Word belgelerine açıklama eklemeyi öğreneceğiz.

Bu yazıda aşağıdaki konular ele alınacaktır:

Word Belgesi Açıklama REST API’si ve Node.js SDK’sı

DOC veya DOCX dosyalarına açıklama eklemek için GroupDocs.Annotation Cloud]3 API’sinin [Node.js SDK’sını] kullanacağız. Lütfen konsolda aşağıdaki komutu kullanarak kurun:

npm install groupdocs-annotation-cloud

Belirtilen adımları izlemeden önce lütfen panodan Müşteri Kimliğinizi ve Sırrınızı alın. Kimliğinizi ve sırrınızı aldıktan sonra, kodu aşağıda gösterildiği gibi ekleyin:

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’de REST API kullanarak Word Belgelerine Açıklama Ekleyin

Aşağıda belirtilen basit adımları izleyerek DOCX dosyalarına ek açıklamalar ekleyebiliriz:

Belgeyi Yükle

Öncelikle aşağıda verilen kod örneğini kullanarak DOCX dosyasını Buluta yükleyeceğiz:

// API'yi başlat
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// Dosyayı IOStream'de yerel/diskten açın.
var resourcesFolder = 'C:\\Files\\Annotation\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // Yükleme isteği oluştur
  var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  // Dosya yükleme
  fileApi.uploadFile(request);
});

Sonuç olarak, yüklenen DOCX dosyası, bulut üzerindeki kontrol panelinin dosyalar bölümünde mevcut olacaktır.

Node.js’de DOCX Dosyalarına Birden Çok Ek Açıklama Ekleme

Aşağıda verilen adımları izleyerek programlı olarak Word belgelerine birden çok ek açıklama ekleyebiliriz:

  • İlk olarak, AnnotateApi’nin bir örneğini oluşturun.
  • Ardından, AnnotationInfo’nun ilk örneğini oluşturun.
  • Ardından, ilk örnek için konum, tür, metin vb. gibi ek açıklama özelliklerini ayarlayın.
  • AnnotationInfo’nun birden çok örneğini eklemek için yukarıdaki adımları tekrarlayın. Birden çok ek açıklama eklemek için her örnek için farklı açıklama türleri ve diğer özellikler ayarlayacağız.
  • Ardından, bir FileInfo örneği oluşturun ve giriş dosyası yolunu ayarlayın.
  • Ardından, AnnotateOptions’ın bir örneğini oluşturun.
  • Şimdi, FileInfo’yu ve tanımlı ek açıklama örneklerini AnnotateOptions’a atayın.
  • Ayrıca çıktı dosyası yolunu ayarlayın.
  • Bundan sonra, AnnotateOptions ile AnnotateRequest yöntemini çağırın.
  • Son olarak, AnnotateRequest ile AnnotateApi.annotate() yöntemini çağırarak sonuçları alın.

Aşağıdaki kod örneği, Node.js’de bir REST API kullanarak bir Word belgesine birden çok ek açıklamanın nasıl ekleneceğini gösterir.

// API'yi başlat
let annotateApi = groupdocs_annotation_cloud.Açıklama ekleApi.fromKeys(clientId, clientSecret);

// Mesafe ek açıklamasını tanımla
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.";

// Alan ek açıklamasını tanımla
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.";

// Ok açıklamasını tanımla
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.";

// Elips açıklamasını tanımla
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.";

// Giriş dosyası yolu
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Açıklama seçeneklerini tanımlayın
let options = new groupdocs_annotation_cloud.Açıklama ekleOptions();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "AddMultipleAnnotations.docx";

// Açıklama isteği oluştur
let request = new groupdocs_annotation_cloud.Açıklama ekleRequest(options);

// Açıklama ekle
let result = await annotateApi.annotate(request);
Node.js'de DOCX Dosyalarına Birden Çok Ek Açıklama Ekleme

Node.js’de DOCX Dosyalarına Birden Çok Ek Açıklama Ekleme

Açıklamalı Dosyayı İndirin

Yukarıdaki kod örneği, açıklamalı Word belgesini (DOCX) buluta kaydedecektir. Aşağıdaki kod örneği kullanılarak indirilebilir:

// FileApi'yi Oluştur
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);

// İndirme dosyası isteği oluştur
let request = new groupdocs_annotation_cloud.DownloadFileRequest("AddMultipleAnnotations.docx", myStorage);
// Dosyayı indir
let response = await fileApi.downloadFile(request);

// Dosyayı çalışma dizinine kaydet
fs.writeFile("C:\\Files\\Annotation\\AddMultipleAnnotations.docx", response, "binary", function (err) { });

Node.js’de REST API kullanarak Word Belgelerine Görüntü Açıklamaları Ekleyin

Aşağıda verilen adımları izleyerek programlı olarak Word belgelerine resim ek açıklamaları ekleyebiliriz:

  • İlk olarak, AnnotateApi’nin bir örneğini oluşturun.
  • Ardından, AnnotationInfo’nun bir örneğini oluşturun.
  • Ardından, bir dikdörtgen tanımlayın ve konumunu, yüksekliğini ve genişliğini ayarlayın.
  • Bundan sonra, konum, metin, yükseklik, genişlik vb. gibi ek açıklama özelliklerini ayarlayın.
  • Ardından, ek açıklama türünü Görüntü olarak ayarlayın.
  • Ardından, bir FileInfo örneği oluşturun ve giriş dosyası yolunu ayarlayın.
  • Ardından, AnnotateOptions’ın bir örneğini oluşturun.
  • Şimdi, FileInfo nesnesini ve açıklamayı AnnotateOptions’a atayın.
  • Ayrıca çıktı dosyası yolunu ayarlayın.
  • Bundan sonra, argüman olarak AnnotateOptions nesnesi ile AnnotateRequest yöntemini çağırarak bir istek oluşturun.
  • Son olarak, AnnotateRequest nesnesi ile AnnotateApi.annotate() yöntemini çağırarak sonuçları alın.

Aşağıdaki kod örneği, Node.js’de bir REST API kullanarak bir Word belgesine resim ek açıklamasının nasıl ekleneceğini gösterir. Dosya yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.

// API'yi başlat
let annotateApi = groupdocs_annotation_cloud.Açıklama ekleApi.fromKeys(clientId, clientSecret);

// Görüntü ek açıklamasını tanımlayın
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";

// Giriş dosyası yolu
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Açıklama seçeneklerini tanımlayın
let options = new groupdocs_annotation_cloud.Açıklama ekleOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddImageAnnotation.docx";

// Açıklama isteği oluştur
let request = new groupdocs_annotation_cloud.Açıklama ekleRequest(options);

// Açıklama ekle
let result = await annotateApi.annotate(request);
Node.js'de REST API kullanarak Word Belgelerine Görüntü Ek Açıklamaları ekleyin

Node.js’de REST API kullanarak Word Belgelerine Görüntü Ek Açıklamaları ekleyin

Node.js’de REST API kullanarak Word Belgelerine Metin Alanı Ek Açıklamaları ekleyin

Daha önce bahsedilen adımları izleyerek programlı olarak Word belgelerine metin alanı ek açıklamaları ekleyebiliriz. Ancak ek açıklama türünü TextField olarak ayarlamamız gerekiyor.

Aşağıdaki kod örneği, Node.js’de REST API kullanarak bir Word belgesine metin alanı notunun nasıl ekleneceğini gösterir. Dosya yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.

// API'yi başlat
let annotateApi = groupdocs_annotation_cloud.Açıklama ekleApi.fromKeys(clientId, clientSecret);

// Metin alanı açıklamasını tanımla
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.";

// Giriş dosyası yolu
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Açıklama seçeneklerini tanımlayın
let options = new groupdocs_annotation_cloud.Açıklama ekleOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddTextFieldAnnotation.docx";

// Açıklama isteği oluştur
let request = new groupdocs_annotation_cloud.Açıklama ekleRequest(options);

// Açıklama ekle
let result = await annotateApi.annotate(request);
Node.js'de REST API kullanarak Word Belgelerine Ek Açıklamalar Ekleyin

Node.js’de REST API kullanarak Word Belgelerine Metin Alanı Ek Açıklamaları ekleyin

Node.js’de REST API kullanan Word Belgelerinde Filigran Ek Açıklamaları

Daha önce bahsedilen adımları izleyerek programlı olarak Word belgelerine filigran ek açıklamaları ekleyebiliriz. Ancak ek açıklama türünü Watermark olarak belirlememiz gerekiyor.

Aşağıdaki kod örneği, Node.js’de REST API kullanarak bir Word belgesine filigran notunun nasıl ekleneceğini gösterir. Dosya yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.

// API'yi başlat
let annotateApi = groupdocs_annotation_cloud.Açıklama ekleApi.fromKeys(clientId, clientSecret);

// Filigran açıklamasını tanımla
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.";

// Giriş dosyası yolu
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Açıklama seçeneklerini tanımlayın
let options = new groupdocs_annotation_cloud.Açıklama ekleOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddWatermarkAnnotation.docx";

// Açıklama isteği oluştur
let request = new groupdocs_annotation_cloud.Açıklama ekleRequest(options);

// Açıklama ekle
let result = await annotateApi.annotate(request);
Node.js'de REST API kullanan Word Belgelerinde Filigran Ek Açıklamaları

Node.js’de REST API kullanan Word Belgelerinde Filigran Ek Açıklamaları

Çevrimiçi Deneyin

Lütfen yukarıdaki API kullanılarak geliştirilen aşağıdaki ücretsiz çevrimiçi DOCX ek açıklama aracını deneyin. https://products.groupdocs.app/annotation/docx

Çözüm

Bu yazımızda, bulut üzerinde Word belgelerine açıklama eklemeyi öğrendik. Node.js’de bir REST API kullanarak DOCX dosyasına resim ve metin alanı ek açıklamalarının nasıl ekleneceğini de gördük. Bu makalede ayrıca bir DOCX dosyasının programlı olarak buluta nasıl yükleneceği ve ardından düzenlenen dosyanın Buluttan nasıl indirileceği açıklanmaktadır. Ayrıca belgeleri kullanarak GroupDocs.Annotation Cloud API hakkında daha fazla bilgi edinebilirsiniz. Ayrıca, doğrudan tarayıcı aracılığıyla API’lerimizi görselleştirmenize ve bunlarla etkileşimde bulunmanıza olanak tanıyan bir API Referansı bölümü de sağlıyoruz. Herhangi bir belirsizlik durumunda, lütfen forumda bizimle iletişime geçmekten çekinmeyin.

Ayrıca bakınız