DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:plugin:struct:csvimport

Extension Struct

Extension Struct: Import CSV

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
  • Les colonnes dont les en-têtes ne correspondent à aucun nom de champ sont ignorées
  • Seules les virgules sont prises en charge en tant que séparateur
  • 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 ("")
  • Les champs de type 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 à 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, 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).

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.

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.

Vous pouvez utiliser l'export CSV dans le même onglet pour obtenir un exemple de fichier CSV.

fr/plugin/struct/csvimport.txt · Dernière modification : 2020-05-18 07:28 de Digitalin

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki