Aller au contenu

Modifications pour le document Documenter l’aide en ligne

Modifié par Joséphine Ducruet le 2026/02/18 16:34
Depuis la version 37.1
modifié par Doriane Bautista
sur 2025/09/11 15:27
Commentaire de modification : Il n'y a aucun commentaire pour cette version
À la version 77.1
modifié par Joséphine Ducruet
sur 2026/02/18 16:31
Commentaire de modification : Il n'y a aucun commentaire pour cette version

Résumé

Détails

Propriétés de la Page
Auteur du document
... ... @@ -1,1 +1,1 @@
1 -XWiki.DBA
1 +XWiki.JDT
Contenu
... ... @@ -1,3 +1,5 @@
1 +**PAGE EN COURS DE REDACTION**
2 +
1 1  (% class="mark small" %)**Version 4.5.54 et ultérieures**
2 2  
3 3  |(% style="width:840px" %)(((
... ... @@ -5,102 +5,81 @@
5 5  (((
6 6  Dans Flora, chaque **champ ou bloc de champ** est accompagné d’une **aide en ligne **accessible directement depuis une **grille de saisie**. Par défaut, l’aide affichée provient du wiki.
7 7  
8 -Elle peut toutefois être personnalisée : chaque institution a la possibilité de** rédiger sa propre aide en ligne** afin d’adapter les consignes à ses besoins internes et à sa charte de saisie.
10 +Elle peut toutefois être personnalisée : chaque institution a la possibilité de** créer sa propre aide en ligne** afin d’adapter les consignes à ses besoins internes et à sa charte de saisie.
9 9  )))
10 10  
11 11  (((
12 -= À quoi sert l'aide en ligne dans Flora ? =
14 += L'aide en ligne : un appui à la saisie dans Flora =
13 13  
14 -L’aide en ligne **accompagne** les utilisateurs dans la **compréhension** et l’**usage **des **champs et blocs de champs **présents dans toutes les tables de Flora. Elle permet d’assurer une saisie cohérente et conforme aux pratiques définies par l’institution.
15 15  
16 -**Lorsqu’un musée crée une** **aide en ligne personnalisée, celle du wiki disparaît au profit du contenu local.** Si la personnalisation est ensuite supprimée, l’aide du wiki réapparaît automatiquement. Cette personnalisation n’a d’effet que dans la base de données de l’institution qui l’a rédigée :** elle ne modifie en rien les contenus du wiki et n’impacte pas les autres musées**.
17 +L’aide en ligne **accompagne les utilisateurs** dans la compréhension et l’utilisation des champs présents dans les différentes tables de Flora.
18 +Elle contribue à garantir une saisie homogène, cohérente et conforme aux pratiques définies par votre institution. Elle complète les documents de référence internes et les procédures métiers du musée.
19 +Son objectif est de traduire concrètement ces règles directement dans l’interface de Flora, au plus près des champs utilisés par les équipes au quotidien.
17 17  
18 ->(% class="small" %)Cas d'usage:
21 +Concrètement, l’aide en ligne permet de :
19 19  
20 -(((
21 ->(% class="small" %)Expliquer le contenu attendu dans un champ.
23 +* **Expliquer le contenu attendu dans un champ**.
24 +* **Formaliser les règles de saisie propres à l’institution** (abréviations autorisées, vocabulaire contrôlé, conventions d’écriture, etc.).
25 +* **Donner accès à des ressources externes de référence** (textes réglementaires, chartes internes, normes, guides méthodologiques).
26 +* **Harmoniser les pratiques et éviter les erreurs d’interprétation**, notamment dans les équipes élargies ou en cas de renouvellement des agents.
22 22  
23 -(((
24 ->(% class="small" %)Formaliser les règles de saisie propres à l’institution.
28 +Par défaut, **l’aide en ligne est redirigée vers l’aide disponible sur le wiki officiel**. Cette documentation est actuellement en cours de rédaction et d’enrichissement par l’équipe de Flora Software.
25 25  
26 ->(% class="small" %)Indiquer à quels processus le champ est lié  (ex. : inventaire, récolement, prêt, dépôt, restauration, etc.).
30 +Elle constitue une **base commune de référence pour l’ensemble des utilisateurs**.
27 27  
28 ->(% class="small" %)Donner accès à des ressources externes de référence.
32 +Toutefois, chaque institution a la possibilité d**’adapter cette aide à ses propres pratiques**.
29 29  
30 ->(% class="small" %)Harmoniser les pratiques et éviter les erreurs d’interprétation.
31 -)))
32 -)))
34 += Personnaliser l'aide en ligne =
33 33  
34 -(% class="box successmessage" %)
35 -(((
36 -**Bonnes pratiques : **
36 +Lorsqu’un musée crée une **aide en ligne personnalisée** pour un champ :
37 37  
38 -* **Uniformisez la présentation** : adoptez une structure homogène pour toutes vos aides (ex. : définition, usage, remarques).
39 -* **Soyez clairs et concis** : rédigez des explications courtes et immédiatement compréhensibles.
40 -* **Employez le vocabulaire métier partagé** : utilisez les termes définis dans la charte de saisie de votre institution.
41 -* **Précisez le contexte d’utilisation** : indiquez si le champ ou le bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration).
42 -* **Ajoutez des exemples concrets** : illustrez les valeurs attendues afin d’éviter les ambiguïtés.
43 -* **Limitez les redondances** : ne recopiez pas intégralement l’aide du wiki, mais complétez-la ou adaptez-la selon vos besoins.
44 -* **Documentez aussi les blocs de champs** : expliquez leur rôle global en plus des champs qu’ils contiennent.
45 -* **Conservez une mémoire interne** : gardez une copie (Word, tableur, etc.) de vos aides personnalisées pour en assurer le suivi et la maintenance lors des mises à jour Flora.
46 -* **Vérifiez l’accessibilité** : testez l’ouverture des pop-up d’aide dans les navigateurs utilisés.
47 -* **Mettez à jour régulièrement** : adaptez vos contenus lorsque vos procédures internes ou règles métier évoluent.
48 -)))
38 +* le contenu standard issu du** wiki est automatiquement masqué**
39 +* seul le **contenu rédigé localement est affiché**
49 49  
50 -= Récupérer le nom informatique du champ ou du bloc à documenter =
41 +Si cette personnalisation est supprimée, l’aide du wiki réapparaît automatiquement.
51 51  
52 -Pour retrouver le fichier d’aide correspondant, vous devez d’abord identifier le nom interne du champ ou du bloc de champs. Pour cela :
43 +Cette **personnalisation est strictement locale** : elle s’applique uniquement à la base de données de l’institution qui l’a créée.
44 +Elle ne modifie pas le contenu du wiki et n’a aucun impact sur les autres institutions.
53 53  
54 -* Survolez le libellé dans une grille de saisie : son nom interne s’affiche en infobulle.
55 -* Vous pouvez aussi faire un clic droit sur le libellé et choisir **Afficher informations** pour copier directement le nom interne.
46 +== Identifier le nom interne du champ ou du bloc ==
56 56  
57 ->(% class="small" %)Exemple : dans la table MUS_BIEN, le champ Numéro d’inventaire porte le nom technique **NUM_INVENTAIRE**.
48 +Pour retrouver le fichier d’aide correspondant, vous devez d’abord identifier le nom interne du champ ou du bloc de champs.
58 58  
59 -[[//Ex. Biens : survol d'un libellé et affichage du nom interne en infobulle//>>image:1744363912649-947.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
50 +Pour cela :
60 60  
52 +1. Faites un **clic droit** sur le libellé du champ
53 +1. Choisir **Afficher informations**
54 +1. **Copiez le nom interne **du champ (ligne name)
61 61  
62 -[[//Ex. Biens : clic droit sur le champ - Afficher informations//>>image:1744363948510-224.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
56 +[[//Clic droit - Afficher informations//>>image:1744363948510-224.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
63 63  
64 64  
65 -[[//Résultat : Nom interne du champ indiqué sur la première ligne//>>image:1744363968204-295.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
59 +[[//Nom interne du champ//>>image:1744363968204-295.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
66 66  
67 67  
68 -= Accéder à l'éditeur d'aide en ligne =
62 +== Accéder à l'éditeur d'aide en ligne ==
69 69  
70 -Pour créer ou modifier une aide, rendez-vous dans l’espace de travail **Administration**, menu **Paramétrage** > **Aide en ligne**.
64 +1. Rendez-vous dans l'espace de travail **Administration, menu Paramétrage, Aide en ligne**
65 +1. Dépliez la rubrique** Aide à la saisie**
66 +1. Choisir la source et la table
67 +1. **Utilisez le raccourci clavier Ctrl + F** pour ouvrir la barre de recherche
68 +1. **Collez le nom interne** que vous avez récupéré
69 +1. **Cliquez sur l’élément trouvé** pour ouvrir l’éditeur
71 71  
72 -Vous y trouverez la liste des fichiers disponibles, organisés par source et par table.
71 +[[//Choix de la source Musée et de la table Biens et ensembles//>>image:1757595391112-778.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
73 73  
74 -Dépliez la rubrique **Aide à la saisie** pour rechercher les champs et blocs de champs à documenter.
75 75  
76 -[[//Espace de travail **Administration **~> menu **Paramétrage** ~> **Aide en ligne** ~> rubrique** Aide à la saisie**//>>image:1757594385587-551.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
74 +[[//Afficher la barre de recherche avec **CTRL+F** pour rechercher le champ//>>image:1757595571069-539.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
77 77  
78 78  
79 -= Rechercher le champ ou le bloc à documenter =
77 +[[//Ouverture de l'éditeur//>>image:1757595726608-759.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
80 80  
81 -Une fois dans le module d’édition des aides en ligne, vous devez localiser précisément le champ ou le bloc concerné avant de pouvoir le personnaliser. Procédez étape par étape :
82 82  
83 -1. **Choisissez la source** (ex. Musées, Bibliothèque, Archives).
84 -1. **Sélectionnez la table** dans laquelle se trouve le champ ou le bloc à documenter.
85 -1. **Utilisez le raccourci clavier Ctrl + F** pour ouvrir la barre de recherche.
86 -1. **Collez le nom interne** que vous avez récupéré (champ ou bloc).
87 -1. **Cliquez sur l’élément trouvé** pour ouvrir l’éditeur.
80 +== Rédiger l'aide en ligne ==
88 88  
89 -[[//Choix de la **source Musée** et de la **table Biens et ensembles**//>>image:1757595391112-778.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
82 +L’éditeur fonctionne comme un traitement de texte (type Word) et vous permet d’appliquer différents outils :
90 90  
91 -
92 -[[//Recherche **CTRL+F** et clic sur le nom interne du champ **NUM_INVENTAIRE**//>>image:1757595571069-539.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
93 -
94 -
95 -[[//Résultat : l'éditeur d'aide en ligne apparait //>>image:1757595726608-759.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
96 -
97 -
98 -= Éditer l'aide en ligne =
99 -
100 -Une fois le champ ou le bloc trouvé, cliquez sur son nom pour ouvrir l’éditeur HTML.
101 -
102 -Cet éditeur fonctionne comme un traitement de texte (type Word) et propose de nombreuses options :
103 -
84 +(((
104 104  * **Mise en forme du texte** : gras, italique, souligné, exposant, indice.
105 105  * **Organisation du contenu** : listes à puces, listes numérotées, retrait, alignement.
106 106  * **Styles et formats** : titres, styles prédéfinis, choix de la police et de la taille.
... ... @@ -108,55 +108,30 @@
108 108  * **Éléments enrichis** : caractères spéciaux, symboles.
109 109  * **Outils pratiques** : correcteur orthographique, recherche/remplacement, annuler/rétablir, affichage du code source.
110 110  
111 -(% class="box warningmessage" %)
92 +(% class="box successmessage" %)
112 112  (((
113 -**Point d’attention : insérer des liens**
94 +**Astuce -  insérer des liens**
114 114  
115 115  * Pour créer un lien vers un document ou une ressource externe, copiez d’abord l’URL dans un document Word : elle devient un lien bleu cliquable.
116 116  * Copiez-collez ensuite ce lien dans l’éditeur d’aide en ligne. Il sera reconnu correctement et restera actif.
117 117  )))
99 +)))
118 118  
119 -Vous pouvez saisir directement votre texte ou copier-coller l’aide du wiki avant de l’adapter à vos besoins internes. Une fois vos modifications terminées, cliquez sur **Sauvegarder** pour enregistrer votre personnalisation.
120 -
121 -(% class="box successmessage" %)
122 122  (((
123 -**Bonnes pratiques : **
102 +== Sauvegarder la personnalisation ==
124 124  
125 -* **Uniformisez la présentation** : adoptez une structure homogène (définition, usage, remarques).
126 -* **Soyez clairs et concis** : rédigez des explications courtes et directement utiles.
127 -* **Employez le vocabulaire métier partagé** : utilisez les termes définis dans la charte de saisie de votre institution.
128 -* **Précisez le contexte** : indiquez si le champ ou bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration).
129 -* **Ajoutez des exemples concrets** : illustrez les valeurs attendues pour éviter toute ambiguïté.
130 -* **Limitez les redondances** : n’intégrez que ce qui est pertinent, sans recopier inutilement l’aide du wiki.
131 -* **Documentez aussi les blocs de champs** : expliquez leur rôle global en plus des champs qu’ils contiennent.
132 -* **Conservez une mémoire interne** : gardez une copie (Word, tableur, etc.) de vos aides personnalisées pour en assurer le suivi et la maintenance lors des mises à jour Flora.
133 -)))
104 +Cliquez sur **Sauvegarder** pour enregistrer vos modifications.
134 134  
135 -(% class="wikigeneratedid" id="H200B200B200B200B200B200B200B200B200B200B200B200B200B200B" %)
136 -[[image:1757596818102-351.png]]​​​​​​​​​​​​​​
106 +Dès la sauvegarde, l’aide en ligne du wiki disparaît : elle est remplacée par votre aide personnalisée.
137 137  
138 -
139 -(% id="cke_bm_851S" style="display:none" %)
140 -
141 -Que ce soit les pages html ou celle du wiki leur ouverture de fait au sein d'une pop-up. Si vous ne voyez pas de fenêtre s'ouvrir lors d'un appel au menu "Afficher aide", pensez à vérifier les autorisations accordées à Flora par votre navigateur. Voici des liens d'information sur ce sujet :
142 -
143 -* (((
144 -[[Firefox>>https://support.mozilla.org/fr/kb/parametres-exceptions-depannage-blocage-popup]]
108 +(% class="box successmessage" %)
109 +(((
110 +Astuce – Conserver l’aide du wiki tout en la personnalisant
145 145  )))
146 -* (((
147 -[[Safari >>https://support.apple.com/fr-fr/guide/safari/ibrwe2159f50/mac]]
148 -)))
149 -* (((
150 -[[Chrome>>https://support.google.com/chrome/answer/95472?co=GENIE.Platform%3DDesktop&hl=fr]]
151 -)))
152 -* (((
153 -[[Edge>>https://support.microsoft.com/fr-fr/help/17479/windows-internet-explorer-11-change-security-privacy-settings]]
154 -)))
155 155  
156 -
157 -
158 158  
159 159  )))
115 +)))
160 160  )))|(% style="width:300px" %)(((
161 161  (% class="box" %)
162 162  (((
... ... @@ -170,6 +170,7 @@
170 170  **Aller plus loin**
171 171  
172 172  * [[Comprendre les sources et les tables dans Flora>>doc:2_Administration.Administration fonctionnelle.Présentation des sources et des tables.WebHome||target="_blank"]]
129 +* [[Insérer un document interne pour accueil>>doc:2_Administration.Administration fonctionnelle.Documents de référence sur page d'aide.WebHome||target="_blank"]]
173 173  * (((
174 174  [[Saisir dans Flora>>doc:1_Fonctionnalités.5\.C\. Saisie.WebHome||target="_blank"]]
175 175  )))
... ... @@ -178,13 +178,8 @@
178 178  (% class="box" %)
179 179  (((
180 180  **Icônes principales**
181 -)))
182 182  
183 -(((
184 -
185 -
186 -
187 -
139 +* [[image:1757600253202-543.png||height="45" width="45"]] Paramétrages
188 188  )))
189 189  )))
190 190  
1757597613394-216.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +135.0 KB
Contenu
1757597668258-471.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +138.2 KB
Contenu
1757597985000-452.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +193.0 KB
Contenu
1757599364051-795.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +148.4 KB
Contenu
1757599402906-988.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +98.9 KB
Contenu
1757599437795-401.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +112.8 KB
Contenu
1757599467798-396.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +115.5 KB
Contenu
1757599482084-563.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +129.8 KB
Contenu
1757599570577-172.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +75.3 KB
Contenu
1757599808499-510.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +11.4 KB
Contenu
1757600036454-769.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +199.0 KB
Contenu
1757600253202-543.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +XWiki.DBA
Taille
... ... @@ -1,0 +1,1 @@
1 +6.3 KB
Contenu