database:import-formats

Différences

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

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
database:import-formats [2026/06/17 08:26] – [Format des fichiers d'import] jpmilcentdatabase:import-formats [2026/08/21 07:08] (Version actuelle) – [Principe de la procédure de mise à jour] jpmilcent
Ligne 67: Ligne 67:
     * les actions suivantes //parser// le fichier CSV, //copier// le CSV préparé dans la base, //insérer// les lignes dont //meta_last_action// vaut "I" et //mettre à jour// les lignes dont //meta_last_action// vaut "U" sur les entités dans l'ordre suivant : ''source'', ''organism'', ''user'', ''acquistion_framework'', ''dataset'', ''synthese''.     * les actions suivantes //parser// le fichier CSV, //copier// le CSV préparé dans la base, //insérer// les lignes dont //meta_last_action// vaut "I" et //mettre à jour// les lignes dont //meta_last_action// vaut "U" sur les entités dans l'ordre suivant : ''source'', ''organism'', ''user'', ''acquistion_framework'', ''dataset'', ''synthese''.
     * enfin, il est possible de //supprimer// les lignes dont //meta_last_action// vaut "D" sur les entités dans l'ordre suivant : ''synthese'', ''dataset'', ''acquistion_framework'', ''user'', ''organism'', ''source''.     * enfin, il est possible de //supprimer// les lignes dont //meta_last_action// vaut "D" sur les entités dans l'ordre suivant : ''synthese'', ''dataset'', ''acquistion_framework'', ''user'', ''organism'', ''source''.
 +
 +=== Gestion du différentiel dans la base des locale d'un administrateur de données ===
 +
 +Il faut gérer un différentiel par rapport à la date du dernier export vers le SINP. 
 +
 +Seules les données ajoutées, modifiées ou supprimées depuis le dernier export doivent être transmises.
 +
 +Pour les données ajoutées :
 +  * ''meta_last_acton'' doit prendre la valeur "''I''"
 +  * ''meta_create_date'' doit indiquer la date et heure de création de l'enregistrement.
 +
 +Pour les données modifiées (1 ou plusieurs fois) :
 +  * ''meta_last_action'' doit prendre la valeur "''U''"
 +  * ''meta_update_date'' doit indiquer la date et heure de **la dernière** modification depuis l'export précédent
 +
 +Pour les données supprimées :
 +  * ''meta_last_action'' doit prendre la valeur "''D''".
 + 
 +Cas particuliers :
 +  * une donnée ajoutée (et éventuellement modifiée), puis supprimée depuis le dernier export n'est pas à transmettre ; 
 +  * une donnée ajoutée puis modifiée doit être transmise avec ''meta_last_action''  = "''I''" (ajout) et non "''U''" (mise à jour).
  
 ==== Format du fichier des métadonnées de l'archive "meta_archive.ini" ==== ==== Format du fichier des métadonnées de l'archive "meta_archive.ini" ====
Ligne 118: Ligne 139:
   * si nécessaire utiliser **deux guillemets** successifs ("") pour échapper le caractère guillemet dans une valeur de champ préfixé et suffixé par des guillemets.   * si nécessaire utiliser **deux guillemets** successifs ("") pour échapper le caractère guillemet dans une valeur de champ préfixé et suffixé par des guillemets.
   * respecter l'ordre des champs décrits dans cette documentation   * respecter l'ordre des champs décrits dans cette documentation
-  * si possible fournir les fichiers avec l'ensemble des champs décrits même avec s'ils doivent contenir des valeurs nulles+  * si possible fournir les fichiers avec l'ensemble des champs décrits même s'ils doivent contenir des valeurs nulles
    
 Il faut vous assurer d'avoir supprimé, remplacé ou protégé les caractères suivant dans les valeurs des champs : Il faut vous assurer d'avoir supprimé, remplacé ou protégé les caractères suivant dans les valeurs des champs :
Ligne 167: Ligne 188:
  
 ==== Évolutions ==== ==== Évolutions ====
 +  * 2026-06-17 :
 +    * Ajout des statuts des différents fichiers.
 +    * Ajout de complément sur le format des fichiers CSV attendus.
 +    * Mise à jour des textes introductifs. 
   * 2026-04-02 :   * 2026-04-02 :
     * Utilisation de ''VARCHAR(50)'' pour tous les champs ''code_nomenclature_...'' de SYNTHESE.     * Utilisation de ''VARCHAR(50)'' pour tous les champs ''code_nomenclature_...'' de SYNTHESE.
 +  * 2026-03-13 :
 +    * Ajout du format VALIDATION. Nécessaire pour intégrer un historique des validations à la Synthese ou dans le cadre de l'utilisation du format OCCTAX.
   * 2025-04-30 :   * 2025-04-30 :
-    * Ajout du format OccTax supporté pour les ajouts uniquement. Non nécessaire pour l'instant dans le cadre des SINP.+    * Ajout du format OCCTAX supporté pour les ajouts uniquement. Non nécessaire pour l'instant dans le cadre des SINP.
   * 2024-10-23 :   * 2024-10-23 :
     * Nous privilégions maintenant l'utilisation des UUID comme identifiant de lien entre les ressources à la place des codes ou noms.     * Nous privilégions maintenant l'utilisation des UUID comme identifiant de lien entre les ressources à la place des codes ou noms.
  • database/import-formats.1781684784.txt.gz
  • Dernière modification : 2026/06/17 08:26
  • de jpmilcent