Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Personnalisation

Le Dock et la barre latérale de module

Arranger le Dock d'une application et la barre latérale d'un module directement à l'écran, pour vous seul ou pour tout le site, et choisir le mode d'affichage du Dock.

Le Dock et la barre latérale de module

La navigation du bureau repose sur deux éléments :

  • le Dock : la colonne d'icônes d'une application. Chaque entrée ouvre un module, un espace de travail ou une URL ;
  • la barre latérale de module : la liste des liens d'un module (listes, rapports, pages, espaces de travail).

Les deux se règlent sans code, directement à l'écran : chacun est son propre aperçu pendant que vous le modifiez. Ils partagent le même fonctionnement.

Modifier la barre latérale et Gérer le dock ne sont pas proposés sur mobile.

Les couches d'un arrangement

Un Dock ou une barre latérale se construit en couches. Chaque couche part de la couche du dessous et peut masquer, réordonner ou ajouter des entrées.

CoucheQui la modifieChoix dans l'éditeur
ApplicationLe développeur, en mode développeur« Pour {application} »
SiteUn utilisateur qui a le rôle Gestionnaire d'espace de travail« Pour tous »
UtilisateurChaque utilisateur, pour lui seul« Juste pour moi »

La couche en cours d'édition est nommée à l'écran. L'en-tête de la barre latérale affiche le module suivi de la couche, par exemple « Stock for everyone » (libellé non traduit). La barre du Dock affiche « Dock » suivi de la couche. Si plusieurs couches vous sont proposées, cliquez sur cette mention pour changer de couche.

Arranger le Dock

Vous pouvez ouvrir l'éditeur de deux façons :

  • cliquez sur votre avatar, puis sur Gérer le dock ;
  • ou faites glisser une icône du Dock vers une autre place. L'éditeur s'ouvre avec l'ordre que vous venez de donner, comme première modification non enregistrée.

Le Dock reste ouvert pendant la modification. Une barre s'affiche en bas à gauche de l'écran : vous pouvez la déplacer en la saisissant par sa poignée. Elle contient le nom de la couche, un menu ⋯, Annuler et Enregistrer.

  1. Si plusieurs couches vous sont proposées, cliquez sur le nom de la couche dans la barre et choisissez « Juste pour moi » ou « Pour tous ».
  2. Glissez-déposez les icônes pour les réordonner.
  3. Cliquez sur une icône pour ouvrir ses champs dans un panneau à côté du Dock : Étiquette et Icône. Le bouton Supprimer, en haut du panneau, retire l'icône du Dock. Pour remettre un module retiré, saisissez son nom dans la tuile + (voir plus bas).
  4. Cliquez sur la tuile en pointillés + pour ajouter une entrée (voir plus bas).
  5. Cliquez sur Enregistrer. Le bouton reste inactif tant que vous n'avez rien modifié.

Annuler ferme l'éditeur ; si vous avez des modifications non enregistrées, Dokos demande de confirmer l'abandon. La touche Échap ferme seulement le panneau ouvert.

Dans le menu ⋯, Réinitialiser vide votre arrangement sur cette couche : à l'enregistrement, le Dock revient à celui de la couche du dessous.

Sur la couche « Pour tous », le menu propose aussi Réinitialiser pour tous. Cette action supprime l'arrangement du site et celui de chaque utilisateur pour cette application : tout le monde retrouve le Dock livré par l'application. Elle s'applique tout de suite, après une confirmation, et ne peut pas être annulée.

Une entrée de Dock pointe vers une de ces cibles :

« Type de lien »Cible
Barre latéraleUn module. Le clic ouvre la barre latérale du module et sa page d'accueil.
Espace de travailUn espace de travail épinglé.
URLUn lien externe.

Chaque entrée peut avoir sa propre « Étiquette » et son « Icône ».

Ajouter un module au Dock

