ダッシュボードはモデル駆動型アプリで使用される様々な種類のフォームのうちの 1 つです。
SystemForm.TypeまたはUserForm.Typeを使用して、フォームがダッシュボードであるかどうかを判断します。 フォームの種類がダッシュボードの場合は、プロパティ値が 0 になっています。
フォーム コンテンツとプレゼンテーションの定義は、FormXML 内に格納されます。 詳細については、「 フォーム XML スキーマ」を参照してください。
さまざまな種類のダッシュボードの FormXML 文字列の例については、「サンプル ダッシュボード」を参照してください。
ダッシュボードのコンポーネント
ダッシュボードには、グラフ、グリッド、IFRAME、または Web リソースを含めることができます。 既定では、1 つのダッシュボードにこれらのコンポーネントを最大で 6 つ含めることができます。
グラフ
組織所有のダッシュボードには、組織所有のグラフのみを含めることができます。 ただし、ユーザー所有のダッシュボードには、ユーザー所有のグラフと組織所有のグラフを含めることができます。 詳細については、 モデル駆動型アプリのグラフ (視覚化) を参照してください。
グリッド
モデル駆動型アプリにおけるグリッドは、クエリ (ビュー) からデータをフェッチします。 組織所有のダッシュボードには、保存済みのクエリからデータをフェッチするグリッドのみを含めることができます。 ただし、ユーザー所有のダッシュボードには、ユーザー クエリと保存済みクエリからデータをフェッチするグリッドを含めることができます。 詳細については、 SavedQuery テーブルを参照してください。
IFRAMEs
IFRAME を組織所有のダッシュボードに追加する際には、クロスフレーム スクリプトを制限するか、または許可するかを指定できます。
これを行うには、FormXML の IFRAME コントロールで <Security> パラメーターを使用します。 ただし、ユーザー所有のダッシュボードについては、IFRAME のクロスフレーム スクリプトは制限され、これを変更することはできません。 クロスフレーム スクリプトが有効化された IFRAME を含むユーザー所有ダッシュボードを作成しようとすると、エラー メッセージが表示されます。
Web リソース
フォームが有効な Web リソースのみをダッシュボードに含めることができます。 この制限は、Web アプリケーションでダッシュボード デザイナーを使用して Web リソースを追加する場合に適用されますが、Web リソースをダッシュボードに追加する場合、SDK はこの制限を適用しません。 詳細については、 モデル駆動型アプリの Web リソースに関するページを参照してください。
ダッシュボード コンポーネントと FormXML 要素
モデル駆動型アプリでは、FormXML で指定された値に基づいてダッシュボード コンポーネントが表示されます。 次の画像は、ダッシュボードの例を示しています。 各ダッシュボードには、複数のタブを含めることができます。 タブは、ダッシュボードの本体を区切る垂直スタックであり、展開または折りたたみを行うことができます。 タブには、複数のセクションを含めることができます。 セクションを使用すると、ダッシュボード コンポーネントのグループ化とレイアウトが可能になります。
ヒント
ダッシュボード ページにタブ名とセクション名が表示されません。
ダッシュボード用にサポートされている FormXML 要素
ダッシュボードはフォームの一種ですが、ダッシュボードはすべての FormXML 要素とパラメーターをサポートしているわけではありません。 次の表は、ダッシュボードがサポートする FormXML 要素、子要素、およびパラメーターに関する情報を示しています。
さまざまな種類のダッシュボードの FormXML の例については、「サンプル ダッシュボード」を参照してください。
| 要素 | 子要素 | 要素パラメーター |
|---|---|---|
<form> |
<tabs> |
なし |
<tabs> |
<tab> |
なし |
<tab> |
-<labels>- <columns> |
-id- name- expanded- verticallayout- showlabel- locklevel |
<labels> |
<label> |
なし |
<label> |
なし | -description- languagecode |
<columns> |
<column> |
なし |
<column> |
<sections> |
width |
<sections> |
<section> |
addedby |
<section> |
-<labels>- <rows> |
-id- name- showlabel- showbar- columns |
<rows> |
<row> |
addedby |
<row> |
<cell> |
addedby |
<cell> |
-<labels>- <control> |
-auto- addedby- id- showlabel- rowspan- colspan |
<control> |
<parameters> |
-id- classid |
<parameters> |
-<Url>- <PassParameters>- <Security>- <Scrolling>- <Border>- <ViewIds>- <ViewId>- <IsUserView>- <IsUserChart>- <TargetEntityType>- <AutoExpand>- <RecordsPerPage>- <EnableQuickFind>- <EnableJumpBar>- <EnableChartPicker>- <EnableViewPicker>- <ChartGridMode>- <VisualizationId> |
なし |