Jako vývojář Node.js můžete snadno anotovat jakýkoli ze svých dokumentů PDF programově v cloudu. Do dokumentu můžete přidat obrázky, komentáře, poznámky nebo jiné typy externích poznámek jako anotace. V tomto článku se dozvíte, jak anotovat dokumenty PDF pomocí REST API v Node.js.
Tento článek bude obsahovat následující témata:
- Anotace dokumentu REST API a Node.js SDK
- Anotujte dokumenty PDF pomocí rozhraní REST API v Node.js
- Přidejte anotace obrázků pomocí Node.js
Anotace dokumentu REST API a Node.js SDK
Pro anotování PDF dokumentů budu používat Node.js SDK of GroupDocs.Annotation Cloud API. Umožňuje vám programově vytvářet online nástroje pro anotaci dokumentů. Do podporovaných formátů dokumentů můžete přidávat anotace, překryvy vodoznaku, nahrazování textu, redigování a textová označení. Poskytuje také .NET, Java, PHP, Ruby a Python SDK jako členové rodiny anotací dokumentu pro Cloud API.
GroupDocs.Annotation Cloud můžete nainstalovat do své aplikace Node.js pomocí následujícího příkazu v konzole:
npm install groupdocs-annotation-cloud
Než začnete postupovat podle kroků a dostupných příkladů kódu, získejte své ID klienta a tajný klíč klienta z dashboard. Jakmile budete mít své ID a tajemství, přidejte kód, jak je uvedeno níže:
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";
Anotujte dokumenty PDF pomocí rozhraní REST API v Node.js
Své dokumenty PDF můžete v cloudu anotovat pomocí následujících jednoduchých kroků:
- Nahrát soubor PDF do cloudu
- Anotovat dokument PDF pomocí Node.js
- Stáhnout anotovaný soubor
Nahrajte dokument
Nejprve nahrajte soubor PDF do cloudu pomocí následující ukázky kódu:
// inicializovat api
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// Otevřete soubor v IOStream z místního disku/disku.
var resourcesFolder = 'C:\\Files\\sample.pdf';
// číst soubor
fs.readFile(resourcesFolder, (err, fileStream) => {
// vytvořit žádost o nahrání souboru
var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", fileStream, myStorage);
// nahrát soubor
fileApi.uploadFile(request)
});
V důsledku toho bude nahraný soubor PDF dostupný v sekce souborů vašeho řídicího panelu v cloudu.
Anotujte dokument PDF pomocí Node.js
Do dokumentu PDF můžete přidat více anotací programově podle následujících kroků:
- Vytvořte instanci AnnotateApi
- Vytvořte první instanci AnnotationInfo
- Nastavte vlastnosti anotace pro první instanci, např. pozici, typ, text atd.
- Vytvořte druhou instanci AnnotationInfo
- Nastavte vlastnosti anotace pro druhou instanci, např. pozici, typ, text atd.
- Vytvořte třetí instanci AnnotationInfo
- Nastavte vlastnosti anotace pro třetí instanci, např. pozici, typ, text atd.
- Vytvořte čtvrtou instanci AnnotationInfo
- Nastavte vlastnosti anotace pro čtvrtou instanci, např. pozici, typ, text atd.
- Vytvořte instanci FileInfo a nastavte cestu k vstupnímu souboru
- Vytvořte instanci AnnotateOptions
- Přiřaďte FileInfo a definované instance anotací k AnnotateOptions
- Nastavte cestu k výstupnímu souboru
- Vytvořte požadavek voláním metody AnnotateRequest pomocí AnnotateOptions
- Získejte výsledky voláním metody AnnotateApi.annotate() s AnnotateRequest
Následující ukázka kódu ukazuje, jak anotovat dokument PDF s více anotacemi pomocí REST API v Node.js.
// inicializovat api
let opatřit poznámkamiApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);
// anotace vzdálenosti
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 anotace vzdálenosti";
a1.creatorName = "Anonym A.";
// oblastní anotace
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 oblastní anotace";
a2.creatorName = "Anonym A.";
// anotace textového pole
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.";
// elipsová anotace
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 elipsová anotace";
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";
// vytvořit požadavek na anotaci
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// opatřit poznámkami
let result = await opatřit poznámkamiApi.opatřit poznámkami(request);
console.log("Multiple Annotations added: " + result.href);
Anotujte dokumenty PDF pomocí rozhraní REST API v Node.js
Více o podporovaných typech anotací si můžete přečíst v sekci přidávání anotací v dokumentaci.
Stáhněte si soubor s poznámkami
Výše uvedená ukázka kódu uloží anotovaný soubor PDF do cloudu. Můžete si jej stáhnout pomocí následující ukázky kódu:
// vytvořit FileApi
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// vytvořit požadavek na stažení souboru
let request = new groupdocs_annotation_cloud.DownloadFileRequest("Output/output.pdf", myStorage);
// stáhnout soubor
let response = await fileApi.downloadFile(request);
// uložit soubor do pracovního adresáře
fs.writeFile("C:\\Files\\output.pdf", response, "binary", function (err) { });
console.log(response);
Přidejte anotace obrázků pomocí Node.js
Do dokumentů PDF můžete přidat anotace obrázků programově podle následujících kroků:
- Vytvořte instanci AnnotateApi
- Vytvořte instanci AnnotationInfo
- Definujte obdélník a nastavte jeho polohu, výšku a šířku
- Nastavte vlastnosti anotace, např. pozici, text, výšku, šířku atd.
- Nastavte typ anotace jako Obrázek
- Vytvořte instanci FileInfo a nastavte cestu k vstupnímu souboru
- Vytvořte instanci AnnotateOptions
- Přiřaďte FileInfo a anotaci k AnnotateOptions
- Nastavte cestu k výstupnímu souboru
- Vytvořte požadavek voláním metody AnnotateRequest pomocí AnnotateOptions
- Získejte výsledky voláním metody AnnotateApi.annotate() pomocí AnnotateRequest
Následující ukázka kódu ukazuje, jak přidat anotace obrázků do dokumentu PDF pomocí rozhraní REST API v Node.js. Chcete-li nahrát a stáhnout soubor, postupujte podle výše uvedených kroků.
// inicializovat api
let opatřit poznámkamiApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);
// anotace obrázku
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 anotace obrázku";
a1.creatorName = "Anonym A.";
a1.imagePath = "JohnSmith.png";
// cesta k vstupnímu souboru
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
// definovat možnosti anotace
let options = new groupdocs_annotation_cloud.AnnotateOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "Output/output.pdf";
// vytvořit žádost o anotaci
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// opatřit poznámkami
let result = await opatřit poznámkamiApi.opatřit poznámkami(request);
console.log("Image Annotation added: " + result.href);
Přidejte anotace obrázků pomocí Node.js
Vyzkoušejte online
Vyzkoušejte prosím následující bezplatný online nástroj pro anotaci PDF, který je vyvinut pomocí výše uvedeného API. https://products.groupdocs.app/annotation/pdf
Závěr
V tomto článku jste se naučili, jak přidat více anotací do dokumentů PDF v cloudu. Také jste se naučili, jak programově přidávat anotace obrázků do dokumentů PDF. Navíc jste se naučili, jak programově nahrát soubor PDF do cloudu a poté stáhnout soubor s poznámkami z cloudu. Více o GroupDocs.Annotation Cloud API se můžete dozvědět pomocí dokumentace. Poskytujeme také sekci API Reference, která vám umožní vizualizovat a pracovat s našimi API přímo prostřednictvím prohlížeče. V případě jakýchkoliv nejasností nás prosím neváhejte kontaktovat na fóru.