Node.jsにおけるメタデータ管理

メタデータの管理は、特にさまざまな文書形式で動作するアプリケーションにとって、文書自動化の重要な部分です。この記事では、Node.js アプリケーションにおけるメタデータの管理方法、特にメタデータの抽出、変更、および削除に焦点を当てて見ていきます。

このガイドでは、以下のセクションを探ります:

  1. グループドックスメタデータとは何ですか?そしてそれはどのように役立ちますか?
  2. How to install
  3. クイックスタートガイド
  4. Key Features
  5. Common Use Cases
  6. Getting Started with a Free Trial
  7. See Also

GroupDocs.Metadataとは何ですか、そしてそれはどのように役立ちますか?

GroupDocs.Metadata for Node.js は、Node.js アプリケーションでさまざまなドキュメント形式のメタデータを管理するのに役立つライブラリです。

ノード.js開発者がファイルサイズ、タイプ、属性などの基本メタデータを抽出することを可能にするネイティブメソッドがある一方で、これらのメソッドは特定のファイル形式に関連するより複雑なメタデータをカバーしていません。

GroupDocs.Metadata は、ユーザーが PDF、Microsoft Office フォーマット、画像、音声、動画などのファイルからメタデータを取得、更新、削除できるようにすることで、このギャップを埋めます。また、著者、タイトル、ファイルフォーマットの特定のプロパティ、GPS 位置情報データなど、詳細な情報へのアクセスも可能にします。シンプルな API を使用することで、GroupDocs.Metadata は多くの文書自動化およびデータ処理シナリオをカバーするためにメタデータを効果的に操作できるようにします。

インストール方法

GroupDocs.Metadata for Node.js via Java は NPM にホスティングされています。次のコマンドを使用して、Node.js プロジェクトで簡単に API を参照できます:

npm install @groupdocs/groupdocs.metadata

クイックスタートガイド

GroupDocs.Metadata for Node.js を始めるのは、私たちのサンプルプロジェクトを使えば簡単でスムーズです。 ここに設定を手伝うための簡単なガイドがあります:

  1. リポジトリをクローンする: 例のリポジトリをローカルマシンにクローンします。

    git clone https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java.git
    
  2. Examples フォルダーに移動:

    cd ./GroupDocs.Metadata-for-Node.js-via-Java/
    
  3. 必要なパッケージをインストールする:

    npm install   
    
  4. 例を実行します:

    node runExamples.js 
    

このコードは、GroupDocs.Metadata ライブラリのさまざまな機能を示す一連のサンプルスクリプトを実行します。

主な機能

GroupDocs.Metadata for Node.js は、ドキュメントメタデータを扱う開発者にとって便利な API となる一連の機能を備えています。以下は、主な機能のいくつかです:

  • 豊富なメタデータ管理機能: 様々な文書形式からメタデータを読み取り、更新し、削除します。
  • ターゲットプロパティ操作: 特定の基準を満たすメタデータプロパティを検索、更新、および削除します。
  • 統一プロパティ管理:一般的なメタデータプロパティを一貫した方法で簡単に操作できるようにタグを活用します。
  • パスワード保護されたドキュメントのサポート: 機密データでも柔軟性を確保しながら、保護されたドキュメントで作業します。
  • ドキュメントプロパティについての洞察: 隠れたページ、デジタル署名、ユーザーコメント、改訂などに関する詳細情報を抽出します。
  • 人気のある標準との互換性: IPTC、XMP、EXIF、および画像リソースなどの主要なメタデータ標準で作業します。
  • マルチメディアメタデータの処理: 様々なフォーマットのネイティブメタデータプロパティを操作し、マルチメディアファイルから技術情報を抽出します。
  • 文書統計の計算:文書の単語数や文字数などの一般的な文書統計を計算します。
  • ファイル形式の検出: ファイルの内部構造に基づいて形式とMIMEタイプを特定します。
  • オーディオタグのサポート:ID3、歌詞、APEを含むさまざまなオーディオタグを管理します。

一般的な利用ケース

