Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:plugin:struct:csvimport [2020-05-17 21:47] – todo Digitalin
+++ fr:plugin:struct:csvimport [2020-05-18 07:28] (Version actuelle) – mise à jour Digitalin
@@ Ligne 1: / Ligne 1: @@
 <= [[fr:plugin:struct|Extension Struct]]
-:!: page à remanier suite aux changements d'organisation des données (données de page, globales ou en série)
 ====== Extension Struct: Import CSV ======
-[[fr:plugin:struct:schemaedit|L'éditeur de schéma]] comporte un onglet Import/Export qui permet d'importer des données brutes dans un schéma (de consultation ou de page) à l'aide d'un fichier CSV.
+[[fr:plugin:struct:schemaedit|L'éditeur de schéma]] comporte un onglet Import/Export qui permet d'importer des données brutes dans un schéma à l'aide d'un fichier CSV. Vous devez choisir quel type de données importer ou exporter, page, global, ou en série.
+Quelques règles générales :
   * La première ligne doit contenir des en-têtes correspondant aux noms de champ du schéma de consultation que vous importez
@@ Ligne 12: / Ligne 13: @@
   * Le contenu des colonnes doit être accompagné de guillemets doubles
   * Les guillemets doubles peuvent être échappés avec une barre oblique inverse (''\'') ou en utilisant le standard des double guillemets (''%%""%%'')
-  * Pour les champs multiples, le contenu de la colonne sera divisé en virgules (pas de support pour aucun échappement)
+  * Les champs de type [[fr:plugin:struct:type_lookup|lookup (recherche)]] ont une structure spéciale : ils consistent en un tableau codé en JSON avec un numéro de page et un numéro de ligne. Par exemple, une valeur de recherche brute référençant une page serait ''["namespace:id",2]'', tandis que la valeur échappée et citée en CSV ressemblerait à ceci ''"[""namespace:id"",2]"''
+  * Pour les champs multiples, le contenu de la colonne sera divisé en virgules (pas de support pour aucun échappement)  mais les champs de type "lookup" ne seront séparés que par les virgules appropriées entre les valeurs.
   * Le contenu doit être en encodage UTF-8
 En outre, dans l'importation de schémas de page :
-  * La colonne 'pid' doit exister. Elle est utilisée pour lier les données du schéma à une page appropriée.
+  * La colonne ''pid'' doit exister. Elle est utilisée pour lier les données à une page appropriée.
   * Si de nombreuses lignes font référence au même 'pid', seule la première est importée et les autres sont omises avec le message d'erreur qui convient.
-  * Si la page donné avec le 'pid' n'existe pas, la ligne entière est omise (avec le message d'erreur adéquat) mais l'importation continue.
+  * Si la page donné avec le ''pid'' n'existe pas, la ligne entière est omise (avec le message d'erreur adéquat) mais l'importation continue.
     * Si, toutefois, la case correspondante est cochée, la page est créée à la place. Cette création de page utilise le modèle d'espace de noms existant s'il existe ou crée seulement une page avec le nom de page comme premier en-tête.
-    * Dans le modèle, vous pouvez utiliser des caractères génériques de base en style Bureaucracy  pour les valeurs importées de Struct sous la forme suivante @@schemaname.labelname@@ ou ##schemaname.labelname##. Notez que les labels sont sensibles à la casse ici (par opposition à leur utilisation dans les modèles avec Bureaucracy).
+    * Dans le modèle, vous pouvez utiliser des caractères génériques de base en style Bureaucracy  pour les valeurs importées de Struct sous la forme suivante ''%%@@schemaname.labelname@@%%'' ou ''%%##schemaname.labelname##%%''. Notez que les labels sont sensibles à la casse ici (par opposition à leur utilisation dans les modèles avec Bureaucracy).
+Les données en série sont importées de manière similaire que les données de page avec quelques exceptions :
+  * Plusieurs lignes avec le même pid sont toutes importées.
+  * Si vous choisissez l'option de créer des pages inexistantes, la syntaxe sérielle appropriée sera ajoutée au bas de la page créée. Les espaces réservés dans les modèles de page sont **non pris en charge**.
-Dans le schéma de consultation, les données importées sont ajoutées à toutes les données qui sont déjà stockées.
+Les données globales ou en série importées sont ajoutées à toutes les données qui sont déjà stockées.
 Dans le schéma de page, chaque ligne importée crée une nouvelle révision de la page.