Show Menu
トピック×

リソースのデータ構造の設定

新しいカスタムリソースを作成した後は、データ構造を設定する必要があります。
リソースの編集時に、「 Data structure 」タブで次のものを追加できます。

リソースへのフィールドの追加

標準搭載のデータモデルに含まれていないデータを保存するために、リソースに新しいフィールドを追加できます。
  1. フィールドを作成するには、「 Create element 」ボタンを使用します。
  2. ラベル、ID、フィールドタイプを指定し、このフィールドに許可する最大の長さを定義します。
    この「 ID 」フィールドは必須で、フィールドを追加するごとに一意の識別子を指定する必要があります。
    最大 30 文字です。
  3. いずれかのフィールドを変更する場合は、「 Edit Properties 」ボタンをクリックします。
  4. Field definition ​画面でオーディエンスやターゲティングに使用するカテゴリーを定義できます。説明を追加することもできます。
  5. ユーザーに提示する値(定義済みリストの値)を定義する場合は、「 Specify a list of authorized values 」オプションをオンにします。
    次に「 Create element 」をクリックし、「 Label 」と「 Value 」を指定します。値は必要な数だけ追加できます。
  6. フィールドを追加し終えたら、「 Add audit fields 」チェックボックスをオンにして、作成日、リソースを作成したユーザー、日付、および最後の変更をおこなった作成者を記述したフィールドを取り込みます。
  7. Add access authorization management fields 」チェックボックスをオンにして、この特定のリソースへのアクセス権を持つユーザーを記述したフィールドを取り込みます。
    これらのフィールドは、データベースの更新がおこなわれた後に表示できるデータとメタデータに表示されます。詳しくは、 データベース構造の更新 の節を参照してください。
  8. ID を自動生成するには、「 Add automatic ID 」フィールドをオンにします。既存のエンティティは空のままになります。詳しくは、 プロファイルおよびカスタムリソースに対する一意の ID の生成 を参照してください。
  9. リストや作成ステップでリソース要素の名前を表示する形式を変更するには、「 Customize the title of the resource elements 」チェックボックスをオンにします。このリソース用として作成した要素からフィールドを選択します。
    このオプションをオンにせずに、テーブルのすべてのエンティティを一覧表示すると、自動プライマリキー(テーブルにエンティティを追加するたびに自動的に作成される)が使用されます。
これで、リソースのフィールドが定義されました。

識別キーの定義

各リソースには、一意のキーが少なくとも 1 つ必要です。例えば、ある購入テーブル中で 2 つの製品に同じ ID を付けることがないようにキーを指定できます。
  1. テクニカルキーを自動的かつ増分的に生成させる場合は、「 Automatic primary key 」セクションでストレージのサイズを指定します。
  2. キーを作成するには、「 Create element 」ボタンを使用します。
    Label 」と「 ID 」のフィールドは、デフォルトで入力されますが、編集は可能です。
    最大 30 文字です。
  3. このキーを構成する要素を定義するには、「 Create element 」をクリックし、このリソース用に作成したフィールドを選択します。
    作成したキーは、「 Custom keys 」セクションに表示されます。
これで、リソースの識別キーが作成されます。
識別キーを作成する際のベストプラクティスについては、 こちらの節 を参照してください。

インデックスの定義

1 つのインデックスから、単一または複数のリソースフィールドを参照できます。インデックスを使用すると、データベースではレコードを並べ替えて、より簡単にレコードを回復できるようになります。インデックスにより SQL クエリのパフォーマンスが最適化されます。
インデックスの定義付けは推奨されますが、省略してもかまいません。
  1. インデックスを作成するには「 Create element 」ボタンを使用します。
  2. Label 」と「 ID 」のフィールドは、デフォルトで入力されますが、編集は可能です。
    最大 30 文字です。
  3. このインデックスを構成する要素を定義するには、このリソース用に作成したフィールドから必要なフィールドを選択します。
  4. Confirm 」をクリックします。
