• Modifier l'apparence
• Modifier le premier plan
• Créer une page d'accueil
  • Ajouter un portail d'accès
  • Utiliser un modèle de page d'accueil
  • Personnaliser la page d'accueil
    • Modifier les éléments de rôle
    • Modifier l'aide
    • Exemple
  • Supprimer ou désactiver l'affichage de la page d'accueil
  • Désactiver le menu de navigation vertical
• Gérer les images
• Gérer les légendes
• Gérer les dimensions
• Modifier les styles du tableau de bord
• Exécuter du code JavaScript 
• Modifier les propriétés globales du tableau de bord
  • Propriétés du Dashboard
    • Configurer un message à destination des utilisateurs
  • Propriétés de l'Éditeur de tableaux de bord

Il est possible de modifier de manière globale le tableau de bord.
Ces modifications s'effectuent via le sous-menu Paramètres du menu déployable depuis le nom de l'utilisateur.

Modifier l'apparence

Deux apparences (thèmes graphiques) sont disponibles pour l'interface de l'Editeur de tableaux de bord : Sombre ou Clair.
L'apparence Sombre est sélectionné par défaut. Pour changer d'apparence :

• Cliquez sur Apparence puis sélectionnez le mode souhaité.
  

Le mode d'affichage choisi se propage à l'ensembe des modules de DigDash.

Modifier le premier plan

Cette fonctionnalité permet d'avoir des éléments qui seront présents sur chaque page lors de l'affichage du tableau de bord, elle permet par exemple d'ajouter un en-tête de page qui sera affiché sur l'ensemble des pages de tableaux de bord.

Pour modifier les éléments affichés au premier plan :

1. Cliquez sur Premier plan : cela affiche un nouvel onglet au même niveau que les rôles, sélectionnez cet onglet.
2. Créez un objet contenant le contenu de votre entête, pied de page ou objet à gauche/droite. Vous pouvez par exemple utiliser un éditeur HTML contenant le texte souhaité.
3. Cliquez ensuite sur la roue crantée en haut à droite de l'élément que vous venez de créer.
   ➡ Le menu d'édition apparaît.
4. Selon la position souhaitée pour l'objet, cochez En-tête de page, Pied de page, Objet à gauche ou Objet à droite.

Si vous avez sélectionné En-tête ou Pied de page, l'élément sélectionné est placé en haut ou en bas de la page. La largeur de l'objet est celle du tableau de bord (100% de la largeur totale). 
Si vous avez sélectionné Objet à gauche ou Objet à droite, l'élément sélectionné est placé à gauche ou à droite de la page. La hauteur de l'objet est celle du tableau de bord (100% de la hauteur totale).

Créer une page d'accueil

Il est possible de créer facilement une page d’accueil qui sera affichée en premier lors de la connexion au tableau de bord.
Cette page peut être personnalisée par chaque utilisateur pour afficher les éléments souhaités. Dans la majorité des cas, elle sert à présenter la liste des rôles (ou pages) auxquels l’utilisateur a accès, sous forme de tuiles interactives.

La construction de cette page est libre, cela signifie que vous pouvez ajouter tous les objets disponibles dans le tableau de bord.

Pour créer la page d'accueil :

1. Dans le menu Paramètres, cliquez sur Accueil. 
   ➡ Une page nommée Accueil est ajoutée automatiquement en première position (avant les rôles).
2. Dans le message qui s'affiche au centre de l'écran : cliquez sur Ajouter un portail d'accès (recommandé) pour créer une page d'accueil de manière automatique ou Commencer à partir d'une page vide pour créer vos propres tuiles ou appliquer un modèle de page d'accueil.
   

Ajouter un portail d'accès

Cette méthode offre plus de flexibilité et de possiblités de personnalisation avancées.

1. Cliquez droit sur l'onglet Accueil correspondant et sélectionnez Ajouter un portail d'accès.
   ➡ Par défaut, la liste des rôles s'affiche.
2. Vous pouvez alors choisir d'afficher les pages et le type de groupement.
   Les styles sont également personnalisables.
   Consultez le paragraphe Portail d'accès pour plus de détails.

