Erstellen eines Dashboards
Organisationseigene Dashboards können mithilfe der Dynamics 365 Customer Engagement Webdienste erstellt werden oder indem Sie das Formular für Entitäten in Dynamics 365 for Customer Engagement anpassen, indem Sie die Datei customizations.xml bearbeiten.
Notiz
Einige Dashboards, die unter Verwendung von SDK oder durch Anpassung des Entitätsformulars erstellt wurden, werden vom Dashboard-Designer in der Webanwendung nicht unterstützt. Weitere Informationen finden Sie unter Einschränkungen: Dashboards mithilfe des SDK oder durch Formularanpassung erstellen unten in diesem Thema.
Bevor Sie ein Dashboard erstellen, sollten Sie Folgendes erwägen:
Typ des Dashboards: Wenn die Dashboards in der gesamten Organisation verfügbar sein sollen und Sie die Zugriffsebenen nicht genauer verwalten möchten, sollten Sie ein Dashboard im Besitz einer Organisation erstellen. Wenn Sie sich jedoch über die Zugriffsrechte und die Sicherheit Ihres dashboards Gedanken machen, sollten Sie überlegen, ein Dashboard im Besitz eines Benutzers zu erstellen, bei der Sie eine größere Kontrolle darüber haben, wer darauf zugreifen kann.
Um die Dashboards im Besitz der Organisation zu erstellen, müssen Sie die Rolle "Systemanpasser" oder "Systemadministrator" besitzen.
Dashboardlayout: Beim Erstellen von Dashboards müssen Sie die FormXML-Datei verwenden, um die Dashboardkomponenten das Layout zu definieren. Informationen zum Arbeiten mit FormXML, um ein Dashboard zu definieren, finden Sie unter Dashboardkomponenten und FormXML-Elemente. Einige Beispiel-FormXML-Dateien unterschiedlicher Typen von Dashboards finden Sie unter Beispiel-Dashboards.
Erstellen eines Dashboards mithilfe von SDK
Um ein Dashboard zu erstellen, erstellen Sie eine Instanz von SystemForm für ein Dashboard im Besitz der Organisation, oder UserForm für ein Dashboard im Besitz des Benutzers. Im folgenden Beispiel wird gezeigt, wie ein Dashboard im Besitz der Organisation erstellt wird.
//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 = _serviceProxy.Create(dashboard);
Ein vollständiges Beispiel finden Sie unter Beispiel: Erstellen, Abrufen, Aktualisieren und Löschen eines Dialogs. Ein Beispiel des Erstellens eines benutzereigenenn Dashboards und dessen Zuordnung an einen anderen Benutzer finden Sie unter Beispiel: Zuordnung eines benutzereigenenn Dashboards an einen anderen Benutzer.
Erstellen eines Dashboards im Besitz eines Benutzers durch Anpassen des Entitätsformulars
Die customizations.xml-Datei, die mit einer nicht verwalteten Lösung exportiert wird, enthält Definitionen für Entitätsformulare und Dashboards. Sie können die customizations.xml-Datei ändern oder hinzufügen, um ein Dashboard hinzuzufügen oder zu aktualisieren.
Erstellen eines Dashboards durch Anpassen eines Entitätsformulars
Melden Sie sich bei Dynamics 365 for Customer Engagement an.
Exportieren Sie eine Lösung. Informationen dazu finden Sie unter Exportierung, Vorbereitung zum Bearbeiten und Importierung des Menübands.
Suchen Sie die Datei customizations.xml im Ordner "Exportierte Lösungen", und öffnen Sie sie zum Bearbeiten.
Navigieren Sie zum Ende des Dashboardbereichs in der customizations.xml-Datei, indem Sie nach dem folgenden Tag suchen:
</Dashboards>.Vor dem
</Dashboards>-tag fügen Sie Folgendes hinzu, um ein neues Dashboard zu definieren:<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>Speichern der customizations.xml-Datei.
Importieren Sie die .zip-Datei als Lösung in Dynamics 365 for Customer Engagement. Weitere Informationen: Exportieren, Vorbereiten der Bearbeitung und Importieren des Menübands.
Einschränkungen: Erstelen von Dashboards mithilfe des SDK oder durch Formularanpassung
Bestimmte Dashboards, die mithilfe der Dynamics 365 Customer Engagement Webdienste oder durch die Anpassung von Formularen erstellt oder geändert werden, werden vom Dashboard-Designer in der Webanwendung nicht unterstützt. Vermeiden Sie Folgendes beim Erstellen oder Ändern eines Dashboards mithilfe des SDK oder durch Formularanpassung.
Allgemein
Problem: Sie können ein Dashboard erstellen, das eine Registerkarte enthält, ohne dass ein Abschnitt in der FormXML-Datei definiert wird.
Abschluss: Achten Sie darauf, dass Sie ein Dashboard erstellen, bei dem mindestens ein Abschnitt für jede der Registerkarte in der FormXML-Datei definiert ist.
Problem: Sie können ein Dashboard erstellen, das nicht die gleiche Anzahl von
<row>-Elementen für einen Abschnitt enthält, wie in derrowspan-Eigenschaft eines<cell>-Elements des Abschnitt in der FormXML-Datei angegeben. Idealerweise müssen derrowspan-Eigenschaftswert eines<cell>-Elements und die Anzahl der<row>-Elemente in einem Abschnitt identisch sein.Lösung: Achten Sie darauf, dass Sie ein Dashboard erstellen, das die gleiche Anzahl von
<row>-Elementen für einen Abschnitt enthält, wie in derrowspan-Eigenschaft eines<cell>-Elements in dem Abschnitt angegeben ist.
Raster
Problem: Sie können ein Dashboard erstellen, das Raster enthält, bei denen der <AutoExpand>-Parameterwert für das Raster auf Auto gesetzt ist.
Lösung: Achten Sie darauf, dass Sie den <AutoExpand>-Parameterwert als Fixed für die Raster in der FormXML-Datei beim Erstellen eines Dashboards angeben.
IFRAMEs
Problem: Sie können ein Dashboard erstellen, das einen IFRAME enthält. Dies ist der Fall, wenn Sie keinen Wert für den <Url>-Parameter für das IFRAME-Steuerelement in der FormXML-Datei angeben.
Lösung: Achten Sie darauf, dass Sie einen wert für den <Url>-Parameter angeben, während Sie einen IFRAME in der FormXML-datei erstellen.
Siehe auch
Dashboards für Microsoft Dynamics 365 Customer Engagement
Nutzung der FormXML-Datei für Dashboards
Aktionen für Dashboards
Beispiel-Dashboards
Beispiel: Ein Dashboard erstellen, abbrufen, aktualisieren und löschen (EAAL)
Anpassen von Entitätsformularen in Microsoft Dynamics 365 Customer Engagement