リソースのデータ構造の設定 configuring-the-resource-s-data-structure

フィールドを作成するには、「Create element」ボタンを使用します。

ラベル、ID、フィールドタイプを指定し、このフィールドに許可する最大の長さを定義します。

この「ID」フィールドは必須で、フィールドを追加するごとに一意の識別子を指定する必要があります。

いずれかのフィールドを変更する場合は、「Edit Properties」ボタンをクリックします。

Field definition ​画面でオーディエンスやターゲティングに使用するカテゴリーを定義できます。説明を追加することもできます。

ユーザーに提示する値（定義済みリストの値）を定義する場合は、「Specify a list of authorized values」オプションをオンにします。

次に「Create element」をクリックし、「Label」と「Value」を指定します。値は必要な数だけ追加できます。

フィールドを追加し終えたら、「Add audit fields」チェックボックスをオンにして、作成日、リソースを作成したユーザー、日付、および最後の変更をおこなった作成者を記述したフィールドを取り込みます。

「Add access authorization management fields」チェックボックスをオンにして、この特定のリソースへのアクセス権を持つユーザーを記述したフィールドを取り込みます。

これらのフィールドは、データベースの更新がおこなわれた後に表示できるデータとメタデータに表示されます。詳しくは、データベース構造の更新の節を参照してください。

ID を自動生成するには、「Add automatic ID」フィールドをオンにします。既存のエンティティは空のままになります。詳しくは、プロファイルおよびカスタムリソースに対する一意の ID の生成を参照してください。

リストや作成ステップでリソース要素の名前を表示する形式を変更するには、「Customize the title of the resource elements」チェックボックスをオンにします。このリソース用として作成した要素からフィールドを選択します。

テクニカルキーを自動的かつ増分的に生成させる場合は、「Automatic primary key」セクションでストレージのサイズを指定します。

キーを作成するには、「Create element」ボタンを使用します。

「Label」と「ID」のフィールドは、デフォルトで入力されますが、編集は可能です。

このキーを構成する要素を定義するには、「Create element」をクリックし、このリソース用に作成したフィールドを選択します。

作成したキーは、「Custom keys」セクションに表示されます。

インデックスを作成するには「Create element」ボタンを使用します。

「Label」と「ID」のフィールドは、デフォルトで入力されますが、編集は可能です。

このインデックスを構成する要素を定義するには、このリソース用に作成したフィールドから必要なフィールドを選択します。

「Confirm」をクリックします。

ターゲットリソースへのリンクを作成するには、「Create element」ボタンを使用します。

「Select a target resource」をクリックします。

リソースはアルファベット順に表示されます。また、名前を基準にフィルタリングできます。技術名は角括弧で囲まれて表示されます。

リストから要素を選択し、「Confirm」をクリックします。

カーディナリティに従って​ Link type ​を選択します。選択したカーディナリティの種類によって、レコードが削除されたり、複製されたりしたときの動作が異なる場合があります。

次のようなリンクタイプがあります。

• 1 cardinality simple link：ソーステーブルの 1 つの出現に対応するターゲットテーブルの出現を最大 1 つに制限するリンクです。
• N cardinality collection link：ソーステーブルの 1 つの出現に対応するターゲットテーブルの複数の出現が可能ですが、ターゲットテーブルの 1 つの出現に対応するソーステーブルの出現は最大 1 つに制限されます。
• 0 or 1 cardinality simple link：ソーステーブルの 1 つの出現に対応するターゲットテーブルの出現が最大 1 つまたはゼロに制限されます。この種の​ Link type ​は、パフォーマンス低下の原因になることがあります。

New link ​画面で、「Label」と「ID」のフィールドは、デフォルトで入力されますが、編集は可能です。

Category for the audience and targeting ​リストにより、このリンクをカテゴリーに割り当てて、クエリエディターツールで見やすく表示できるようになります。

必要に応じて、「Reverse link definition」で、ターゲットリソースに含まれるリソースのラベルと ID を表示できます。

リンクで参照されるレコードの動作を「Behavior if deleted/duplicated」セクションで定義します。

デフォルトでは、リンクで参照されるレコードがなくなると、ターゲットレコードは削除されます。

「Join definition」セクションでは、デフォルトの「Use the primary keys to make the join」が選択されますが、次の 2 つのオプションのいずれかを選択できます。

• Use the primary key to make the join：この結合定義により、プロファイルのプライマリキーを使用して、購入のプライマリキーに紐付けできるようになります。
• Define specific join conditions：この結合定義により、両方のリソースを結合するフィールドを手動で選択できるようになります。データが正しく設定されていないと、Purchase レコードが表示されません。

新しいリソース Purchase を作成します。

これをカスタムリソース Profiles にリンクさせるには、「Data structure」タブの「Links」セクションを展開し、「Create element」をクリックします。

ターゲットリソース Profiles (profile) を選択します。

この例では、デフォルトのリンクタイプ「1 cardinality simple link」を選択したままにします。

結合定義を選択します。ここではデフォルト「Use the primary key to make the join」をそのまま保持します。

必要に応じて詳細画面を定義すれば、Purchase を編集し、プロファイルにリンクさせることができます。

「Detail screen configuration」セクションを展開し、「Define a detail screen」をオンにして、リソースの各要素に対応する画面を設定します。このボックスをオフにすると、このリソースの要素を示す詳細表示にはアクセスできなくなります。

「Create element」をクリックします。

リンクされたリソースを選択し、「Add」をクリックします。

以降、新しいリソースは、Client data／Purchase を選択すれば詳細設定メニューで使用できるようになります。

設定が完了したら、「Confirm」をクリックします。

これで、新しいリソースを公開できます。

「Edit properties」ボタンをクリックして、説明を追加します。

必要に応じて、リソースのラベルおよび ID を変更します。

このリソースへのアクセスを特定の組織単位に制限する必要がある場合は、ここで組織単位を指定します。許可された組織単位のユーザーだけが、アプリケーションでこのリソースを使用できます。

変更内容を保存します。

プロファイルリソースの拡張機能を作成するか、新規のリソースを作成します。

データ構造の定義で「Fields」セクションにある「Add automatic ID field」をオンにします。

リソースに加えた変更を保存した後、公開します。API を介して作成した要素に、このメカニズムを適用する場合は、API を拡張するオプションを選択します。