フィールドとは、個々のエンティティに格納されるデータの一部を表すものです。単一のフィールドは異なるエンティティタイプ間で使用できます。

アカウントのフィールドを表示および管理するには、Knowledge Graph> 構成に移動し、[フィールド] タイルをクリックします。

Yextには多数の組み込みフィールドがあり、必要に応じて追加のカスタムフィールドを作成できます。エンティティのすべてのフィールドは、組み込みであれカスタムであれ、以下のプロパティがあります。
- タイプ(フィールドが受け入れるデータ形式。フィールドタイプについては以下で詳しく説明します)
- 表示名
- API名
- 検証(例:テキストフィールドの最大文字数、写真の縦横比など)
- 多言語動作 (多言語体験を使用している場合、翻訳された場合のフィールドの動作)
カスタムフィールドを作成する
カスタムフィールドを作成して、エンティティに関する追加情報をKnowledge Graphに保存できます。
-
Knowledge Graph > 設定に移動し、 [フィールド] タイルをクリックします。
- [カスタムフィールドを作成] をクリックします。
-
[フィールドタイプを選択] ドロップダウンをクリックして、作成するカスタムフィールドのタイプを選択します。
- フィールドタイプの作成方法については、「フィールドタイプを管理する」を参照してください
- フィールド設定の詳細を入力します。以下では、利用可能な設定について説明します。
- 設定を追加したら、右下の[フィールドを保存]をクリックします。
基本フィールド設定
フィールドの基本情報を入力してください。選択したフィールドタイプに応じて、表示されるオプションが若干異なる場合があります。
-
フィールド名
- 注: フィールドが作成された後は、フィールドタイプを変更することはできません。
-
ID:これは名前に基づいて自動的に設定されますが、必要に応じて変更できます。
- フィールドを作成した後にこれを変更することは推奨されません。これは、現在のフィールドIDを参照するアプリケーションが動作しなくなる可能性があるためです。
- エンティティタイプの利用可能性:このフィールドを利用可能にしたいエンティティタイプを選択します。
- フィールド設定:フィールドの検証と許可される入力のオプションを設定します。選択したフィールドの種類に応じて、異なるオプションが表示される場合があります。
-
ツールチップの説明:(オプション)ユーザーがフィールド名の横にある疑問符アイコンをクリックすると、Knowledge Graphに表示される説明が表示されます。
詳細フィールドの設定
必要に応じて、フィールドの追加設定を構成します。選択したフィールドタイプに応じて、表示されるオプションが若干異なる場合があります。
- カスタムフィールド権限グループ:フィールド権限グループを割り当ててこのフィールドにアクセスできるユーザーを制限します。カスタム権限グループ作成の詳細については、「カスタムフィールド権限グループを作成する」をご覧ください。
- 代替言語の動作:エンティティで代替言語プロファイルを使用している場合は、エンティティプロファイル全体でこのフィールドを動作させる方法を選択します。代替言語の動作についての詳細は、Hitchhikersの「代替言語プロファイルフィールドの動作」参考資料をご覧ください。
-
書き込みスコープ:フィールドに変更を加えることが許可されているシステムです。以下のオプションから1つ以上選択します。
- Yextシステム(これは常時選択されます)
- アプリ
- ユーザー
- コネクタ
翻訳
代替言語プロフィールを使用している場合は、フィールド設定に翻訳を追加します。
- 名前やツールチップなど、オプションが表示されている任意の設定で[翻訳を追加]をクリックします。
- 希望の言語を選択し、翻訳された値を入力します。[保存]または[保存してさらに追加]をクリックし、同じ設定に別の翻訳を追加します。
計算フィールド値
Yextシステムで自動的に計算方法を設定したい場合は、フィールドに計算方法を定義できます。計算フィールド値の使用方法について詳しくは、計算フィールド値活用ガイドをご覧ください。
フィールド計算設定にアクセスするには、計算方法タブをクリックします。
フィールドの設定を更新する
既存のフィールドの設定を更新できます。以下の理由で特定のフィールド設定を変更することができない場合があることにご留意ください。
- フィールドがすでにエンティティで使用されている
- フィールドがカスタムフィールドではなく、組み込みのYextフィールドである
フィールド設定を更新するには:
- Knowledge Graph > 設定に移動し、[フィールド] タイルを選択します。
- テーブルの目的のフィールドを見つけてクリックします。
- [設定] タブで目的の設定を変更します。 完了したら、右下の [フィールドを保存] をクリックします。
フィールドAPI名を表示する
API名はYextシステムのバックエンドのフィールドの一意のIDです。API名は、Yextと他のシステムとの統合など、アプリケーションでフィールドを識別するために使用されます。
フィールドとそのAPI名を表示する方法はいくつかあります。
エンティティタイプのフィールド構成経由
- ナビゲーションバーにある [Knowledge Graph] をクリックし、[構成] をクリックします。
- [エンティティタイプ] をクリックします。
- 目的のエンティティタイプの横にある [詳細を表示] をクリックします。
- [フィールド] タブをクリックします。
- このエンティティタイプに構成されたすべてのフィールドが、フィールドセクションごとに整理されます。フィールドのAPI名は、フィールド名のすぐ下に記載されています。
エンティティ編集経由
- ナビゲーションバーにある [Knowledge Graph] をクリックし、[エンティティ] をクリックします。
- 目的のエンティティを選択します。
- そのエンティティのフィールドのリストが、フィールド名の下にAPI名を示して表示されます。
フィールド設定経由
- ナビゲーションバーにある [Knowledge Graph] をクリックし、[構成] をクリックします。
- [構成] をクリックします。
- アカウントのすべてのフィールドのリストが表示され、フィールド名の下にAPI名が表示されます。