Projet.Biodiv

Si l’objectif principal d’un site Biodiv est de collecter des observations qui lui sont propre, le site permet aussi d’importer des observations venant d’autres sources. Avec la 3.8, le traitement des imports a été amélioré pour prendre en compte de nouvelles situations.

Format du fichier d’import

Le format d’entrée est un fichier XML [1]. Un exemple est proposé ci dessous :

<?xml version="1.0" encoding="UTF-8"?>
<observations>
    <observation>
        <xref>COJ2401.1.9</xref>
        <date_obs>2024-01-27</date_obs>
        <adresse>Avenue de Toulouse</adresse>
        <observateurs>Thierry PAPILLON</observateurs>
        <id_auteur>0</id_auteur>
        <espece>Accenteur mouchet</espece>
        <cd_nom>3978</cd_nom>
        <quantite>1</quantite>
        <denombrement>Co</denombrement>
        <lat>43.6095</lat>
        <lng>1.4939</lng>
        <commune>Balma</commune>
        <insee>31440</insee>
    </observation>
</observations>

A noter :

• Le jeu de caractères utilisé doit être UTF-8
• xref est la référence de l’observation dans la source externe
• L’objet observation peut être répété autant de fois que nécessaire entre les balises observations.
• Le format de la date d’observation date_obs est obligatoirement AAAA-MM-JJ
• espece représente l’espèce supposée
• cd_nom est l’identifiant TAXREF de l’espèce, si celle-ci a été déterminée. Dans le cas contraire, le champ ne doit pas apparaître.
• denombrement accepte les valeurs suivantes uniquement : Co (comptage), Es (estimation), Ca (calcul) ou NSP (ne sait pas).
• insee est le code INSEE de la commune, et non le code postal.

La nouveauté de la 3.8 porte sur la gestion du champid_auteur.

• Quand l’observateur est connu du site biodiv, la valeur du champ doit être l’identifiant numérique de l’observateur.
• Quand plusieurs observateurs, tous connus, sont à l’origine de l’observation, les identifiants doivent apparaitre, séparés par des virgules.
• Quand au moins un auteur n’est pas connu du site, ce champ doit avoir la valeur 0. L’observation sera alors enregistrée au nom du webmestre (auteur 1) et le nom du ou des observateurs sera mentionné dans le commentaire associé à l’observation.

Dans les différentes situations décrites ci-dessus, le champ id_auteur n’est pas vide, et l’import ne prendra en compte que les valeurs indiquées. Si le champ est vide ou absent, les observations seront attribuées à l’utilisateur réalisant l’import.

Créer la source externe

Pour pouvoir importer depuis une source externe, il est nécessaire de déclarer cette source dans la base du site. Cette opération est réservée aux administrateurs.

Réaliser l’import

Une fois la source externe créée dans la base, il est possible d’importer le fichier au moyen d’un formulaire situé sur la page Traitements par lots.

Après avoir sélectionné le fichier XML à importer, il est important de choisir la source de données externe et le mode de contrôle avant de déclencher l’importation.