クラウド開発者向けのニュースがもう 1 つあります。 GroupDocs は、ドキュメント メタデータ操作クラウド API を開始しました。これにより、GroupDocs の ドキュメント メタデータ管理ソリューション が強化されます。このソリューションは、.NET および Java 開発者向けに オンプレミス API として、またあらゆる種類のユーザーがドキュメントのメタデータを表示および編集できる 無料のオンライン ドキュメント メタデータ エディター アプリ として、すでに .NET および Java 開発者に提供されています。

メタデータ操作クラウドAPI

クラウド用の GroupDocs.Metadata

GroupDocs.Metadata Cloud 開発者が 50 を超えるファイル形式のメタデータを操作 (追加、削除、更新、抽出、表示) できるようにする API と SDK。

GroupDocs.Metadata を使用すると、次のようなさまざまな方法でファイルのメタデータにアクセスし、処理することができます。

  • 可能なタグ名
  • プロパティ名
  • プロパティ値
  • 完全に一致するフレーズ
  • 正規表現と一致する
  • メタデータ ツリー全体
  • 鬼ごっこ

機能と製品についてよりよく理解するには、いつでも ドキュメント セクションの開発者ガイドにアクセスしてください。

サポートされているドキュメント形式

ワードプロセッサドキュメント、スプレッドシート、プレゼンテーション、オーディオおよびビデオファイル、画像、PDF、電子ブック、図面などのドキュメントに対して操作を実行できます。以下にリストされているのは、GroupDocs API で現在サポートされているファイル形式であり、要件を満たすことが期待されます。いつでもドキュメントにアクセスして、すべての サポートされているドキュメント形式 やあらゆる種類のガイダンスについて知ることができます。

メタデータ - SDK とサンプル

GroupDocs は、クラウド用のメタデータ編集 REST API に加えて、オープンソース SDK も提供するため、要件に応じてセルフカスタマイズできます。開発者は、cURL を使用して GroupDocs.Metadata Cloud API と対話することができ、関連する SDK を使用して開発をスピードアップすることもできます。これにより、開発者はリクエストの作成と応答の処理に関する低レベルの詳細について心配する必要がなくなります。以下の SDK とコード例は GitHub で入手できます。

このブログでは。 Java コードを使用して、ドキュメントのメタデータ プロパティを操作する方法を示しています。さらに、メタデータを抽出、追加、削除、変更する方法のうちの 1 つだけを示します。 ドキュメント および関連する GitHub リポジトリから、C# の例やその他の方法の詳細を確認することもできます。

Java または .NET でファイルからメタデータを抽出する

API を使用すると、次のようなさまざまなオプションを使用してドキュメントのメタデータを抽出できます。

  • メタデータ プロパティ ツリー全体
  • 指定されたタグ、名前、または値による

参考として、実行中のサンプルが GitHub で入手できます。 C# と Java を使用して独自のメタデータ アプリケーションをどれだけ抽出して作成できるかを示す groupdocs.appexample をアップロードしました。

Java でメタデータ プロパティ ツリー全体を抽出する

クラウド ストレージとの接続を設定した後、以下に説明する数行のコードを使用して、メタデータ プロパティのツリー全体を抽出できます。ここでは、Java SDK for Cloud を使用して Excel スプレッドシートのプロパティ ツリーを抽出しています。これは、他の利用可能な SDK を使用して簡単に実現できます。

// Set File Path
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents"+ File.separator +"input.xlsx");
// Set Options to extract the metadata from any file.
ExtractOptions options = new ExtractOptions();
options.setFileInfo(fileInfo);
// Send a Request with options to extract metadata and received the response.
ExtractRequest request = new ExtractRequest(options);
ExtractResult response = apiInstance.extract(request);

Java でのメタデータ ツリー全体の印刷

// That's it. You have received the whole Metadata Tree. Now you can use it the way you like.
for (MetadataProperty entry : response.getMetadataTree().getInnerPackages().get(0).getPackageProperties()){
	System.out.println("\\n" + entry.getName() + ": " + entry.getValue());
	if (entry.getTags() == null)
		continue;
	// Print Tags
	for (Tag tagItem : entry.getTags()) {
		System.out.println("=== Tag for Property ===");
		System.out.println("Name :" + tagItem.getName());
		System.out.println("Category: " + tagItem.getCategory());
	}
}

出力

FileFormat: 2
=== Tag for Property ===
Name :FileFormat
Category: Content

MimeType: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
=== Tag for Property ===
Name :FileFormat
Category: Content
 
SpreadsheetFileFormat: 3
=== Tag for Property ===
Name :FileFormat
Category: Content

メタデータ抽出の他のさまざまな方法はすべて、次のリソースのいずれかで参照できます。

Java または .NET を使用してメタデータを追加する

GroupDocs Metadata REST API を使用すると、次の機能を使用してドキュメントにメタデータを追加できます。

  • メタデータ プロパティには、String, DateTime、Integer、Double, Boolean などのさまざまなタイプの値が含まれる場合があります。
  • プロパティは次のさまざまな方法で追加できます。
    • メタデータ プロパティを名前で追加します。
      • 名前の一部
      • 正確なフレーズ
      • 正規表現の一致
    • タグによるメタデータ プロパティの追加:
      • 正確なタグ
      • 可能なタグ名

Java での正確なタグによるメタデータ プロパティの追加

以下に、正確なタグによってメタデータ プロパティを追加するソース コードの例を示します。

