wave analytics ダッシュボード json リファレンス¬¬ 1 章 wave analytics...

Wave Analytics ダッシュボード JSON リファレンスバージョン 38.0, Winter ’17

@salesforcedocs最終更新日: 2016/09/09

https://twitter.com/salesforcedocs

本書の英語版と翻訳版で相違がある場合は英語版を優先するものとします。

© Copyright 2000–2016 salesforce.com, inc. All rights reserved. Salesforce およびその他の名称や商標は、salesforce.com,

inc. の登録商標です。本ドキュメントに記載されたその他の商標は、各社に所有権があります。

目次

第 1 章: Wave Analytics ダッシュボード JSON の概要 . . . . . . . . . . . . . . . . . . . . . . . . 1

第 2 章: ダッシュボード JSON ファイルの表示または変更 . . . . . . . . . . . . . . . . . . . 2

第 3 章: Wave デザイナダッシュボードの JSON の例 . . . . . . . . . . . . . . . . . . . . . . . . 4

第 4 章: Classic デザイナダッシュボードの JSON の例 . . . . . . . . . . . . . . . . . . . . . . 19

第 5 章: ダッシュボード JSON プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

gridLayouts (Wave デザイナダッシュボードのみ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24gridLayouts プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

widgetStyle プロパティ (Wave デザイナダッシュボードのみ) . . . . . . . . . . . . . . . . . . . . . 37layouts (Classic デザイナダッシュボードのみ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

ダッシュボードのモバイルレイアウトの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40モバイルレイアウトの列、行、およびセルのサイズ設定について . . . . . . . . . . . . . 42レイアウトの仕様 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44layouts プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54steps プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69widget プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

第 1 章 Wave Analytics ダッシュボード JSON の概要

Wave Analytics でダッシュボードを作成する最も簡単な方法は、デザイナを使用することです。ただし、必要に応じて JSON ファイルを編集することによって、ダッシュボードをさらにカスタマイズできます。JSON では、ダッシュボードのコンポーネントとそのやりとりの方法を定義します。デザイナのユーザインターフェースではできない、次のような高度なカスタマイズタスクを実行するには、ダッシュボードの JSON ファイルを変更します。• 手動でバインドを設定してデフォルトのファセット動作を上書きし、デフォルト

ではバインドされないステップ間のリレーションを手動で指定する。• クエリ制限を設定する。• 値テーブルの列を指定する。• SAQL クエリを指定する。• クエリからではなく、指定した静的値のリストで絞り込みセレクタを設定する。• ダッシュボードのモバイルデバイスのレイアウトを設定する。最後の 3 つのタスクは、Classic デザイナで作成されたダッシュボードにのみ関連します。Wave ダッシュボードデザイナを使用すると、JSON を編集することなく、ユーザインターフェースを使用してこれらのタスクを実行できます。

メモ: このドキュメントでは、情報がいずれかのダッシュボードデザイナにのみ適用される場合にそのことが明記されます。

1

第 2 章ダッシュボード JSON ファイルの表示または変更

エディション

使用可能なエディション:Salesforce Classic およびLightning Experience

有料オプションで使用可能なエディション:Enterprise Edition、Performance Edition、および Unlimited Edition。Developer Edition でも使用可能。

ユーザ権限

ダッシュボードを定義する JSON ファイルを変更するには、以下の手順に従ってください。• 「Wave Analytics ダッ

シュボードの作成および編集」

ダッシュボードまたはレンズの JSON を変更するには、エキスパートエディタモードを使用します。エキスパートエディタモードではレンズまたはダッシュボードの JSON が表示され、実行中のアセットでの編集の効果をすばやく確認できます。1. エキスパートエディタモードにアクセスするには、

編集するレンズまたはダッシュボードを開き、Ctrl+E

キー (PC) または CMD+E キー (Mac) を押します。2. エディタで JSON を変更します。関数の編集や検索

には標準のキーボードショートカットを使用できます。

3. エクスプローラに戻り、JSON への編集がレンズまたはダッシュボードにどう表示されるかを確認するには、[完了] をクリックします。

4. 編集を保持するには、レンズまたはダッシュボードを保存します。JSON で行った変更内容はレンズまたはダッシュボードを明示的に保存するまで保存されません。

エキスパートエディタモードでは、次のショートカットを使用して、基本的な操作をキーボードから実行できます。

説明エキスパートエディタモードのキーボードショートカット

変更を無視して元の JSON を読み込むCRTL+3 (Windows); CMD+3 (Mac)

切り取りCRTL+X (Windows); CMD+X (Mac)

コピーCRTL+C (Windows); CMD+C (Mac)

貼り付けCRTL+V (Windows); CMD+V (Mac)

元に戻すCRTL+Z (Windows); CMD+Z (Mac)

やり直しSHIFT+CRTL+Z (Windows); SHIFT+CMD+Z (Mac)

検索 (正規表現の検索、大文字と小文字を区別する検索、単語単位の検索を使用可能)

CRTL+F (Windows); CMD+F (Mac)

2

説明エキスパートエディタモードのキーボードショートカット

JSON が変更されたダッシュボードを表示する

CRTL+E (Windows); CMD+E (Mac)

3

ダッシュボード JSON ファイルの表示または変更

第 3 章 Wave デザイナダッシュボードの JSONの例

各 Wave デザイナダッシュボードの JSON には、複数レベルのプロパティが含まれます。プロパティを設定する場所を理解するため、JSON の構造を確認してください。

メモ: JSON の構造は、ダッシュボードの作成に Wave デザイナとClassic デザイナのどちらを使用するかによって異なります。

例:

{"label": "Opportunity Overview","description": "Sample Wave designer dashboard with multiple

layouts.","state": {

"gridLayouts": [{

"name": "Default","numColumns": 12,"pages": [

{"widgets": [

{"colspan": 3,"column": 3,"name": "container_1","row": 1,"rowspan": 6,"widgetStyle": {

"backgroundColor": "#FFFFFF",

"borderColor": "#9687BB","borderEdges": [

"top"],"borderRadius": 0,"borderWidth": 8

}},{

"colspan": 12,"column": 0,"name": "text_2","row": 0,"rowspan": 1,"widgetStyle": {


"borderColor": "#77B0AD","borderEdges": [],"borderRadius": 0,

4

"borderWidth": 8}

},{

"colspan": 3,"column": 0,"name": "container_4","row": 1,"rowspan": 6,"widgetStyle": {


"borderColor": "#77B0AD","borderEdges": [


}},{


"borderEdges": []}

},{


"borderEdges": []}

},{

"colspan": 3,"column": 0,"name": "number_1","row": 2,"rowspan": 2,"widgetStyle": {

"borderEdges": []}

},{

"colspan": 3,"column": 3,"name": "number_2",

5

Wave デザイナダッシュボードの JSON の例

"row": 2,"rowspan": 2,"widgetStyle": {

"borderEdges": []}

},{

"colspan": 3,"column": 0,"name": "chart_1","row": 4,"rowspan": 3,"widgetStyle": {

"borderEdges": []}

},{


"borderEdges": []}

},{


"borderEdges": []}

}]

}],"selectors": [],"style": {

"alignmentX": "left","alignmentY": "top","backgroundColor": "#F2F6FA","cellSpacingX": 8,"cellSpacingY": 8,"documentId": "","fit": "original"

},"version": 1

},{

"name": "Tablet","numColumns": 8,

6


"selectors": ["minWidth(600)","maxWidth(900)","orientation(portrait)"

],"pages": [

{"widgets": [

{"colspan": 7,"column": 0,"name": "text_2","row": 0,"rowspan": 1,"widgetStyle": {


"borderColor": "#77B0AD","borderEdges": [],"borderRadius": 0,"borderWidth": 8

}},{


"borderEdges": []}

},{


"borderEdges": []}

},{


"borderEdges": []}

},{

7




"borderColor": "#77B0AD","borderEdges": [


}},{


"borderEdges": []}

},{


"borderEdges": []}

},{


"borderEdges": []}

},{



8


"borderColor": "#9687BB","borderEdges": [


}},{


"borderEdges": []}

}]

}],"version": 1,"style": {

"backgroundColor": "#C5D3E0","cellSpacingX": 4,"cellSpacingY": 4,"documentId": "","fit": "original","alignmentX": "left","alignmentY": "top"

},"maxWidth": 500

}],"layouts": [],"steps": {

"LeadSource_6": {"datasets": [

{"id": "0Fbx000000000LzCAI","label": "Opportunities","name": "opportunity1","url":

"/services/data/v38.0/wave/datasets/0Fbx000000000LzCAI"}

],"isFacet": true,"isGlobal": false,"query": {

"measures": [[

"sum","Amount"

9


]],"groups": [

"LeadSource"]

},"type": "aggregate","useGlobal": true,"visualizationParameters": {

"visualizationType": "hbar","options": {}

}},"LeadSource_7": {

"datasets": [{

"id": "0Fbx000000000LzCAI","label": "Opportunities","name": "opportunity1","url":



"measures": [[

"sum","Amount"

]],"groups": [

"LeadSource"]



}},"CreatedDate_Year_CreatedDate_Month_9": {

"datasets": [{



],"isFacet": true,

10


"isGlobal": false,"query": {

"measures": [[

"sum","Amount","A",{

"display": "Sum of Amount"}

],[

"sum","Amount","B",{

"display": "Running Total","format": "currencydollars"

}]

],"columns": [

{"query": {

"measures": [[

"sum","Amount"

]],"groups": [

["CreatedDate_Year","CreatedDate_Month"

]]

}},{

"query": {"measures": [

["sum","Amount"

]],"groups": [


]],"formula": "avg(A) over ([-1..0]

partition by all order by

11


('CreatedDate_Year~~~CreatedDate_Month'))"},"format": "currencydollars","header": "Running Total"

}],"groups": [


]]

},"selectMode": "single","type": "aggregate","useGlobal": true,"visualizationParameters": {


}},"Account_Industry_4": {

"datasets": [{




"measures": [[

"sum","Amount"

]],"groups": [

"Account.Industry"]


"visualizationType": "pie","options": {}

}},"Amount_3": {

"datasets": [{

12





"measures": [[

"sum","Amount"

]]



}}

},"widgetStyle": {

"backgroundColor": "#FFFFFF","borderColor": "#77B0AD","borderEdges": [


},"widgets": {

"container_1": {"parameters": {

"alignmentX": "left","alignmentY": "top","documentId": "","fit": "original"

},"type": "container"

},"number_2": {

"parameters": {"compact": true,"exploreLink": true,"measureField": "sum_Amount","numberColor": "#335779","numberSize": 32,"step": "LeadSource_6","textAlignment": "center","titleColor": "#335779",

13


"titleSize": 16},"type": "number"

},"number_1": {

"parameters": {"compact": true,"exploreLink": true,"measureField": "sum_Amount","numberColor": "#335779","numberSize": 32,"step": "Amount_3","textAlignment": "center","titleColor": "#335779","titleSize": 16

},"type": "number"

},"text_1": {

"parameters": {"fontSize": 20,"text": "Industry","textAlignment": "center","textColor": "#000000"

},"type": "text"

},"container_4": {

"parameters": {"alignmentX": "left","alignmentY": "top","documentId": "","fit": "original"

},"type": "container"

},"text_3": {

"parameters": {"fontSize": 20,"text": "Lead Source","textAlignment": "center","textColor": "#000000"

},"type": "text"

},"text_2": {

"parameters": {"fontSize": 20,"text": "Opportunity Overview Dashboard","textAlignment": "center","textColor": "#000000"

},"type": "text"

},

14


"chart_5": {"parameters": {

"autoFitMode": "fit","showValues": true,"barSize": 25,"legend": {

"showHeader": true,"show": true,"position": "bottom-center","inside": false

},"axisMode": "multi","visualizationType": "stackhbar","exploreLink": true,"title": {

"label": "","align": "center","subtitleLabel": ""

},"trellis": {

"enable": false,"type": "x","chartsPerLine": 4

},"measureAxis2": {

"showTitle": true,"showAxis": true,"title": ""

},"measureAxis1": {


},"normalize": false,"step":

"CreatedDate_Year_CreatedDate_Month_9","theme": "wave","autoFit": false,"dimensionAxis": {


}},"type": "chart"

},"chart_2": {

"parameters": {"legend": {

"showHeader": true,"show": true,"position": "right-top","inside": false

15


},"showMeasureTitle": false,"showTotal": true,"visualizationType": "pie","step": "LeadSource_7","theme": "wave","exploreLink": true,"title": {


},"trellis": {


},"inner": 50

},"type": "chart"

},"chart_1": {

"parameters": {"autoFitMode": "fit","showValues": true,"barSize": 25,"legend": {

"showHeader": true,"show": true,"position": "right-top","inside": false

},"axisMode": "multi","visualizationType": "hbar","exploreLink": true,"title": {


},"trellis": {


},"measureAxis2": {


},"measureAxis1": {

"showTitle": false,"showAxis": true,"title": ""

16


},"step": "Account_Industry_4","theme": "wave","autoFit": false,"dimensionAxis": {

"showTitle": true,"showAxis": true,"title": "Industries"

}},"type": "chart"

}}

},"datasets": [

{"id": "0Fbx000000000LzCAI","label": "Opportunities","name": "opportunity1","url":


]}

この JSON ファイルは、Wave デザイナで作成された次のダッシュボードを定義します。

このダッシュボードには次のウィジェットが表示されます。• ファセットされた 2 つの数値ウィジェット: number_1 (ステップ Amount_3

に基づく) と number_2 (ステップ LeadSource_6 に基づく)。• ファセットされた 3 つのグラフウィジェット: 1 つの棒グラフ chart_5 (ス

テップ Account_Industry_4 に基づく)、1 つの円グラフ chart_2 (ステップ LeadSource_7 に基づく)、および 1 つの積み上げ棒グラフ chart_5 (ステップ CreatedDate_Year_CreatedDate_Month_9 に基づく)。これらのステップは同じ 0Fbx000000000LzCAI データセットを参照します。

17


• 2 つのコンテナウィジェット (container_1 と container_4)。各コンテナウィジェットで数値ウィジェットとグラフをグループ化します。

• 2 つのテキストウィジェット (text_1と text_3)。コンテナのラベルを提供します。

18


第 4 章 Classic デザイナダッシュボードの JSONの例

各 Classic デザイナダッシュボードの JSON には、複数レベルのプロパティが含まれます。プロパティを設定する場所を理解するため、JSON の構造を確認してください。

メモ: JSON の構造は、ダッシュボードの作成に Wave デザイナとClassic デザイナのどちらを使用するかによって異なります。

例:

{"description": "Shows opportunities by industry.","label" : "Opportunities","folder" : {

"id" : "00l36000000SpXiAAK"},"state": {"steps": {"AccountIndustryPieChart": {"type": "aggregate","isGlobal": false,"isFacet": true,"useGlobal": true,"selectMode": "single","start": null,"visualizationParameters": {"visualizationType": "pie"

},"query": {"query":

"{\"groups\":[\"AccountId.Industry\"],\"measures\":[[\"count\",\"*\"]]}",

"version": -1},"datasets": [{"name": "Opps"

}]

},"AccountIndustryBarChart": {"type": "aggregate","isGlobal": false,"isFacet": true,"useGlobal": true,"selectMode": "single","start": null,"visualizationParameters": {"options": {"sqrt": true

},

19

"visualizationType": "hbar"},"query": {"query":

"{\"measures\":[[\"sum\",\"Amount\"]],\"groups\":[\"AccountId.Industry\"],\"order\":[[-1,{\"ascending\":false}]]}",

"version": -1},"datasets": [{"name": "Opps"

}]

}},"widgets": {"chart_1": {"type": "chart","position": {"zIndex": 3,"x": 10,"y": 80,"w": 500,"h": 300

},"parameters": {"step": "AccountIndustryPieChart","legend": true,"visualizationType": "pie"

}},"text_1": {"type": "text","position": {"zIndex": 4,"x": 0,"y": 10

},"parameters": {"text": "Account Industries","textAlignment": "left"

}},"text_4": {"type": "text","position": {"zIndex": 11,"x": 500,"y": 10

},"parameters": {"text": "Amount by Industries"

}},

20

Classic デザイナダッシュボードの JSON の例

"chart_4": {"type": "chart","position": {"zIndex": 12,"x": 530,"y": 70,"w": 500,"h": 300

},"parameters": {"step": "AccountIndustryBarChart","sqrt": true,"visualizationType": "vbar"

}}

}}

}

このダッシュボード JSON ファイルは、Classic デザイナで作成される単純なダッシュボードを定義します。このダッシュボードには、1 つの円グラフ chart_1

(ステップ AccountIndustryPieChart に基づく) と 1 つの棒グラフ chart_4

(ステップ AccountIndustryBarChart に基づく) の 2 つのファセットされたウィジェットが表示されます。両方のステップは同じ Opps データセットを参照します。

21

Classic デザイナダッシュボードの JSON の例

第 5 章ダッシュボード JSON プロパティ

ダッシュボード JSON は、レイアウト、ウィジェット、およびステップを定義するプロパティで構成されます。キーにより、Wave デザイナダッシュボードのすべてのレイアウトが定義されます。各レイアウトの個別のノードが含まれます。各レイアウトには、レイアウトを使用できるデバイス、およびレイアウト内の各ウィジェットの配置に関する情報を提供するプロパティがあります。また、グリッドのセルのスペーシングやダッシュボードの背景色または背景画像などのダッシュボードのプロパティも含まれます。

トピック:

• gridLayouts (Wave デザイナダッシュボードのみ)

• widgetStyle プロパティ (Wave デザイナダッシュボードのみ) 一部のプロパティは公開され、ダッシュボードデザイナのユーザインターフェース

で編集できます。他のパラメータは JSON を介してのみ編集できます。• layouts (Classic デザイナダッシュボードのみ)

ダッシュボード JSON ごとに、次の概要プロパティがあります。

詳細プロパティ名• steps

型String

label• widgets

ダッシュボードデザイナのユーザインターフェースで公開はい

説明ダッシュボードの名前。

型String

description


説明ダッシュボードの説明。

型Array

state

ダッシュボードデザイナのユーザインターフェースで公開いいえ

説明ダッシュボードに定義されているすべてのレイアウト、ウィジェット、およびステップのプロパティを指定します。state プロパティは、ダッシュボードの保存に使用したデザイナによって異なります。たとえば、ダッシュボードがWave ダッシュボー

22

詳細プロパティ名

ドデザイナで保存された場合、state には gridLayoutsセクションも含まれます。ダッシュボードデザイナを使用してダッシュボードを保存すると、ダッシュボードの状態が JSON で保持されます。

型Array

datasets


説明ダッシュボードのステップで使用されるすべてのデータセットを指定します。

次のセクションでは、stateでネストされる各種プロパティについて説明します。

23

ダッシュボード JSON プロパティ

gridLayouts (Wave デザイナダッシュボードのみ)

gridLayouts セクションでは、ダッシュボード用に作成されるすべてのレイアウトを定義します。Wave デザイナダッシュボードのレイアウトについての詳細は、「Generate Unique Dashboard Layouts for Different

Devices」を参照してください。Classic デザイナダッシュボードのレイアウトについての詳細は、「layouts (Classic

デザイナダッシュボードのみ)」を参照してください。

例:

"gridLayouts": [{"name": "Default","numColumns": 12,"pages": [{"widgets": [{"colspan": 3,"column": 3,"name": "container_1","row": 1,"rowspan": 6,"widgetStyle": {"backgroundColor": "#FFFFFF","borderColor": "#9687BB","borderEdges": ["top"],"borderRadius": 0,"borderWidth": 8}}, {"colspan": 12,"column": 0,"name": "text_2","row": 0,"rowspan": 1,"widgetStyle": {"backgroundColor": "#FFFFFF","borderColor": "#77B0AD","borderEdges": [],"borderRadius": 0,"borderWidth": 8}}, {"colspan": 3,"column": 0,"name": "container_4","row": 1,"rowspan": 6,"widgetStyle": {"backgroundColor": "#FFFFFF","borderColor": "#77B0AD","borderEdges": ["top"],

24

gridLayouts (Wave デザイナダッシュボードのみ)ダッシュボード JSON プロパティ

https://help.salesforce.com/apex/HTViewHelpDoc?id=%20bi_dashboard_layout_select_flex.htm&language=ja


"borderRadius": 0,"borderWidth": 8}}, {"colspan": 3,"column": 0,"name": "text_1","row": 1,"rowspan": 1,"widgetStyle": {"borderEdges": []}}, {"colspan": 3,"column": 3,"name": "text_3","row": 1,"rowspan": 1,"widgetStyle": {"borderEdges": []}}, {"colspan": 3,"column": 0,"name": "number_1","row": 2,"rowspan": 2,"widgetStyle": {"borderEdges": []}}, {"colspan": 3,"column": 3,"name": "number_2","row": 2,"rowspan": 2,"widgetStyle": {"borderEdges": []}}, {"colspan": 3,"column": 0,"name": "chart_1","row": 4,"rowspan": 3,"widgetStyle": {"borderEdges": []}}, {"colspan": 3,"column": 3,"name": "chart_2","row": 4,"rowspan": 3,

25


"widgetStyle": {"borderEdges": []}}, {"colspan": 6,"column": 6,"name": "chart_5","row": 1,"rowspan": 6,"widgetStyle": {"borderEdges": []}}]}],"selectors": [],"style": {"alignmentX": "left","alignmentY": "top","backgroundColor": "#F2F6FA","cellSpacingX": 8,"cellSpacingY": 8,"documentId": "","fit": "original"},"version": 1}, {"name": "Tablet","numColumns": 8,"selectors": ["minWidth(600)","maxWidth(900)","orientation(portrait)"],"pages": [{"widgets": [{"colspan": 7,"column": 0,"name": "text_2","row": 0,"rowspan": 1,"widgetStyle": {"backgroundColor": "#FFFFFF","borderColor": "#77B0AD","borderEdges": [],"borderRadius": 0,"borderWidth": 8}}, {"colspan": 3,"column": 0,"name": "text_1","row": 1,"rowspan": 1,"widgetStyle": {

26


"borderEdges": []}}, {"colspan": 3,"column": 0,"name": "number_1","row": 2,"rowspan": 2,"widgetStyle": {"borderEdges": []}}, {"colspan": 3,"column": 0,"name": "chart_1","row": 4,"rowspan": 3,"widgetStyle": {"borderEdges": []}}, {"colspan": 4,"column": 0,"name": "container_4","row": 1,"rowspan": 6,"widgetStyle": {"backgroundColor": "#FFFFFF","borderColor": "#77B0AD","borderEdges": ["top"],"borderRadius": 0,"borderWidth": 8}}, {"colspan": 3,"column": 4,"name": "text_3","row": 1,"rowspan": 1,"widgetStyle": {"borderEdges": []}}, {"colspan": 3,"column": 4,"name": "number_2","row": 2,"rowspan": 2,"widgetStyle": {"borderEdges": []}}, {

27


"colspan": 3,"column": 4,"name": "chart_2","row": 4,"rowspan": 3,"widgetStyle": {"borderEdges": []}}, {"colspan": 4,"column": 4,"name": "container_1","row": 1,"rowspan": 6,"widgetStyle": {"backgroundColor": "#FFFFFF","borderColor": "#9687BB","borderEdges": ["top"],"borderRadius": 0,"borderWidth": 8}}, {"colspan": 8,"column": 0,"name": "chart_5","row": 7,"rowspan": 6,"widgetStyle": {"borderEdges": []}}]}],"version": 1,"style": {"backgroundColor": "#C5D3E0","cellSpacingX": 4,"cellSpacingY": 4,"documentId": "","fit": "original","alignmentX": "left","alignmentY": "top"},"maxWidth": 500}]

gridLayouts プロパティgridLayouts キーは、Wave デザイナダッシュボードのすべてのレイアウトを定義します。各レイアウトの個別のノードが含まれます。各レイアウトには、レイアウトを使用できるデバイス、およびレイアウト内の各ウィジェットの配置に関する情報を提供するプロパティがあります。また、グリッドのセルのスペーシングやダッシュボードの背景色または背景画像などのダッシュボードのプロパティも含まれます。

28


gridLayouts プロパティgridLayoutsキーは、Wave デザイナダッシュボードのすべてのレイアウトを定義します。各レイアウトの個別のノードが含まれます。各レイアウトには、レイアウトを使用できるデバイス、およびレイアウト内の各ウィジェットの配置に関する情報を提供するプロパティがあります。また、グリッドのセルのスペーシングやダッシュボードの背景色または背景画像などのダッシュボードのプロパティも含まれます。


型String

name

ダッシュボードデザイナのユーザインターフェースで公開はい。

説明レイアウトの名前。

ダッシュボードが使用可能な最大幅 (ピクセル単位)。必要な場合は Wave で、レイアウトのこの設定に基づいて、既存のダッシュボードウィジェットが再配置されます。

maxWidth

型Integer

numColumns

ダッシュボードデザイナのユーザインターフェースで公開はい。

説明レイアウトの列数。

型Array

pages


説明ダッシュボードレイアウトでの各ウィジェットの配置を決定するプロパティが含まれます。現在、Wave デザイナではレイアウトごとに 1 ページのみがサポートされています。

型Array

selectors

ダッシュボードデザイナのユーザインターフェースで公開はい。レイアウトを設定するときに、セレクタを選択できます。

説明タイミングを決定するセレクタのプロパティのリスト。

29

gridLayouts プロパティダッシュボード JSON プロパティ


型Array

style

ダッシュボードデザイナのユーザインターフェースで公開はい。レイアウトを設定するときに、セレクタを選択できます。

説明タイミングを決定するセレクタのプロパティのリスト。

version

pages プロパティpages キーには、Wave デザイナダッシュボードレイアウトでの各ウィジェットの配置を決定するプロパティが含まれます。現在、Wave デザイナではレイアウトごとに 1 ページのみがサポートされています。selectors プロパティselectorsキーには、レイアウト名、デザイナグリッド設定、背景設定、およびこのレイアウトを使用できるデバイスの要件を指定するレイアウトプロパティが含まれます。style プロパティstyle キーには、グリッドのセルのスペーシングやダッシュボードの背景色または背景画像などのダッシュボードのプロパティが含まれます。

pages プロパティpages キーには、Wave デザイナダッシュボードレイアウトでの各ウィジェットの配置を決定するプロパティが含まれます。現在、Wave デザイナではレイアウトごとに 1 ページのみがサポートされています。


型Array

widgets


説明各ウィジェットの高さと幅、およびダッシュボードレイアウト上での配置場所を決定するプロパティが含まれます。

widgets プロパティwidgetsキーには、各ウィジェットの高さと幅、およびダッシュボードレイアウト上での配置場所を決定するプロパティが含まれます。Wave ダッシュボードデザイナではグリッドを使用するため、行と列に関するプロパティを指定します。たとえば、列数を指定してウィジェットの幅を決定します。

30


widgets プロパティwidgets キーには、各ウィジェットの高さと幅、およびダッシュボードレイアウト上での配置場所を決定するプロパティが含まれます。Wave ダッシュボードデザイナではグリッドを使用するため、行と列に関するプロパティを指定します。たとえば、列数を指定してウィジェットの幅を決定します。


型String

name


説明ウィジェットの内部名。この名前は、ダッシュボード JSON でウィジェットを参照するときに使用します。

型Integer

column

ダッシュボードデザイナのユーザインターフェースで公開はい。値は、ウィジェットの配置に基づいて決まります。

説明ウィジェットが開始する列番号。Column と row によってウィジェットの左上隅を指定します。

メモ: このウィジェットがコンテナに含まれている場合、これらのプロパティはコンテナウィジェットに対して相対的です。

型Integer

row


説明ウィジェットが開始する行番号。Column と row によってウィジェットの左上隅を指定します。

型Integer

colspan


説明ウィジェットがまたがる列数。ウィジェットの幅。ダッシュボードに指定された幅を表示するのに十分な列数がない場合、そのダッシュボードに列が追加されます。

31



型Integer

rowspan


説明ウィジェットがまたがる行数。ウィジェットの高さ。ダッシュボードに指定された高さを表示するのに十分な行数がない場合、行が追加されます。

型Array

widgetStyle

次のウィジェットで使用可能• すべてのウィジェット


説明境界線の種類、境界線の色、および背景色を設定するプロパティが含まれます。

widgetStyle プロパティwidgetStyleキーには、ウィジェットの境界線の種類、境界線の色、および背景色を設定するプロパティが含まれます。これらの属性は 2 つのレベルで指定できます。すべてのダッシュボードウィジェットのデフォルトを設定するには、gridLayoutsの widgetStyle項目を使用します。特定のウィジェットを設定するには、widgets の widgetStyle 項目を使用します。すべてのウィジェットで、この設定はデフォルト設定よりも優先されます。

widgetStyle プロパティ

widgetStyle キーには、ウィジェットの境界線の種類、境界線の色、および背景色を設定するプロパティが含まれます。これらの属性は 2 つのレベルで指定できます。すべてのダッシュボードウィジェットのデフォルトを設定するには、gridLayoutsの widgetStyle項目を使用します。特定のウィジェットを設定するには、widgets の widgetStyle 項目を使用します。すべてのウィジェットで、この設定はデフォルト設定よりも優先されます。


型String

backgroundColor

次のウィジェットで使用可能すべてのウィジェット

32




説明ウィジェットの背景色。デフォルトは、#FFFFFF です。

型String

borderColor



説明ウィジェットの境界線の色。デフォルトは、#FFFFFF です。

型List

borderEdges



説明ウィジェットのどの辺に境界線を表示するかを指定する値のリスト。有効な値は、left、right、top、bottom、および all です。デフォルトは境界線なしです。

型Integer

borderRadius

このウィジェットで使用可能すべてのウィジェット


説明境界線の角の丸み。有効な値は、0 (丸みなし、デフォルト)、4、8、16 です。値が大きいほど角が丸くなります。

型Integer

borderWidth

33





説明ウィジェットの境界線の幅。有効な値は、1、2 (デフォルト)、4、8 です。

selectors プロパティselectors キーには、レイアウト名、デザイナグリッド設定、背景設定、およびこのレイアウトを使用できるデバイスの要件を指定するレイアウトプロパティが含まれます。


型Integer

minWidth(<width>)


説明このレイアウトでサポートされるデバイスの最小幅 (ピクセル)。

型Integer

maxWidth(<width>)


説明このレイアウトでサポートされるデバイスの最大幅 (ピクセル)。

型String

orientation(<orientation>


説明このレイアウトでサポートされるデバイスの方向。有効な値は、portrait またはlandscapeです。このプロパティが指定されていない場合、レイアウトは両方の方向をサポートします。

34



型String

platform(<platform>)


説明このレイアウトでサポートされるデバイスのプラットフォーム。有効な値は、iOS

または Androidです。このプロパティが指定されていない場合、レイアウトは両方のプラットフォームをサポートします。

style プロパティstyle キーには、グリッドのセルのスペーシングやダッシュボードの背景色または背景画像などのダッシュボードのプロパティが含まれます。


型String

alignmentX


説明ダッシュボードに適用される背景画像の横方向の配置。有効な値は、left (デフォルト)、center、および right です。

型String

alignmentY


説明ダッシュボードに適用される背景画像の縦方向の配置。有効な値は、top (デフォルト)、center、および bottom です。

型String

backgroundColor


35



説明16 進数の色コードで指定されるダッシュボードの背景色。デフォルトは、#FFFFFF

です。

型Integer

cellSpacingX


説明ダッシュボードグリッドのセル間の横方向の間隔 (ピクセル単位)。有効な値は、0、4、8 (デフォルト)、16 です。

型Integer

cellSpacingY


説明ダッシュボードグリッドのセル間の縦方向の間隔 (ピクセル単位)。有効な値は、0、4、8 (デフォルト)、16 です。

型String

documentId


説明ダッシュボードの背景として適用する画像の 15 文字のドキュメント ID。セキュリティを保護するため、画像ファイルはドキュメントとして Salesforce にアップロードし、[外部参照可]オプションを選択します。このオプションが選択されていない場合や参照先ドキュメントが画像でない場合は、画像が表示されません。

型String

fit


説明画像のサイズを変更する方法を指定します。有効な値は、original (デフォルト)、stretch、tile、fitwidth、fitheightです。

36


widgetStyle プロパティ (Wave デザイナダッシュボードのみ)

widgetStyle キーには、各ウィジェットに適用できるデフォルトのウィジェットプロパティが含まれます。このセクションは、Wave ダッシュボードデザイナを使用して作成されたダッシュボードにのみ適用されます。

メモ: これらの属性は 2 つのレベルで指定できます。すべてのダッシュボードウィジェットのデフォルトを設定するには、gridLayouts の widgetStyle 項目を使用します。特定のウィジェットを設定するには、widgets の widgetStyle 項目を使用します。ウィジェットレベルの設定はすべてのウィジェットのデフォルト設定を上書きします。


型String

backgroundColor



説明16 進数の色コードで指定されるウィジェットの背景の色。デフォルトは、#FFFFFF

です。

型String

borderColor



説明16 進数の色コードで指定されるウィジェットの境界線の色。デフォルトは、#FFFFFF

です。境界線を指定しない場合、ウィジェットには境界線が表示されません。

型List

borderEdges



説明ウィジェットのどの辺に境界線を表示するかを指定する値のリスト。有効な値は、left、right、top、bottom、および all です。デフォルトは境界線なしです。

37

widgetStyle プロパティ (Wave デザイナダッシュボードのみ)



型Integer

borderRadius



説明境界線の角の丸み。有効な値は、0 (丸みなし、デフォルト)、4、8、16 です。値が大きいほど角が丸くなります。

型Integer

borderWidth



説明境界線の太さ。有効な値は、1、2 (デフォルト)、4、8 です。値が大きいほど境界線が太くなります。

layouts (Classic デザイナダッシュボードのみ)

JSON に layouts セクションを追加して、モバイルデバイスでのClassic デザイナダッシュボードの外観をカスタマイズします。

メモ: Wave デザイナダッシュボードのレイアウトについての詳細は、「Generate Unique Dashboard Layouts for

Different Devices」を参照してください。モバイルデバイスの Classic デザイナダッシュボードレイアウトには 2 つの種類があります。絶対 (デフォルト)

ダッシュボードの JSON で layouts セクションが定義されていない場合、ダッシュボードのレイアウトは絶対です。絶対レイアウトは、デスクトップまたはラップトップコンピュータの Web ブラウザでの表示に合わせて最適化されます。

モバイルダッシュボードの JSON に layoutsセクションがある場合、ダッシュボードのレイアウトはモバイルです。

38

layouts (Classic デザイナダッシュボードのみ)ダッシュボード JSON プロパティ



モバイルレイアウトでは、モバイルデバイスでの表示に合わせてダッシュボードのウィジェットの位置、順序、およびサイズを最適化できます。このレイアウトは、行、列、セル、ページで構成されます。グリッド内の各セルには 0 個以上のウィジェットを含めることができます。モバイルレイアウト内の行数、列数、およびセル数は、ウィジェット数とページ数によって異なります。

絶対レイアウトのダッシュボードは Web ブラウザに適しています。

同じ絶対レイアウトのダッシュボードは、スマートフォンでは適切に表示されない可能性があります。

2 つのページでモバイルレイアウトを使用すると、スマートフォンでダッシュボードが完璧に表示されます。

39

layouts (Classic デザイナダッシュボードのみ)ダッシュボード JSON プロパティ

ダッシュボードのモバイルレイアウトの使用モバイルレイアウトを使用して、モバイルデバイスのダッシュボードの外観をカスタマイズします。モバイルレイアウトの列、行、およびセルのサイズ設定についてウィジェットのサイズ、行のサイズ、および列の数は動的に決定されますが、JSON で指定することもできます。レイアウトの仕様layoutsセクションは、モバイルデバイスのダッシュボードの表示方法をカスタマイズするために使用されます。layouts プロパティlayoutsキーでは、モバイルレイアウトの各ウィジェットの位置、順序、およびサイズを指定します。このレイアウトは、行、列、セル、ページで構成されます。グリッド内の各セルには 0 個以上のウィジェットを含めることができます。モバイルレイアウト内の行数、列数、およびセル数は、ウィジェット数とページ数によって異なります。

ダッシュボードのモバイルレイアウトの使用モバイルレイアウトを使用して、モバイルデバイスのダッシュボードの外観をカスタマイズします。ダッシュボードの JSON ファイルの layoutsセクションは、stateセクションの子で、widgetsおよび steps

セクションの兄弟です。1. 開いているダッシュボードから、CTRL+E (PC) または CMD+E キー (Mac) を押します。これにより、エキスパー

トエディタモードが開きます。詳細は、「ダッシュボード JSON ファイルの表示または変更」を参照してください。

2. ダッシュボードの JSONに layouts セクションを追加します。

40

ダッシュボードのモバイルレイアウトの使用ダッシュボード JSON プロパティ

たとえば、この layouts セクションでは、各ページに 2 行のウィジェットがある 2 ページのモバイルレイアウトを定義します。1 番目のページには、各行に 1 つのウィジェットがあります。2 番目のページには、1 行目に 2 つのウィジェットがあり、2 行目に 1 つのウィジェットがあります。"layouts": [{"device": "default","pages": [{"rows": ["buttongroup_2","chart_1"

]},{"rows": ["dimfilter_1 | dimfilter_3","chart_1"

]}

],"version": 1

}

3. 必要に応じて、各ウィジェットおよび行の属性を設定することによってダッシュボードのレイアウトをカスタマイズしてください。たとえば、ステップ 2 の layoutsをウィジェットや行の属性を含めるように変更できます。最初のページの最初の行の高さは 300 ピクセルです。2 番目のページのグラフウィジェットには、2 つの列の幅があります。"layouts": [{"device": "default","pages": [{"rows": ["buttongroup_2 | row:{height=300}","chart_1"

]},{"rows": ["dimfilter_1 | dimfilter_3","chart_1 {colspan=2}"

]}

],"version": 1

}

4. 必要に応じて、ダッシュボードにデバイス固有および方向固有のレイアウトを設定します。使用できるデバイスおよび方向に関するオプションについては、「レイアウトの仕様」の「レイアウトオプション」を参照してください。

41

ダッシュボードのモバイルレイアウトの使用ダッシュボード JSON プロパティ

たとえば、ステップ 3 の layouts は、iPad で画面が横向きのときに 1 ページだけ使用するように変更できます。"layouts": [{"device": "default","pages": [{"rows": ["buttongroup_2 | row:{height=300}","chart_1"

]},{"rows": ["dimfilter_1 | dimfilter_3","chart_1 {colspan=2}"

]}

],"version": 1

},{"device": "ipad","orientation": "landscape","pages": [{"rows": ["dimfilter_1 | dimfilter_3 | buttongroup_2","chart_1 {colspan=3}"

]}

],"version": 1

}

5. [ランタイムに切り替え] をクリックして更新されたダッシュボードを保存します。6. モバイルデバイスでダッシュボードを表示してダッシュボードの新しいモバイルレイアウトをテストしま

す。

関連トピック:

layouts プロパティレイアウトの仕様

モバイルレイアウトの列、行、およびセルのサイズ設定についてウィジェットのサイズ、行のサイズ、および列の数は動的に決定されますが、JSON で指定することもできます。

42

モバイルレイアウトの列、行、およびセルのサイズ設定について


列の数とサイズの設定方法モバイルレイアウトの列の数は、行のウィジェットの数に相当します。各行に 3 つのウィジェットがある場合、ダッシュボードには 3 つの列があります。モバイルレイアウトに 2 つの行があり、最初の行に 4 つのウィジェット、2 番目の行に 5 つのウィジェットがある場合、ダッシュボードには 5 つの列があります。colspan

属性で、どの行のウィジェット数よりも多い列数を指定すると、colspan 属性に合わせてダッシュボードに列が追加されます。たとえば、次の layouts セクションがあるダッシュボードでは、最初のページに 3 つの列、2 番目のページに 2 つの列があります。"layouts": [{"device": "default","pages": [{"rows": ["buttongroup_2","chart_1 {colspan=3}"

]},{"rows": ["dimfilter_1 | dimfilter_3","chart_1"

]}

],"version": 1

}

モバイルレイアウト内の列数を決定する場合には、次のヒントを考慮してください。• どの列の幅も同じです。ダッシュボードに 4 つの列がある場合、各列の幅は、2 つの列があるダッシュボー

ドの半分になります。• 表示される列数は、ダッシュボードのページごとに独立して決まります。たとえば、ダッシュボードの最

初のページに 3 つの列、2 番目のページに 4 つの列を表示できます。• 各ダッシュボードには少なくとも 1 つの列があります。• ダッシュボードの列数に制限はありません。追加した列数が多すぎると、列の幅が実用に耐えないほど小

さくなることがあります。必ずレイアウトの使いやすさをテストしてください。

行の数と高さの設定方法次に、各行の高さの計算方法を示します。• height 属性を使用して行の高さを設定する場合、行の高さは指定した値になります。• 行の 1 つ以上のウィジェットに優先される高さがある場合、行の高さは、優先される高さで最も高い高さ

になります。• height 属性がなく、行のウィジェットに優先される高さがない場合、行の高さは使用可能なスペースを

埋めるように動的に拡張されます。複数の行が動的に拡張される場合、それぞれの高さは同じになります。

43

モバイルレイアウトの列、行、およびセルのサイズ設定について


たとえば、使用可能なスペースが 200 ピクセルで、動的に高さが設定される行が 2 つある場合、各行の高さは 100 ピクセルになります。

ウィジェットのサイズ変更方法サイズが固定されているウィジェットもあれば、動的に拡大縮小するウィジェットもあります。

高さの拡大縮小動作幅の拡大縮小動作高さが固定されているか?

幅が固定されているか?

ウィジェット

拡大縮小なし拡大縮小なしはいはいリンク

テキストに合わせて拡大縮小

テキストに合わせて拡大縮小

1 行の場合は「はい」。複数行の場合は「いいえ」。

いいえテキスト

拡大縮小なし拡大縮小はいいいえPillbox

拡大縮小拡大縮小いいえいいえボックス

拡大縮小拡大縮小いいえいいえグラフ

拡大縮小なし拡大縮小はいいいえリストセレクタ

拡大縮小なし拡大縮小はいいいえ範囲セレクタ

拡大縮小なし拡大縮小はいいいえ数値

レイアウトの仕様layouts セクションは、モバイルデバイスのダッシュボードの表示方法をカスタマイズするために使用されます。ダッシュボードの JSON ファイルの layoutsセクションは、stateセクションの子で、widgetsおよび steps

セクションの兄弟です。次に、典型的な layouts セクションの例を示します。"layouts": [{"device": "default","pages": [{"rows": ["widget_name_1","widget_name_2"

]},{"rows": ["widget_name_3 | widget_name_4","widget_name_2 {attribute=2}"

44

レイアウトの仕様ダッシュボード JSON プロパティ

]}

],"version": 1

},{"device": "ipad","orientation": "landscape","pages": [{"rows": ["widget_name_1 | widget_name_3 | widget_name_4 | row: {attribute=300}","widget_name_2 {widget_name=3}"

]}

],"version": 1

}

前述の例の widget_name は、JSON ファイルの widgets セクションで指定される特定のウィジェットを参照します。属性は、「layouts プロパティ」に記載されているいずれかの属性を参照します。パイプ文字 ( | ) はセルの区切り文字です。カンマ ( , ) で区切ってセルに複数のウィジェットを含めることができます。行は、引用符で囲まれた文字列 (引用符で囲まれた各文字列は 1 行) の外側のカンマ ( , ) で区切られます。

簡単な layouts セクション次に、1 つのページに 1 つの列、4 つの行、4 つのウィジェットがある簡単な layoutsセクションを示します。"layouts": [{"device": "default","pages": [{"rows": ["buttongroup_1","dimfilter_1","dimfilter_2","chart_1"

]}

]"version": 1

}

複雑な layouts セクション複雑な layouts セクションを使用して、デバイス固有および方向固有の表示ルールを設定できます。次のlayoutsセクションでは、2 つのページでダッシュボードのウィジェットをレイアウトします。最初のページの最初の行の高さは 300 ピクセルです。2 番目のページには、2 つの行と 2 つの列があります。最初の行のセルの 1 つに 2 つのウィジェットが含まれます。ボックスウィジェットの 1 つに 3 つの属性セットがあります。グラフウィジェットは 2 つの列にまたがります。横モードの iPad でダッシュボードが表示される場合、2 つの行

45


がある 1 つのページのみが表示されます。最初の行には 3 つのウィジェットがあり、2 番目の行には 3 つの列にまたがる 1 つのウィジェットがあります。"layouts": [{"device": "default","pages": [{"rows": ["buttongroup_2 | row: {height=300}","chart_1"

]},{"rows": ["dimfilter_1, box_1 {colspan=2, rowspan=2, zIndex=-1, vpad=5, hpad=5} |

dimfilter_2”,"chart_1 {colspan=2}"]

}],"version": 1

},{"device": "ipad","orientation": "landscape","pages": [{"rows": ["dimfilter_1, box_1 {colspan=2, rowspan=3, zIndex=-1, vpad=5, hpad=5} | dimfilter_2

|buttongroup_2",

"chart_1 {colspan=3}"]

}],"version": 1

}

レイアウトのオプション前の例は、横モード (“device:ipad, orientation:landscape”) の iPad に固有のレイアウトです。次に、レイアウトのデバイスおよび方向のオプションを示します。• “device”:“default”: 特定のデバイスまたは方向を対象としていないレイアウト用です。• “device”:“ipad”, “orientation”:“portrait”: 縦モードの Apple iPad 用です。• “device”:“ipad, “orientation”:“landscape”: 横モードの Apple iPad 用です。• “device”:“ipad”: 縦モードまたは横モードの Apple iPad 用です。• “device”:“iphone”: Apple iPhone 用です (暗黙的に縦モード)。• “device”:“external”: 外部デバイス用です (デバイスが HDMI ケーブルでプロジェクターやディスプレイ

に接続されている場合など)。externalレイアウトを使用するには、[設定] で [プレゼンテーションモード]

を選択します。

46


• “device”:“applewatch”: Apple Watch 用です。1 つのスクロールページのみがサポートされます。• “orientation”:“portrait”: 縦モードの iPhone または iPad 用です。• “orientation”:“landscape”: 横モードの iPad 用です。

メモ: アプリケーションが Apple Watch で表示され、かつ “device”:”applewatch” レイアウトが存在していない場合、アプリケーションはまず “device”:”iphone” レイアウトの最初のページの形式の変更を試みます。“device”:”iphone”が存在していない場合、次に “device”:“default”レイアウトの最初のページの使用を試みます。

メモ: アプリケーションが外部デバイスで表示され、かつ “device”:”external” レイアウトが存在していない場合、アプリケーションはまず “device”:”ipad” “orientation”:”landscape” の最初のページの使用を試みます。“device”:”ipad” “orientation”:”landscape”が存在していない場合、次に “device”:“default” レイアウトの最初のページの使用を試みます。

レイアウトのオートフォーマットlayouts が指定されていない場合、Wave では使用に適したレイアウトの最適な推測を行うオートフォーマットを使用してダッシュボードが表示されます。レイアウトのオートフォーマットに関する次の事項に注意してください。• Apple Watch の場合、オートフォーマットは default レイアウトの最初のページを使用してそれを 1 つの列に

変換します。• 外部デバイスの場合、オートフォーマットはスクロールできない 1 つのページのみをサポートし、外部ディ

スプレイにすべてのダッシュボードコンテンツを収めようとします。• オートフォーマットでサポートされる各デバイスの列数には制限があります (下記の表を参照)。

オートフォーマットでサポートされる最大列数デバイス

1Apple Watch

2Apple iPhone

4Apple iPad

オートフォーマットはデフォルトで有効になっています。モバイルレイアウトを使用できない、入念に設計されたダッシュボードなどの場合に、オートフォーマットを無効にするには、次のように空の pages 配列をlayouts 配列の下に追加します。"layouts": [{"pages": [{}

47


]}

関連トピック:

ダッシュボードのモバイルレイアウトの使用layouts プロパティ

layouts プロパティlayouts キーでは、モバイルレイアウトの各ウィジェットの位置、順序、およびサイズを指定します。このレイアウトは、行、列、セル、ページで構成されます。グリッド内の各セルには 0 個以上のウィジェットを含めることができます。モバイルレイアウト内の行数、列数、およびセル数は、ウィジェット数とページ数によって異なります。

ウィジェット属性ウィジェットに次の属性を設定できます。各ウィジェットに属性を 0 個以上選択できます。


型Integer

colspan


説明ウィジェットがまたがる列数。ウィジェットの幅。ダッシュボードに指定された幅を表示するのに十分な列数がない場合、そのダッシュボードに列が追加されます。

例この例では、“chart_1” という名前のウィジェットが 3 列にまたがります。"layouts": [{"device": "default","pages": [{"rows": ["dimfilter_1 | dimfilter_2 | dimfilter_3","chart_1 {colspan=3}"

]}

]"version": 1

}

48

layouts プロパティダッシュボード JSON プロパティ


型Integer

rowspan


説明ウィジェットがまたがる行数。ウィジェットの高さ。ダッシュボードに指定された高さを表示するのに十分な行数がない場合、行が追加されます。

例この例では、“dimfilter1_1” という名前のウィジェットが 2 行にまたがります。"layouts": [{"device": "default","pages": [{"rows": ["dimfilter_1 {rowspan=2} | dimfilter_2","chart_1"

]}

]"version": 1

}

型Integer

zIndex


説明ウィジェットの位置は、ダッシュボードの他のウィジェットに対して相対的です。zIndexでは、ウィジェットが別のウィジェットの前後どちらに位置するかを指定します。zIndex値が小さいウィジェットは、zIndex値が大きい他のウィジェットよりも後ろに表示されます。zIndex のデフォルト値は 0 です。

例この例では、“box_1”という名前のウィジェットが “number_1”という名前のウィジェットの後ろに表示されます。"layouts": [{"device": "default","pages": [{"rows": [

49



"box_1 {zIndex=1}, number_1 {zIndex=2} | chart_1"]

}]"version": 1

}

型Integer

vpad


説明ウィジェットのセルの上下に追加されるパディング (ピクセル単位)。vpadが 10 の場合、セルの上下に 10 ピクセルが追加されます。vpad のデフォルト値は 0 です。

例この例では、“dimfilter_1”という名前のウィジェットを含むセルの上下に 5 ピクセルのパディングがあります。"layouts": [{"device": "default","pages": [{"rows": ["dimfilter_1 {vpad=5}"

]}

]"version": 1

}

型Integer

hpad


説明ウィジェットのセルの左右に追加されるパディング (ピクセル単位)。hpadが 10 の場合、セルの左右に 10 ピクセルが追加されます。負の値を割り当てることができます。hpad のデフォルト値は 0 です。

50



例この例では、“dimfilter_1”という名前のウィジェットを含むセルの上下に 5 ピクセルのパディングがあります。"layouts": [{"device": "default","pages": [{"rows": ["dimfilter_1 {hpad=5}"

]}

]"version": 1

}

型Integer

vAxisWidth

次のウィジェットで使用可能• chart

説明グラフウィジェットの X 軸のサイズ (ピクセル単位)。vAxisWidthを使用して複数のグラフウィジェットを配置します。

例この例では、“chart_1” という名前のウィジェットに 250 ピクセルの幅の X 軸があります。"layouts": [{"device": "default","pages": [{"rows": ["chart_1 {vAxisWidth=250}"

]}

]"version": 1

}

型Integer

hAxisHeight


51



説明グラフウィジェットの Y 軸のサイズ (ピクセル単位)。hAxisHeight を使用して複数のグラフウィジェットを配置します。

例この例では、“chart_1” という名前のウィジェットに 250 ピクセルの高さの Y 軸があります。"layouts": [{"device": "default","pages": [{"rows": ["chart_1 {hAxisHeight=250}"

]}

]"version": 1

}

行属性行に次の属性を設定できます。


説明height に数値が設定されている場合、height は行の高さ (ピクセル単位) です。heightに preferredが設定されている場合、行の高さは最大の高さと等しくなります。

height

例この例では、最初の行の高さは 300 ピクセルです。2 番目の行の高さは、最も高いウィジェットの高さと等しくなります。"layouts": [{"device": "default","pages": [{"rows": ["chart_1 {colspan=3} | row:{height=300}","dimfilter_1 | buttongroup_1 | number_1 |

row:{height=preferred}"]

}]

52



"version": 1}

ウィジェット属性の上書き次の属性をウィジェットに渡して、ウィジェットのデフォルトの動作を上書きできます。すべての色プロパティは「#022B54」のような文字列を使用します。

属性ウィジェットタイプ

すべてのウィジェット

• compact

• placeholder

ChartWidget • legend

• miniBars

• fit

• normalize

• multiMetrics

• splitAxis

• backgroundColor

• measureAxis (true/false)

• categoryLabels (true/false)

• textColor

• limitBarThickness (true/false)

BoxWidget • backgroundColor

• borderColor

• imageUrl

• stretch

LinkWidget • destinationType

• destination

• visualizationType

• includeState

ListSelectorWidget • instant

• expanded

TextWidget • title または text

53


属性ウィジェットタイプ

• textColor

• textAlignment

• fontSize

PillBoxWidget • backgroundColor

• textColor

• borderColor

• selectedColor

次に、属性を渡して chart_1 の背景色、テキストの色、軸や表示ラベルの表示を変更している例を示します。"layouts": [

{"device": "default","pages": [{"rows": ["chart_1 {backgroundColor=\"#022B54\", measureAxis=false, categoryLabels=false,

textColor=\"#FFFFFF\"}"]

}],"version": 1

}]

関連トピック:

ダッシュボードのモバイルレイアウトの使用レイアウトの仕様

steps

steps セクションでは、作成され、ダッシュボードにクリップされたすべてのステップが定義されます。プロパティは、ステップがコンパクトフォームまたは SAQL フォームのどちらであるかに基づいて異なります。

例: コンパクトフォームのステップ

"steps": {"Product_StageName_1": {

"type": "aggregateflex","visualizationParameters": {


},

54

stepsダッシュボード JSON プロパティ

"query": {"measures": [

["sum","Amount"

],[

"sum","quantity"

]],"groups": [

"Product","StageName"

],"order": [

[-1, { "ascending": false }]],"aggregateFilters": [[

["sum","Amount"

],[

[14550720,58807698

]],">=<="

]]},"isFacet": true,"useGlobal": true,"isGlobal": false,"datasets": [{

"name": "Flexy_Sales","url": "/services/data/v38.0/wave/datasets/0FbB00000000q5gKAA","id": "0FbB00000000q5gKAA"

}]}

}

例: SAQL フォームのステップ

ステップが SAQL フォームの場合、各グループと基準がそれぞれ groups と measures プロパティでどのように定義されているか、さらに pigql プロパティでどのように定義されているかを確認してください。クエリの他の部分 (filter、limit、order など) は pigql プロパティで 1 回定義するだけで済みます。関連するグラフウィジェットで正しい予測を表示するには、"groups" および "measures" のコンパクトフォーム要素を指定しますまた、SAQL クエリの 'sum_Amount' と 'sum_Amount'の予測が、基準で [[ "count", "*",

"sum_Amount" ], [ "count", "*", "sum_quantity" ]] として参照されていることを確認してく

55


ださい。SAQLの基準予測には、集計、アンダースコア (_) 、基準名 ('sum_Amount') が常に含まれるため、それらをコンパクトフォーム "measures": [[ "count", "*", "sum_Amount" ], [ "count", "*",

"sum_quantity" ]] で参照できます。"steps": {

"Product_StageName_2": {"type": "aggregateflex","visualizationParameters": {

"options": {}},"query": {

"pigql": "q = load \"Flexy_Sales\";\nq = group q by ('Product', 'StageName');\nq = foreach q generate 'Product' as 'Product',

'StageName' as 'StageName',sum('Amount') as 'sum_Amount',sum('quantity') as 'sum_quantity';\n

q = filter q by 'sum_Amount' >= 14550720 && 'sum_Amount' <=58807698;\n

q = order q by 'sum_Amount' desc;\nq = limit q 10000;","measures": [

["count","*","sum_Amount"

],[

"count","*","sum_quantity"

]],"groups": [

"Product","StageName"

]},"isFacet": true,"useGlobal": true,"isGlobal": false,"datasets": [{

"name": "Flexy_Sales","url": "/services/data/v38.0/wave/datasets/0FbB00000000q5gKAA","id": "0FbB00000000q5gKAA"

}]}

}

例: aggregateflex ステップと Wave ダッシュボードデザイナのバインド

"steps": {"Account_BillingCount_1": {

"datasets": [{"id": "0FbB00000000oEkKAI",

56


"label": "Opportunities","name": "opportunity","url": "/services/data/v38.0/wave/datasets/0FbB00000000oEkKAI"

}],"isFacet": true,"isGlobal": false,"query": {

"measures": "{{column(StaticMeasureNames.selection,[\"value\"]).asObject()}}",

"limit": "{{column(StaticLimits.selection, [\"value\"]).asObject()}}","groups": "{{column(StaticGroupingNames.selection,

[\"value\"]).asObject()}}","filters": "{{column(StaticFilters.selection, [\"value\"]).asObject()}}",

"order": "{{column(StaticOrdering.selection, [\"value\"]).asObject()}}"},"selectMode": "single","type": "aggregateflex","useGlobal": true,"visualizationParameters": {


}}

}

例: aggregate ステップと Classic デザイナのバインド

Classic デザイナのダッシュボードをWave デザイナに変換する場合、aggregateステップは aggregateflex

に変換されません。このステップはClassic デザイナのバインド構文を引き続き使用します。これは、Wave

デザイナの構文とは異なります。Wave デザイナは両方の構文をサポートします。"steps": {

"step_Account_Name_1": {"isFacet": false,"query": {

"pigql": "q = load \"opp\";\nq = filter q by 'Account-Name' in {{

selection(step_Account_Owner_Name_2) }};\nq = group q by {{ single_quote(value(selection(step_StageName_3)))

}};\nq = foreach q generate

{{ single_quote(value(selection(step_StageName_3))) }}as {{ value(selection(step_StageName_3)) }},

sum('Amount') as 'sum_Amount',count() as 'count'",

"groups": "{{ selection(step_StageName_3) }}","measures": [

["sum", "Amount"]]

},"visualizationParameters": {

"visualizationType": "hbar"},

57


"selectMode": "none","useGlobal": true,"datasets": [{

"name": "opp"}],"type": "aggregate","isGlobal": false

}}

例: SAQL クエリの比較テーブルのステップ

この例は、モバイルクライアントのClassic デザイナダッシュボード用の比較テーブルのステップを示します。globalQueryの下の pigql定義には、この単純な 2 列の比較テーブルを作成するための統合された1 つの SAQL クエリが含まれます。

"compare_2": {"isFacet": true,"isGlobal": false,"selectMode": "single","type": "multi","useGlobal": true,"start": null,"datasets": [

{"name": "Honeywell_Recent_Deals1"

}],"visualizationParameters": {

"visualizationType": "comparisontable"},"columns": [

{"header": "Sum of LeadScore","query": {

"measures": [[

"max",

58


"LeadScore"]

],"groups": [

"Industry"]

},"showBars": true

},{

"header": "Avg of LeadScore","query": {

"measures": [[

"avg","LeadScore"

]],"groups": [

"Industry"]

},"showBars": false

}],"globalQuery": {

"pigql": "q = load \"Honeywell_Recent_Deals1\"; q = group q by 'Industry'; q= filter q by 'Industry' in [\"Consumer\",\"Fin Svcs\",\"Mfg\",\"HighTech\",\"Healthcare\",\"Prof Svcs\"]; q = foreach q generate 'Industry' as 'Industry',avg('LeadScore') as 'avg_LeadScore', sum('LeadScore') as 'sum_LeadScore'; q = limitq 2000;"

}},

メモ: この比較テーブルには次の制限があります。• +、-、*、/、( ) の機能のみが含まれます。• モバイルデバイスでは、列レベルで SAQL が使用されません。グローバル SAQL 定義がサポートさ

れます。または、各列からコンパクトフォームを使用します。• モバイルデバイスでは、比較テーブルが参照のみとなります。

SAQL についての詳細は、SAQL リファレンスを参照してください。

steps プロパティsteps キーは、ダッシュボードで使用できるすべてのステップを定義します。これには、ステップごとに別々のノードが含まれます。各ステップノードには、クエリまたは静的値のリストを定義するプロパティがあります。また、ステップの動作 (ステップをファセットするかどうかなど) を制御するプロパティも含まれます。

59


steps プロパティstepsキーは、ダッシュボードで使用できるすべてのステップを定義します。これには、ステップごとに別々のノードが含まれます。各ステップノードには、クエリまたは静的値のリストを定義するプロパティがあります。また、ステップの動作 (ステップをファセットするかどうかなど) を制御するプロパティも含まれます。

説明項目名

このステップで使用されたデータセットの配列。各データセットの別名を指定します。現時点では、最初のデータセットのみが使用されます。

datasets

メモ: ファセットされたステップは、この配列で指定した最初のデータセットのみに基づいて絞り込まれます。

ステップに関する視覚化の詳細。例:

"visualizationParameters": {"options": {

visualizationParameters

"legend": false,"legendHideHeader": false,"legendWidth": 145,"maxColumnWidth": 200,"minColumnWidth": 30,"miniBars": 0,"multiMetrics": false,"splitAxis": false,"sqrt": false,"trellis": false

},"visualizationType":"hbar"

}

このステップと、このステップの datasets 項目で指定される同じデータセットから構築された他のステップ間で双方向ファセットを有効にします。true またはfalse に設定します。

isFacet

メモ: SAQL クエリが複数のデータセットに基づいている場合、datasets 項目で指定された最初のデータセットのみがファセットされます。また、isFacet は、デフォルトでコンパクトフォームクエリでのみ動作します。SAQL クエリで有効にするには、さらに autoFilterオプションを trueに設定します。

クエリで指定された検索条件がグローバル検索条件として使用されるか (true)、否か (false) を示します。デフォルトは、false です。このプロパティは、範囲/グ

isGlobal

ローバル検索条件ウィジェットに接続されているステップにのみ適用できます。他のすべてのステップでこのプロパティは無視されます。範囲/グローバル検索条件ウィジェットでは、ダッシュボードの他のステップのうち、useGlobal が true に設定され、同じデータセットを参照するステップが絞り込まれます。デフォルトでは、コンパクトフォームステップのみが絞り込まれま

60

steps プロパティダッシュボード JSON プロパティ

説明項目名

す。SAQL ステップを絞り込むには、SAQL ステップの autoFilter を true に設定します。

ステップで使用するクエリ。SAQL またはコンパクトフォームが有効です。query

選択操作を決定します。グラフ用のオプションは、none、single、singlerequired です。リストおよび切り替えセレクタ用のオプションは、single、singlerequired、multi、multirequired です。

selectMode

メモ: selectMode は、数値、値テーブル、比較テーブル、範囲、日付、グローバル検索条件ウィジェットでは使用されません。

ダッシュボードを初めて開いたときに適用される初期検索条件。start

次の型に設定できます。type

• grain — 値テーブルを構築するには、これを使用します。• multi — Classic デザイナダッシュボードで比較テーブルを構築するには、これ

を使用します。Wave デザイナダッシュボードで比較テーブルを構築するには、aggregate または aggregateflex ステップを使用します。

• static — 静的ステップを構築するには、これを使用します。Wave デザイナダッシュボードで static ステップはサポートされますが、代わりに staticflex

ステップを使用することをお勧めします。• staticflex — Wave ダッシュボードデザイナで静的ステップを構築するには、

これを使用します。• aggregate — 他のすべてのステップで使用します。Wave デザイナダッシュボー

ドで aggregate ステップはサポートされますが、代わりに aggregateflex

ステップを使用することをお勧めします。• aggregateflex — Wave デザイナダッシュボードの他のすべてのステップのみ

で使用します。

メモ: aggregateflex ステップのステッププロパティをバインドする場合、Wave デザイナのバインド構文を使用する必要があります。バインドについての詳細は、『Wave Analytics バインド開発者ガイド』を参照してください。

ステップでダッシュボードの範囲/グローバル検索条件ウィジェットを使用するか(true)、否か (false) を示します。

useGlobal

他のステップをファセットするために使用するディメンション。Wave では、ユーザインターフェースでこのディメンションに選択した値に基づいて他の値がファ

dimensions

セットされます。isFacet が true に設定されている場合のみ dimensions 属性を指定します。

61


https://resources.docs.salesforce.com/204/latest/ja-jp/sfdc/pdf/bi_dev_guide_bindings.pdf

説明項目名

例:

"step_filter_dim": {"type": "static","dimensions": [ "Product" ],"datasets":[{"name":"opportunity"}],"selectMode": "single","values": [

{"value": ["EKG Machine"]},{"value": ["Mammography Machine"]},{"value": ["Ultrasound Machine"]}

],"isFacet": true

},

静的ステップの結果を絞り込むために使用する値。たとえば、次の値を使用して日付セレクタの入力を行うことができます。"step_date_static_with_start": {

"type": "static",

values

"values": [{

"display": "-6 years","value": [[["year",-6],["year",0]]]

},{


},{


}],"selectMode": "singlerequired","start": [[[["year",-5],["year",0]]]]

}

静的ステップを定義するときに、valuesの下で任意の項目と値を作成できます。静的値を別のステップにバインドするには、バインドで任意の項目を参照して値を取得できます。静的ステップのバインドについての詳細は、『Wave Analytics バインド開発者ガイド』を参照してください。

query プロパティquery キーには、コンパクトフォームステップと SAQL フォームステップのクエリパラメータが含まれます。エクスプローラまたはダッシュボードデザイナで作成されたステップは、コンパクトフォームで作成されます。SAQL エディタで作成されたステップは、SAQL フォームで作成されます。

62




visualizationParameters プロパティvisualizationParameters キーには、ダッシュボードウィジェットをサポートするために作成したステップの定義が含まれます。

query プロパティquery キーには、コンパクトフォームステップと SAQL フォームステップのクエリパラメータが含まれます。エクスプローラまたはダッシュボードデザイナで作成されたステップは、コンパクトフォームで作成されます。SAQL エディタで作成されたステップは、SAQL フォームで作成されます。非静的ステップは、クエリに基づいてデータを取得します。ステップノードのクエリキーは、基準、条件、グルーピング、制限、並び替え順などのクエリパラメータを定義します。クエリの構造とプロパティは、ステップが作成されたフォーム (コンパクトフォームおよび SAQL フォーム) によって異なります。ステップについての詳細は、「Create Steps in the Wave Dashboard Designer」を参照してください。

メモ: クエリプロパティは、選択内容または別のステップの結果に基づいて動的に設定できます。たとえば、切り替えウィジェットの選択内容に基づいてグルーピングを変更できます。詳細は、『Wave Analytics

バインド開発者ガイド』を参照してください。ダッシュボード JSON ファイルの query セクションのプロパティは、次のとおりです。

説明項目名

自動的に生成されます。変更しないでください。aggregateFilters

ファセットが設定された SAQL クエリステップに適用する条件を、コンパクトフォームクエリステップと範囲/グローバル検索条件ウィジェットか

autoFilter

ら有効にします。コンパクトフォームクエリステップからの条件を SAQL

クエリステップに適用するには、autoFilter と isFacet を true に設定します。範囲ウィジェットからの条件を SAQL クエリステップに適用するには、autoFilterと useGlobalを trueに設定します。autoFilter

が false に設定されているか指定されていない場合、コンパクトフォームクエリステップおよび範囲ウィジェットからの条件は SAQL クエリステップに適用されません。

使用するディメンションは次のように指定します。"dimensions": [ "Department" ]

dimensions

自動的に生成されます。変更しないでください。facet_filters

データに適用される絞り込み条件。次に、対象の"SFO"、"LAX"、"ORD"、"DFW"がある行のみが含まれるようにする単純な絞り込み条件の例を示します。"filters": [["dest", ["SFO", "LAX", "ORD", "DFW"]]]

filters

63


https://help.salesforce.com/apex/HTViewHelpDoc?id=bi_dashboard_steps_create.htm&language=ja



説明項目名

メモ: コンパクトフォームクエリを含むステップにのみ適用されます。SAQL クエリに基づいてステップの条件を指定するには、filter

ステートメントを SAQL クエリに含めます。

formula は、比較テーブルのステップで multi ステップタイプと共に使用されます。multiタイプのステップには複数のサブクエリが含まれます。

formula

基本的な数学演算子 *、/、-、+、(、) を使用して、ステップ内の他のサブクエリを参照する数式を作成できます。他のサブクエリを参照するには、自動的に割り当てられる名前 (「A」は最初のクエリ、「B」は 2 番目のクエリなど) を使用します。"step_comptable": {

"type": "multi","datasets":[{"name":"opp"}],"isFacet": true,"useGlobal": true,"query": {"columns": [{"header": "Opptys Won","query": {"pigql": null,"filters": [["StageName", ["5 - Closed-Won"]],

["Close Date", [[["year", -1], ["year", 0]]]]],"measures": [["count", "*"]],"values": [],"groups": ["Owner-Name"],"formula": null,"order": []

}}, {"header": "Opptys Won ($)","query": {"pigql": null,

"filters": [["StageName", ["5 - Closed-Won"]]],

"measures": [["sum", "Amount"]],"values": [],"groups": ["Owner-Name"],"formula": null,"order": []

}}, {"sort": {"asc": false,"inner": false

},"header": "Opptys Won ($)","showBars": true,"query": {

64


説明項目名

"pigql": null,"filters": [["StageName", ["5 - Closed-Won"]]],


}}, {"header": "Opptys Lost ($)","query": {"pigql": null,

"filters": [["StageName", ["5 - Closed-Lost"]]],


}}, {"header": "Opptys Lost ($)","showBars": true,"query": {"pigql": null,



}}, {"header": "Win-Loss (%)","query": {"groups": ["Owner-Name"],


"measures": [["sum", "Amount"]],"values": [],"pigql": null,"formula": "B/(B+D)*100","order": []

}}

]}

}},

65


説明項目名

グループ化の基準となるディメンション。たとえば、"groups":

["carrier"] です。groups は、コンパクトフォームクエリと SAQLフォーgroups

ムクエリの両方で指定します。SAQLフォームクエリを使用している場合、ディメンションでグループ化するには、このパラメータと SAQL クエリのpigql パラメータでグループ化の基準となるディメンションを指定する必要があります。

返される結果の数。たとえば、"limit": 10 です。limit ステートメントで返される結果は自動的に並び替えられないため、このステートメントは、並び替えられているデータでのみ使用してください。

limit

メモ: コンパクトフォームクエリを含むステップにのみ適用されます。SAQL クエリに基づいてステップの制限を指定するには、limit


使用する基準は次のように指定します。"count", "*", null, {

"display": "% of total flights"}

measures

コンパクトフォームクエリと SAQL フォームクエリの両方で指定します。関連付けられたグラフウィジェットで正しい予測を表示できるようにSAQL

クエリで指定します。基準の UI 表示ラベルは、display オプションを設定して変更できます。SAQL フォームクエリを使用している場合、基準を追加するには、このパラメータと SAQL クエリの pigql パラメータで基準を指定します。

最初に指定した基準を昇順または降順に並び替えます。結果を昇順に並び替えるには、ascending を true に設定します。結果を降順に並び替え

order

るには、ascendingを falseに設定します。特定の順序を強制しない場合、"order": [] のように空の角括弧を指定します。例:

"step1": {"type": "aggregate","datasets":[{"name":"airline"}],"query": {"groups": ["dest"],"filters": [["carrier", "{{ selection(step1) }}"],["dest", "{{ filter(step1, 'dest') }}"],["origin", "{{ filter(step1, 'origin') }}"]

],"measures": [["sum", "miles"], ["count", "*"]],

66


説明項目名

"order": [[-1, {"ascending": false}]]}

メモ: コンパクトフォームクエリを含むステップにのみ適用されます。SAQL クエリに基づいてステップの順序を指定するには、order


SAQL フォームのクエリ。コンパクトフォームを使用して実行されないようにクエリをカスタマイズする必要がある場合、SAQL フォームのクエリを使用します。

pigql

SAQL クエリを指定する場合、pigql 属性内で条件、制限、および順序を指定する必要があります。query属性で設定されているfilters、limit、order属性は Wave で無視されます。各基準は SAQL クエリに含め、measures属性で指定する必要があります。グルーピングを指定するには、SAQL クエリに group by ステートメントを含め、同じディメンションをgroups属性で指定する必要があります。

メモ: SAQL クエリから作成されたステップでファセットを有効にできますが、SAQLクエリが複数のデータセットに基づいている場合、datasets 項目で指定された最初のデータセットのみがファセットされます。

値は、値テーブルウィジェットの grain ステップまたは static ステップで使用されます。grain ステップの値には、値テーブルに含める列をリストします。次に例を示します。"step_grain": {"type": "grain",

values

"datasets":[{"name":"opp"}],"query": {"values": ["Amount", "Owner-Name", "Name", "Account-Name",

"StageName", "ForecastCategory", "Current Age", "Time toWin"],

}}

staticステップの値は手動で定義します。valuesは、コンパクトフォームクエリと SAQL フォームクエリの両方に含めることができます。

visualizationParameters プロパティvisualizationParameters キーには、ダッシュボードウィジェットをサポートするために作成したステップの定義が含まれます。"visualizationParameters": {"options": {

67


"legend": false,"legendHideHeader": false,"legendWidth": 145,"maxColumnWidth": 200,"minColumnWidth": 30,"miniBars": 0,"multiMetrics": false,"splitAxis": false,"sqrt": false,"trellis": false

},"visualizationType":"hbar"

}

説明項目名

デザイナにクリップするステップのグラフプロパティを指定します。これらのオプションがウィジェットパラメータで定義されている場合、Waveはこれらのオプショ

options

ンを上書きします。これらのオプションについての詳細は、「widgetプロパティ」を参照してください。

グラフの種類を指定します。グラフの種類をウィジェットレベルで上書きできます。

visualizationType

visualizationType の有効値は次のとおりです。• calheatmap* — カレンダーヒートマップ• comparisontable — テーブル比較• hbar — 横棒• hdot* — 横方向のドットプロット• heatmap* — ヒートマップ• matrix* — マトリックス• parallelcoords* — 平行座標• pie — ドーナツ• pivottable* — ピボットテーブル• scatter — 散布図• stackhbar — 積み上げ横棒• stackvbar — 積み上げ縦棒• time — タイムライン• valuestable — 未加工データテーブル• vbar — 縦棒• vdot* — 縦方向のドットプロット

メモ: Wave ダッシュボードデザイナは、アスタリスク (*) が付いているグラフをサポートしていません。サポートされていない型を指定すると、ダッシュボードではデザイナによって横棒 (hbar) に置き換えられます。

68


widgets

widgets セクションでは、ダッシュボードに表示されるウィジェットを定義します。各ウィジェットには名前があります。

例: Wave デザイナダッシュボードのウィジェット

"widgets": {"text_1": {"parameters": {"fontSize": 20,"text": "Grouping","textAlignment": "center","textColor": "#091A3E"},"type": "text"},"pillbox_1": {"parameters": {"compact": false,"exploreLink": false,"step": "StaticSAQLMinRanges"},"type": "pillbox"},"chart_1": {"parameters": {"autoFitMode": "fit","showValues": true,"legend": {"showHeader": true,"show": true,"position": "right-top","inside": false},"axisMode": "multi","visualizationType": "hbar","exploreLink": true,"title": {"label": "","align": "center","subtitleLabel": ""},"trellis": {"enable": false,"type": "x","chartsPerLine": 4},"measureAxis2": {"showTitle": true,"showAxis": true,"title": ""},"measureAxis1": {

69

widgetsダッシュボード JSON プロパティ

"showTitle": true,"showAxis": true,"title": ""},"theme": "wave","step": "Account_BillingCount_1","dimensionAxis": {"showTitle": true,"showAxis": true,"title": ""}},"type": "chart"}}

例: Classic デザイナダッシュボードのウィジェット

"widgets": {"chart_1": {"type": "chart","position": {"zIndex": 3,"x": 10,"y": 80,"w": 500,"h": 300},"parameters": {"step": "Match_Status_3","legend": true,"visualizationType": "pie"}},"text_1": {"type": "text","position": {"zIndex": 4,"x": 0,"y": 10},"parameters": {"text": "We took a look at your current accounts and \ncontacts and found the

following matches below","textAlignment": "left"}},"number_3": {"type": "number","position": {"zIndex": 5,"x": 510,"y": 90,"w": 550

70


},"parameters": {"step": "all_4","measureField": "count","title": "Accounts and Contacts from your org were analyzed","fontSize": 42,"textAlignment": "left"}},"chart_2": {"type": "chart","position": {"zIndex": 7,"x": 10,"y": 440,"w": 500,"h": 490},"parameters": {"step": "SIC_Desc_Match_Status_5","visualizationType": "hbar"}},"text_3": {"type": "text","position": {"zIndex": 8,"x": 10,"y": 390},"parameters": {"text": "What does this look like by SIC ?"}},"chart_3": {"type": "chart","position": {"zIndex": 10,"x": 520,"y": 240,"w": 500,"h": 300},"parameters": {"step": "Match_Status_6","visualizationType": "hbar"}},"text_4": {"type": "text","position": {"zIndex": 11,"x": 500,"y": 200

71


},"parameters": {"text": "What's the value of these to you?"}},"chart_4": {"type": "chart","position": {"zIndex": 12,"x": 530,"y": 440,"w": 500,"h": 300},"parameters": {"step": "SIC_Desc_7","sqrt": true,"visualizationType": "vbar"}},"text_5": {"type": "text","position": {"zIndex": 13,"x": 520,"y": 390},"parameters": {"text": "Where do you make your money today?"}},"text_6": {"type": "text","position": {"zIndex": 16,"x": 1050,"y": 20},"parameters": {"text": "The future of data..."}}}

widget プロパティwidgetsキーは、ダッシュボードで使用できるすべてのウィジェットを定義します。これには、ウィジェットごとに別々のノードが含まれます。各ウィジェットは、それが追加されたすべてのレイアウトで表示されます。各ウィジェットで使用できるプロパティは、ウィジェットタイプによって異なります。たとえば、グラフウィジェットには legend プロパティがありますが、テキストウィジェットにはありません。

72


widget プロパティwidgets キーは、ダッシュボードで使用できるすべてのウィジェットを定義します。これには、ウィジェットごとに別々のノードが含まれます。各ウィジェットは、それが追加されたすべてのレイアウトで表示されます。各ウィジェットで使用できるプロパティは、ウィジェットタイプによって異なります。たとえば、グラフウィジェットには legend プロパティがありますが、テキストウィジェットにはありません。

説明項目名

ウィジェットのパラメータは、ウィジェットのタイプとグラフの種類 (該当する場合) によって異なります。step 要素では、ウィジェットに関連付けられるステップを定義し

parameters

ます。各種ウィジェットパラメータについての詳細は、「widget プロパティ」を参照してください。

(Classic デザイナダッシュボードのみ) ダッシュボード内のウィジェットの位置を指定します。位置は次のプロパティで構成されます。x と y

ウィジェットの左上隅を指定します。これらの項目の値は、整数にする必要があります。

position

w と h

幅と高さをそれぞれ指定します。"auto"、パーセント ("36%")、整数 ("20") を文字列値として入力できます。

zIndex

ダッシュボードの他のウィジェットに対して、ウィジェットの相対的な位置を決定します。zIndex は、ウィジェットが別のウィジェットの前後どちらに位置するかを指定します。zIndex 値が小さいウィジェットは、zIndex 値が大きい他のウィジェットよりも後ろに表示されます。この値は、整数にする必要があります。

例:

"position": {"x": 40,"y": 40,"w": "300","h": "auto"}

ピクセル単位で測定されます。

メモ: Wave ダッシュボードデザイナでは、これらの設定は無視され、ダッシュボード JSON の gridLayoutsセクションで指定した position 属性が使用されます。

ウィジェットタイプでは、サポートされるいずれかのウィジェットタイプを指定します。この項目の値は、文字列にする必要があります。

type

• box — Classic デザイナでのみ使用可能• chart

• comparetable

• container — Wave ダッシュボードデザイナでのみ使用可能

73

widget プロパティダッシュボード JSON プロパティ

説明項目名

• dateselector

• globalfilters

• image — Wave ダッシュボードデザイナでのみ使用可能• link

• listselector

• number

• pillbox

• rangeselector

• table — Wave ダッシュボードデザイナでのみ使用可能• text

• url — Classic デザイナでのみ使用可能• valuestable

メモ: Wave ダッシュボードデザイナはボックスウィジェットおよび URL ウィジェットをサポートしていません。このデザイナは、ダッシュボードが開かれたときにこれらのウィジェットタイプを削除します。また、Classic デザイナはコンテナウィジェットをサポートしていません。代わりにボックスウィジェットを使用してください。

parameters プロパティparameters キーには、ウィジェットの外観を制御するプロパティのリストが含まれます。各ウィジェットタイプには、グラフの種類を含め、固有のプロパティセットが含まれます。

parameters プロパティparametersキーには、ウィジェットの外観を制御するプロパティのリストが含まれます。各ウィジェットタイプには、グラフの種類を含め、固有のプロパティセットが含まれます。

メモ: 別のステップの選択内容や結果に基づいて、Wave デザイナダッシュボードの数値ウィジェットとグラフウィジェットのプロパティを動的に設定できます。たとえば、切り替えウィジェットの選択内容に基づいて、グラフ内の地図タイプを変更できます。詳細は、『Wave Analytics バインド開発者ガイド』を参照してください。

グラフウィジェットの多くのプロパティは、グラフの種類によって異なります。Classic デザイナダッシュボードの各グラフのプロパティのリストは、次の表を参照してください。Wave デザイナダッシュボードのグラフ固有のプロパティについての詳細は、「Visualizing Data with Charts」を参照してください。このセクションでは、Wave デザイナダッシュボードのグラフプロパティについては説明しません。

74



https://help.salesforce.com/apex/HTViewHelpDoc?id=bi_visualize.htm&language=ja

有効なプロパティ視覚化のタイプ

legend, legendHideHeader, legendWidth,maxColumnWidth, minColumnWidth, miniBars,multiMetrics, splitAxis, sqrt, and trellis

棒グラフ

maxColumnWidth and minColumnWidth比較テーブルlegend, legendHideHeader, and legendWidthドーナツfit, legend, legendHideHeader, legendWidth,and sqrt

ドットプロット

legend, legendHideHeader, and legendWidthヒートマップlegend, legendHideHeader, and legendWidthマトリックスfit, legend, legendHideHeader, legendWidth,and sqrt

平行座標

maxColumnWidth, minColumnWidth, and totalsピボットテーブルfit, legend, legendHideHeader, legendWidth,and sqrt

散布図

legend, legendHideHeader, legendWidth,maxColumnWidth, minColumnWidth, miniBars,normalize, and sqrt

積み上げ棒/縦棒

fit, legend, legendHideHeader, legendWidth,and sqrt

スケジュール

hideHeaderColumn, maxColumnWidth, andminColumnWidth

値テーブル

parameters プロパティで設定されるウィジェットプロパティは、次のとおりです。


型String

alignmentX

このウィジェットで使用可能• image


説明ウィジェット内の画像を横方向に配置します。有効な値は、left (デフォルト)、center、および right です。

75



型String

alignmentY



説明ウィジェット内の画像を縦方向に配置します。有効な値は、top (デフォルト)、center、および bottom です。

型Boolean

compact

次のウィジェットで使用可能• listselector

• number

• pillbox


説明表示する数値を短縮するか (true)、否か (false) を示します。たとえば、true の場合、数値 48,081 は 48k と表示されます。数値は丸められているように見えますが、そうではありません。計算を実行する場合には、値 48,081 がグラフに保持されます。false の場合、48,081 は 48,081 と表示されます。デフォルトは、false です。

型Boolean

computeTotal

次のウィジェットで使用可能• chart (visualizationType が stackwaterfall および waterfall の場合の

み)


説明合計測定値列を含めるか (true)、否か (false) を示します。デフォルトは、true です。

76



型List

containedWidgets

このウィジェットで使用可能• container


説明コンテナウィジェット内のすべてのウィジェットのリスト。

例次の例は、コンテナウィジェット (container_1) に含まれる 2 つのウィジェット(meafilter_1 と chart_1) を示しています。"container_1": {

"type": "container","position":{

"x": 0,"y": 0

},"parameters":{

"containedWidgets": ["meafilter_1","chart_1"

]}

}

型String

destination

このウィジェットで使用可能• link


説明ダッシュボード、レンズ、またはステップの ID。デフォルト値は null です。

型String

destinationType


77




説明リンクの対象種別。値は次のとおりです。• dashboard — 保存されたダッシュボード• explore — 未保存で有効なレンズの探索セッション• lens — 保存されたレンズデフォルトは、lens です。

型String

documentId



説明背景として適用する画像ファイルの 15 文字のドキュメント ID。セキュリティを保護するため、画像ファイルをドキュメントとして Salesforce にアップロードし、[外部参照可]オプションを選択する必要があります。このオプションが選択されていない場合や参照先ドキュメントが画像でない場合には、ウィジェットに画像が表示されません。デフォルト値は null です。

例次の画像ウィジェット (image_1) の例では、ID 015R0000000DClP の画像が表示されています。"image_1": {

"type": "image","parameters": {

"documentId": "015R0000000DClP","fit": "stretch","alignmentX": "center","alignmentY": "center"

}}

型Boolean

dualAxis

次のウィジェットで使用可能• chart (visualizationType が combo の場合のみ)

78




説明2 つの基準それぞれの軸を含めるか (true)、否か (false) を示します。デフォルトは、true です。

型Boolean

expanded

次のウィジェットで使用可能• dateselector

• listselector


説明ウィジェット内の項目を表示するか (true)、非表示にするか (false) を示します。非表示 (false) の場合、ダッシュボード閲覧者はウィジェットをクリックして、項目を表示および変更できます。デフォルトは、true です。

メモ: モバイルデバイスでは、この設定に関係なくリスト内の項目が表示されます。

型Boolean

exploreLink


• comparetable

• listselector

• number

• pillbox

• valuestable


説明ウィジェットに探索アイコンを表示して、ダッシュボード閲覧者がそのアイコンをクリックしてウィジェットをレンズとして探索できるようにするか (true)、否か(false) を示します。このオプションは、SAQL フォームではなくコンパクトフォーム

79



のステップに基づくウィジェットのみに影響します。この設定に関係なく、SAQL

フォームのステップに基づいて構築されたウィジェットを探索できません。デフォルトは true です。

メモ: モバイルデバイスでは、この設定に関係なくアイコンが表示されます。

型Boolean

fit (グラフウィジェット)

このウィジェットで使用可能• chart (visualizationType が scatter の場合のみ)


説明グラフの軸がデータの中心にあるか (true)、(0, 0) にあるか (false) を示します。デフォルトは、false です。

型String

fit (画像ウィジェット)



説明画像のサイズを変更する方法を指定します。有効な値は、original (デフォルト)、stretch、tile、fitwidth、fitheight です。

型Integer

fontSize

次のウィジェットで使用可能• link

• number

• text


説明数値またはテキストのフォントサイズ。デフォルトは次のとおりです。• number: 36

80



• text: 26

型Boolean

hideHeaderColumn


• valuestable

ダッシュボードデザイナのユーザインターフェースで公開いいえ。JSON を介してのみ編集できます。

説明未加工データテーブルの最初の列 (行カウント) を非表示にするか (true)、否か (false)

を示します。デフォルトは、false です。

メモ: この設定は、モバイルデバイスでウィジェットを表示する場合には適用されません。

型String

imageUrl

このウィジェットで使用可能• box

• container


説明背景として適用する画像ファイルのドキュメント ID。セキュリティを保護するため、画像ファイルをドキュメントとして Salesforce にアップロードし、[外部参照可] オプションを選択する必要があります。このオプションが選択されていない場合や参照先ドキュメントが画像でない場合には、ウィジェットに画像が表示されません。デフォルト値は null です。

例次の例には、背景画像が含まれるコンテナウィジェット (container_1) があります。画像のドキュメント ID は 01599000000D8HP です。"container_1": {

"type": "container","position": {

"x": 0,"y": 0

},"parameters": {

81



"containedWidgets": [],"imageUrl": "01599000000D8HP"

}}

型Boolean

includeState



説明ダッシュボード閲覧者によって適用された選択内容を閲覧者がリンクをクリックした後で destination に保持するか (true)、否か (false) を示します。選択内容にdestination との互換性がないか、null の場合は、保持されません。デフォルトは、false です。

型Boolean

instant


• listselector

• rangeselector


説明ダッシュボード閲覧者がこのウィジェットで選択を行ったときに、ファセットされた他のウィジェットをすぐに更新するか (true)、否か (false) を示します。false の場合、facet が設定されたウィジェットに変更をカスケードするには、ダッシュボード閲覧者が [更新] をクリックする必要があります。true の場合、[更新] ボタンは非表示になります。デフォルトは次のとおりです。• dateselector: false

• listselector: true

• rangeselector: false

メモ: Wave ダッシュボードデザイナで展開されているリスト、範囲、または日付ウィジェットの場合、このウィジェットプロパティは常に有効になります。つまり、このウィジェットの選択内容は、他のウィジェットでも即座に更新さ

82



れます。これらのウィジェットが展開されている間は、この設定を変更できません。

型Boolean

legend

このウィジェットで使用可能• chart (visualizationTypeが hbar、vbar、stackhbar、stackvbar、pie、

scatter、time、hdot、vdot、matrix、calheatmap、heatmap、parallelcoords、stackwaterfall、funnel、または choropleth の場合のみ)


説明凡例を表示するか (true)、否か (false) を示します。pivottable 以外のすべてのグラフの種類のデフォルトは false です。

メモ: モバイルデバイスの場合、pieウィジェットでのみ凡例を表示できます。

型Boolean

legendHideHeader


scatter、time、hdot、vdot、matrix、calheatmap、heatmap、stackwaterfall、combo、combo、または parallelcoords の場合のみ)


83



説明凡例にタイトルがあるか (true)、否か (false) を示します。タイトルは常に、凡例に記述されたディメンションの名前になります。pivottable 以外のすべてのグラフの種類のデフォルトは false です。


型Integer

legendWidth


scatter、time、hdot、vdot、matrix、calheatmap、heatmap、stackwaterfall、combo、または parallelcoords の場合のみ)


説明凡例領域の幅 (ピクセル単位)。pivottable 以外のすべてのグラフの種類のデフォルトは 145 です。


型Integer

maxColumnWidth

次のウィジェットで使用可能• chart (visualizationTypeが comparisontable、pivottable、stackhbar、

stackvbar、hbar、stackwaterfall、または vbar の場合のみ)

• comparisontable

• valuestable


説明デスクトップまたはラップトップの Web ブラウザでのディメンション項目の最大表示サイズ (ピクセル)。デフォルトは 200、最小値は 20、最大値は 200 です。

メモ: この設定は、モバイルデバイスでウィジェットを表示する場合には適用されません。最小値 (20) を指定した場合、この設定は、Classic デザイナダッシュボードにバーを表示する比較テーブル列には適用されません。

84



型String

measureField

次のウィジェットで使用可能• listselector

• number

• pillbox


説明データで実行する数学的関数。<formula>_<field> の形式で measureField を指定します。<formula> は、measures ステッププロパティで指定したいずれかの数式と一致する必要があります。<formula> に使用できる値は、次のとおりです。• avg — 数学的平均値 (中間値) を計算します• max — 最大値• min — 最小値• sum — すべての値を加算します• unique — 一意の値の数をカウントします。たとえば、これを使用して一意の

ディメンションの数をカウントします。<formula> と組み合わせる <field> は、measures で指定した項目名と一致する必要があります。たとえば、measures ステップのプロパティが次のようになっているとします。

"measures”: [["sum","Profit"

],["avg","Discount"

],["count","ModelNumber"

]]

この場合、measureField は sum_Profit、avg_Discount、またはunique_ModelNumber である必要があります。avg と Profit が measures プロ

85



パティでペアになっていないため、measureFieldを avg_Profitにすることはできません。

メモ: 基準とは異なり、ユーザインターフェース内のディメンションのカウントでは、一意のディメンション値の数が計算されます。その結果、基盤となるJSON の measureField には、unique_<dimension_field_name> などのunique 数式が表示されます、

デフォルト値は null です。

型Integer

minColumnWidth

このウィジェットで使用可能• chart (visualizationTypeが comparisontable、pivottable、stackhbar、

stackvbar、hbar、stackwaterfall、または vbar の場合のみ)

• comparisontable

• valuestable


説明ディメンション項目の表示サイズの最小値 (ピクセル単位)。デフォルトは、30 です。


型Integer

miniBars

このウィジェットで使用可能• chart (visualizationType が stackhbar、stackvbar、hbar、または vbar

の場合のみ)


説明(Classic デザイナダッシュボードのみ) 棒グラフでの棒の表示サイズ (ピクセル単位)。デフォルトは、0 です (棒グラフと縦棒グラフでのみ使用可能)。

型Boolean

multiMetrics

86



このウィジェットで使用可能• chart (visualizationType が hbar または vbar の場合のみ)


説明2 つ以上の基準を各グループの下に隣接する棒として表示するか (true)、個別の隣接するグラフとして表示するか (false) を示します。デフォルトは、false です (棒グラフと縦棒グラフでのみ使用可能)。

型String

negativeColor

次のウィジェットで使用可能• chart (visualizationType が waterfall の場合のみ)


説明グラフの値が減少した測定値列の色。rgb(a, b, c, d) の形式で色を指定します。0 ～ 255 の数値を使用し、a は色の赤の度合い、b は緑の度合い、c は青の度合いを示します。0 の値は色がないことを示し、255 の値は色の度合いが最大であることを示します。0 ～ 1 の数値を使用し、d は透明度を示します。0 の値は透明を示し、1 の値は不透明を示します。たとえば、rgb(0, 0, 0, 0.93) は不透明の黒に近い色に設定します。rgb(255,

0, 0, 0.14) は透明に近い赤色に設定します。または、16 進表記を使用して色を設定することもできます。16 進表記を使用する場合、透明度は設定できません。デフォルトでは、16 進表記の色がすべて不透明になります。#000000 は 16 進表記の黒を示します。#ff0000 は赤を示します。

型Boolean

normalize

このウィジェットで使用可能• chart (visualizationType が stackhbar または stackvbar の場合のみ)


87



説明グラフを対数スケールを使用して表示するか (true)、線形スケールを使用して表示するか (false) を示します。デフォルトは、false です (stackhbar と stackvbar でのみ使用可能)。

型String

numberColor

このウィジェットで使用可能• number


説明(Wave デザイナダッシュボードのみ) 数値のフォントの色。rgb(a, b, c, d) の形式で色を指定します。0 ～ 255 の数値を使用し、a は色の赤の度合い、b は緑の度合い、c は青の度合いを示します。0 の値は色がないことを示し、255 の値は色の度合いが最大であることを示します。0 ～ 1 の数値を使用し、d は透明度を示します。0 の値は透明を示し、1 の値は不透明を示します。たとえば、rgb(0, 0, 0, 0.93) は不透明の黒に近い色に設定します。rgb(255,

0, 0, 0.14) は透明に近い赤色に設定します。または、16 進表記を使用して色を設定することもできます。16 進表記を使用する場合、透明度は設定できません。デフォルトでは、16 進表記の色がすべて不透明になります。#000000 は 16 進表記の黒を示します。#ff0000 は赤を示します。デフォルトは、#000 です。

型Integer

numberSize



説明(Wave デザイナダッシュボードのみ) 数値のフォントのサイズ。デフォルトは 26 です。

型String

positiveColor

88





説明グラフの値が減少または変わらない測定値列の色。rgb(a, b, c, d) の形式で色を指定します。0 ～ 255 の数値を使用し、a は色の赤の度合い、b は緑の度合い、c は青の度合いを示します。0 の値は色がないことを示し、255 の値は色の度合いが最大であることを示します。0 ～ 1 の数値を使用し、d は透明度を示します。0 の値は透明を示し、1 の値は不透明を示します。たとえば、rgb(0, 0, 0, 0.93) は不透明の黒に近い色に設定します。rgb(255,


型Boolean

showValues

このウィジェットで使用可能• chart (visualizationType が stackwaterfall または waterfall の場合の

み)


説明各基準列の値を表示するか (true)、否か (false) を示します。デフォルトは、true です。

型Boolean

splitAxis

このウィジェットで使用可能• chart


89



説明グラフの各ディメンションを独自の軸で測定するか (true)、共有軸で測定するか(false) を示します。multiMetrics が true に設定されている場合にのみ適用されます。デフォルトは、false です (棒グラフと縦棒グラフでのみ使用可能)。


型Boolean

sqrt

このウィジェットで使用可能• chart (visualizationType が parallelcoords、hdot、vdot、time、

scatter、stackhbar、stackvbar、hbar、stackwaterfall、または vbar

の場合のみ)


説明グラフを対数スケールを使用して表示するか (true)、線形スケールを使用して表示するか (false) を示します。デフォルトは、falseです (棒グラフ、縦棒グラフ、折れ線グラフ、時系列でのみ使用可能)。


型String

startColor



説明グラフの最初の測定値列の色。rgb(a, b, c, d) の形式で色を指定します。0 ～ 255 の数値を使用し、a は色の赤の度合い、b は緑の度合い、c は青の度合いを示します。0 の値は色がないことを示し、255 の値は色の度合いが最大であることを示します。

90



0 ～ 1 の数値を使用し、d は透明度を示します。0 の値は透明を示し、1 の値は不透明を示します。たとえば、rgb(0, 0, 0, 0.93) は不透明の黒に近い色に設定します。rgb(255,


型String

step


• comparetable

• dateselector

• globalfilters

• listselector

• number

• pillbox

• rangeselector

• valuestable


説明ウィジェットにデータを提供するステップの名前。デフォルト値は null です。

型Boolean

stretch

このウィジェットで使用可能• box


説明画像の幅と高さをウィジェットの幅と高さと同じ値に設定するか (true)、否か (false)


91



型Boolean

stretchImage

このウィジェットで使用可能• container


説明画像の幅と高さをウィジェットの幅と高さと同じ値に設定するか (true)、否か (false)


型String

text


• text


説明テキストウィジェットに表示するメッセージ。たとえば、textに “Hello, World!”

という値が割り当てられている場合、テキストウィジェットに「Hello, World!」と表示されます。デフォルト値は null です。

型String

textAlignment


• text


説明テキストの配置。使用できる値には、left、center、および right があります。値が指定されない場合、テキストの配置はデフォルトの中央揃えになります。デフォルトは次のとおりです。• number: right

• text: center

92



型String

textColor

次のウィジェットで使用可能• link

• number

• text


説明テキストのフォントの色。rgb(a, b, c, d) の形式で色を指定します。0 ～ 255 の数値を使用し、a は色の赤の度合い、b は緑の度合い、c は青の度合いを示します。0 の値は色がないことを示し、255 の値は色の度合いが最大であることを示します。0 ～ 1 の数値を使用し、d は透明度を示します。0 の値は透明を示し、1 の値は不透明を示します。たとえば、rgb(0, 0, 0, 0.93) は不透明の黒に近い色に設定します。rgb(255,


型String

title


• listselector

• number

• pillbox

• rangeselector


説明ウィジェットのタイトル。デフォルト値は null です。

93



型String

titleColor



説明(Wave デザイナダッシュボードのみ) タイトルのフォントの色。rgb(a, b, c, d) の形式で色を指定します。0 ～ 255 の数値を使用し、a は色の赤の度合い、b は緑の度合い、c は青の度合いを示します。0 の値は色がないことを示し、255 の値は色の度合いが最大であることを示します。0 ～ 1 の数値を使用し、d は透明度を示します。0 の値は透明を示し、1 の値は不透明を示します。たとえば、rgb(0, 0, 0, 0.93) は不透明の黒に近い色に設定します。rgb(255,


型Integer

titleSize



説明(Wave デザイナダッシュボードのみ) タイトルのフォントのサイズ。デフォルトは 26

です。

型String

totalColor



94



説明グラフの合計測定値列の色。rgb(a, b, c, d) の形式で色を指定します。0 ～ 255 の数値を使用し、a は色の赤の度合い、b は緑の度合い、c は青の度合いを示します。0 の値は色がないことを示し、255 の値は色の度合いが最大であることを示します。0 ～ 1 の数値を使用し、d は透明度を示します。0 の値は透明を示し、1 の値は不透明を示します。たとえば、rgb(0, 0, 0, 0.93) は不透明の黒に近い色に設定します。rgb(255,


型Boolean

totals

次のウィジェットで使用可能• chart (visualizationType が pivottable の場合のみ)


説明各基準列にすべての値の合計を表示する行を含めるか (true)、否か (false) を示します。chart のデフォルトは、false です (pivottable でのみ使用可能)。


型Boolean

trellis

このウィジェットで使用可能• chart


説明ステップに 2 つ以上のグループ化と 1 つの基準がある場合、最後のグループ化を独自の軸に表示するか (true)、他のグループ化と同じ軸に表示するか (false) を示します。

95



chart のデフォルトは、false です (棒グラフと縦棒グラフでのみ使用可能)。


型String

videoSize

このウィジェットで使用可能• url


説明YouTube ビデオのサイズ。値は次のとおりです。• (4/3) 240 x 180

• (4/3) 420 x 315

• (4/3) 480 x 360

• (4/3) 640 x 480

• (4/3) 960 x 720

• (16/9) 320 x 180

• (16/9) 560 x 315

• (16/9) 640 x 360

• (16/9) 853 x 480

• (16/9) 1280 x 720

デフォルトは、(4/3) 240 x 180 です。

メモ: モバイルデバイスでは、url ウィジェットは表示されません。

型String

visualizationType


• link


説明データの表示に使用されるグラフの種類。値は次のとおりです。• calheatmap* — カレンダーヒートマップ• choropleth — コロプレス (地図)

96



• combo — 複数の総計値を示す線と棒• comparisontable — 比較テーブル (Classic デザイナ内のみ)。• flatgauge — フラットゲージ (Wave ダッシュボードデザイナ内のみ)。• funnel — じょうご• hbar — 横棒• hdot* — 横方向のドットプロット• heatmap* — ヒートマップ• matrix* — マトリックス• parallelcoords* — 平行座標• pie — ドーナツ• pivottable* — ピボットテーブル• polargauge — 極座標 (Wave ダッシュボードデザイナ内のみ)。• pyramid — ピラミッド (Wave ダッシュボードデザイナ内のみ)。• rating — 評価 (Wave ダッシュボードデザイナ内のみ)。• scatter — 散布図• stackhbar — 積み上げ横棒• stackpyramid — 積み上げピラミッド (Wave ダッシュボードデザイナ内のみ)。• stackvbar — 積み上げ縦棒• stackwaterfall — 積み上げ滝• time — タイムライン• valuestable — 未加工データテーブル (Classic デザイナ内のみ)。• vbar — 縦棒• vdot* — 縦方向のドットプロット• waterfall — 滝

メモ: Wave ダッシュボードデザイナは、アスタリスク (*) が付いているグラフの種類をサポートしていません。サポートされていない型を指定すると、ダッシュボードではデザイナによって hbar に置き換えられます。

型ConnectUri

url

このウィジェットで使用可能• url


説明YouTube ビデオの URL。

97



デフォルト値は null です。

メモ: モバイルデバイスでは、url ウィジェットは表示されません。

98


wave analytics ダッシュボード json リファレンス¬¬ 1 章 wave analytics...

Documents