Node.js の REST API を使用して PDF から注釈を抽出または削除する

注釈は、追加情報を提供するドキュメント内のコメント、ポップアップ、その他のさまざまなグラフィック オブジェクトです。クラウド上でプログラムを使用して、ドキュメントにさまざまな種類の注釈を簡単に追加できます。 Node.js を使用してドキュメントからすべての注釈を抽出または削除することもできます。この記事では、Node.js の REST API を使用して PDF ドキュメントから注釈を抽出または削除する方法を学習します。

この記事では次のトピックについて説明します。

ドキュメント注釈 REST API および Node.js SDK

PDF ドキュメントから注釈を抽出または削除するには、GroupDocs.Annotation Cloud の Node.js SDK API を使用します。これにより、Node.js でドキュメント アノテーター ツールを構築できるようになります。このようなツールを使用すると、PDF、Word、Excel、PowerPoint, Outlook、画像形式などのすべての一般的なドキュメント形式に対して、注釈、透かしオーバーレイ、テキスト置換、墨消し、付箋、およびテキスト マークアップを追加、編集、または削除できます。また、クラウド API の ドキュメント アノテーション ファミリー メンバー として、.NET、Java、PHP、Ruby、Python SDK も提供します。

コンソールで次のコマンドを使用して、GroupDocs.Annotation Cloud を Node.js アプリケーションにインストールできます。

npm install groupdocs-annotation-cloud

手順と利用可能なコード例を開始する前に、ダッシュボード からクライアント ID とクライアント シークレットを取得してください。 ID とシークレットを取得したら、以下に示すようにコードを追加します。

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 の REST API を使用して PDF ファイルから注釈を抽出または削除する

以下の簡単な手順に従って、PDF ドキュメントからすべての注釈を抽出または削除できます。

ドキュメントをアップロードする

まず、以下のコード例を使用して PDF ファイルをクラウドにアップロードします。

// APIの初期化
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);

// 入力ファイル
var resourcesFolder = 'C:\\Files\\sample.pdf';

// ファイルを読み取る
fs.readFile(resourcesFolder, (err, fileStream) => {
  // アップロードファイルリクエストの作成
  var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", fileStream, myStorage);
  // ファイルをアップロードする
  fileApi.uploadFile(request)
});

その結果、アップロードされた PDF ファイルは、クラウド上のダッシュボードの ファイル セクション で利用できるようになります。

Node.js で PDF ファイルから注釈を抽出する

以下の手順に従って、PDF ドキュメントからすべての注釈をプログラムで抽出できます。

  • AnnotateApi のインスタンスを作成する
  • FileInfo のインスタンスを作成する
  • 入力ファイルのパスを設定する
  • FileInfo オブジェクトを使用して ExtractRequest メソッドを呼び出してリクエストを作成します。
  • ExtractRequest オブジェクトを使用して AnnotateApi.extract() メソッドを呼び出して結果を取得します

次のコード スニペットは、Node.js の REST API を使用して PDF ドキュメントから注釈を抽出する方法を示しています。

// APIを初期化する
let annotateApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);

// 入力ファイル
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";

// 抽出リクエストを作成する
let request = new groupdocs_annotation_cloud.ExtractRequest(fileInfo);

// エキス
let result = await annotateApi.エキス(request);
// 結果を示す
console.log("GetAnnotations: annotations count = " + result.length);
result.forEach(element => console.log("Annotation ID:" + element.id + " Element Text: " + element.text));
Node.js で PDF ファイルから注釈を抽出する

Node.js で PDF ファイルから注釈を抽出する

Node.js で PDF ドキュメントから注釈を削除する

以下の手順に従って、プログラムで PDF ドキュメントから注釈を削除できます。

  • AnnotateApi のインスタンスを作成する
  • FileInfo のインスタンスを作成する
  • 入力ファイルのパスを設定する
  • RemoveOptions のインスタンスを作成する
  • FileInfo を RemoveOptions に設定します
  • 削除する注釈 ID を指定してください
  • 出力ファイルのパスを設定する
  • RemoveOptions オブジェクトを使用して RemoveAnnotationsRequest メソッドを呼び出してリクエストを作成します。
  • AnnotateApi.removeAnnotations() メソッドを呼び出して結果を取得します

次のコード例は、Node.js の REST API を使用して PDF ドキュメントから注釈を削除する方法を示しています。前述したように、ExtractRequest で extract() メソッドを使用してアノテーション ID を取得できます。

// APIの初期化
let annotateApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);

// 入力ファイルのパス
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";

// 削除オプションを定義する
let options = new groupdocs_annotation_cloud.RemoveOptions();
options.fileInfo = fileInfo;
options.annotationIds = [0, 1, 2, 3];
options.outputPath = "Output/output.pdf";

// 注釈の削除リクエストの作成
let request = new groupdocs_annotation_cloud.RemoveAnnotationsRequest(options);

// 注釈を削除する
let result = await annotateApi.removeAnnotations(request);

console.log("DeleteAnnotations: annotations delete: " + result.href);
Node.js で PDF ドキュメントから注釈を削除する

Node.js で PDF ドキュメントから注釈を削除する

出力ファイルをダウンロードする

上記のコード サンプルは、注釈を削除した後に出力ファイルをクラウドに保存します。次のコードサンプルを使用してダウンロードできます。

// FileApi を構築する
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);

// ダウンロードファイルリクエストの作成
let request = new groupdocs_annotation_cloud.DownloadFileRequest("Output/output.pdf", myStorage);
let response = await fileApi.downloadFile(request);

// ファイルを作業ディレクトリに保存します
fs.writeFile("C:\\Files\\output.pdf", response, "binary", function (err) { });
console.log(response);

オンラインで試す

上記の API を使用して開発された、次の無料のオンライン PDF 注釈ツールをお試しください。 https://products.groupdocs.app/annotation/pdf

結論

この記事では、Node.js を使用してクラウド上の PDF ドキュメントから注釈を抽出または削除する方法を学習しました。また、プログラムによって PDF ファイルをクラウドにアップロードし、更新されたファイルをクラウドからダウンロードする方法も学習しました。 ドキュメント を使用すると、GroupDocs.Annotation Cloud API についてさらに詳しく学ぶことができます。また、ブラウザーを通じて直接 API を視覚化し操作できるようにする API リファレンス セクションも提供しています。不明な点がある場合は、フォーラム でお気軽にお問い合わせください。

関連項目