Documenter l’aide en ligne

1

(% class="mark small" %)**Version 4.5.54 et ultérieures**

2

3

|(% style="width:840px" %)(((

4

(% class="box" %)

5

(((

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

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.

)))

(((

= À quoi sert l'aide en ligne dans Flora ? =

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

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

18

>(% class="small" %)Cas d'usage:

19

20

(((

21

>(% class="small" %)Expliquer le contenu attendu dans un champ.

22

23

(((

24

>(% class="small" %)Formaliser les règles de saisie propres à l’institution.

25

26

>(% class="small" %)Indiquer à quels processus le champ est lié (ex. : inventaire, récolement, prêt, dépôt, restauration, etc.).

27

28

>(% class="small" %)Donner accès à des ressources externes de référence.

29

30

>(% class="small" %)Harmoniser les pratiques et éviter les erreurs d’interprétation.

)))

)))

(% class="box successmessage" %)

35

(((

36

**Bonnes pratiques : **

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

)))

49

50

= Récupérer le nom informatique du champ ou du bloc à documenter =

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 :

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.

56

57

>(% class="small" %)Exemple : dans la table MUS_BIEN, le champ Numéro d’inventaire porte le nom technique **NUM_INVENTAIRE**.

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"]]

60

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"]]

63

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"]]

66

67

68

= Accéder à l'éditeur d'aide en ligne =

69

70

Pour créer ou modifier une aide, rendez-vous dans l’espace de travail **Administration**, menu **Paramétrage** > **Aide en ligne**.

71

72

Vous y trouverez la liste des fichiers disponibles, organisés par source et par table.

73

74

Dépliez la rubrique **Aide à la saisie** pour rechercher les champs et blocs de champs à documenter.

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"]]

77

78

79

= Rechercher le champ ou le bloc à documenter =

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

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.

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"]]

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 sélectionné, cliquez sur son nom pour ouvrir l’éditeur html. Vous pouvez :

101

102

* saisir directement votre texte,

103

* ou copier-coller l’aide du wiki avant de l’adapter à vos besoins internes.

104

105

Lorsque votre rédaction est terminée, cliquez sur **Sauvegarder** pour enregistrer votre personnalisation.

106

107

(% class="box successmessage" %)

108

(((

109

**Bonnes pratiques : **

110

111

* **Uniformisez la présentation** : adoptez une structure homogène (définition, usage, remarques).

112

* **Soyez clairs et concis** : rédigez des explications courtes et directement utiles.

113

* **Employez le vocabulaire métier partagé** : utilisez les termes définis dans la charte de saisie de votre institution.

114

* **Précisez le contexte** : indiquez si le champ ou bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration).

115

* **Ajoutez des exemples concrets** : illustrez les valeurs attendues pour éviter toute ambiguïté.

116

* **Limitez les redondances** : n’intégrez que ce qui est pertinent, sans recopier inutilement l’aide du wiki.

117

* **Documentez aussi les blocs de champs** : expliquez leur rôle global en plus des champs qu’ils contiennent.

118

* **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.

119

)))

120

121

(% class="wikigeneratedid" id="H200B200B200B200B200B200B200B200B200B200B200B200B200B200B" %)

122

[[image:1757596818102-351.png]]

(% id="cke_bm_851S" style="display:none" %)

127

128

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 :

129

130

* (((

131

[[Firefox>>https://support.mozilla.org/fr/kb/parametres-exceptions-depannage-blocage-popup]]

132

)))

133

* (((

134

[[Safari >>https://support.apple.com/fr-fr/guide/safari/ibrwe2159f50/mac]]

135

)))

136

* (((

137

[[Chrome>>https://support.google.com/chrome/answer/95472?co=GENIE.Platform%3DDesktop&hl=fr]]

138

)))

139

* (((

140

[[Edge>>https://support.microsoft.com/fr-fr/help/17479/windows-internet-explorer-11-change-security-privacy-settings]]

)))

)))

)))|(% style="width:300px" %)(((

(% class="box" %)

(((

**Sommaire**

)))

(% class="box" %)

(((

**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"]]

160

* (((

161

[[Saisir dans Flora>>doc:1_Fonctionnalités.5\.C\. Saisie.WebHome||target="_blank"]]

)))

)))

(% class="box" %)