Docs: flux de données

1 files changed, 115 insertions, 0 deletions

diff --git a/docs/fr/source/principes.rst b/docs/fr/source/principes.rst
index 172764c95..8e755e8cd 100644
--- a/docs/fr/source/principes.rst
+++ b/docs/fr/source/principes.rst
@@ -174,6 +174,121 @@ Les documents sont gérés de manière transversale et peuvent être librement a
 Notions avancées
 ================
 
+Les flux de données
+-------------------
+
+Pour alimenter Ishtar en données, on distingue 3 modes opératoires :
+
+- l'import,
+- l'ajout/modification par formulaire,
+- la modification par lot.
+
+Chacun de ces modes offrent avantages et inconvénients qu'il faut avoir en tête pour utiliser Ishtar de manière optimale.
+
+Import
+******
+
+Mode opératoire
+###############
+
+Cela consiste en l'import de données dans Ishtar depuis un fichier « tableur » (format CSV).
+
+Un « importeur » est utilisé afin d'extraire les données de ce fichier.
+
+Cet « importeur » définit plusieurs choses, en particulier :
+
+- quel est le type de données à importer (des opérations, du mobilier, de la documentation, etc.) ;
+- un ordre de colonne précis ;
+- quelles sont les colonnes obligatoires ;
+- des formats de données attendus pour chaque colonne ;
+- une correspondance entre colonnes et champs de base de données (sachant que certains champs peuvent être constitués d'une concaténation de plusieurs colonnes) ;
+- des données par défaut ;
+- etc.
+
+Une fois un fichier d'import rempli, depuis l'interface Ishtar, on procède à l'import effectif. Celui-ci se déroule en plusieurs phases :
+
+- création d'un import (où l'on spécifie le nom, le type d'importeur, le fichier à importer, etc.).
+- analyse du fichier à importer : Ishtar vérifie la cohérence de base du fichier et désigne d'éventuelles entrées à rapprocher.
+- rapprochement entre des entrées du fichier du tableur et des listes de types fixes d'Ishtar : une table de correspondance est créée.
+- import effectif des données.
+
+
+Atouts
+######
+
+- Ce mode opératoire permet d'utiliser en amont des outils externes pour le raffinage des données (exemple : OpenRefine).
+- Les rapprochements permettent aussi une mise en correspondance facilitée des données.
+- La personne qui fournit les données n'a pas besoin de compte sur Ishtar : l'import peut être fait par un gestionnaire de données qui en amont fournit un exemple de fichier ou alors remodèle les données sources pour correspondre à l'importeur.
+- Dans le cadre d'intégration de données externes, le fichier d'import demeure afin de pouvoir ainsi remonter à la source des données et conserver l'historique.
+
+Inconvénients
+#############
+
+- Ce mode opératoire nécessite la création d'un importeur qui nécessite une forme d'expertise sur la base (connaître les champs obligatoires en création, générer correctement les identifiants depuis les colonnes, savoir faire correspondre les champs aux noms en base de données). Des importeurs sont disponibles de base dans Ishtar ;
+- L'importeur n'apporte pas de surcouche de contrôle, des données incohérentes dans le fichier source peuvent déclencher des erreurs en base de données et donner lieu à des messages d'erreur assez peu explicites ;
+- Les données importées sont écrites dans la base de données directement, un mauvais paramétrage d'importeur peut donner lieu à une destruction de données.
+
+Cas d'utilisation
+#################
+
+C'est le mode opératoire à privilégier pour les sources de données externes à Ishtar que cela soit une reprise d'une base de données pré-existante ou une intégration de données d'autres intervenants.
+
+En terme de mise à jour, ce mode opératoire peut être pertinent lors de la mise à jour de masse, notamment lorsque cette mise à jour est déléguée. En effet, avec un importeur ciblé sur les seules données à mettre à jour, ce mode peut être très efficace. Le contrôle du fichier avant import est aisé.
+
+Ajout/modification par formulaire
+*********************************
+
+Mode opératoire
+###############
+
+L'ajout se fait via un enchaînement de formulaire web dans l'interface Ishtar. Ces formulaires sont découpés de manière thématique (exemple : formulaire « Conservation » de « Mobilier ») ou logique (le type d'opération est dans le premier formulaire Opération car il conditionne les formulaires suivants).
+
+Chaque formulaire peut être personnalisé en ajoutant certains champs spécifiques (les champs personnalisés) ou en supprimant des champs de l'affichage. Ces personnalisations peuvent être faites pour tous ou simplement pour certains profils d'utilisateurs.
+
+Atouts
+######
+
+- Notamment via les formulaires spécialisés, ce mode opératoire peut être un moyen efficace de saisie, en offrant des formulaires contextuels.
+- De base, ces formulaires présentent tous les champs disponibles, c'est la méthode la plus exhaustive.
+- La mise à disposition de facilitateurs de saisie permet par endroits des filtres de données (exemple : le champ Contenant parent ne liste que les contenants du lieu de conservation actuel) ou de faciliter la saisie (exemple : la saisie intelligente d'une liste de parcelle depuis un champ texte).
+
+Inconvénients
+#############
+
+- Cette saisie peut être longue et fastidieuse sur des gros volumes.
+
+Cas d'utilisation
+#################
+
+Ce mode opératoire est particulièrement adapté à de la saisie/correction unitaire. Elle peut s'avérer pertinente pour une saisie terrain pour peu que l'on dispose de matériel adapté (tablette avec connexion Internet) et avec éventuellement des formulaires personnalisés afin de réduire la saisie aux seuls champs pertinents.
+
+Modification par lot
+********************
+
+Mode opératoire
+###############
+
+Depuis les interfaces tableaux Ishtar, on fait une sélection multiple des lignes correspondant aux élément à modifier puis un clic sur le crayon vert permet d'accéder au formulaire de modification par lot.
+
+Atouts
+######
+
+- Édition très rapide de champs sur plusieurs éléments.
+
+Inconvénients
+#############
+
+- La facilité et rapidité d'édition est propice aux erreurs si l'on n'est pas vigilant (un élément supplémentaire est vite sélectionné).
+- Pour cette raison, cette interface n'est accessible qu'aux gestionnaires de base / administrateurs.
+- Le nombre de champs disponible est limité.
+- Sur les champs multivalués (types de matériau par exemple), on ne peut actuellement qu'ajouter une nouvelle valeur, pas remplacer une valeur existante.
+
+Cas d'utilisation
+#################
+
+Ce mode opératoire est particulièrement pertinent pour la correction en masse de données. Cela peut être aussi utile pour des travaux de pointage.
+
+
 .. _donnees-geographiques:
 
 Données géographiques