Utiliser un modèle de page d'accueil

Cette méthode permet d'afficher uniquement la liste des rôles.

1. Cliquez droit sur l'onglet Accueil correspondant et sélectionnez Appliquer un modèle.
   ➡ La fenêtre Modèles s'affiche.
2. Ouvrez l'onglet Pages d'accueil pour afficher les modèles disponibles. Un aperçu s'affiche lorsque vous en sélectionnez un. 

   Plusieurs types de pages sont proposés : les pages ne contenant que la liste des rôles sous forme de tuiles, et les pages contenant, en plus des rôles, une aide affichée sous forme de popup. 
   

   Dans notre exemple, nous allons choisir le modèle Liste rôles + aide (mode sombre)

3. Cliquez sur OK.
   ➡ 3 objets apparaissent : l'un représente la tuile d'Aide cliquable, l'autre le contenu de l'aide affichée sous forme de popup, et enfin le dernier représente la liste des rôles. Ces 3 objets sont des objets de type Éditeur préconfigurés pour afficher le contenu souhaité. Le modèle contient aussi une image d'arrière-plan qu'il est possible de modifier.
   

4. Sauvegardez la page et affichez-la en mode consultation :
   

Personnaliser la page d'accueil

Il est possible, à partir du modèle choisi de personnaliser sa page d'Accueil.

Modifier les éléments de rôle

L'objet affichant la liste des rôles est dynamique, cela signifie que la liste est différente selon l'utilisateur qui se connecte. Il ne faut donc pas hésiter à redimensionner cet objet en fonction du nombre de rôles moyen auxquels auront accès les utilisateurs afin d'avoir le meilleur rendu quelque soit le nombre de rôles.

La disposition des rôles est ensuite faite de manière automatique (vignette centrée et retour à la ligne) et n'est pas modifiable (Le contenu de cet objet ne doit en aucun cas être modifié, celui-ci contient un mot-clé permettant de rendre dynamique la liste des rôles suivant l'utilisateur connecté).

Il est toutefois possible de personnaliser cet objet et notamment les icônes représentant les rôles (par défaut l'icône DigDash est utilisée). 

Pour modifier l'icône du rôle (affiché également dans l'onglet du rôle) :

1. Cliquez-droit sur l'onglet du rôle puis sélectionnez Icône.
2. L'interface qui apparait vous permet d'ajouter une image puis de l'associer au rôle (nous conseillons les icônes au format vectorielle SVG pour avoir un rendu plus propre). Une fois l'image associée au rôle, cette image est affichée dans la vignette pour ce rôle.
3. Réitérez l'opération pour tous les rôles.

Modifier l'aide

Concernant l'aide, le principe est d'avoir une vignette d'aide sur laquelle l'utilisateur va cliquer pour afficher le contenu de l'aide sous forme de popup. C'est pour cela que 2 objets sont présents pour l'aide :

• Le premier objet de type Editeur (la vignette) contient du HTML permettant le rendu mais contient aussi l'action permettant l'affichage du contenu de l'aide sous forme de popup (on utilise ici la fonction ddCtrl.openPorletInWindow permettant l'affichage sous forme de popup de n'importe quel objet du tableau de bord).
• Le deuxième objet est aussi de type Editeur et contient l'aide qui sera affichée sous forme de popup lorsque l'utilisateur cliquera sur la vignette d'aide. C'est surtout cet objet qui doit être modifié pour contenir l'aide dont l'utilisateur aura besoin. La modification du contenu de cet objet ou de se taille se fait de la même manière que pour tous les objets de type Editeur présents dans le tableau de bord.

Exemple

Dans notre exemple, nous souhaitons personnaliser la page d'accueil en changeant les icônes de chaque rôle et l'arrière plan. Une fois les modifications effectuées, l'affichage est le suivant :

Supprimer ou désactiver l'affichage de la page d'accueil

Si vous souhaitez ne plus afficher la page d'accueil :

