Skip to main content
コンテンツエクスプローラのメタデータビューのv1は公式サポートが終了しました。v124.0.0パッケージで引き続き利用できますが、バグ修正や新機能は提供されなくなりました。最新の機能が提供されるようにするには、移行ガイドに従い、コンテンツエクスプローラのv2のメタデータビューに切り替えてください。
コンテンツエクスプローラを使用すると、メタデータに基づいてファイルおよびフォルダを表示できます。メタデータビューでは、を使用して、表示するデータを探します。
メタデータビュー

前提条件

  • ガイドを読む。
  • を確認する。
  • に関する情報を確認する。

アプリの作成と構成

  1. [CORSドメイン] にローカルでの開発用のアドレスを追加します。 CORSドメイン
  2. を生成します。

メタデータテンプレートの作成

次の手順では、メタデータテンプレートを作成します。
  1. または管理コンソールを使用してテンプレートを作成します。
  2. すでに作成済みのテンプレートをBoxフォルダに適用します。必ずカスケードポリシーを有効にするようにしてください。詳細な手順については、テンプレートのカスタマイズと適用の手順を参照してください。
メタデータテンプレートは、ファイルにも適用できます。

表示名と主なパラメータ

  • displayNameパラメータは、管理コンソールに表示されるテンプレートの表示名です。
  • templateKeyパラメータは、テンプレートの一意の識別子です。これは、メタデータテンプレート作成の対象となる企業全体で一意である必要があります。templateKeyパラメータを指定しなかった場合は、APIによって、displayNameの値を基に一意の識別子が作成されます。
  • [fields].displayNameパラメータは、ウェブアプリおよびモバイルアプリでユーザーに表示されるフィールドの表示名です。
  • [fields].keyパラメータは、テンプレート内の特定のフィールドの一意の識別子です。この識別子は、そのフィールドが属するテンプレート内で一意である必要があります。

メタデータビューの表示

次に、コンテンツエクスプローラに渡される必須のプロパティを入力します。作業を簡単にするために、基本的なReactアプリに基づいたサンプルプロジェクトを使用して、メタデータビューを起動できます。
  1. メタデータのサンプルプロジェクトを複製します。
  2. App.js内のプレースホルダを実際の値で更新します。 defaultViewfieldsToShowmetadataQueryの各パラメータは、すでにサンプルプロジェクトで定義されています。これらのパラメータの例は、サンプルプロジェクトで確認できます。
  3. コンテンツエクスプローラコンポーネントに必須パラメータを渡します。
コンテンツエクスプローラのメタデータビューを含むReactコンポーネントのサンプルコードは次のようになります。

メタデータキー

表示するフィールドを決定するには、コンテンツエクスプローラで、ではなく、メタデータのを使用します。表示名は管理コンソールやユーザービューで確認できる一方、フィールドキーはAPIを使用して取得できます。 フィールドキーは、メタデータの表示名を変更した場合でも変わりません。これにより、UIビューでメタデータが変更されても、この機能は正常に動作します。

メタデータキーのサニタイズ

は、英数字のみに制限されています。
  • ハイフン-とアンダースコア_は許可されていません。
  • 許可されているのは文字 (a-z, A-Z) と数字 (0-9) のみです。
ラテン語以外の文字: キーにラテン語以外のアルファベット (キリル文字、アラビア語、中国語など) が含まれている場合、それらは自動的に共通識別子に変更されます。
  • 最初に出現した文字はfield
  • それ以降出現した文字はfield1field2と続く
キーは、表示名に基づいています。
ヒント: 詳細なフローについては、メタデータビューに関するブログ記事を参照してください。
最終更新日 2026年7月21日