1. Sitecore Content Hub

メタデータ設定構造

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

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

以下のコードスニペットは、ImportMetadataConfiguration設定の例を示しています。このJSON設定は、アップロードされたファイルから抽出されたメタデータ(ファイルサイズ、ファイル名、画像幅など)をSitecore Content Hubの特定のアセットプロパティや関係にマッピングします。メタデータをMainFileプロパティおよびMasterFile関係にどのように転送するかを定義し、ファイルサイズのフォーマットなどのオプション変換も含みます。

{ "from": { "extension": "extension", "filesize": { "file": "metadata", "path": "$'File

'" }, "filename": { "file": "metadata", "path": "$'File
'" }, "width": { "file": "metadata", "path": "$'Composite
'", "$'File
'", "$'EXIF
'", "$'QuickTime
'", "$'MPEG
'", "$'PNG
'", "$'GIF
'", "$'Photoshop
'", "$'RIFF
'", "$'ASF
'"

} }, "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セクションには3種類のメタデータプロパティ宣言が含まれています。以下の表がそれらを説明します:

  • from 条項
  • {"extension": "extension"}: Extension*(最初の出現)* - toセクションで使用された参照。Extension*(2回目の出現)* - システム内のプロパティ名。注fileまたはpathパラメータがないことは、静的なメタデータプロパティを参照していることを示しています。
  • {"filesize": { "file": "metadata", "path": ["$['File
    ']" ]}}: filesize: to セクションで使用される参照。file: プロパティが所在するファイル。この場合、metadata はmetadata.jsonファイルを指します。path: メタデータファイル内のプロパティのパス。注意 path値は metadata.json ファイルのmetadataプロパティを参照します。
  • {"width": { "file": "metadata", "path": ["$['Composite
    ']", "$['File
    ']", "$['EXIF
    ']", "$['QuickTime
    ']", "$['MPEG
    ']", "$['PNG
    ']", "$['GIF
    ']", "$['Photoshop
    ']", "$['RIFF
    ']", "$['ASF
    ']" ]}}: width - to セクションで使用される参照。file - プロパティが所在するファイル。この場合、 metadata は metadata.json ファイルを指します。path - メタデータファイル内のプロパティのパス。注: path パラメータに複数の値がある場合、プロセッサは有効な数値を見つけるまですべてのエントリを順番に解析します。

toセクション

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

ファイルをアップロードすると、MasterFile関係を使ってアセットエンティティに関連付けられます。メタデータ設定のtoセクションはファイルエンティティプロパティから始まり、related属性を使ってアセットエンティティプロパティに続きます。

以下の図はtoセクションの構造を示しています。

Structure of the to section in the setting configuration

toセクションはpropertiesとrelatedの2つの部分で構成されています。

プロパティマッピング

propertiesは、fromセクションとファイルエンティティプロパティ間のマッピングの一覧です。マッピングは 複雑で、バッグに整理されたサブプロパティを含む場合があります。または 単純な単一値プロパティを含む単純なマッピングもあります。

複素写像とは、エンティティ定義の要素を参照するプロパティであり、例えばMainFile。以下のプロパティを含みます。

  • bag - プロパティが格納されている袋の名前(例: properties)。
  • properties - バッグに収納すべき簡単な性質のリスト。

単純な写像とは、エンティティ定義のメンバーを参照するプロパティのことです。例えばfilesize。これには以下のプロパティが含まれます。

  • value- プロパティに割り当てられた値。例えば、fromセクションのプロパティを参照するfilesize。
  • conversion - 値に適用される変換。例えば、 FileSize。

valueもconversionも任意なので、代わりにwidth

・バリューマッピングを提供できます。

関連するマッピング

relatedはfrom断面と関連するエンティティの性質(例えばAsset)との間の写像の配列です。

関連写像とは、関連する実体(例えばMasterFile)との関係を記述する性質のことです。これには以下の性質が含まれます。

  • role - リレーションにおけるファイルエンティティの役割。例えば、 MasterFile リレーションでは、 File は Assetの子です。有効な値は parent または childです。
  • properties - 関連するエンティティへの複雑または単純なプロパティマッピングの配列。

変換ロジック

メタデータ構成はconversionプロパティの以下の値をサポートしています:

  • Duration - 持続時間を1000倍で切り上げます。
  • FileSize - ファイルサイズを小数点以下の2桁と0.000001の係数で丸めます。
  • ArrayToString - 配列の要素を連結して、カンマ区切られた単一の文字列を作成する。
この記事を改善するための提案がある場合は、 お知らせください!