Docs-fr: type lists.

2 files changed, 68 insertions, 38 deletions

diff --git a/docs/fr/source/annexe-3-ex-flux-ope.rst b/docs/fr/source/annexe-3-ex-flux-ope.rst
index 3a497700f..94aca453c 100644
--- a/docs/fr/source/annexe-3-ex-flux-ope.rst
+++ b/docs/fr/source/annexe-3-ex-flux-ope.rst
@@ -25,6 +25,7 @@ Pré-requis :
 
   - les patrons des actes administratifs associés à la demande de prêt ont été créés,
   - la personne en charge du prêt a un compte Ishtar qui dispose au minimum :
+
      - de droits de lecture et modification sur le mobilier éventuellement concerné par la sélection,
      - d'un droit de création de demande de traitement,
      - d'un droit de création d'acte administratif.
@@ -50,7 +51,7 @@ Sélection du mobilier depuis cette pré-selection par la structure emprunteuse
 
 .. note:: Un lien direct peut être donné à la structure emprunteuse pour quelle gère son panier, il suffit d'aller sur le panneau de gestion des éléments du panier concerné (*Mobilier › Panier › Gestion des éléments*) et de recopier l'adresse dans la barre d'adresse. La structure emprunteuse devra préalablement s'identifier avant d'accéder à ce lien.
 
-.. warning:: Si le droit de lecture de mobilier de la structure emprunteuse est basé sur le mobilier rattaché via ce panier, enlever un élément du panier lui retire le droit de consulter cet élément. Une astuce peut être de partager le panier dupliqué : une fois en lecture seule, une fois en lecture/édition, ainsi même si un élément est retiré du panier en lecture/édition, il reste « rataché » à la structure emprunteuse par la panier en lecture seule.
+.. warning:: Si le droit de lecture de mobilier de la structure emprunteuse est basé sur le mobilier rattaché via ce panier, enlever un élément du panier lui retire le droit de consulter cet élément. Une astuce peut être de partager le panier dupliqué : une fois en lecture seule, une fois en lecture/édition, ainsi même si un élément est retiré du panier en lecture/édition, il reste « rataché » à la structure emprunteuse par la panier en lecture seule. Le panier en lecture simple peut aussi recevoir des éléments disponibles pour prêt mais pas forcément retenu dans la sélection proposée.
 
 3. La structure emprunteuse retire du panier les éléments qui ne l'intéresse pas.
 4. Fin d'étape : la structure emprunteuse a fini sa sélection et confirme son intérêt pour un prêt (par courriel, ...).
@@ -77,7 +78,8 @@ Départ effectif du mobilier concerné
 
         panier="Exposition Sein 2018" pret="Oui" fin-de-traitement-avant="aujourdhui+30"
 
-3. 3O jours avant la date de retour attendue, l'alerte sera affichée. 
+3. Avec cette requête, 30 jours avant la date de retour attendue, l'alerte sera affichée.
+4. Fin d'étape : le mobilier a été retourné.
 
 
 Gestion du retour du mobilier
diff --git a/docs/fr/source/interface-administrateur.rst b/docs/fr/source/interface-administrateur.rst
index 59e3710d5..c0d2b26c7 100644
--- a/docs/fr/source/interface-administrateur.rst
+++ b/docs/fr/source/interface-administrateur.rst
@@ -18,6 +18,34 @@ L'interface d'administration présente la liste des différentes tables par ordr
 
 .. warning:: Pour des questions de performance, Ishtar utilise intensément un système de cache. Il arrive parfois que celui-ci tarde à se mettre à jour. Il peut arriver que des modifications en administration prennent plusieurs minutes à être prises en compte.
 
