database:import-formats:taxhub-medias-textes

Ceci est une ancienne révision du document !


Import de médias et textes dans TaxHub - Format v1.0

Les fichiers seront transmis dans un fichier d'archive au format ZIP. Le nom du fichier devra être en minuscule et contenir plusieurs parties séparées par des underscores ("_"). Les parties du fichier seront les suivantes :

  1. date au format ISO 8601 : 2020-08-26
  2. sujet : sinp
  3. abréviation de la région concernée : paca / aura
  4. abréviation de l'organisme fournisseur : cbna / cbnmed / cbnmc / cenpaca …
  5. type de données : media / text
  6. extension : .zip

Exemple : 2020-08-26_sinp_paca_cbna_media.zip

L'archive devra contenir le fichier suivant :

  • meta_archive.ini : fichier contenant les métadonnées sur le fournisseur de l'archive et la version du format d'échange utilisée.

L'archive pour les données de type media devra contenir le fichiers suivant :

  1. media.csv : ficher contenant les informations sur les médias (images, pdf…) à lier aux taxons.

L'archive pour les données de type text devra contenir le fichiers suivant :

  1. text.csv : fichier contenant les informations sur les textes à lier aux taxons et concernant un attribut.

L'archive pour les données de type text pourra contenir le fichiers suivant :

  1. attribut.csv : fichier contenant les informations des attributs d'un thème.
  2. theme.csv : fichier contenant les informations d'un thème.

Ce fichier au format INI a pour objectif de fournir les informations sur l'origine des autres fichiers fournis dans l'archive.
Il concerne le créateur de l'archive.

Ce fichier devra:

  • être encodé en UTF-8
  • être nommé (en minuscule) : meta_archive.ini

Les règles à respecter pour ce format INI sont le suivantes :

  • une ligne peut contenir soit un commentaire débutant par le caractère # ou une entrée clé / valeur
  • la clé doit être séparé de sa valeur par un =
  • les clés doivent être en minuscule et utilisé l'underscore (_) comme séparateur de mots
  • des espaces peuvent encadrer les clés et valeurs (ils seront supprimés).
  • Si la valeur contient plusieurs lignes, encadrée là par des guillemets doubles (") et indenter les ligne supplémentaires.

Format (en gras les champs obligatoires) :

  • format_version [VARCHAR(8)] : version du format d'échange utilisé pour les fichiers à importer.
  • export_date [DATE(YYYY-MM-DD HH:MM)] : date et heure de l'export des observations de la synthèse hors de la base d'origine.
  • taxref_version [VARCHAR(8)] : version de TaxRef utilisée lors de la génération de l'archive.
  • habref_version [VARCHAR(8)] : version de HabRef utilisée lors de la génération de l'archive.
  • editor [VARCHAR(100)] : nom de l'organisme créateur de l'archive.
  • contact [VARCHAR(100)] : infos sur la personne ayant créé l'archive. Format : NOM Prénom <email>.
  • notes [TEXT] : remarques divers sur les fichiers de l'archive.

Exemple :

format_version = 1.0
export_date = 2020-08-27 10:15
taxref_version = 13
editor = Conservatoire Botanique National Alpin
contact = jp.milcent@cbn-alpin.fr
notes = "Données de test.
    À utiliser seulement lors de la phase de conception."
  • database/import-formats/taxhub-medias-textes.1684251144.txt.gz
  • Dernière modification : 2023/05/16 15:32
  • de jpmilcent