> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# メタデータ

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = localizeLink(href);
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

メタデータを使用すると、ユーザーやアプリケーションは、ファイルやフォルダに関連付けられたカスタムデータを定義、格納できます。

<Frame border center>
  <img src="https://mintcdn.com/box/Or-P29MSx7z0-Y8K/ja/guides/metadata/metadata-example.png?fit=max&auto=format&n=Or-P29MSx7z0-Y8K&q=85&s=9b6c637f75199d06960ae13479746756" alt="文字列フィールド" width="1145" height="790" data-path="ja/guides/metadata/metadata-example.png" />
</Frame>

メタデータは、ファイルまたはフォルダに割り当てられているキー/値ペアで構成されます。たとえば、重要な契約には、`clientNumber: 820183`と`clientName: bioMedicalCorp`のキー/値ペアが使用されている場合があります。

## メタデータの用語

メタデータを操作するには、開発者は異なる数種類のリソースを使用する必要があります。

* **テンプレート:** <Link href="/guides/metadata/templates">メタデータテンプレート</Link>には、ファイルに割り当てることができる再利用可能な一連のキー/値ペアが記載されています。たとえば、`invoiceData`テンプレートでは、請求書に関するデータを保持するため、請求書IDと顧客IDのフィールドが設定されています。
* **フィールド:** <Link href="/guides/metadata/fields">メタデータテンプレートフィールド</Link>には、メタデータテンプレート内の特定のデータが記載されています。たとえば、請求書のIDを`invoiceData`テンプレートの`id`フィールドとして表すことができます。
* **インスタンス:** <Link href="/guides/metadata/instances">メタデータインスタンス</Link>には、各フィールドに割り当てられている値など、テンプレートとファイルやフォルダ間の関係が記載されています。たとえば、ユーザーは、`invoiceData`メタデータテンプレートをファイルに割り当て、2つの値を指定しています (1つは請求書ID、もう1つは顧客ID)。特定のファイルまたはフォルダには最大100個のテンプレートを割り当てることができます。
* **カスケードポリシー**: <Link href="/guides/metadata/cascades">メタデータカスケードポリシー</Link>には、フォルダに適用されているメタデータインスタンスを、そのフォルダ内の項目にどのように適用するかが記載されています。たとえば、ユーザーは、同じ`invoiceData`メタデータテンプレートをプロジェクトフォルダに割り当てると (2つの値を含む)、そのプロジェクトフォルダ内のすべてのファイルとフォルダに自動的に適用できます。
* **クエリ:** <Link href="/guides/metadata/queries">メタデータクエリ</Link>を使用すると、ファイルやフォルダに設定されているメタデータを検索して、そのファイルやフォルダを見つけることができます。たとえば、特定のIDが付いた請求書についてすべてのファイルを検索するには、クエリで、その請求書に適用されている`invoiceData`テンプレートと値`id = :id` (ここで、`:id`は請求書の値) が設定されたすべてのファイルとフォルダを検索することができます。

## メタデータの目的

メタデータは多くの目的で使用できます。会社がマーケティングチーム向けにデジタルアセットを効率よく編成する場合もあれば、開発者がワークフローや承認の促進のような高度なコンテンツ機能を提供する場合もあります。

たとえば、`marketingCollateral`テンプレートでは、特定のマーケティングコンテンツを使用する状況とタイミングを定義できます。ユーザーは、Boxウェブアプリでテンプレートのレプリゼンテーションを確認すると同時に、ファイルのプレビューに移動できます。

詳細については、[Boxコミュニティの記事][community]を参照してください。

[community]: https://support.box.com/hc/ja/articles/360044196173-メタデータの使用
