拡張メタデータ (XMD) の概要
データセットの XMD を変更すると、そのデータセットを使用するすべての UI の視覚化に新しい形式が適用されます。次の事項を制御できます。
- 基準の形式
- ディメンションおよび基準の表示ラベル
- 基準のディメンションのグループ化
- 特定の項目の色
- 値テーブルに表示されるデフォルトの列
- ユーザインターフェースでのディメンションおよび基準の非表示
- ユーザが Salesforce オブジェクトのアクションを利用し、Salesforce および外部 Web サイトのレコードへのリンクをたどることができるカスタムメニュー
- 複数組織のデータセットの Salesforce レコードへのリンクがそのレコードの正しい組織インスタンスに解決できるようにする、URL への Salesforce 組織 ID の対応付け。
XMD ファイルは JSON 形式です。XMD ファイルにアクセスするには、対応するデータセットを編集します。[編集] ページから既存の XMD ファイルをダウンロードできます。
XMD の変更および更新についての情報は、XMD 2.0 セクションを参照してください。
拡張メタデータの例
XMD ファイルの形式の例を次に示します。
XMD 2.0
いくつかの XMD 要素が変更され、いくつかの動作も変更されました。Salesforce の開発サークルでは、これらの変更は XMD 1.1 に対して XMD 2.0 として参照されます。
主な変更点は、XMD が JSON ファイルではなく BPO (Base Platform Object: ベースプラットフォームオブジェクト) に保存されるようになったことです。API がこのオブジェクトに対して動作するため、XMD API エンドポイントを使用して XMD ディレクトリを操作できます。
ユーザは依然として JSON ファイルのダウンロードとアップロードを行って独自の変更を有効にすることができます。XMD はその場で変換されます。ただし、この変更には副次的影響もあります。
- XMD はデータセットのバージョンごとに保存されます。
- system XMD は、main.json がアップロードされたとき、または旧バージョンのデータフローで API 経由で GET コールが実行されたときに生成されます。
以前と同様に、main タイプの XMD は、system と user をマージすることで作成されます。user XMD ファイルを変更して、Wave Analytics の多くのダッシュボード要素の形式をカスタマイズできます。
これはどのような意味を持つのでしょうか?
次の表で、XMD 要素の変更点について説明します。変更点のほとんどは新規要素ですが、名前が変更された既存の要素もいくつかあります。これらの要素を使用している場合は、XMD を更新してください。
| 要素 | 次のレベルの要素 | 次のレベルの要素 | 型 | メモ |
|---|---|---|---|---|
| dimensions | ||||
| sfdcActions | List | salesforceActions に名前変更されました。 | ||
| sfdcActionsEnabled | Boolean | salesforceActionsEnabled に名前変更されました。 | ||
| measures | ||||
| format | List | 既存。 | ||
| unitMultiplier | Double | 新規。単位乗数。 | ||
| customFormat | String | 互換性のために保持されています。「[\"\",1]" のような形式の文字列を指定します。 | ||
| dates | label | String | 新規。日付列の表示ラベル。 | |
| fiscalMonthOffset | Integer | 新規。カレンダー年に対する会計年度のオフセット (月数)。 | ||
| firstDayOfWeek | Integer | 新規。週の開始曜日として何を使用するか。 |