メタデータのインポート

メタデータの設定

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecore Content Hub™ では、MetadataConfiguration 設定を使用して、アップロードされたファイルのメタデータとアセットプロパティ間のマッピングを管理します。メタデータ設定は、アップロードされたファイルから取得したメタデータプロパティとメタデータがマッピングされるアセットプロパティをリスト化した JSON ファイルに保存されます。

注意

MetadataConfiguration 設定を表示および編集するにはスーパーユーザーである必要があります。

次のコードスニペットは、.json ファイルとして保存された MetadataConfiguration 設定の例です。

{
"from": {
"extension": "extension",
"filesize": {
"file": "metadata",
"path": ["$['File:FileSize']"]
},
"filename": {
"file": "metadata",
"path": ["$['File:FileName']"]
},
"width": {
"file": "metadata",
"path": [
"$['Composite:ImageWidth']",
"$['File:ImageWidth']",
"$['EXIF:ImageWidth']",
"$['QuickTime:ImageWidth']",
"$['MPEG:ImageWidth']",
"$['PNG:ImageWidth']",
"$['GIF:ImageWidth']",
"$['Photoshop:ImageWidth']",
"$['RIFF:ImageWidth']",
"$['ASF:ImageWidth']"
]
}
},
"to": {
"properties": {
"MainFile": {
"bag": "properties",
"properties": {
"extension": "extension",
"filesize": {
"value": "filesize",
"conversion": "FileSize"
},
"filesizebytes": "filesize",
"filename": "filename",
"width": "width"
}
}
},
"related": [
{
"relation": "MasterFile",
"role": "Child",
"properties": {
"FileSize": {
"value": "filesize",
"conversion": "FileSize"
},
"FileProperties": {
"bag": "properties",
"properties": {
"extension": "extension",
"width": "width"
}
}
}
}
]
}
}

メタデータ設定の編集

メタデータ設定を編集するには:

メニューバーで、[管理] をクリックします。
[管理] ページで、[設定] をクリックします。
[設定] ページの左側のペインにある [検索] ボックスに「ImportMetadataConfiguration」と入力し、選択します。
右側のペインで、必要に応じて設定を変更し、[保存] をクリックします。

注意

メニューのオプションを使用して、[フォーム]、[テキスト]、[ツリー] から設定の表示方法を変更できます。

メタデータ設定構造

JSON ファイルには 2 つのセクションがあります。

From: アップロードされたファイルから抽出されたメタデータを一覧表示します。
To: メタデータがマッピングされるアセット/ファイルのプロパティを一覧表示します。

From セクション

From セクションには、アセット/ファイルプロパティにマップされるアップロードされたファイルから取得されたメタデータプロパティが一覧表示されます。

次の表に示すように、メタデータプロパティ宣言は 3 種類あります。

From 句モデル	説明
`{ "extension": "extension" }`	`Extension` (1 つ目): To セクションで使用されるプロパティ参照。 `Extension` (2 つ目): システム内のプロパティ名。注意: `File` または `Path` パラメーターがない場合は、これが静的メタデータプロパティを参照していることを示します。
`{ "filesize": { "file": "metadata", "path": [ "$['File:FileSize']" ] } }`	`Filesize`: `To` セクションで使用されるプロパティ参照。 `File`: プロパティが見つかったファイル。この場合、`metadata` は metadata.json ファイルを指します。 `Path`: メタデータファイル内のプロパティのパス。注意: `Path` 値は metadata.json ファイル内の `metadata` プロパティを指します。詳しくは概要を参照してください。
`{ "width": { "file": "metadata", "path": [ "$['Composite:ImageWidth']", "$['File:ImageWidth']", "$['EXIF:ImageWidth']", "$['QuickTime:ImageWidth']", "$['MPEG:ImageWidth']", "$['PNG:ImageWidth']", "$['GIF:ImageWidth']", "$['Photoshop:ImageWidth']", "$['RIFF:ImageWidth']", "$['ASF:ImageWidth']" ] } }`	`Width`: `To` セクションで使用されるプロパティ参照。 `File`: プロパティが見つかったファイル。この場合、`metadata` は metadata.json ファイルを指します。 `Path`: メタデータファイル内のプロパティのパス。注意 `Path` パラメーターに複数の値がある場合、プロセッサは有効な値が見つかるまですべてのエントリを順番に解析します。

メタデータプロパティを From セクションで定義したら、Toセクションのアセットプロパティにマッピングできます。

To セクション

To セクションは、From セクションで定義されたさまざまなメタデータプロパティをアセットプロパティにマッピングします。

警告

概要の「メタデータ抽出」セクションで説明されている通り、ファイルのアップロード後に、ファイルエンティティが作成され、MasterFile リレーションを使ってアセットエンティティに関連付けられます。メタデータ設定の To セクションは、ファイルエンティティプロパティから始まり、related 属性を使ったアセットエンティティプロパティが続きます。

次の図は To セクションの全体構造を説明しています。

メタデータ設定ファイルには、主要なセクションが 2 つあります。

プロパティ: From セクションからファイルエンティティプロパティにマッピングされたプロパティのリストです。プロパティマッピングは、複雑または単純にすることができます。
- 複雑: このタイプは、「バッグ」と呼ばれるグループに編成されたサブプロパティを含む複雑なプロパティに使用されます。
  
  複雑なプロパティは、次の 3 つの要素で構成されます。
  - プロパティ名: これは、MainFile などのエンティティ定義のプロパティを参照するプロパティ名です。
  - バッグ: プロパティのバッグなどの、プロパティが格納されているバッグの名前です。
  - プロパティ: これは、バッグに保存されるシンプルなプロパティのリストです。シンプルなプロパティにはそれぞれ、プロパティ名、値、コンバージョンがあります (これについては、「シンプルなプロパティタイプ」で説明されています)。
- シンプル: このタイプは、単純な単一値のプロパティに使用されます。
  
  シンプルなプロパティは、次の 3 つの要素で構成されます。
  - プロパティ名:エンティティ定義のプロパティを参照するプロパティ名です (filesize など)。
  - 値: プロパティに割り当てられている値 (たとえば、from セクションのファイルサイズを参照する filesize)。
  - 変換: 値に適用される変換 (FileSize 変換など)。
  注意
  
  シンプルなプロパティタイプの値と変換パラメーターは、オプションです。単純なキーと値のマッピングを提供できます (width:width など)。
関連: 関連するエンティティのプロパティへの From セクションからのプロパティマッピングのリストです (Asset など)。

関連する各マッピングは、次の 3 つの要素で構成されています。
- 関係: 関連エンティティのリレーションの名前 (MasterFile など)。
- ロール: リレーションのファイルエンティティのロールです (例: MasterFile 関係では、ファイルはアセットの子になります)。有効な値は parent または child です。
- プロパティ: 関連エンティティにマッピングされるプロパティ (複雑またはシンプル) のリストです。この場合、メタデータプロパティ (From セクションで参照) が、ファイル関連のアセットエンティティにマッピングされています。
  
  related の下にあるプロパティは複雑なプロパティ (プロパティ名、バッグ、サブプロパティのリスト) またはシンプルなプロパティ (プロパティ名、値、および/または変換) にすることができます。
  
  シンプルなプロパティの例
  
  複雑なプロパティの例

この記事を改善するための提案がある場合は、お知らせください!