Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente |
database:import-formats [2025/04/30 08:40] – [Description du format OCCTAX] jpmilcent | database:import-formats [2025/07/03 08:31] (Version actuelle) – [Description du format OCCTAX] choarau |
---|
| |
==== À faire / Améliorations ==== | ==== À faire / Améliorations ==== |
* <todo>Trouer une solution au problème du remplacement des caractères \n, \r… qui ne fonctionne pas lors de l'import dans la base</todo> | * <todo>Dans le format OccTax, renommer les champs UUID en unique_id_couting, unique_id_occurence et unique_id_survey pour que cela soit plus clair !</todo> |
| * <todo>Dans le format OccTax, prevoir l'ajout des champ code_nomenclature_tech_collect_campanule et sample_number_proof</code> |
| * <todo>Trouver une solution au problème du remplacement des caractères \n, \r… qui ne fonctionne pas lors de l'import dans la base</todo> |
* <todo>Modifier le nom du champ //determiner// de la ressource //SYNTHESE// en //determiner**s**//</todo> | * <todo>Modifier le nom du champ //determiner// de la ressource //SYNTHESE// en //determiner**s**//</todo> |
* <todo>Intégrer si nécessaire les nouveaux champs de GeoNature v2.6.0 aux formats (-- @jpmilcent 2021-02-21) :</todo> | * <todo>Intégrer si nécessaire les nouveaux champs de GeoNature v2.6.0 aux formats (-- @jpmilcent 2021-02-21) :</todo> |
* **code_dataset** [VARCHAR(255)] (//=T_releves_occtax.id_dataset//) : code alphanumérique permettant d'identifier le jeu de donnée de l'observation. Sert de lien avec la ressource DATASET et son champ "shortname". | * **code_dataset** [VARCHAR(255)] (//=T_releves_occtax.id_dataset//) : code alphanumérique permettant d'identifier le jeu de donnée de l'observation. Sert de lien avec la ressource DATASET et son champ "shortname". |
* code_digitiser [VARCHAR(50)] (//t_releves_occtax.id_digitiser//): UUID de l'utilisateur à l'origine de la saisie de l'observation. Sert de lien avec la ressource USER et son champ "unique_id". | * code_digitiser [VARCHAR(50)] (//t_releves_occtax.id_digitiser//): UUID de l'utilisateur à l'origine de la saisie de l'observation. Sert de lien avec la ressource USER et son champ "unique_id". |
* observers [VARCHAR(1000)] (//t_releves_occtax.observers_txt//] : Nom, prénom, email, organisme et UUID de la ou des personnes ayant réalisé l'observation. Voir le détail du format à plat des infos sur une personne. | * observers [VARCHAR(1000)] (//t_releves_occtax.observers_txt//] : Nom, prénom, email, organisme et UUID de la ou des personnes ayant réalisé l'observation. Voir [[database:correspondance-champs-sinp-geonature-synthese#format_a_plat_des_infos_sur_une_personne|le détail du format à plat des infos sur une personne]]. |
* **code_nomenclature_grp_typ** [VARCHAR(25)] (//=t_releves_occtax.id_nomenclature_grp_typ//) : code alphanumérique de la valeur du type de nomenclature TYP_GRP ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | TypeRegroupementValue|24|page90]]). | * **code_nomenclature_grp_typ** [VARCHAR(25)] (//=t_releves_occtax.id_nomenclature_grp_typ//) : code alphanumérique de la valeur du type de nomenclature TYP_GRP ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | TypeRegroupementValue|24|page90]]). |
* grp_method [VARCHAR(255)] (=t_releves_occtax.grp_method) : description de la méthode ayant présidé au regroupement, de façon aussi succincte que possible : champ libre. | * grp_method [VARCHAR(255)] (=t_releves_occtax.grp_method) : description de la méthode ayant présidé au regroupement, de façon aussi succincte que possible : champ libre. |
* **date_min** [DATE(YYYY-MM-DD HH:MM:SS)] (//=t_releves_occtax.date_min//) : date et heure du jour, dans le système local de l’observation dans le calendrier grégorien. En cas d’imprécision, cet attribut représente la date la plus ancienne de la période d’imprécision. La date doit être écrite suivant la norme ISO8601. L'heure est dans le fuseau horaire de la zone d'observation. Ce champ est obligatoire et ne peut pas contenir de valeur nulle. | * **date_min** [DATE(YYYY-MM-DD HH:MM:SS)] (//=t_releves_occtax.date_min//) : date et heure du jour, dans le système local de l’observation dans le calendrier grégorien. En cas d’imprécision, cet attribut représente la date la plus ancienne de la période d’imprécision. La date doit être écrite suivant la norme ISO8601. L'heure est dans le fuseau horaire de la zone d'observation et correspond à l'heure stocké dans le champ ''hour_min'' de la table ''t_releve_occtax''. Ce champ est obligatoire et ne peut pas contenir de valeur nulle. |
* **date_max** [DATE(YYYY-MM-DD HH:MM:SS)] (//=t_releves_occtax.date_max//) : date et heure du jour, dans le système local de l’observation dans le système grégorien. Lorsqu’une observation est faite sur un jour, les dates et heures de début et de fin sont les mêmes (cas le plus courant). La date doit être écrite suivant la norme ISO8601. L'heure est dans le fuseau horaire de la zone d'observation. Ce champ est obligatoire et ne peut pas contenir de valeur nulle. Ce champ doit contenir une date supérieur ou égale à celle du champ "date_min". | * **date_max** [DATE(YYYY-MM-DD HH:MM:SS)] (//=t_releves_occtax.date_max//) : date et heure du jour, dans le système local de l’observation dans le système grégorien. Lorsqu’une observation est faite sur un jour, les dates et heures de début et de fin sont les mêmes (cas le plus courant). La date doit être écrite suivant la norme ISO8601. L'heure est dans le fuseau horaire de la zone d'observation et correspond à l'heure stocké dans le champ ''hour_max'' de la table ''t_releve_occtax''. Ce champ est obligatoire et ne peut pas contenir de valeur nulle. Ce champ doit contenir une date supérieur ou égale à celle du champ "date_min". |
* cd_hab [INT(4)] (//=t_releves_occtax.cd_hab//) : code HABREF de l'habitat où le taxon de l'observation a été identifié. Il peut être trouvé dans la colonne "CD_HAB" d'HabRef. | * cd_hab [INT(4)] (//=t_releves_occtax.cd_hab//) : code HABREF de l'habitat où le taxon de l'observation a été identifié. Il peut être trouvé dans la colonne "CD_HAB" d'HabRef. |
* altitude_min [INT(4)] (//=t_releves_occtax.altitude_min//) : altitude minimum de l’observation en mètres. | * altitude_min [INT(4)] (//=t_releves_occtax.altitude_min//) : altitude minimum de l’observation en mètres. |
* code_nomenclature_geo_object_nature [VARCHAR(25)] (//=t_releves_occtax.id_nomenclature_geo_object_nature//) : code alphanumérique de la valeur du type de nomenclature NAT_OBJ_GEO ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 |NatureObjetGeoValue|3|page64]]). | * code_nomenclature_geo_object_nature [VARCHAR(25)] (//=t_releves_occtax.id_nomenclature_geo_object_nature//) : code alphanumérique de la valeur du type de nomenclature NAT_OBJ_GEO ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 |NatureObjetGeoValue|3|page64]]). |
* precision [INT(4)] (//=t_releves_occtax.precision//) : estimation en mètres d’une zone tampon autour de l'objet géographique. Cette précision peut inclure la précision du moyen technique d’acquisition des coordonnées (GPS,…) et/ou du protocole naturaliste. | * precision [INT(4)] (//=t_releves_occtax.precision//) : estimation en mètres d’une zone tampon autour de l'objet géographique. Cette précision peut inclure la précision du moyen technique d’acquisition des coordonnées (GPS,…) et/ou du protocole naturaliste. |
* **unique_id_occurence_occtax** : <color black/#fff200>UUID de l’occurrence s'il existe déjà dans les données sources.</color> | * **unique_id_occurence_occtax** [UUID] : <color black/#fff200>UUID de l’occurrence s'il existe déjà dans les données sources.</color> |
* **code_nomenclature_obs_technique** [VARCHAR(25)] (//=t_occurrences_occtax.id_nomenclature_obs_technique//) (//=t_releves_occtax.id_nomenclature_tech_collect_camp//) : code alphanumérique de la valeur du type de nomenclature METH_OBS ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | ObservationTechniqueValue|14|page69]]). __Attention__ : MethodeObservation devient techniqueObservation, renommé "Technique de collecte (Campanule)(2018). | * **code_nomenclature_tech_collect_campanule** [VARCHAR(25)] (//=t_releves_occtax.id_nomenclature_tech_collect_camp//) : code alphanumérique de la valeur du type de nomenclature METH_OBS ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | ObservationTechniqueValue|14|page69]]). __Attention__ : MethodeObservation devient techniqueObservation, renommé "Technique de collecte (Campanule)(2018). |
* **code_nomenclature_bio_condition** [VARCHAR(25)] (//=t_occurrences_occtax.id_nomenclature_bio_condition//) : code alphanumérique de la valeur du type de nomenclature ETA_BIO ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | OccurrenceEtatBiologiqueValue|7|page75]]). | * **code_nomenclature_bio_condition** [VARCHAR(25)] (//=t_occurrences_occtax.id_nomenclature_bio_condition//) : code alphanumérique de la valeur du type de nomenclature ETA_BIO ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | OccurrenceEtatBiologiqueValue|7|page75]]). |
* code_nomenclature_bio_status [VARCHAR(25)] (//=t_occurrences_occtax.id_nomenclature_bio_status//) : code alphanumérique de la valeur du type de nomenclature STATUT_BIO ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | OccurrenceStatutBiologiqueValue|13|page76]]). | * code_nomenclature_bio_status [VARCHAR(25)] (//=t_occurrences_occtax.id_nomenclature_bio_status//) : code alphanumérique de la valeur du type de nomenclature STATUT_BIO ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | OccurrenceStatutBiologiqueValue|13|page76]]). |
* non_digital_proof [TEXT] (//=t_occurrences_occtax.non_digital_proof//) : adresse ou nom de la personne ou de l'organisme qui permettrait de retrouver la preuve non numérique de l'observation. | * non_digital_proof [TEXT] (//=t_occurrences_occtax.non_digital_proof//) : adresse ou nom de la personne ou de l'organisme qui permettrait de retrouver la preuve non numérique de l'observation. |
* comment_description [TEXT] (//=t_occurrences_occtax.comment//) : description libre de l'observation, aussi succincte et précise que possible. Informations sur le(s) individu(s) observé(s) (=quoi). | * comment_description [TEXT] (//=t_occurrences_occtax.comment//) : description libre de l'observation, aussi succincte et précise que possible. Informations sur le(s) individu(s) observé(s) (=quoi). |
* unique_id_sinp_occtax : <color black/#fff200>UUID du dénombrement s'il existe déjà dans les données sources.</color> | * unique_id_sinp_occtax [UUID] : <color black/#fff200>UUID du dénombrement s'il existe déjà dans les données sources.</color> |
* **code_nomenclature_life_stage** [VARCHAR(25)] (//=cor_counting_occtax.id_nomenclature_life_stage//) : code alphanumérique de la valeur du type de nomenclature STADE_VIE ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | OccurrenceStadeDeVieValue|10|page78]]). | * **code_nomenclature_life_stage** [VARCHAR(25)] (//=cor_counting_occtax.id_nomenclature_life_stage//) : code alphanumérique de la valeur du type de nomenclature STADE_VIE ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | OccurrenceStadeDeVieValue|10|page78]]). |
* **code_nomenclature_sex** [VARCHAR(25)] (//=cor_counting_occtax.id_nomenclature_sex//) : code alphanumérique de la valeur du type de nomenclature SEXE ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | OccurrenceSexeValue|9|page78]]). | * **code_nomenclature_sex** [VARCHAR(25)] (//=cor_counting_occtax.id_nomenclature_sex//) : code alphanumérique de la valeur du type de nomenclature SEXE ([[https://inpn.mnhn.fr/docs-web/docs/download/221989 | OccurrenceSexeValue|9|page78]]). |
=== À faire === | === À faire === |
| |
* <todo>Faire le point sur l'ordre des champs</todo> | * <todo>Faire le point sur l'ordre des champs</todo> : voir si nous ordonnons les champs suivant l'ordre hiérarchiques des tables d'OccTax. |
* <todo>Faire le point sur les champs</todo> ''unique_id_...'' | * <todo>Faire le point sur les champs</todo> ''unique_id_...'' |
| * <todo>Renommer</todo> ''unique_id_occurence_occtax'' en ''unique_id_occurence'' ou plutôt ''unique_id_sinp'' si c'est bien la même chose |
* <todo>Renommer</todo> ''unique_id_sinp_occtax'' en ''unique_id_counting'' | * <todo>Renommer</todo> ''unique_id_sinp_occtax'' en ''unique_id_counting'' |
* <todo>Renommer</todo> ''unique_id_occurence_occtax'' en ''unique_id_occurence'' | |
* <todo>Voir si on garde ou pas le champ</todo> ''meta_device_entry'' (le garder si présent dans le standard ou important pour GN) | * <todo>Voir si on garde ou pas le champ</todo> ''meta_device_entry'' (le garder si présent dans le standard ou important pour GN) |
* <todo>Suite aux modifications précédentes tenir à jour les script SQL du dépôt sinp-shared-data</todo> | * <todo>Suite aux modifications précédentes tenir à jour les script SQL du dépôt sinp-shared-data</todo> |
| * <todo>Le champ additional_data est utilisé pou le champ additional_fields de t_releve_occtax</todo>. Il faudrait voir si cela convient ou s'il faut en gérer d'autres pour les autres champs ''additional_fields'' des autres tables d'OccTax. |
| |
===== Format META_ADDITIONAL_DATA d'import ===== | ===== Format META_ADDITIONAL_DATA d'import ===== |