AddOptions options = new AddOptions();
ArrayList<AddProperty> properties = new ArrayList<AddProperty>();
AddProperty property = new AddProperty();
SearchCriteria searchCriteria = new SearchCriteria();
TagOptions tagOptions = new TagOptions();
// Set Tag name and category
Tag tag = new Tag();
tag.setName("Printed");
tag.setCategory("Time");
// Set Tag
tagOptions.setExactTag(tag);
searchCriteria.setTagOptions(tagOptions);
//Set Date for Value
Date date = new Date();
DateFormat dateFormat = new SimpleDateFormat("MM-dd-yyyy hh:mm:ss");
// Setting the Add Property
property.setSearchCriteria(searchCriteria);
property.setValue(dateFormat.format(date));
property.setType("datetime");
properties.add(property);
// Set Properties of AddOptions
options.setProperties(properties);
// Select the document to add metadata property
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/input.docx");
options.setFileInfo(fileInfo);
// Sending the request and fetch response after adding the metadata property
AddRequest request = new AddRequest(options);
AddResult response = apiInstance.add(request);
// Printing the Changes Count and Path of changed file.
System.out.println("Count of changes: " + response.getAddedCount());
System.out.println("Resultant file path: " + response.getPath());

出力: タグによるメタデータ追加後

Count of changes: 1
Resultant file path: metadata/add\_metadata/documents/input\_docx/input.docx

メタデータを追加するその他のさまざまな方法はすべて、次のリソースのいずれかで参照できます。

Java または .NET を使用してメタデータを削除する

メタデータ プロパティを追加するほぼ同様のオプションを使用して、ドキュメントからメタデータ プロパティを削除することもできます。

  • メタデータ プロパティには、String, DateTime、Integer、Double, Boolean などのさまざまなタイプの値が含まれる場合があります。.
  • メタデータ プロパティは、次のさまざまな方法で削除/削除できます。
    • メタデータ プロパティを名前で削除します。
      • 名前の一部
      • 正確なフレーズ
      • 一致する正規表現
    • タグによるメタデータ プロパティの削除:
      • 正確なタグ
      • 可能なタグ名

Java で正規表現 (Regex) を使用してメタデータを削除する

以下に、指定された正規表現に一致するメタデータ プロパティを削除するソース コードの例を示します。

// Name Options
NameOptions nameOptions = new NameOptions();
nameOptions.setValue("^\[N\]ame\[A-Z\].\*");
// Match Options
MatchOptions matchOptions = new MatchOptions();
matchOptions.setIsRegex(true);
nameOptions.setMatchOptions(matchOptions);
// Remove Metadata Options and Search Criteria
RemoveOptions options = new RemoveOptions();
SearchCriteria searchCriteria = new SearchCriteria();
// Search Criteria
searchCriteria.setNameOptions(nameOptions);
options.setSearchCriteria(searchCriteria);
// Set fileInfo for the source document
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/input.docx");
options.setFileInfo(fileInfo);
// Send request to remove and receive the response
RemoveRequest request = new RemoveRequest(options);
RemoveResult response = apiInstance.remove(request);
// In response, you can get the path of the updated document with the removed properies.
System.out.println("Count of changes: " + response.getRemovedCount());
System.out.println("Resultant file path: " + response.getPath());

出力: 正規表現によるメタデータの削除後

Count of changes: 1
Resultant file path: metadata/remove\_metadata/documents/input\_docx/input.docx 

メタデータを削除するその他のさまざまな方法はすべて、次のリソースのいずれかで参照できます。

Java または .NET を使用してメタデータを更新する

REST API では、メタデータの追加、削除、抽出に加えて、さまざまな方法で既存のメタデータ プロパティを更新できます。以下では、プロパティに可能なタグ名を指定することで、Java コードを使用してドキュメントのメタデータ プロパティを更新する方法を示します。 Excel スプレッドシートを使用して、作成者メタデータ タグを更新しました。 .NET API を使用して C# でも同じことを実現できます。

Java を使用した可能なタグ名によるメタデータの更新

SetOptions options = new SetOptions();
ArrayList<SetProperty> properties = new ArrayList<SetProperty>();
SetProperty property = new SetProperty();
SearchCriteria searchCriteria = new SearchCriteria();
// Set Tag Options and Possible Tag Name
TagOptions tagOptions = new TagOptions();
tagOptions.setPossibleName("creator");
searchCriteria.setTagOptions(tagOptions);
//Set the new Value and Type and then add the property
property.setSearchCriteria(searchCriteria);
property.setNewValue("GroupDocs");
property.setType("string");
properties.add(property);
options.setProperties(properties);
// Select the file to update its metadata properties
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/input.xlsx");
options.setFileInfo(fileInfo);
// Send Request and catch the Response
SetRequest request = new SetRequest(options);
SetResult response = apiInstance.set(request);
// Print the Response Fields
System.out.println("Changes count: " + response.getSetCount());
System.out.println("Resultant file path: " + response.getPath());

出力: 可能なタグ名でメタデータを変更した後

 Count of changes: 1
 Resultant file path: metadata/set\_metadata/documents/input\_xlsx/input.xlsx 

応答で返されたパスから更新されたドキュメントをダウンロードできます。さらに、メタデータの追加や削除など、同様の方法で既存のプロパティを更新できます。例と説明は、GroupDocs.Metadata Cloud API の次のリソースで参照できます。

話しましょう

これは、GroupDocs.Metadata Cloud API の概要をまとめたものです。これで、上で強調した機能を使用して独自のアプリケーションを構築できるようになります。問題について話し合ったり、解決したり、フィードバックを共有したりするには、フォーラム にご連絡いただければ幸いです。ありがとう。

資力