ダッシュボードについて: ダッシュボード コンポーネントと FormXML

 

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

ダッシュボードは、Microsoft Dynamics 365 で使用されるフォームの種類の 1 つです。 フォームがダッシュボードかどうかは、SystemForm.Type または UserForm.Type 属性を使用して確認できます。 フォームの種類がダッシュボードの場合は、プロパティ値が "0" になっています。

フォーム コンテンツとプレゼンテーションの定義は、FormXML 内に格納されます。詳細:Form XML schema

さまざまな種類のダッシュボードの FormXML 文字列の例については、「サンプル ダッシュボード」を参照してください。

このトピックの内容

ダッシュボードのコンポーネント

ダッシュボード コンポーネントと FormXML 要素

ダッシュボード用にサポートされている FormXML 要素

ダッシュボード コントロール数の設定

ダッシュボードのコンポーネント

ダッシュボードには、グラフ、グリッド、IFRAME、または Web リソースを含めることができます。 既定では、1 つのダッシュボードにこれらのコンポーネントを最大で 6 つ含めることができます。

Microsoft Dynamics 365 の設置型バージョンでは、Windows PowerShell を使用して、ダッシュボードに表示するコンポーネントの数を変更できます。詳細:ダッシュボード コントロール数の設定

グラフ

組織所有のダッシュボードには、組織所有のグラフのみを含めることができます。 ただし、ユーザー所有のダッシュボードには、ユーザー所有のグラフと組織所有のグラフを含めることができます。詳細:ビジュアル化を使用したデータの表示 (グラフ)

グリッド

グリッドは、Microsoft Dynamics 365 内のクエリ (ビュー) からデータをフェッチします。 組織所有のダッシュボードには、保存済みのクエリからデータをフェッチするグリッドのみを含めることができます。 ただし、ユーザー所有のダッシュボードには、ユーザー クエリと保存済みクエリからデータをフェッチするグリッドを含めることができます。詳細:SavedQuery (ビュー) エンティティのメッセージとメソッド

IFRAME

IFRAME を組織所有のダッシュボードに追加する際には、クロスフレーム スクリプトを制限するか、または許可するかを指定できます。 これを行うには、FormXML 内の IFRAME コントロールで <Security> (FormXml) パラメーターを使用する必要があります。 ただし、ユーザー所有のダッシュボードについては、IFRAME のクロスフレーム スクリプトは制限され、これを変更することはできません。 クロスフレーム スクリプトが有効化された IFRAME を含むユーザー所有ダッシュボードを作成しようとすると、エラー メッセージが表示されます。詳細:フォーム上で IFRAME および Web リソース コントロールを使用する。

Web リソース

ダッシュボードには、フォーム対応の Web リソースのみを含めることができます。 この制限は Web アプリケーション内でダッシュボード デザイナーを使用して Web リソースを追加する際に適用されますが、SDK を使用してダッシュボードに Web リソースを追加する際には、このような制限は適用されません。詳細:Microsoft Dynamics 365 の Web リソース

ダッシュボード コンポーネントと FormXML 要素

ダッシュボード コンポーネントは、FormXML で指定された値に基づいて Microsoft Dynamics 365 に表示されます。 次の画像は、ダッシュボードの例を示しています。 各ダッシュボードには、複数のタブを含めることができます。 タブとは、ダッシュボードの本文を分割する垂直スタックで、展開したり閉じたりすることができます。詳細:<tabs> (FormXml)。 タブには、複数のセクションを含めることができます。 セクションを使用すると、ダッシュボード コンポーネントをグループ化およびレイアウトできます。詳細:<sections> (FormXml)

ダッシュボード用にサポートされている FormXML 要素

ダッシュボードはフォームの一種ですが、すべての FormXML 要素と属性がダッシュボードによってサポートされるわけではありません。 次の表は、ダッシュボードによってサポートされる FormXML 要素、下位要素、および属性に関する情報をまとめたものです。詳細:Form XML reference

さまざまな種類のダッシュボードの FormXML の例については、「サンプル ダッシュボード」を参照してください。

Element	下位要素	要素属性
<form> (FormXml)	<tabs> (FormXml)	-
<tabs> (FormXml)	<tab> (FormXml)	-
<tab> (FormXml)	<labels> (FormXml) <columns> (FormXml)	id name expanded verticallayout showlabel locklevel
<labels> (FormXml)	<label> (FormXml)	-
<label> (FormXml)	-	description languagecode
<columns> (FormXml)	<column> (FormXml)	-
<column> (FormXml)	<sections> (FormXml)	width
<sections> (FormXml)	<section> (FormXml)	addedby
<section> (FormXml)	<labels> (FormXml) <rows> (FormXml)	id name showlabel showbar columns
<rows> (FormXml)	<row> (FormXml)	addedby
<row> (FormXml)	<cell> (FormXml)	addedby
<cell> (FormXml)	<labels> (FormXml) <control> (FormXml)	auto addedby id showlabel rowspan colspan
<control> (FormXml)	<parameters> (FormXml)	id classid
<parameters> (FormXml)	<Url> (FormXml) <PassParameters> (FormXml) <Security> (FormXml) <Scrolling> (FormXml) <Border> (FormXml) <ViewIds> (FormXml) <ViewId> (FormXml) <IsUserView> (FormXml) <IsUserChart> (FormXml) <TargetEntityType> (FormXml) <AutoExpand> (FormXml) <RecordsPerPage> (FormXml) <EnableQuickFind> (FormXml) <EnableJumpBar> (FormXml) <EnableChartPicker> (FormXml) <EnableViewPicker> (FormXml) <ChartGridMode> (FormXml) <VisualizationId> (FormXml)	-

ダッシュボード コントロール数の設定

下記に示すように、Windows PowerShell を使用して、ダッシュボード コントロールの数を調整できます。 または、展開 Web サービスを使用できます。 最大値は 20 です。 詳細については、「展開 Web サービスの概要」を参照して、 MaximumControlsLimit プロパティの更新方法を確認してください。

ダッシュボード制限の取得と設定

1. Windows PowerShell コマンド ウィンドウを開きます。

2. Microsoft Dynamics 365Windows PowerShell スナップインを追加します。

   Add-PSSnapin Microsoft.Crm.PowerShell
   

3. 現在の設定を取得します。

   $setting = Get-CrmSetting -SettingType DashboardSettings
   

4. 現在の設定を変更します。

   $setting.MaximumControlsLimit = 5
   

   Set-CrmSetting -Setting $setting
   

関連項目

ダッシュボードによるデータの分析
ダッシュボードに対するアクション
ダッシュボードを作成する
Form XML reference

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権