Bir Node.js geliştiricisi olarak, bulutta programlı olarak PDF belgelerinizden herhangi birine kolayca açıklama ekleyebilirsiniz. Belgeye açıklamalar olarak resimler, yorumlar, notlar veya diğer türde harici açıklamalar ekleyebilirsiniz. Bu makalede, Node.js’de bir REST API kullanarak PDF belgelerine açıklama eklemeyi öğreneceksiniz.
Bu yazıda aşağıdaki konular ele alınacaktır:
- Document Annotation REST API ve Node.js SDK
- Node.js’de REST API kullanarak PDF Belgelerine Açıklama Ekleyin
- Node.js kullanarak Görüntü Ek Açıklamaları ekleyin
Document Annotation REST API ve Node.js SDK
PDF belgelerine açıklama eklemek için GroupDocs.Annotation Cloud]2 API’sinin [Node.js SDK’sını] kullanacağım. Belge ek açıklama araçlarını çevrimiçi olarak programlı olarak oluşturmanıza olanak tanır. Desteklenen belge biçimlerine açıklamalar, filigran kaplamaları, metin değiştirmeleri, düzeltmeler ve metin işaretlemeleri ekleyebilirsiniz. Ayrıca Cloud API için document annotation family üyeleri olarak .NET, Java, PHP, Ruby ve Python SDK’ları sağlar.
Konsolda aşağıdaki komutu kullanarak GroupDocs.Annotation Cloud’u Node.js uygulamanıza yükleyebilirsiniz:
npm install groupdocs-annotation-cloud
Lütfen adımları ve mevcut kod örneklerini izlemeye başlamadan önce gösterge tablosundan İstemci Kimliğinizi ve İstemci 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"; // Get ClientId and ClientSecret from https://dashboard.groupdocs.cloud
global.clientSecret = "b377c36cfa28fa69960ebac6b6e36421"; // Get ClientId and ClientSecret from https://dashboard.groupdocs.cloud
global.myStorage = "";
const configuration = new groupdocs_annotation_cloud.Configuration(clientId, clientSecret);
configuration.apiBaseUrl = "https://api.groupdocs.cloud";
Node.js’de REST API kullanarak PDF Belgelerine Açıklama Ekleyin
Aşağıda verilen basit adımları izleyerek PDF belgelerinize bulutta açıklama ekleyebilirsiniz:
- PDF dosyasını Buluta Yükle
- Node.js kullanarak PDF Belgesine Açıklama Ekleyin
- Açıklamalı dosyayı İndir
Belgeyi Yükle
Öncelikle, aşağıdaki kod örneğini kullanarak PDF dosyasını Bulut’a yükleyin:
// api'yi başlat
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// Dosyayı IOStream'de yerel/diskten açın.
var resourcesFolder = 'C:\\Files\\sample.pdf';
// dosyayı oku
fs.readFile(resourcesFolder, (err, fileStream) => {
// dosya yükleme isteği oluştur
var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", fileStream, myStorage);
// dosya yükleme
fileApi.uploadFile(request)
});
Sonuç olarak, yüklenen PDF dosyası, bulut üzerindeki kontrol panelinizin dosyalar bölümünde mevcut olacaktır.
Node.js kullanarak PDF Belgesine Açıklama Ekleyin
Aşağıda belirtilen adımları izleyerek PDF belgesine programlı olarak birden fazla ek açıklama ekleyebilirsiniz:
- AnnotateApi’nin bir örneğini oluşturun
- AnnotationInfo’nun ilk örneğini oluşturun
- İlk örnek için ek açıklama özelliklerini ayarlayın, örneğin konum, tür, metin vb.
- AnnotationInfo’nun ikinci örneğini oluşturun
- İkinci örnek için ek açıklama özelliklerini ayarlayın, örneğin konum, tip, metin vb.
- AnnotationInfo’nun üçüncü örneğini oluşturun
- Üçüncü örnek için ek açıklama özelliklerini ayarlayın, örneğin konum, tür, metin vb.
- AnnotationInfo’nun dördüncü örneğini oluşturun
- Dördüncü örnek için ek açıklama özelliklerini ayarlayın, örneğin konum, tür, metin vb.
- Bir FileInfo örneği oluşturun ve giriş dosyası yolunu ayarlayın
- AnnotateOptions örneğini oluşturun
- FileInfo’yu ve tanımlanmış ek açıklama örneklerini AnnotateOptions’a atayın
- Çıktı dosyası yolunu ayarla
- AnnotateOptions ile AnnotateRequest yöntemini çağırarak bir istek oluşturun
- 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 PDF belgesine birden çok ek açıklamayla nasıl açıklama ekleneceğini gösterir.
// api'yi başlat
let açıklama eklemekApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);
// mesafe notu
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 mesafe notu";
a1.creatorName = "Anonym A.";
// alan notu
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 alan notu";
a2.creatorName = "Anonym A.";
// metin alanı notu
let a3 = new groupdocs_annotation_cloud.AnnotationInfo();
a3.annotationPosition = new groupdocs_annotation_cloud.Point();
a3.annotationPosition.x = 100;
a3.annotationPosition.y = 100;
a3.box = new groupdocs_annotation_cloud.Rectangle();
a3.box.x = 450
a3.box.y = 150
a3.box.width = 100
a3.box.height = 30
a3.pageNumber = 0;
a3.fontColor = 65535;
a3.fontSize = 16;
a3.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.TextField;
a3.text = "Text field text";
a3.creatorName = "Anonym A.";
// elips açıklaması
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 elips açıklaması";
a4.creatorName = "Anonym A.";
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
let options = new groupdocs_annotation_cloud.AnnotateOptions();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "Output/output.pdf";
// ek açıklama isteği oluştur
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// açıklama eklemek
let result = await açıklama eklemekApi.açıklama eklemek(request);
console.log("Multiple Annotations added: " + result.href);
Node.js’de REST API kullanarak PDF Belgelerine Açıklama Ekleyin
Belgelerdeki ek açıklama ekleme bölümünde desteklenen ek açıklama türleri hakkında daha fazla bilgi edinebilirsiniz.
Açıklamalı Dosyayı İndirin
Yukarıdaki kod örneği, açıklamalı PDF dosyasını buluta kaydedecektir. Aşağıdaki kod örneğini kullanarak indirebilirsiniz:
// FileApi'yi inşa et
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// indirme dosyası isteği oluştur
let request = new groupdocs_annotation_cloud.DownloadFileRequest("Output/output.pdf", myStorage);
// dosyayı indir
let response = await fileApi.downloadFile(request);
// dosyayı çalışma dizinine kaydet
fs.writeFile("C:\\Files\\output.pdf", response, "binary", function (err) { });
console.log(response);
Node.js kullanarak Görüntü Ek Açıklamaları ekleyin
Aşağıda verilen adımları izleyerek programlı olarak PDF belgelerinize görüntü ek açıklamaları ekleyebilirsiniz:
- AnnotateApi’nin bir örneğini oluşturun
- AnnotationInfo örneğini oluşturun
- Bir dikdörtgen tanımlayın ve konumunu, yüksekliğini ve genişliğini ayarlayın
- Konum, metin, yükseklik, genişlik vb. gibi ek açıklama özelliklerini ayarlayın.
- Ek açıklama türünü Görüntü olarak ayarlayın
- Bir FileInfo örneği oluşturun ve giriş dosyası yolunu ayarlayın
- AnnotateOptions örneğini oluşturun
- FileInfo ve ek açıklamayı AnnotateOptions’a atayın
- Çıktı dosyası yolunu ayarla
- AnnotateOptions ile AnnotateRequest yöntemini çağırarak bir istek oluşturun
- 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 PDF belgesine görüntü ek açıklamaları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 açıklama eklemekApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);
// görüntü ek açıklaması
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 = 160;
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 görüntü ek açıklaması";
a1.creatorName = "Anonym A.";
a1.imagePath = "JohnSmith.png";
// giriş dosyası yolu
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
// ek açıklama seçeneklerini tanımlayın
let options = new groupdocs_annotation_cloud.AnnotateOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "Output/output.pdf";
// açıklama isteği oluştur
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// açıklama eklemek
let result = await açıklama eklemekApi.açıklama eklemek(request);
console.log("Image Annotation added: " + result.href);
Node.js kullanarak Görüntü Ek Açıklamaları ekleyin
Çevrimiçi Deneyin
Lütfen yukarıdaki API kullanılarak geliştirilen aşağıdaki ücretsiz çevrimiçi PDF ek açıklama aracını deneyin. https://products.groupdocs.app/annotation/pdf
Çözüm
Bu makalede, bulutta PDF belgelerine nasıl birden çok açıklama ekleyeceğinizi öğrendiniz. Ayrıca, programlı olarak PDF belgelerine görüntü ek açıklamalarının nasıl ekleneceğini de öğrendiniz. Ayrıca, bir PDF dosyasını programlı olarak buluta nasıl yükleyeceğinizi ve ardından açıklamalı dosyayı buluttan nasıl indireceğinizi öğrendiniz. Belgeleri kullanarak GroupDocs.Annotation Cloud API hakkında daha fazla bilgi edinebilirsiniz. Ayrıca, API’lerimizi doğrudan tarayıcı aracılığıyla 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.