+Listes de types
+---------------
+
+Ishtar fournit par défaut des données pour chaque liste de choix. Chacune de ces listes est paramétrable en administration.
+
+Dans les pages d'administration, les listes de types se retrouvent sous les dénominations « Types de ... », rangées par application :
+
+- **Ishtar - Commun** : contient les listes de types transversales utilisées par plusieurs types d'éléments ;
+- **Ishtar - Opération** : contient les listes de types concernant les opérations et les entités archéologiques/sites ;
+- **Ishtar - Unités d'enregistrement** : contient les listes de types relatives aux Unités d'enregistrement et aux datations ;
+- **Ishtar - Mobilier** : contient les listes de types relatives au mobilier et au traitements ;
+- **Ishtar - Lieu de conservation** : contient les listes de types relatives aux lieux de conservation et aux contenants ;
+- **Ishtar - Dossier** : contient les listes de types relatives aux dossiers administratifs.
+
+Dans Ishtar, chaque type est défini au minimum par les champs suivants :
+
+- **Dénomination**
+- **Identifiant textuel** : L'identifiant textuel est une version standardisée du nom. Il ne contient que des lettres en minuscule, des nombres et des tirets (-). Chaque identifiant textuel doit être unique dans la liste de type. Ces identifiants sont des clés permettant les échanges entre bases de données et pour des traductions. Ces identifiants peuvent être utilisés dans le code source de l'application. Une fois créés il ne faut a priori pas changer ces identifiants textuels.
+- **Commentaire** : Le contenu du commentaire est affiché dans l'aide en ligne sur les formulaires.
+- **Disponibilité** : Décocher ce champ rend indisponible ce type dans les formulaires.
+- **Ordre** : Dans les listes les champs sont ordonnés par ce numéro d'ordre et en cas d'égalité par ordre alphabétique.
+
+Certains types permettent de mettre en place une hiérarchie. Pour cela le champ **parent** est disponible. Chaque « sous-type » renseigne ce champ avec le « sur-type » adéquat. 
+
+Certains types disposent aussi d'autres champs spécifiques ils sont explicites ou disposent d'une aide en ligne.
+
+.. note:: Pour travailler sur ces listes de types ou les transmettre à des tiers, la possibilité est offerte d'exporter ces listes de types via l'interface d'administration. On sélectionne les éléments à exporter (ou tous les éléments) puis on utilise l'action « Exporter les éléments sélectionnés en fichier CSV ». Le fichier peut alors être édité dans un tableur. Pour une mise à jour, il est important de ne pas modifier les identifiants textuels qui sont la clé de rapprochement pour le ré-import. L'action d'import est disponible en haut à droite : « Import depuis un CSV ».
+
 
 Champs personnalisés
 --------------------
@@ -30,23 +58,23 @@ Ajouter un champ personnalisé se fait via l'interface d'administration au nivea
 
 Les différentes données à rentrer sont :
 