La tuile + n'est affichée que si vous avez le droit de créer un module. Elle ouvre un panneau intitulé New item (libellé non traduit), avec les champs Nom et Icône.

  • Si le nom est celui d'un module déjà proposé par ce Dock, l'icône retirée revient simplement sur le Dock.
  • Sinon, Dokos ajoute un nouveau module à l'application du Dock. Il n'est créé qu'à l'enregistrement : Annuler ne laisse rien derrière. Le module s'ouvre sur une page d'accueil créée automatiquement, et l'icône choisie est celle de cette page. Sans icône, Dokos en prend une par défaut.
  • Un nom déjà utilisé par un autre module est refusé dès que vous cliquez sur Ajouter, avec le message « There is already a module called {0}. » (libellé non traduit).
  • Un module appartient à tout le site : vous ne pouvez en ajouter un que sur la couche « Pour tous » (ou sur celle de l'application), et il faut le droit de créer un module. Sur « Juste pour moi », Dokos vous invite à passer sur « Pour tous ».

Arranger la barre latérale d'un module

  1. Ouvrez le module.
  2. Dans le menu de l'en-tête de la barre latérale, cliquez sur Modifier la barre latérale.
  3. La barre latérale devient l'éditeur : l'en-tête garde son titre et nomme la couche, la liste des entrées prend la place des sections habituelles, et ⋯, Annuler et Enregistrer sont en bas.
  4. Faites glisser une entrée par n'importe quelle partie de la ligne pour la déplacer. Faites-la glisser sous une section pour l'y ranger.
  5. Cliquez sur une ligne pour modifier ses champs dans le panneau qui s'ouvre à côté de la barre latérale. Cliquez sur la croix d'une ligne pour la retirer de la barre latérale. L'entrée disparaît aussi de la liste de l'éditeur. Pour la remettre, ajoutez de nouveau le même lien, ou réinitialisez la couche.
  6. Cliquez sur Enregistrer.

Pour les détails (ajout d'un lien ou d'une section, niveaux, réinitialisation), voir Éditeur de la barre latérale.

La barre latérale reste ouverte tant que vous la modifiez. Vous avez des modifications non enregistrées et vous ouvrez une page qui affiche la barre latérale d'un autre module ? Dokos vous propose alors Enregistrer, Ignorer ou Stay (libellé non traduit).

Dans le menu ⋯, Réinitialiser supprime votre arrangement sur cette couche, après une confirmation. La barre latérale revient à la couche du dessous. Réinitialiser au standard supprime l'arrangement du site et celui de chaque utilisateur pour ce module. Ce bouton est réservé au Gestionnaire d'espace de travail.

Un lien de barre latérale peut pointer vers un type de document (avec une vue : liste, calendrier, kanban…), une page, un rapport, un espace de travail, un tableau de bord ou une URL. Un lien vers un rapport peut garder des filtres. Deux liens vers le même rapport avec des filtres différents restent deux liens distincts.

Choisir le mode d'affichage du Dock

  1. Cliquez sur votre avatar, puis sur Paramètres.
  2. Ouvrez l'onglet Apparence.
  3. Dans la section « Dock », choisissez Épinglé ou Flottant.
ModeAffichage
Épinglé (par défaut)Le Dock est une colonne fixe à gauche de la barre latérale.
FlottantLe Dock glisse depuis le bord gauche de l'écran, par-dessus le contenu.

Le changement s'applique tout de suite. Le mode est enregistré sur votre fiche Utilisateur. Pendant la modification du Dock, un Dock flottant reste affiché.

Exemple

Exemple fictif : l'équipe RH utilise souvent la liste des candidatures.

  1. La responsable, qui a le rôle Gestionnaire d'espace de travail, ouvre le module RH.
  2. Elle clique sur Modifier la barre latérale et choisit « Pour tous » en cliquant sur la mention de couche dans l'en-tête.
  3. Elle place le lien vers la liste des candidatures en tête, en le faisant glisser, et retire un rapport inutilisé avec sa croix.
  4. Elle enregistre. Tous les utilisateurs du module voient la nouvelle barre latérale.

Un collaborateur peut ensuite ajouter ses propres liens avec « Juste pour moi », sans changer la barre latérale des autres.

Pour les développeurs

  • Le Dock d'une application est un document Dock avec « Standard » coché. L'entrée Exporter vers l'application du menu ⋯ de l'éditeur l'exporte dans l'application (mode développeur).
  • La barre latérale standard d'un module est un document Barre latérale, nommé par son titre. Son enregistrement vide le cache de démarrage (bootinfo) de tous les utilisateurs.
  • Les méthodes save_site_dock et save_app_dock acceptent un argument facultatif modules (liste de noms de modules à créer, placé en dernier). Les modules sont créés comme Module Def personnalisés de l'application, dans la même requête que l'enregistrement : un échec n'en crée aucun. save_user_dock n'a pas cet argument. Quand des modules sont créés, la réponse contient l'état du bureau (pages, barres latérales) avec le Dock.
  • Déplacer un document Custom Sidebar ou Dock vers un autre utilisateur exige le rôle Gestionnaire d'espace de travail.
  • La commande bench convert-sidebar-fixtures convertit les anciennes fixtures de barre latérale (Workspace Sidebar) d'une application.

Pages liées