Dokumenty Wordu můžeme snadno programově anotovat v cloudu. K dokumentům můžeme přidávat obrázky, komentáře, poznámky nebo jiné typy externích poznámek jako anotace. V tomto článku se naučíme, jak přidávat anotace do dokumentů aplikace Word pomocí REST API v Node.js.
Tento článek bude obsahovat následující témata:
- Anotace dokumentu Word REST API a Node.js SDK
- Anotujte dokumenty Word pomocí REST API v Node.js
- Přidejte poznámky k obrázkům do dokumentů aplikace Word pomocí rozhraní REST API v Node.js
- Přidejte poznámky k textovým polím do dokumentů aplikace Word pomocí REST API Node.js
- Anotace vodoznaku v dokumentech Word pomocí REST API v Node.js
Anotace dokumentu Word REST API a Node.js SDK
Pro anotování souborů DOC nebo DOCX budeme používat Node.js SDK of GroupDocs.Annotation Cloud API. Nainstalujte jej pomocí následujícího příkazu v konzole:
npm install groupdocs-annotation-cloud
Před provedením uvedených kroků získejte své ID klienta a tajný klíč z řídicího panelu. Jakmile budete mít své ID a tajemství, přidejte kód, jak je uvedeno níže:
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";
Anotujte dokumenty Word pomocí REST API v Node.js
Do souborů DOCX můžeme přidat anotace podle jednoduchých kroků uvedených níže:
- Nahrajte soubor DOCX do cloudu
- Přidat více anotací k souborům DOCX v Node.js
- Stáhnout anotovaný soubor
Nahrajte dokument
Nejprve nahrajeme soubor DOCX do cloudu pomocí níže uvedeného příkladu 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\\Annotation\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
// Vytvořit požadavek na nahrání
var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
// Nahrát soubor
fileApi.uploadFile(request);
});
V důsledku toho bude nahraný soubor DOCX dostupný v sekce souborů řídicího panelu v cloudu.
Přidejte více anotací do souborů DOCX v Node.js
Do dokumentů Wordu můžeme přidat více anotací programově podle následujících kroků:
- Nejprve vytvořte instanci AnnotateApi.
- Dále vytvořte první instanci AnnotationInfo.
- Poté nastavte vlastnosti anotace pro první instanci, např. pozici, typ, text atd.
- Opakováním výše uvedených kroků přidáte více instancí AnnotationInfo. Pro každou instanci nastavíme různé typy anotací a další vlastnosti pro přidání více anotací.
- Dále vytvořte instanci FileInfo a nastavte cestu vstupního souboru.
- Poté vytvořte instanci AnnotateOptions.
- Nyní přiřaďte FileInfo a definované instance anotací k AnnotateOptions.
- Nastavte také cestu k výstupnímu souboru.
- Poté zavolejte metodu AnnotateRequest pomocí AnnotateOptions.
- Nakonec získejte výsledky voláním metody AnnotateApi.annotate() s AnnotateRequest.
Následující ukázka kódu ukazuje, jak přidat více anotací do dokumentu aplikace Word pomocí rozhraní REST API v Node.js.
// Inicializovat API
let annotateApi = groupdocs_annotation_cloud.Opatřit poznámkamiApi.fromKeys(clientId, clientSecret);
// Definujte anotaci 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 distance annotation";
a1.creatorName = "Anonym A.";
// Definujte anotaci oblasti
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.";
// Definujte anotaci šipky
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.";
// Definujte anotaci 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.";
// Vstupní cesta k souboru
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// Definujte možnosti poznámek
let options = new groupdocs_annotation_cloud.Opatřit poznámkamiOptions();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "AddMultipleAnnotations.docx";
// Vytvořit žádost o anotaci
let request = new groupdocs_annotation_cloud.Opatřit poznámkamiRequest(options);
// Opatřit poznámkami
let result = await annotateApi.annotate(request);
Přidejte více anotací do souborů DOCX v Node.js
Stáhněte si soubor s poznámkami
Výše uvedená ukázka kódu uloží anotovaný dokument aplikace Word (DOCX) do cloudu. Lze jej stáhnout pomocí následující ukázky kódu:
// Vytvořte FileApi
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// Vytvořit požadavek na stažení souboru
let request = new groupdocs_annotation_cloud.DownloadFileRequest("AddMultipleAnnotations.docx", myStorage);
// Stáhnout soubor
let response = await fileApi.downloadFile(request);
// Uložte soubor do pracovního adresáře
fs.writeFile("C:\\Files\\Annotation\\AddMultipleAnnotations.docx", response, "binary", function (err) { });
Přidejte poznámky k obrázkům do dokumentů aplikace Word pomocí rozhraní REST API v Node.js
Do dokumentů aplikace Word můžeme přidat anotace obrázků programově podle následujících kroků:
- Nejprve vytvořte instanci AnnotateApi.
- Dále vytvořte instanci AnnotationInfo.
- Poté definujte obdélník a nastavte jeho polohu, výšku a šířku.
- Poté nastavte vlastnosti anotace, např. pozici, text, výšku, šířku atd.
- Poté nastavte typ anotace jako Obrázek.
- Dále vytvořte instanci FileInfo a nastavte cestu vstupního souboru.
- Poté vytvořte instanci AnnotateOptions.
- Nyní přiřaďte objekt FileInfo a anotaci k AnnotateOptions.
- Nastavte také cestu k výstupnímu souboru.
- Poté vytvořte požadavek voláním metody AnnotateRequest s objektem AnnotateOptions jako argumentem.
- Nakonec získejte výsledky voláním metody AnnotateApi.annotate() s objektem AnnotateRequest.
Následující ukázka kódu ukazuje, jak přidat anotaci obrázku do dokumentu aplikace Word 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 annotateApi = groupdocs_annotation_cloud.Opatřit poznámkamiApi.fromKeys(clientId, clientSecret);
// Definujte anotaci 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 = 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";
// Vstupní cesta k souboru
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// Definujte možnosti anotace
let options = new groupdocs_annotation_cloud.Opatřit poznámkamiOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddImageAnnotation.docx";
// Vytvořit žádost o anotaci
let request = new groupdocs_annotation_cloud.Opatřit poznámkamiRequest(options);
// Opatřit poznámkami
let result = await annotateApi.annotate(request);
Přidejte poznámky k obrázkům do dokumentů aplikace Word pomocí rozhraní REST API v Node.js
Přidejte poznámky k textovým polím do dokumentů aplikace Word pomocí rozhraní REST API v Node.js
Do dokumentů aplikace Word můžeme přidat anotace textových polí programově podle výše uvedených kroků. Musíme však nastavit typ anotace jako TextField.
Následující ukázka kódu ukazuje, jak přidat anotaci textového pole do dokumentu aplikace Word 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 annotateApi = groupdocs_annotation_cloud.Opatřit poznámkamiApi.fromKeys(clientId, clientSecret);
// Definujte anotaci textového pole
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.";
// Vstupní cesta k souboru
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// Definujte možnosti anotace
let options = new groupdocs_annotation_cloud.Opatřit poznámkamiOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddTextFieldAnnotation.docx";
// Vytvořit žádost o anotaci
let request = new groupdocs_annotation_cloud.Opatřit poznámkamiRequest(options);
// Opatřit poznámkami
let result = await annotateApi.annotate(request);
Přidejte poznámky k textovým polím do dokumentů aplikace Word pomocí rozhraní REST API v Node.js
Anotace vodoznaku v dokumentech Word pomocí REST API v Node.js
Do dokumentů aplikace Word můžeme přidat anotace vodoznaku programově podle výše uvedených kroků. Musíme však nastavit typ anotace jako Vodoznak.
Následující ukázka kódu ukazuje, jak přidat anotaci vodoznaku do dokumentu aplikace Word 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 annotateApi = groupdocs_annotation_cloud.Opatřit poznámkamiApi.fromKeys(clientId, clientSecret);
// Definujte anotaci vodoznaku
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.";
// Vstupní cesta k souboru
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// Definujte možnosti anotace
let options = new groupdocs_annotation_cloud.Opatřit poznámkamiOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddWatermarkAnnotation.docx";
// Vytvořit žádost o anotaci
let request = new groupdocs_annotation_cloud.Opatřit poznámkamiRequest(options);
// Opatřit poznámkami
let result = await annotateApi.annotate(request);
Anotace vodoznaku v dokumentech Word pomocí REST API v Node.js
Vyzkoušejte online
Vyzkoušejte prosím následující bezplatný online anotační nástroj DOCX, který je vyvinut pomocí výše uvedeného API. https://products.groupdocs.app/annotation/docx
Závěr
V tomto článku jsme se naučili přidávat anotace do dokumentů Wordu v cloudu. Viděli jsme také, jak přidat do souboru DOCX anotace obrázků a textových polí pomocí REST API v Node.js. Tento článek také vysvětlil, jak programově nahrát soubor DOCX do cloudu a poté stáhnout upravený soubor z cloudu. Kromě toho se můžete dozvědět více o GroupDocs.Annotation Cloud API 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 neváhejte kontaktovat na fóru.