La structure du Tableau de bord est définie par l'ensemble des fichiers de configuration figurant dans le chemin de recherche de la base de données d'actions.
En cas de conflit entre les composants d'une définition, les règles de priorité déterminent la définition utilisée. Il existe deux cas de conflit :
lorsque les composants partagent le même nom d'objet
de commande, CONTAINER_NAME
et CONTAINER_TYPE
.
lorsque les composants doivent théoriquement occuper
le même emplacement (noms différents mais valeurs de CONTAINER_NAME
, CONTAINER_TYPE
et POSITION_HINTS
identiques).
Le Tableau de bord utilise les règles de priorité suivantes :
Dans le premier cas (même nom d'objet, même nom et même type de conteneur), c'est le premier composant lu qui est utilisé.
Par exemple, si un objet de commande système et un objet de commande intégré contiennent tous deux les zones suivantes (et s'ils diffèrent par ailleurs) :
CONTROL TextEditor { CONTAINER_TYPE BOX CONTAINER_NAME Top … }
alors l'objet de commande système est prioritaire.
Dans le second cas, l'ordre de lecture détermine leur position respective.
Par exemple, si un utilisateur crée un nouvel objet de commande
personnel pour le Tableau de bord, (CONTAINER_TYPE
BOX et CONTAINER_NAME
Top) et attribue la valeur 5 à POSITION_HINTS
, cet objet personnel décale d'une position vers la droite
l'objet de commande intégré et tous les autres objets de commande
dont le numéro de position est plus élevé.
si vous modifiez un objet de commande en créant une version
système ou personnelle, la nouvelle définition doit comporter
le même nom d'objet de commande et les mêmes valeurs CONTAINER_NAME
et CONTAINER_TYPE
. Si ce n'est pas le cas, le nouvel objet de commande
s'ajoutera à l'objet existant.