作成したインデックスが「 Index 」セクションのリストに表示されます。
インデックス作成時のベストプラクティスについては、 こちらの節 を参照してください。

送信ログ拡張機能の定義

送信ログ拡張機能により、次のことが可能になります。
  • プロファイルのカスタムフィールドを追加 ​することにより、動的レポートの機能を拡張する
  • 送信ログデータを​ セグメントコードとプロファイルデータ ​で拡張する
セグメントコードで拡張
ユーザーは、ワークフローエンジンのセグメントコードを使用してログを拡張できます。
セグメントコードは、ワークフローの内部に定義する必要があります。
この拡張機能を有効にするには、「 Add segment code 」オプションをオンにします。
セグメントコードについて詳しくは、 セグメント化 の節を参照してください。
プロファイルフィールドで拡張
管理者はまず、カスタムフィールドを使用して Profile リソースを拡張しておく必要があります。
Add field 」をクリックして、プロファイルリソースからいずれかのカスタムフィールドを選択します。
プロファイルディメンションにリンクする新しいサブディメンションを生成するには、「 Add this field in Dynamic reporting as a new dimension 」オプションをオンにします。
動的レポートから、カスタムフィールドディメンションをフリーフォームテーブルにドラッグ&ドロップできます。
動的レポートについて詳しくは、 コンポーネントのリスト を参照してください。
動的レポートに送信できるフィールドの数は 20 個に制限されます。

リソースプロパティの編集

カスタムリソース画面の​ Summary ​パネルには、新たに作成されたリソースのステータスが示されます。リソースへのアクセスと一般的なプロパティを管理できます。
  1. Edit properties 」ボタンをクリックして、説明を追加します。
  2. 必要に応じて、リソースのラベルおよび ID を変更します。
    最大 30 文字です。
  3. このリソースへのアクセスを特定の組織単位に制限する必要がある場合は、ここで組織単位を指定します。許可された組織単位のユーザーだけが、アプリケーションでこのリソースを使用できます。
  4. 変更内容を保存します。
変更内容が保存されます。変更内容を適用するには、リソースを再度、公開する必要があります。

プロファイルおよびカスタムリソースに対する一意の ID の生成

デフォルトでは、プロファイルおよびカスタムリソースの作成時に、ビジネス ID は付与されていません。要素の作成時に、自動的に一意の ID を生成するオプションを有効にすることができます。この ID は、次の目的で使用できます。
  • 外部ツールでエクスポートされたレコードを簡単に識別する
  • 別のアプリケーションで処理された更新データをインポートする際にレコードを紐付ける
ID を有効にできるのは、プロファイルとカスタムリソースに限られます。
  1. プロファイルリソースの拡張機能を作成するか、新規のリソースを作成します。
  2. データ構造の定義で「 Fields 」セクションにある「 Add automatic ID field 」をオンにします。
    新しいレコードだけに ACS ID が付与されます。このオプションを有効にする前は、作成したプロファイルや要素の「 ACS ID 」フィールドは空のままになります。
  3. リソースに加えた変更を保存した後、公開します。API を介して作成した要素に、このメカニズムを適用する場合は、API を拡張するオプションを選択します。
これで、「 ACS ID 」フィールドが使用可能になり、API を介して新しい要素を手動で作成した時点、またはインポートワークフローから挿入した時点で自動的に入力されます。ACS ID フィールドは UUID フィールドとして扱われ、インデックスが付けられます。
プロファイルまたはカスタムリソースのエクスポート時に、そのリソースの ID が有効になっていれば、「 ACS ID 」列を追加することができます。この ID を外部ツールで再利用することにより、レコードの識別が可能になります。
別のアプリケーション(例えば、CRM)で処理/更新されたデータを再インポートするときに、このデータを一意の ID に簡単に紐付けることができます。
このオプションを有効にしない限り、作成したプロファイルや要素の「 ACS ID 」フィールドは更新されません。新しいレコードだけに ACS ID が付与されます。
このフィールドは読み取り専用モードです。変更はできません。