-  * **Nom** : Ce nom sera reprit dans les formulaires et la fiche.
-  * **Type de contenu** : Le type d'objet auquel sera rattaché le champ - Opération, Site, Unité d'Enregistrement et Mobilier.
-  * **Clé** : Valeur de la clé dans le format JSON. Cette clé ne doit impérativement comporter que des lettres minuscules, sans accent ou un tiret bas « _ » (ne pas commencer la clé par le tiret bas et ne pas mettre plusieurs tiret bas d'affilée dans la clé de base). On peut structurer les données personnalisée de manière hiérarchique. Pour les clés hiérarchiques on utilise « __ » entre les sections. Par exemple pour la clé « ma_sousclef » dans la catégorie « ma_categorie », la clé sera notée : *ma_categorie__ma_sousclef*.
-  * **Type** : Les types de données disponibles sont les suivants :
+* **Nom** : Ce nom sera repris dans les formulaires et la fiche.
+* **Type de contenu** : Le type d'objet auquel sera rattaché le champ - Opération, Site, Unité d'Enregistrement et Mobilier.
+* **Clé** : Valeur de la clé dans le format JSON. Cette clé ne doit impérativement comporter que des lettres minuscules, sans accent ou un tiret bas « _ » (ne pas commencer la clé par le tiret bas et ne pas mettre plusieurs tiret bas d'affilée dans la clé de base). On peut structurer les données personnalisée de manière hiérarchique. Pour les clés hiérarchiques on utilise « __ » entre les sections. Par exemple pour la clé « ma_sousclef » dans la catégorie « ma_categorie », la clé sera notée : *ma_categorie__ma_sousclef*.
+* **Type** : Les types de données disponibles sont les suivants :
 
-    * Texte,
-    * Texte long : le composant de saisie sera une zone de texte,
-    * Entier : nombre entier positif ou négatif,
-    * Nombre à virgule,
-    * Booléen : case à cocher - Vrai ou Faux,
-    * Date : un composant permettant le choix de date depuis un calendrier est proposé,
-    * Choix : un composant en autocomplétion sur les valeurs existantes est proposé. L'utilisateur a la possibilité de rentrer librement de nouvelles valeurs.
+  * Texte,
+  * Texte long : le composant de saisie sera une zone de texte,
+  * Entier : nombre entier positif ou négatif,
+  * Nombre à virgule,
+  * Booléen : case à cocher - Vrai ou Faux,
+  * Date : un composant permettant le choix de date depuis un calendrier est proposé,
+  * Choix : un composant en autocomplétion sur les valeurs existantes est proposé. L'utilisateur a la possibilité de rentrer librement de nouvelles valeurs.
 
-  * **Ordre** : Le numéro saisie permet d'ordonner par défaut ce champ par rapport aux autres champs.
-  * **Section** : La section correspond à un titre de section pour présenter ce champ sur la fiche et permettre des regroupements.
-  * **Utiliser dans les index de recherche** : Si cette case est cochée, la recherche libre indexera le contenu de ce champ.
-  * **Afficher** : Si cette case n'est pas cochée, ce champ ne sera pas affiché sur la fiche.
+* **Ordre** : Le numéro saisie permet d'ordonner par défaut ce champ par rapport aux autres champs.
+* **Section** : La section correspond à un titre de section pour présenter ce champ sur la fiche et permettre des regroupements.
+* **Utiliser dans les index de recherche** : Si cette case est cochée, la recherche libre indexera le contenu de ce champ.
+* **Afficher** : Si cette case n'est pas cochée, ce champ ne sera pas affiché sur la fiche.
 
 Sauf si un champ personnalisé est uniquement destiné à des données importées et à un affichage sur la fiche, un champ personnalisé sera dans la plupart des cas intégré à un :ref:`formulaire personnalisé <formulaire-personnalise>`.
 
@@ -66,21 +94,21 @@ La création se fait en deux temps, d'abord un paramétrage des champs de base p
 Le paramétrage de base demande les champs suivants :
 
   * **Nom** : le nom correspondant au formulaire personnalisé. Ce nom ne sera visible qu'en administration mais pour s'y retrouver, il doit à la fois reprendre le nom du formulaire ainsi que le contexte pour lequel il a été défini. Par exemple : « Mobilier - 020 - Général - Tout utilisateur » ou « Mobilier - 030 - Conservation - Saisie terrain ».
-  * **Formulaire** : le formulaire à personnaliser. Le nom utilisé permet d'identifier assez simplement le formulaire correspondant car il correspond dans l'ordre (séparé par des tirets) au :
+* **Formulaire** : le formulaire à personnaliser. Le nom utilisé permet d'identifier assez simplement le formulaire correspondant car il correspond dans l'ordre (séparé par des tirets) au :
 
-    * type d'objet concerné (par exemple : « Mobilier »),
-    * éventuellement, le numéro d'ordre dans le wizard,
-    * nom du formulaire.
-  * **À qui s'applique ce formulaire**, cela peut être au choix :
+  * type d'objet concerné (par exemple : « Mobilier »),
+  * éventuellement, le numéro d'ordre dans le wizard,
+  * nom du formulaire.
+* **À qui s'applique ce formulaire**, cela peut être au choix :
 
-    * à tous les utilisateurs,
-    * à certains utilisateurs en particulier,
-    * à certains types d'utilisateurs.
+  * à tous les utilisateurs,
+  * à certains utilisateurs en particulier,
+  * à certains types d'utilisateurs.
 
 Une fois ce paramétrage de base enregistré, la configuration précise du formulaire peut se faire :
 
-  * **champs à exclure** : chaque champ de base présent dans le formulaire actuel peut être sélectionné dans la liste pour être écarté de la saisie.
-  * **champs JSON** : tous les champs JSON préalablement paramétrés concernant l'élément courant peuvent être sélectionnés. La dénomination permet éventuellement de surcharger le nom par défaut du champ JSON. L'ordre permet de placer le champ dans le formulaire. L'aide permet éventuellement d'ajouter un texte pour aider à la saisie.
+* **champs à exclure** : chaque champ de base présent dans le formulaire actuel peut être sélectionné dans la liste pour être écarté de la saisie.
+* **champs JSON** : tous les champs JSON préalablement paramétrés concernant l'élément courant peuvent être sélectionnés. La dénomination permet éventuellement de surcharger le nom par défaut du champ JSON. L'ordre permet de placer le champ dans le formulaire. L'aide permet éventuellement d'ajouter un texte pour aider à la saisie.
 
 .. warning:: Sur les formulaires de création, il est impératif de ne pas exclure des champs obligatoires sans quoi la création devient impossible.
 
@@ -108,28 +136,28 @@ Les permissions dans Ishtar sont essentiellement gérées par « Type de profil
 
 La création/configuration d'un type de profil se fait via : *Ishtar - Commun › Types de profil* :
 
-  - **dénomination** : ce champ doit être explicite car il va être retrouvé au niveau de l'interface utilisateur.
-  - **identifiant textuel** : rempli selon les règles habituelles des identifiants textuels.
-  - **groupes** : listes des groupes auxquels le profil est rattaché.
+- **dénomination** : ce champ doit être explicite car il va être retrouvé au niveau de l'interface utilisateur.
+- **identifiant textuel** : rempli selon les règles habituelles des identifiants textuels.
+- **groupes** : listes des groupes auxquels le profil est rattaché.
 
 Chaque groupe correspond à un type de permission pour un élément précis de la base de données :
 
-  - droit de lecture ;
-  - droit d'ajout ;
-  - droit de modification/suppression.
+- droit de lecture ;
+- droit d'ajout ;
+- droit de modification/suppression.
 
 Chacun de ces droit est décliné en deux modalités :
 
-  - droits sur tous les éléments ;
-  - droit sur les éléments rattachés.
+- droits sur tous les éléments ;
+- droit sur les éléments rattachés.
 
 Un élément est dit « rattaché » à une personne en fonction de règles précises spécifiées dans l':ref:`annexe 1 - règles de rattachement à un élément <annexe-1-rattachement>`. La notion de rattachement permet de spécifier finement les permissions pour des personnes qui sont directement associé à l'élément. Par exemple cela permet donner les droits de modification du mobilier d'une opération au responsable scientifique de cette opération.
 
 En pratique, globalement, les groupes de droits permettent d'accéder à certaines actions :
 
-  - le droit de lecture permet une ouverture de la fiche correspondant à l'élément ;
-  - le droit d'ajout permet d'accéder aux actions d'ajout d'un nouvel élément ;
-  - le droit de modification/suppression permet d'accéder aux actions concernant la modification/suppression des éléments.
+- le droit de lecture permet une ouverture de la fiche correspondant à l'élément ;
+- le droit d'ajout permet d'accéder aux actions d'ajout d'un nouvel élément ;
+- le droit de modification/suppression permet d'accéder aux actions concernant la modification/suppression des éléments.
 
 Dans le détail, il y a certaines actions qui sont ouvertes en fonction d'appartenance à des groupes en particulier. Tout cela est détaillé dans l':ref:`annexe 2 - permissions nécessaires pour les actions <annexe-2-permission-action>`.