1. メタデータの抽出

メタデータ設定の構造

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

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

次のコード スニペットは、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セクションには、3種類のメタデータ プロパティ宣言が含まれています。次の表では、それらについて説明します。

from条項

形容

{
  "extension": "extension"
}

  • Extension(first occurrence) - toセクションで使用される参照。

  • Extension(second occurrence) - システム内のプロパティ名。

メモ

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パラメーターに複数の値がある場合、プロセッサは有効な値が見つかるまですべてのエントリを順番に解析します。

宛先 セクション

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

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

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

Structure of the to section in the setting configuration

toセクションには、propertiesとrelatedの2つの部分があります。

propertiesは、fromセクションとファイルエンティティのプロパティとの間のマッピングのリストです。マッピングは複雑で、バッグに整理されたサブプロパティを含めることができます。または、単純な単一値のプロパティを含むsimpleです。

複合マッピングは、エンティティ定義のメンバーを参照するプロパティです ( MainFileなど)。これには、次のプロパティが含まれます。

  • bag - プロパティが格納されているバッグの名前( propertiesなど)。

  • properties - バッグに格納する単純なプロパティのリスト。

単純なマッピングは、エンティティ定義のメンバーを参照するプロパティです ( filesizeなど)。これには、次のプロパティが含まれます。

  • value- プロパティに割り当てられた値。たとえば、fromセクションのプロパティを参照するfilesizeなどです。

  • conversion - 値に適用する変換。たとえば、FileSize.

valueとconversionはどちらも省略可能であるため、代わりにwidth:widthなどの単純なキーと値のマッピングを提供できます。

relatedは、fromセクションと関連エンティティのプロパティ ( Assetなど) との間のマッピングの配列です。

関連マッピングは、MasterFileなどの関連エンティティとの関係を記述するプロパティです。これには、次のプロパティが含まれます。

  • role - リレーション内のファイルエンティティの役割。たとえば、MasterFileリレーションでは、FileはAssetの子です。有効な値はparentまたはchildです。

  • properties - 関連エンティティへの複雑なプロパティ マッピングまたは単純なプロパティ マッピングの配列。

コンバージョン値

メタデータ構成では、conversionプロパティに対して次の値がサポートされています。

  • Duration - 期間の値を1000の係数で丸めます。

  • FileSize - 小数点以下2桁と係数0.000001を使用してファイル サイズを丸めます。

  • ArrayToString - 配列の要素を連結して、コンマ区切りの1つの文字列を作成します。

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