1. Cliquez-droit sur l'onglet Accueil.
   ➡ Le menu contextuel s'affiche.
   
2. Sélectionnez l'une des deux options :
   • Désactiver l'affichage de la page : la page sera masquée dans le tableau de bord mais pourra toujours être éditée dans l'éditeur.
   • Supprimer la page : le contenu de la page et l'onglet Accueil seront supprimés.
     Une nouvelle page d'Accueil pourra être créée depuis le menu utilisateur comme décrit ci-dessus.

Désactiver le menu de navigation vertical

Dans le cas où le menu de navigation est en mode Vertical, il est possible de désactiver son affichage pour la page d'accueil spécifiquement.

1. Cliquez-droit sur l'onglet Accueil.
   ➡ Le menu contextuel s'affiche.
   ​​​​​​​
2. Cliquez sur Désactiver le menu de navigation sur cette page.
   ➡ Le résultat sera visible lors de l'affichage du tableau de bord.

Menu de navigation vertical activé	Menu de navigation vertical désactivé

Gérer les images

Vous pouvez ajouter des images que vous pourrez insérer ensuite dans un objet image ou comme icône d'une page, par exemple.

Pour cela :

1. Cliquez sur Gestion des images.
2. Dans la boite Image qui s'affiche, cliquez sur Télécharger.
3. Sélectionnez l'image de votre choix et la Portée : image ajoutée pour tous (Publique), pour l'utilisateur ou un rôle défini.
4. Cliquez sur OK.
   ➡ L'image est ajoutée et un aperçu est affiché.

Vous pouvez supprimer une image depuis la boite Image  : sélectionnez-la dans la liste déroulante et cliquez sur Supprimer.

Gérer les légendes

Par défaut, les flux d'une même page partagent les mêmes couleurs. Consultez la page Configurer les couleurs pour plus de détails.

Vous pouvez, dans ce cas, modifier la légende des graphiques figurant dans le tableau de bord. 

Pour cela :

1. Cliquez sur Gestion des légendes.
2. Dans la boite Gestion des légendes, cliquez sur Ajouter.
3. Sélectionnez une valeur de dimension dans la première liste déroulante Nom puis choisissez la couleur dans la palette. Vous pouvez également choisir un motif de remplissage et une couleur de bordure ainsi que renommer la légende dans le champ Texte.
   
4. Cliquez sur OK.

Gérer les dimensions

Vous pouvez modifier les paramètres des dimensions apparaissant dans la barre de filtres interactive (en haut des pages de tableaux de bord).

 Pour cela :

1. Cliquez sur Gestion des dimensions.
   ➡ La boîte Gestion des dimensions s'affiche :
   
