Différences

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

--- database:import-formats:taxhub-medias-textes [2023/05/16 15:34] – [Format du fichier des métadonnées de l'archive "meta_archive.ini"] jpmilcent
+++ database:import-formats:taxhub-medias-textes [2023/05/31 07:22] (Version actuelle) – [Description du format MEDIA] jpmilcent
@@ Ligne 21: / Ligne 21: @@
 L'archive pour les données de type //media// devra contenir le fichiers suivant :
-  - **//media.csv//** : ficher contenant les informations sur les médias (images, pdf...) à lier aux taxons.
+  * **//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 :
-  - **//text.csv//** : fichier contenant les informations sur les textes à lier aux taxons et concernant un //attribut//.
+  * **//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 :
-  - //attribut.csv// : fichier contenant les informations des //attributs// d'un //thème//.
+  * //attribut.csv// : fichier contenant les informations des //attributs// d'un //thème//.
-  - //theme.csv// : fichier contenant les informations d'un //thème//.
+  * //theme.csv// : fichier contenant les informations d'un //thème//.
 ==== Format du fichier des métadonnées de l'archive "meta_archive.ini" ====
@@ Ligne 86: / Ligne 86: @@
   * les caractères **tabulation verticale** (Vertical tab, ASCII 11) sont à supprimer ou à remplacer par ''\v''
+===== Format MEDIA d'import =====
+  * But : Permet de transmettre les informations associé à un média (images, pdf...).\\
+  * Table GeoNature : "//taxonomie.t_medias//".\\
+==== Description du format MEDIA ====
+Pour chaque ligne : ''nom_du_champ [format du champ] (=//nom_champ_table_geonature//) : description du champ.''. Les champs **en gras** sont obligatoires.
+  * **cd_ref** [INT(4)] (=//cd_ref//) : correspond au champ "//cd_ref//" de TaxRef.
+  * **title** [VARCHAR(255)] (=//titre//) : titre court du média.
+  * **url** [VARCHAR(255)] (=//url//): URL qui servira à récupérer le document. Si les médias ne sont pas disponible en ligne, prendre contact avec le responsable des serveurs SINP régional pour déterminer l'URL de base qui les rendra accessible. Remplir alors ce champ en concaténant l'URL de base et le nom du fichier. Transmettre les fichiers médias à part.
+  * **author** [VARCHAR(1000)] (=//auteur//) : liste des auteurs du média. 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]].
+  * description [TEXT] (=//desc_media//): description détaillé du média.
+  * date [DATE(YYYY-MM-DD HH:MM:SS)] (=//date_media//) : date de création du média.
+  * source [VARCHAR(25)] (=//source//) : acronyme/abréviation de la source du média.
+  * licence [VARCHAR(100)] (=//licence//) : acronyme/abréviation standard de la licence du média. Privilégié [[https://creativecommons.org/licenses/?lang=fr-FR|les licences Creative Commons]].
+  * **meta_change_date** [DATE YYYY-MM-DD HH:MM:SS] : date et heure du dernier changement effectué sur l'enregistrement du media.
+  * **meta_last_action** [CHAR(1)] : permet d'identifier les lignes ajoutées depuis le dernier import ("//I//"), modifiées ("//U//") ou supprimées ("//D//").
+=== Notes ===
+Au 2023-05-16 l'intégration des données se base sur le champ **url** pour réaliser un UPSERT (ajout/modification) des enregistrements transmis. Il n'y a donc pas de possibilité de supprimer les médias précédemment ajouté. À l'avenir, nous nous baserons surement sur les champs **meta_change_date** et **meta_last_action** pour réaliser les suppressions.
+==== Description du format THEME ====
+Pour chaque ligne : ''nom_du_champ [format du champ] (=//nom_champ_table_geonature//) : description du champ.''. Les champs **en gras** sont obligatoires.
+  * **code** [VARCHAR(20)] (=//nom_theme//) : code du thème des attributs des textes. Privilégié un seul mot en minuscule.
+  * **description** [VARCHAR(255)] (=//desc_theme//) : description du cadre d'utilisation de ce thème.
+  * **meta_change_date** [DATE YYYY-MM-DD HH:MM:SS] : date et heure du dernier changement effectué sur l'enregistrement.
+  * **meta_last_action** [CHAR(1)] : permet d'identifier les lignes ajoutées depuis le dernier import ("//I//"), modifiées ("//U//") ou supprimées ("//D//").
+=== Notes ===
+Au 2023-05-16 l'intégration des données se base sur le champ **url** pour réaliser un UPSERT (ajout/modification) des enregistrements transmis. Il n'y a donc pas de possibilité de supprimer les médias précédemment ajouté. À l'avenir, nous nous baserons surement sur les champs **meta_change_date** et **meta_last_action** pour réaliser les suppressions.
+==== Description du format ATTRIBUT ====
+Pour chaque ligne : ''nom_du_champ [format du champ] (=//nom_champ_table_geonature//) : description du champ.''. Les champs **en gras** sont obligatoires.
+  * **code** [VARCHAR(255)] (=//nom_attribut//) : code de l'attributs des textes. Privilégié un seul mot en minuscule.
+  * **label** [VARCHAR(50)] (=//label_attribut//) : intitulé de l'attribut (en français) qui sera affiché sur les interfaces.
+  * description [TEXT] (=//desc_attribut//) : description détaillée de l'attribut.
+  * widget [TEXT] (=//type_widget//) : type de widget à utiliser dans l'interface parmi : //textarea//, //select//, //multiselect//.
+  * type [TEXT] (=//type_attribut//) : type de l'attribut parmi : //text//.
+  * values [TEXT] (=//liste_valeur_attribut//) : liste de valeurs possibles pour les widgets de type //select// et //multiselect//. Les valeurs doivent être séparés par des virgules.
+  * mandatory [BOOL] (=//obligatoire//) : indique si cette attribut doit être obligatoirement rempli ou pas dans les interfaces.
+  * theme_code [TEXT] (=//id_theme//) : code du thème de cette attribut. Sert de lien avec la ressource THEME et son champ "//code//".
+  * order [INT(4)] (=//ordre//) : ordre d'affichage des attributs dans le thème.
+  * **meta_change_date** [DATE YYYY-MM-DD HH:MM:SS] : date et heure du dernier changement effectué sur l'enregistrement.
+  * **meta_last_action** [CHAR(1)] : permet d'identifier les lignes ajoutées depuis le dernier import ("//I//"), modifiées ("//U//") ou supprimées ("//D//").
+=== Notes ===
+Au 2023-05-16 l'intégration des données se base sur le champ **url** pour réaliser un UPSERT (ajout/modification) des enregistrements transmis. Il n'y a donc pas de possibilité de supprimer les médias précédemment ajouté. À l'avenir, nous nous baserons surement sur les champs **meta_change_date** et **meta_last_action** pour réaliser les suppressions.
+==== Description du format TEXT ====
+Pour chaque ligne : ''nom_du_champ [format du champ] (=//nom_champ_table_geonature//) : description du champ.''. Les champs **en gras** sont obligatoires.
+  * **cd_ref** [INT(4)] (=//cd_ref//) : code du taxon dans TaxRef.
+  * **code_attribut** [INT(4)] (=//code_attribut//) : code de l'attribut correspondant au texte. Sert de lien avec la ressource ATTRIBUT et son champ "//code//".
+  * **value** [TEXT] (=//valeur_attribut//) : texte de l'attribut.
+  * **meta_change_date** [DATE YYYY-MM-DD HH:MM:SS] : date et heure du dernier changement effectué sur l'enregistrement.
+  * **meta_last_action** [CHAR(1)] : permet d'identifier les lignes ajoutées depuis le dernier import ("//I//"), modifiées ("//U//") ou supprimées ("//D//").
+=== Notes ===
+Au 2023-05-16 l'intégration des données se base sur les champ **cd_ref** et **code_attribut** pour réaliser un UPSERT (ajout/modification) des enregistrements transmis. Il n'y a donc pas de possibilité de supprimer les médias précédemment ajouté. À l'avenir, nous nous baserons surement sur les champs **meta_change_date** et **meta_last_action** pour réaliser les suppressions.