Comprendre les tableaux de bord : composants et FormXML de tableau de bord

Article
02/24/2023

Le tableau de bord est l’un des différents types de formulaires dans les applications pilotées par modèle. Vous pouvez utiliser SystemForm.Type ou UserForm.Type pour déterminer si le formulaire est un tableau de bord. Un formulaire de type tableau de bord a la valeur de propriété 0.

La définition du contenu et de la présentation d’un formulaire est stockée dans le schéma FormXML. Pour plus d’informations, voir : Schéma XML du formulaire

Pour obtenir des exemples de chaînes FormXML pour différents types de tableaux de bord, voir Exemples de tableaux de bord.

Composants de tableau de bord

Un tableau de bord peut contenir des graphiques, des grilles, des IFRAME ou des ressources web. Par défaut, un même tableau de bord peut contenir jusqu’à six de ces composants.

Graphiques

Un tableau de bord appartenant à l’organisation ne peut contenir que des graphiques appartenant à cette organisation. Toutefois, un tableau de bord appartenant à un utilisateur peut contenir des graphiques appartenant à un utilisateur et des graphiques appartenant à l’organisation. Pour plus d’informations, voir Graphiques (visualisations) pour les applications pilotées par modèle

Grilles

Les grilles récupèrent les données depuis les requêtes (vues) dans les applications pilotées par modèle. Un tableau de bord appartenant à l’organisation ne peut contenir que les grilles qui récupèrent les données depuis les requêtes enregistrées. Toutefois, un tableau de bord appartenant à l’organisation peut contenir les grilles qui récupèrent les données provenant des requêtes utilisateur et des requêtes enregistrées. Plus d’informations : Table SavedQuery

IFRAME

Lorsque vous ajoutez un IFRAME à un tableau de bord appartenant à l’organisation, vous pouvez spécifier si les scripts sur plusieurs cadres doivent être limités ou autorisés. Pour cela, utilisez le paramètre <Security> dans le contrôle IFRAME dans le FormXML. Toutefois, pour les tableaux de bord appartenant à l’utilisateur, les scripts sur plusieurs cadres pour IFRAME sont limités et vous ne pouvez pas les modifier. Si vous essayez de créer un tableau de bord appartenant à l’utilisateur qui contient un IFRAME avec les scripts sur plusieurs cadres autorisés, un message d’erreur s’affiche.

Ressources web

Seules les ressources web de type formulaire peuvent être incluses dans un tableau de bord. Bien que cette restriction s’applique lorsque vous ajoutez une ressource Web avec le concepteur de tableau de bord dans l’application Web, cette restriction ne s’applique pas lorsque vous ajoutez une ressource Web à un tableau de bord avec le Kit de développement logiciel (SDK). Pour plus d’informations, voir : Ressources web pour les applications pilotées par modèle

Composants de tableau de bord et éléments du FormXML

Les composants de tableau de bord sont affichés dans les applications pilotées par modèle en fonction des valeurs spécifiées dans le FormXML. L’image suivante propose un exemple de tableau de bord. Chaque tableau de bord peut inclure plusieurs onglets. Les onglets sont une pile verticale séparant le corps du tableau de bord et peuvent être développés ou réduits. Un onglet peut contenir plusieurs sections. Les sections permettent de grouper et disposer les composants de tableau de bord.

Notes

Les noms d’onglet et de section ne sont pas affichés sur une page de tableau de bord.

Présentation des composants de tableau de bord.

Éléments de FormXML pris en charge pour les tableaux de bord

Bien que le tableau de bord soit un type de formulaire, tous les éléments et paramètres FormXML ne sont pas pris en charge par les tableaux de bord. Le tableau suivant fournit des informations sur les éléments, les éléments enfants et les paramètres FormXML pris en charge par les tableaux de bord.

Pour obtenir des exemples FormXML pour différents types de tableaux de bord, voir Exemples de tableaux de bord.

Élément	Éléments enfants	Élément paramètres
`<form>`	`<tabs>`	-
`<tabs>`	`<tab>`	-
`<tab>`	- `<labels>` - `<columns>`	- id - nom - développé - verticallayout - showlabel - locklevel
`<labels>`	`<label>`	-
`<label>`	-	- description - languagecode
`<columns>`	`<column>`	-
`<column>`	`<sections>`	largeur
`<sections>`	`<section>`	addedby
`<section>`	- `<labels>` - `<rows>`	- Id - nom - 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>`	-

Définir le nombre de contrôles de tableau de bord

Vous pouvez utiliser Windows PowerShell pour modifier le nombre de contrôles de tableau de bord comme il est décrit ici. La valeur maximale est 20.

Pour récupérer et définir la limite de tableau de bord

Ouvrez une fenêtre de commande Windows PowerShell.
Ajoutez le composant logiciel enfichable WindowsPowerShell pour les applications pilotées par modèle :
```
Add-PSSnapin Microsoft.Crm.PowerShell  
```

Récupérez le paramètre actuel :

$setting = Get-CrmSetting -SettingType DashboardSettings

Modifiez le paramètre actuel :

$setting.MaximumControlsLimit = 5

Set-CrmSetting -Setting $setting

Voir aussi

Tableaux bord
Actions sur les tableaux de bord
Créer un tableau de bord