2.  Depuis cette boîte, vous pouvez :
   • Modifier l'ordre de tri des filtres : dans la liste déroulante figurant à côté de Tri (en haut à gauche de la boîte de dialogue), sélectionnez A-Z pour un tri croissant, Z-A pour un tri décroissant ou Manuel si vous souhaitez ordonner vos boîtes de filtre manuellement. Si vous choisissez Manuel, glissez-déposez les dimensions à la position souhaitée.
      
   • Sélection multiple : si vous sélectionnez cette option, la sélection de plusieurs dimensions sera possible.
      
   • Cacher l’élément « Tous » : si vous sélectionnez cette option, l'élément Tous ne sera pas affiché dans la boîte de filtre.
      
   • Cacher les éléments sans valeurs : si vous sélectionnez cette option, les valeurs seront filtrées en fonction des valeurs des autres dimensions déjà sélectionnées (exemple : si la valeur France est déjà sélectionnée pour la dimension Pays, la dimension Région n'affichera que des régions de France)
      
   • Cacher/Afficher une dimension : dans la colonne Barre de filtres, cliquez sur Affichage par défaut puis dans la liste déroulante s'affichant, sélectionnez Oui pour afficher la dimension, Non pour cacher la dimension et Affichage par défaut pour conserver le paramètre Affichage défini dans le modèle de données ou la visualisation.
      
   • Modifier le tri : par défaut, le Tri de la dimension est sélectionné. Vous pouvez choisir un Tri Alphabétique ou Numérique croissant ou décroissant.
      
   • Filtrer une dimension à l'édition des commentaires : par défaut, lorsque vous ajoutez un commentaire, vous pouvez préciser à quelles valeurs de dimensions, il se rapporte. Par exemple, vous pouvez ajouter un filtre «Région Magasin » = « France »  pour un commentaire concernant la France uniquement.
     Si vous ne souhaitez pas prendre en compte une dimension lors de l'édition de commentaires, décochez la case Commentaires.

La colonne Modèles de données affiche les modèles auxquels les dimensions appartiennent.

Un certain nombre de paramètres présents dans la page Configuration -> Paramètres serveur -> Cubes -> Constantes permettent également de modifier l'affichage des boîtes de filtres. Consultez la page Constantes pour plus de détails.

Modifier les styles du tableau de bord

Vous pouvez modifier les styles du tableau de bord depuis l'Éditeur de thèmes: intuitif, il ne nécessite aucune connaissance particulière. Consultez la page Éditeur de thèmes pour plus de détails.

Exécuter du code JavaScript 

L'exécution de JavaScript vous permet d'ajouter des comportements personnalisés dans les tableaux de bords. Une interface de programmation (API) permet d'ajouter des appels Javascript de fonctions de tableau de bord permettant par exemple le changement de page, l'ajout de filtre, la modification de variables,...Ces fonctions sont décrites dans la documentation Fonctions Javascript.

Pour exécuter du code JavaScript :

1. Cliquez sur Editeur JavaScript.
   ➡ L'éditeur JavaScript s'affiche.
2. Entrez le JavaScript que vous souhaitez exécuter.
   Des éléments Javascript prédéfinis sont disponibles en cliquant sur le bouton + Insérer du code Javascript en haut à droite de la fenêtre Pages / Objets, Dimensions, Variables et Fonctions classées par type.
   
   
   Si on sélectionne par exemple Fonctions -> Affichage -> Ouvre un flux dans une fenêtre popup, une boite Action s'ouvre afin de définir les paramètres.
   
   Il suffit de sélectionner le flux à afficher et la taille de la fenêtre. En cliquant sur OK, le code est ajouté dans l'éditeur Javascript.
   

Le code JavaScript est stocké dans un fichier js-default.js.

Ce fichier JavaScript peut inclure d'autres fichiers JavaScript. Pour créer un JavaScript :

1. Cliquez sur le bouton  Choix d'un fichier Javascript en haut à droite de la fenêtre.
2. Sélectionnez Nouveau JavaScript
3. Entrez le nom du fichier puis le JavaScript que vous souhaitez exécuter.

Pour inclure ce JavaScript dans un autre fichier .js, utilisez la fonction includeJS (exemple : includeJS('file.js')) ;

Modifier les propriétés globales du tableau de bord

Cette interface permet de modifier les propriétés globales du tableau de bord et de l'éditeur de tableaux de bord qui ne sont pas liées aux rôles ou pages.

Propriétés du Dashboard

Configurer un message à destination des utilisateurs

Il est possible d'activer l'affichage d'un message à la connexion pour les utilisateurs de l'Éditeur et du Dashboard. Par exemple, dans le cas où les administrateurs souhaitent informer les utilisateurs d'une opération de maintenance. Pour cela, dans la section Message des administrateurs :

1. Cochez la case Activer l'affichage du message.
   ➡ Tant que le message est activé, il apparaît à la connexion pour tous les utilisateurs.
2. Modifiez le Titre du message comme souhaité. Par défaut : Message des administrateurs.
3. Entrez le Message administrateur de votre choix.
4. Vous pouvez traduire le message et son titre dans les différentes langues configurées en cliquant sur le bouton  . Consultez la page Traduire le nom d'un objet pour plus de détails.
   

Lors de la connexion des utilisateurs au Dashboard ou l'Éditeur, un message sous la forme suivante s'affichera alors :

Propriétés de l'Éditeur de tableaux de bord