以下は、Node.js アプリケーションにおける GroupDocs.Metadata の一般的な使用例と、それに対応するコードスニペットです。

Use Case 1: 画像からメタデータを取得する

この例では、特定の基準に基づいて画像ファイル(例: image.png)のメタデータプロパティを取得します。

  1. メタデータオブジェクトを初期化します: ファイルを使ってメタデータクラスの新しいインスタンスを作成します。
  2. 検索条件を定義する: “幅"や"高さ"などの特定のプロパティを見つけるために検索仕様を使用します。
  3. メタデータを取得して表示: 一致するプロパティを取得し、その名前と値をログに記録します。
const groupdocsMetadata = require('@groupdocs/groupdocs.metadata');

try {
    // Initialize the Metadata object with the image file
    const metadata = new groupdocsMetadata.Metadata("image.png");

    // Fetch properties based on name criteria: Width or Height
    var searchSpecification = new groupdocsMetadata.WithNameSpecification("Width")
        .or(new groupdocsMetadata.WithNameSpecification("Height"));
    var metadataProperties = metadata.findProperties(searchSpecification);

    console.log(`Total found properties#: ${metadataProperties.getCount()}`);    

    // Iterate and log all found properties
   for (var i = 0; i < metadataProperties.getCount(); i++) {
        console.log(`Property name: ${metadataProperties.get_Item(i).getName()}, 
        Property value: ${metadataProperties.get_Item(i).getValue()}`);
    }
} catch (error) {
    console.error('An error:', error);
}

ユースケース 2: ドキュメントからメタデータをクリーンアップ

ここでは、PDF ドキュメントから不要なメタデータを削除します。

  1. PDFをロードします:PDFファイルのためにMetadataオブジェクトを作成します。
  2. メタデータのサニタイズ: 検出されたメタデータパッケージを削除します。
  3. Cleaned Documentを保存: サニタイズされたドキュメントを新しいファイルに保存します。
try {
    // Load the PDF file
    const metadata = new groupdocsMetadata.Metadata("input.pdf");

    // Remove detected metadata packages and log the properties removed
    var affected = metadata.sanitize();
    console.log(`Properties removed: ${affected}`);

    // Save the cleaned PDF
    metadata.save("cleaned_output.pdf");
} catch (error) {
    console.error('An error occurred during the sanitization:', error);
}

ユースケース 3: ドキュメントメタデータの更新

この例では、ドキュメントの作成日と変更日を更新する方法を示します。

  1. ドキュメントをロードする: ドキュメントファイルのメタデータオブジェクトを初期化します。
  2. 新しいプロパティを設定します: ドキュメントの作成日と変更日を更新します。
  3. 更新されたドキュメントを保存: ファイルへの変更を保存します。
try {
    // Load the VSDX file
    const metadata = new groupdocsMetadata.Metadata("input.vsdx");

    // Set the current date for creation and modification properties
    var affected = metadata.setProperties(
        new groupdocsMetadata.ContainsTagSpecification(
                groupdocsMetadata.Tags.getTime().getCreated())
            .or(new groupdocsMetadata.ContainsTagSpecification(
                groupdocsMetadata.Tags.getTime().getModified())),
        new groupdocsMetadata.PropertyValue(new Date())
    );

    console.log(`Properties set: ${affected}`);

    // Save the updated VSDX
    metadata.save("updated_output.vsdx");
} catch (error) {
    console.error('An error occurred:', error);
}

無料トライアルの始め方

デフォルトでは、ライブラリはライセンスなしでトライアルモードで動作し、ライブラリの基本的な機能や機能を探索できるようにしています。 You can download GroupDocs.Metadata for Node.js via Java from the GroupDocs Releases page.

さらに、このリンク から一時ライセンスを取得できます。テンポラリーライセンスを利用すると、ライブラリを制限なしに使用し、その機能を完全に探索することができます。

See Also

GroupDocs.Metadata とその機能について詳しく掘り下げ、より多くの洞察を得るには、次のリソースを参照してください: