Le Dock et la barre latérale de module
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.
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.
| Couche | Qui la modifie | Choix dans l'éditeur |
|---|---|---|
| Application | Le développeur, en mode développeur | « Pour {application} » |
| Site | Un utilisateur qui a le rôle Gestionnaire d'espace de travail | « Pour tous » |
| Utilisateur | Chaque 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.
- 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 ».
- Glissez-déposez les icônes pour les réordonner.
- 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).
- Cliquez sur la tuile en pointillés + pour ajouter une entrée (voir plus bas).
- 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érale | Un module. Le clic ouvre la barre latérale du module et sa page d'accueil. |
| Espace de travail | Un espace de travail épinglé. |
| URL | Un 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
- Ouvrez le module.
- Dans le menu de l'en-tête de la barre latérale, cliquez sur Modifier la barre latérale.
- 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.
- 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.
- 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.
- 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
- Cliquez sur votre avatar, puis sur Paramètres.
- Ouvrez l'onglet Apparence.
- Dans la section « Dock », choisissez Épinglé ou Flottant.
| Mode | Affichage |
|---|---|
| Épinglé (par défaut) | Le Dock est une colonne fixe à gauche de la barre latérale. |
| Flottant | Le 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.
- La responsable, qui a le rôle Gestionnaire d'espace de travail, ouvre le module RH.
- Elle clique sur Modifier la barre latérale et choisit « Pour tous » en cliquant sur la mention de couche dans l'en-tête.
- Elle place le lien vers la liste des candidatures en tête, en le faisant glisser, et retire un rapport inutilisé avec sa croix.
- 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_docketsave_app_dockacceptent un argument facultatifmodules(liste de noms de modules à créer, placé en dernier). Les modules sont créés commeModule Defpersonnalisés de l'application, dans la même requête que l'enregistrement : un échec n'en crée aucun.save_user_dockn'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 SidebarouDockvers un autre utilisateur exige le rôle Gestionnaire d'espace de travail. - La commande
bench convert-sidebar-fixturesconvertit les anciennes fixtures de barre latérale (Workspace Sidebar) d'une application.