ダッシュボードを作成する
組織が所有するダッシュボードは、Microsoft Dataverse を使用するか、Dataverse のフォームをカスタマイズして customizations.xml ファイルを編集することで作成できます。
注意
SDK を使用、またはエンティティ フォームをカスタマイズして作成される一部のダッシュボードは、Web アプリケーションのダッシュボード デザイナーではサポートされません。 詳細については、このトピックの後半の 制限: SDK を使用する、またはフォームをカスタマイズしてダッシュボードを作成する を参照してください。
ダッシュボードを作成する前に、次の項目を検討します。
ダッシュボードの種類: ダッシュボードを組織全体で利用できるようにし、より詳細なレベルでのアクセス レベル管理を行わない場合は、通常、組織所有のダッシュボードを作成します。 ただし、ダッシュボードのアクセス特権やセキュリティについて考慮する必要がある場合は、アクセスするユーザーをより厳密に制御できる、ユーザー所有のダッシュボードの作成を検討してください。
組織所有のダッシュボードを作成するには、システム管理者ロールまたはシステム カスタマイザー ロールが必要です。
ダッシュボードのレイアウト: ダッシュボードを作成する場合は、FormXML を使用して、ダッシュボード コンポーネントとレイアウトを定義する必要があります。 詳細情報については、 ダッシュボード コンポーネントと FormXML 要素を参照してください。 さまざまな種類のダッシュボードの FormXML の例については、サンプル ダッシュボード を参照してください。
SDK を使用したダッシュボードの作成
ダッシュボードを作成するには、組織所有のダッシュボードの SystemForm のインスタンス、またはユーザー所有のダッシュボードの UserForm のインスタンスを作成します。 次の例は、組織所有のダッシュボードを作成する方法を示しています。
//This is the language code for U.S. English. If you are running this code
//in a different locale, you will need to modify this value.
int languageCode = 1033;
//We set up our dashboard and specify the FormXml. Refer to the
//FormXml schema in the Microsoft Dynamics CRM SDK for more information.
SystemForm dashboard = new SystemForm
{
Name = "Sample Dashboard",
Description = "Sample organization-owned dashboard.",
FormXml = String.Format(@"<form>
<tabs>
<tab name='Test Dashboard' verticallayout='true'>
<labels>
<label description='Sample Dashboard' languagecode='{0}' />
</labels>
<columns>
<column width='100%'>
<sections>
<section name='Information Section'
showlabel='false' showbar='false'
columns='111'>
<labels>
<label description='Information Section'
languagecode='{0}' />
</labels>
<rows>
<row>
<cell colspan='1' rowspan='10'
showlabel='false'>
<labels>
<label description='Top Opportunitiess - 1'
languagecode='{0}' />
</labels>
<control id='TopOpportunities'
classid='{{E7A81278-8635-4d9e-8D4D-59480B391C5B}}'>
<parameters>
<ViewId>{1}</ViewId>
<IsUserView>false</IsUserView>
<RelationshipName />
<TargetEntityType>opportunity</TargetEntityType>
<AutoExpand>Fixed</AutoExpand>
<EnableQuickFind>false</EnableQuickFind>
<EnableViewPicker>false</EnableViewPicker>
<EnableJumpBar>false</EnableJumpBar>
<ChartGridMode>Chart</ChartGridMode>
<VisualizationId>{2}</VisualizationId>
<EnableChartPicker>false</EnableChartPicker>
<RecordsPerPage>10</RecordsPerPage>
</parameters>
</control>
</cell>
<cell colspan='1' rowspan='10'
showlabel='false'>
<labels>
<label description='Top Opportunities - 2'
languagecode='{0}' />
</labels>
<control id='TopOpportunities2'
classid='{{E7A81278-8635-4d9e-8D4D-59480B391C5B}}'>
<parameters>
<ViewId>{1}</ViewId>
<IsUserView>false</IsUserView>
<RelationshipName />
<TargetEntityType>opportunity</TargetEntityType>
<AutoExpand>Fixed</AutoExpand>
<EnableQuickFind>false</EnableQuickFind>
<EnableViewPicker>false</EnableViewPicker>
<EnableJumpBar>false</EnableJumpBar>
<ChartGridMode>Grid</ChartGridMode>
<VisualizationId>{2}</VisualizationId>
<EnableChartPicker>false</EnableChartPicker>
<RecordsPerPage>10</RecordsPerPage>
</parameters>
</control>
</cell>
</row>
<row />
<row />
<row />
<row />
<row />
<row />
<row />
<row />
<row />
</rows>
</section>
</sections>
</column>
</columns>
</tab>
</tabs>
</form>",
languageCode,
defaultOpportunityQuery.SavedQueryId.Value.ToString("B"),
visualization.SavedQueryVisualizationId.Value.ToString("B")),
IsDefault = false
};
_dashboardId = service.Create(dashboard);
完成サンプルについては、サンプル: ダッシュボードを作成、取得、更新、削除 (CRUD) する方法 を参照してください。 ユーザー所有のダッシュボードを作成して別のユーザーに割り当てるサンプルについては、 サンプル: 他のユーザーにユーザー所有のダッシュボードを割り当てる を参照してください。
フォームをカスタマイズして組織所有のダッシュボードを作成する
アンマネージド ソリューションでエクスポートされる customizations.xml ファイルには、フォームやダッシュボードの定義が含まれています。 customizations.xml ファイルを追加または変更して、ダッシュボードを追加または更新できます。
フォームをカスタマイズしてダッシュボードを作成する
Dataverse にログインします。
ソリューションをエクスポートします。 これを行う際の詳細については、" エクスポート、編集の準備、およびリボンのインポートを参照してください。
エクスポートしたソリューション フォルダーで customizations.xml ファイルを参照し、編集用に開きます。
</Dashboards>タグを検索することで、customizations.xml ファイル内のダッシュボード領域の終わりを参照します。</Dashboards>タグの前に、次のコードを追加して新しいダッシュボードを定義します。<Dashboard> <LocalizedNames> <LocalizedName description="Dashboard_Name" languagecode="1033" /> </LocalizedNames> <IsCustomizable>1</IsCustomizable> <IsDefault>0</IsDefault> <FormXml> <forms type="dashboard"> *** Dashboard definition goes here. *** // See "Sample Dashboards" topic for the FormXML content to be used here. </forms> </FormXml> </Dashboard>customizations.xml ファイルを保存します。
.zip ファイルを Dataverse にソリューションとしてインポートします。 詳細: Eリボンのエクスポート、編集の準備、およびインポート。
制限事項: SDK を使用してまたはフォームのカスタマイズを使用してダッシュボードを作成すること
Dataverse を使用して、またはフォームのカスタマイズを通じて作成または変更された特定のダッシュボードは、Web アプリケーションのダッシュボード デザイナーではサポートされません。 SDK を使用するかフォーム カスタマイズを通じてダッシュボードを作成または変更する場合は、次の操作を避けてください。
全般
問題: FormXML で定義されたセクションのないタブを含むダッシュボードを作成できます。
解決方法: FormXML の各タブに対して定義されたセクションが少なくとも 1 つあるダッシュボードを作成してください。
問題: あるセクションの
<row>要素の数が、FormXML のそのセクションの<cell>要素のrowspanプロパティで指定された数と同じではないダッシュボードを作成できます。 理想としては、1 つのセクション内の<cell>要素のrowspanプロパティ値と<row>要素の数が同じである必要があります。解決方法: あるセクションの
<row>要素の数が、そのセクションの<cell>要素のrowspanプロパティで指定された数と同じであるダッシュボードを作成してください。
グリッド
問題: グリッドの <AutoExpand> パラメーター値が Auto に設定されたグリッドを含むダッシュボードを作成できます。
解決方法: ダッシュボードの作成時に、FormXML でグリッドの <AutoExpand> パラメーター値を Fixed として指定してください。
IFRAME
問題: IFRAME を含むダッシュボードを作成できます。 この状況は、FormXML で IFRAME コントロールの <Url> パラメーターの値を指定しない場合に発生します。
解決方法: FormXML で IFRAME を作成する場合は、<Url> パラメーターの値を必ず指定してください。
関連項目
ダッシュボード
ダッシュボード用 FormXML を使用
ダッシュボードに対するアクション
サンプル ダッシュボード
サンプル: ダッシュボードの作成、取得、更新、削除 (CRUD)
フォームのカスタマイズ
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。