1. メタデータのインポート

メタデータ設定の使用

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

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

Sitecore Content Hub は、アップロードされたファイルとアセット プロパティ間のメタデータ マッピングを制御するメタデータ構成設定を提供します。

[!注] スーパーユーザーのみがメタデータ構成設定を確認および編集できます。

メタデータ設定の検索

メタデータ構成設定は、[管理] > [設定] > [レンディション] の順に選択すると見つけることができます。 この設定は、ImportMetadataConfiguration と呼ばれます。

メタデータ構成設定

設定エクスプローラーは、異なる設定を可視化、編集するさまざまな方法を提供します。 * フォーム * テキスト * ツリー:

  • フォーム
  • テキスト
  • ツリー

メタデータ設定の編集

メタデータ設定は、JSON 形式で、アップロード ファイルに既存するさまざまなメタデータ プロパティとメタデータがマッピングされるアセット プロパティを一覧します。

以下は、メタデータ構成設定の例です。

{
  "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"
            }
          }
        }
      }
    ]
  }
}

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

  • From: このセクションには、アップロードされたファイルから抽出されるメタデータが一覧表示されます。

  • To: このセクションでは、メタデータがマッピングされるアセット/ファイルのプロパティを一覧表示します。

「From」セクション

「From」セクションには、アップロードされたファイルのさまざまなメタデータ プロパティが一覧表示されます。 このセクションで宣言されたプロパティは、アセット/ファイル プロパティにマッピングされる「To」セクションで使用されます。

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

「From」句モデル説明

{
    "extension": "extension"
}
  • Extension (1 つ目): 「To」セクションで使用されるプロパティ参照。
  • Extension (2 つ目): システム内のプロパティ名。

注

File および Path パラメーターがないことは、これが静的メタデータ プロパティを参照していることを示しています。


{
    "filesize": {       
        "file": "metadata",
        "path": [    
            "$['File:FileSize']"
        ]
    }
}
  • Filesize: 「To」セクションで使用されるプロパティ参照。
  • File: これは、プロパティを見つけることができるファイルです。 この場合、「メタデータ」は「metadata.json」ファイルを指します。
  • Path: これは、メタデータ ファイル内のプロパティのパスです。
注

Path の値は、「metadata.json」ファイル内のメタデータ プロパティを参照し、概要 のメタデータ抽出セクションで説明されています。


{
    "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.json」ファイルを指します。
  • Path: これは、メタデータ ファイル内のプロパティのパスです。
注

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

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

「To」セクション

「To」セクションは、「From」セクションで定義されたさまざまなメタデータ プロパティをアセット プロパティにマッピングします。 このセクションでは、メタデータ設定の例の「To」セクションを分類して、その設定を説明します。

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

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

to

  • プロパティ:「プロパティ」セクションとは、「From」セクションからファイル エンティティ プロパティにマッピングされたリスト プロパティです。

    各プロパティ マッピングは、次の 2 つの形式のいずれかになります。

    • 複雑: このタイプは、「バッグ」と呼ばれるグループに編成されたサブプロパティを持つ複雑なプロパティを対象としています。

      to.properties.MainFile

      複雑なプロパティは、次の 3 つの要素で構成されます。

      • プロパティ名: これは、MainFile などのエンティティ定義のプロパティを参照するプロパティ名です。

      • バッグ: これは、プロパティが保存されているバッグの名前です（例：「properties」バッグ）。

      • プロパティ: これは、バッグに保存されるシンプルなプロパティのリストです。 各シンプルなプロパティには、プロパティ名、値、コンバージョンがあります (これは、シンプルなプロパティ タイプで説明されています)。

        to.properties.MainFile.properties

    • シンプル: このタイプは、シンプルな単一値のプロパティを対象としています。

      シンプルなプロパティは、次の 3 つの要素で構成されます。

      • プロパティ名: これは、filesize などのエンティティ定義のプロパティを参照するプロパティ名です。

      • 値: これは、プロパティに割り当てられる値です (たとえば、「filesize」は「from」セクションのファイルサイズを参照しています)。

      • **コンバージョン: **これは、値に適用する必要があるコンバージョンです (例: FileSize コンバージョン)。

        [!注]

        シンプルなプロパティ タイプの値とコンバージョン パラメーターは、オプションです。 ユーザーは、 'width:width' などのシンプルなキーと値間のマッピングを提供できます。

  • 関連: 「関連」セクションとは、「From」セクションからアセットなどの関連エンティティのプロパティにマッピングされるプロパティのリストのことを指します。

    to.related

    関連する各マッピングは、次の 3 つの要素で構成されています。

    • リレーション: これは、MasterFile などの関連エンティティのリレーション名です。

    • ロール: これは、リレーションのファイル エンティティのロールです (例: MasterFile リレーションでは、ファイルは、アセットの子となります)。 値は「親」または「子」にすることができます。

    • プロパティ: これは、関連エンティティにマッピングされるプロパティ (複雑またはシンプル) のリストです。 この場合、(「From」セクションで参照された) メタデータ プロパティが、ファイル関連のアセット エンティティにマッピングされています。

      to.related.properties

      'related' の下のプロパティは複雑なプロパティ (プロパティ名、バッグ、サブプロパティのリスト) またはシンプルなプロパティ (プロパティ名、値、および/またはコンバージョン) にすることができます。

      シンプルなプロパティの例

      to.related.properties.FileSize

      複雑なプロパティの例

      to.related.properties.FileProperties

「To」セクション構造

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

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