Modifications pour le document Documenter l’aide en ligne

Modifié par Joséphine Ducruet le 2026/02/18 16:34

Gérer
- Copier
Actions
- Exporter
- Aperçu avant impression
Affichage

From 51.1 to 52.1 From 74.1 to 75.1

Depuis la version 52.1

modifié par Doriane Bautista
sur 2025/09/11 16:18

Commentaire de modification : Il n'y a aucun commentaire pour cette version

À la version 74.1

modifié par Joséphine Ducruet
sur 2026/02/18 14:37

Commentaire de modification : Il n'y a aucun commentaire pour cette version

Source
Rendu

Résumé

Propriétés de la Page (2 modifications, 0 ajouts, 0 suppressions)

Détails

Propriétés de la Page

Auteur du document

@@ -1,1 +1,1 @@
--XWiki.DBA
++XWiki.JDT

Contenu

@@ -1,3 +1,5 @@
++**PAGE EN COURS DE REDACTION**
++
  (% class="mark small" %)**Version 4.5.54 et ultérieures**
  |(% style="width:840px" %)(((
@@ -5,78 +5,73 @@
  (((
  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.
--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.
++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.
  )))
  (((
--= À quoi sert l'aide en ligne dans Flora ? =
++= L'aide en ligne : un appui à la saisie dans Flora =
--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.
--**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**.
++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.
++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.
++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.
-->(% class="small" %)Cas d'usage:
++Concrètement, l’aide en ligne permet de :
--(((
-->(% class="small" %)Expliquer le contenu attendu dans un champ.
++* **Expliquer le contenu attendu dans un champ**.
++* **Formaliser les règles de saisie propres à l’institution** (abréviations autorisées, vocabulaire contrôlé, conventions d’écriture, etc.).
++* **Donner accès à des ressources externes de référence** (textes réglementaires, chartes internes, normes, guides méthodologiques).
++* **Harmoniser les pratiques et éviter les erreurs d’interprétation**, notamment dans les équipes élargies ou en cas de renouvellement des agents.
--(((
-->(% class="small" %)Formaliser les règles de saisie propres à l’institution.
++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.
-->(% class="small" %)Indiquer à quels processus le champ est lié  (ex. : inventaire, récolement, prêt, dépôt, restauration, etc.).
++Elle constitue une **base commune de référence pour l’ensemble des utilisateurs**.
-->(% class="small" %)Donner accès à des ressources externes de référence.
++Toutefois, chaque institution a la possibilité d**’adapter cette aide à ses propres pratiques**.
-->(% class="small" %)Harmoniser les pratiques et éviter les erreurs d’interprétation.
--)))
--)))
++= Personnaliser l'aide en ligne =
--(% class="box successmessage" %)
--(((
--**Bonnes pratiques : **
++Lorsqu’un musée crée une **aide en ligne personnalisée** pour un champ :
--* **Uniformisez la présentation** : adoptez une structure homogène pour toutes vos aides (ex. : définition, usage, remarques).
--* **Soyez clairs et concis** : rédigez des explications courtes et immédiatement compréhensibles.
--* **Employez le vocabulaire métier partagé** : utilisez les termes définis dans la charte de saisie de votre institution.
--* **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).
--* **Ajoutez des exemples concrets** : illustrez les valeurs attendues afin d’éviter les ambiguïtés.
--* **Limitez les redondances** : ne recopiez pas intégralement l’aide du wiki, mais complétez-la ou adaptez-la selon vos besoins.
--* **Documentez aussi les blocs de champs** : expliquez leur rôle global en plus des champs qu’ils contiennent.
--* **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.
--* **Vérifiez l’accessibilité** : testez l’ouverture des pop-up d’aide dans les navigateurs utilisés.
--* **Mettez à jour régulièrement** : adaptez vos contenus lorsque vos procédures internes ou règles métier évoluent.
--)))
++* le contenu standard issu du** wiki est automatiquement masqué**
++* seul le **contenu rédigé localement est affiché**
--= Repérer le nom informatique du champ ou du bloc à documenter =
++Si cette personnalisation est supprimée, l’aide du wiki réapparaît automatiquement.
--Pour retrouver le fichier d’aide correspondant, vous devez d’abord identifier le nom interne du champ ou du bloc de champs. Pour cela :
++Cette **personnalisation est strictement locale** : elle s’applique uniquement à la base de données de l’institution qui l’a créée.
++Elle ne modifie pas le contenu du wiki et n’a aucun impact sur les autres institutions.
--* Survolez le libellé dans une grille de saisie : son nom interne s’affiche en infobulle.
--* Vous pouvez aussi faire un clic droit sur le libellé et choisir **Afficher informations** pour copier directement le nom interne.
-->(% class="small" %)Exemple : dans la table MUS_BIEN, le champ Numéro d’inventaire porte le nom technique **NUM_INVENTAIRE**.
++== Identifier le nom interne du champ ou du bloc ==
--[[//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"]]
++Pour retrouver le fichier d’aide correspondant, vous devez d’abord identifier le nom interne du champ ou du bloc de champs.
++Pour cela :
--[[//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"]]
++1. Faites un **clic droit** sur le libellé du champ
++1. Choisir **Afficher informations**
++1. **Copiez le nom interne **du champ (ligne name)
++[[//Clic droit - Afficher informations//>>image:1744363948510-224.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
--[[//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"]]
++[[//Nom interne du champ//>>image:1744363968204-295.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
--= Accéder à l'éditeur d'aide en ligne =
--Pour créer ou modifier une aide, rendez-vous dans l’espace de travail **Administration**, menu **Paramétrage** > **Aide en ligne**.
++== Ouvrir l’éditeur d’aide en ligne ==
--Vous y trouverez la liste des fichiers disponibles, organisés par source et par table.
++1. Rendez-vous dans l'espace de travail **Administration, menu Paramétrage, Aide en ligne**
++1. Dépliez la rubrique** Aide à la saisie**
++1. Choisir la source et la table
++1.
--Dépliez la rubrique **Aide à la saisie** pour rechercher les champs et blocs de champs à documenter.
++
++
  [[//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"]]
--= Rechercher le champ ou le bloc à documenter =
++= Localiser le champ ou le bloc à personnaliser =
  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 :
@@ -95,23 +95,43 @@
  [[//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"]]
--= Éditer l'aide en ligne =
++= Rédiger et mettre en forme votre aide =
  Une fois le champ ou le bloc trouvé, cliquez sur son nom pour ouvrir l’éditeur HTML.
--Vous pouvez saisir directement votre texte ou copier-coller l’aide du wiki avant de l’adapter à vos besoins internes.
++(((
++1. **Saisir le contenu**
--Cet éditeur fonctionne comme un traitement de texte (type Word) et propose de nombreuses options :
++* Tapez directement votre texte dans l’éditeur.
++* Vous pouvez aussi copier-coller l’aide issue du wiki et l’adapter à vos besoins internes.
--* **Mise en forme du texte** : gras, italique, souligné, exposant, indice.
--* **Organisation du contenu** : listes à puces, listes numérotées, retrait, alignement.
--* **Styles et formats** : titres, styles prédéfinis, choix de la police et de la taille.
--* **Tableaux et images** : insertion et gestion de tableaux, ajout d’images.
--* **Éléments enrichis** : caractères spéciaux, symboles.
--* **Outils pratiques** : correcteur orthographique, recherche/remplacement, annuler/rétablir, affichage du code source.
++(% class="box successmessage" %)
++(((
++**Bonnes pratiques : **
--Une fois votre saisie terminée, cliquez sur **Sauvegarder** pour enregistrer votre personnalisation. **Dès la sauvegarde, l’aide en ligne par défaut issue du wiki est remplacée par votre aide personnalisée** : celle-ci ne s’affichera que dans votre base de données institutionnelle et n’aura aucun impact sur le wiki ni sur les autres musées.
++* Uniformisez la présentation : adoptez une structure homogène pour toutes vos aides (ex. : définition, usage, remarques).
++* Soyez clairs et concis : rédigez des explications courtes et immédiatement compréhensibles.
++* Employez le vocabulaire métier partagé : utilisez les termes définis dans la charte de saisie de votre institution.
++* Précisez le contexte : indiquez si le champ ou bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration).
++* Ajoutez des exemples concrets : illustrez les valeurs attendues pour éviter toute ambiguïté.
++* Limitez les redondances : n’intégrez que ce qui est pertinent, sans recopier inutilement l’aide du wiki.
++* Documentez aussi les blocs de champs : expliquez leur rôle global en plus des champs qu’ils contiennent.
++)))
++)))
++(((
++(% start="2" %)
++1. **Mettre en forme l’aide**
++
++* L’éditeur fonctionne comme un traitement de texte (type Word) et vous permet d’appliquer différents outils :
++** **Mise en forme du texte** : gras, italique, souligné, exposant, indice.
++** **Organisation du contenu** : listes à puces, listes numérotées, retrait, alignement.
++** **Styles et formats** : titres, styles prédéfinis, choix de la police et de la taille.
++** **Tableaux et images** : insertion et gestion de tableaux, ajout d’images.
++** **Éléments enrichis** : caractères spéciaux, symboles.
++** **Outils pratiques** : correcteur orthographique, recherche/remplacement, annuler/rétablir, affichage du code source.
++)))
++
  (% class="box warningmessage" %)
  (((
  **Point d’attention : insérer des liens**
@@ -120,18 +120,21 @@
  * Copiez-collez ensuite ce lien dans l’éditeur d’aide en ligne. Il sera reconnu correctement et restera actif.
  )))
++(((
++(% start="3" %)
++1. **Sauvegarder la personnalisation**
++
++* Cliquez sur **Sauvegarder** pour enregistrer vos modifications.
++* Dès la sauvegarde, l’aide en ligne du wiki disparaît : elle est remplacée par votre aide personnalisée.
++* Cette personnalisation ne s’applique que dans votre base institutionnelle et n’a aucun impact sur le wiki ni sur les autres musées.
++)))
++
  (% class="box successmessage" %)
  (((
  **Bonnes pratiques : **
--* **Uniformisez la présentation** : adoptez une structure homogène (définition, usage, remarques).
--* **Soyez clairs et concis** : rédigez des explications courtes et directement utiles.
--* **Employez le vocabulaire métier partagé** : utilisez les termes définis dans la charte de saisie de votre institution.
--* **Précisez le contexte** : indiquez si le champ ou bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration).
--* **Ajoutez des exemples concrets** : illustrez les valeurs attendues pour éviter toute ambiguïté.
--* **Limitez les redondances** : n’intégrez que ce qui est pertinent, sans recopier inutilement l’aide du wiki.
--* **Documentez aussi les blocs de champs** : expliquez leur rôle global en plus des champs qu’ils contiennent.
--* **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.
++* 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.
++* Mettez à jour régulièrement : adaptez vos contenus lorsque vos procédures internes ou règles métier évoluent.
  )))
  >(% class="small" %)L’exemple ci-dessous illustre le champ **Numéro d’inventaire** avec une aide en ligne enrichie :
@@ -152,13 +152,11 @@
  [[//Saisie et mise en forme des données//>>image:1757596818102-351.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
--(% class="wikigeneratedid" id="H200B200B200B200B200B200B200B200B200B200B200B200B200B200B" %)
--
--[[//Sauvegarde de l'aide en ligne//>>image:1757597668258-471.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++[[//Sauvegarder l'aide en ligne//>>image:1757597668258-471.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
--= Consulter le résultat =
++= Contrôler le rendu dans Flora =
  Une fois votre aide personnalisée sauvegardée, il est essentiel de** vérifier son affichage** dans les grilles de saisie. Cette étape vous permet de **contrôler que le contenu rédigé apparaît bien en contexte** et qu’il remplace correctement, le cas échéant, l’aide du wiki.
@@ -176,7 +176,7 @@
  (% id="cke_bm_851S" style="display:none" %)
--= Revenir à l'aide en ligne du wiki =
++= Rétablir l’aide par défaut du wiki =
  Si vous ne souhaitez plus conserver une aide en ligne personnalisée et préférez retrouver l’aide générique fournie par le wiki, procédez comme suit :
@@ -191,7 +191,7 @@
  **Résultat :** l’aide en ligne personnalisée disparaît et l’aide générique du wiki réapparaît automatiquement pour ce champ ou ce bloc.
--[[//Repérage nom interne du champ - survol//>>image:1757599364051-795.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
++[[//Repérage nom interne du champ - une infobulle apparait avec le survol du champ//>>image:1757599364051-795.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
  [[//Choix de **la source** et de la** table**//>>image:1757599467798-396.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
@@ -220,6 +220,7 @@
  **Aller plus loin**
  * [[Comprendre les sources et les tables dans Flora>>doc:2_Administration.Administration fonctionnelle.Présentation des sources et des tables.WebHome||target="_blank"]]
++* [[Insérer un document interne pour accueil>>doc:2_Administration.Administration fonctionnelle.Documents de référence sur page d'aide.WebHome||target="_blank"]]
  * (((
  [[Saisir dans Flora>>doc:1_Fonctionnalités.5\.C\. Saisie.WebHome||target="_blank"]]
  )))
@@ -233,4 +233,4 @@
  )))
  )))
--*
++