SAINET apis and documentation (stable/4.8.x)

Configuration et export de données

Principe

La tâche d’export SYSXE permet d’exporter les données en suivant une configuration XML spécifiant quelles tables doivent être exportées, quelles données dans ces tables ainsi que quels liens doivent être suivis par le programme d’export afin de constituer une archive cohérente contenant toutes les données nécessaires à la compréhension et à l’import.

Configuration de l’export

Un fichier de configuration au format XML permet de spécifier la ou les tables de base ainsi que les liens.

<dump>
  <!-- Il est possible de limiter l'export des données à une seule société.
        Par défaut, toutes les sociétés sont exportées
  -->
  <domains>ALL</domains>

  <!-- La table ADRDOS contient les dossiers de bénéficiaires présentés
        dans les tâches ADR02, ADRV2, ...
       Nous allons exporter tous les dossiers de test ainsi que les données
        liées telles que l'adresse ADR7A, les événements GTP40 et les entrées
        des combos dynamiques UNI17 qui sont rattachés à ce bénéficiaire.
   -->
  <table id="ADRDOS">
    <!-- Seuls les dossiers dont l'identifiant commence par 'DT-' doivent
          être exportés. Nous filtrons donc l'export de la table ADRDOS.
    -->
    <filter datafield="ADRDOS.ID_PK">DT-*</filter>

    <!-- Export des données liées, en premier les entrées ADR7A. Le lien
          entre le dossier ADR02 et l'adresse ADR7A est précisé dans le
          champ "ADRADRF01" du bénéficiaire.
    -->
    <table id="ADRADR">
      <filter datafield="ADRADR.ID_PK" use="ADRDOS.ADRADRFK01" />
    </table>

    <!-- Export des données liées, ici les événements GTP40. Le lien
          entre l'événement GTP40 et le dossier ADR02 est précisé dans
          le champ "STATECLIENT" de l'événement. Plusieurs événements
          seront exportés
    -->
    <table id="GTPEVT">
      <filter datafield="GTPEVT.STATECLIENT" use="ADRDOS.ID_PK" />
    </table>

    <!-- Export des données liées, ici les combos dynamiques UNI17. Le lien
          entre la combo et le dossier ADR02 est précisé dans le champ
          "PROP1" de la combo. De plus, nous voulons n'exporter que les
          entrées qui sont des pivots dynamiques, par d'éventuelles autres
          entrées.
    -->
    <table id="UNIENU">
      <filter datafield="UNIENU.PROP1" use="ADRDOS.ID_PK" />
      <filter datafield="UNIENU.COMBOID">ADR40_PIVOTDYNAMIQUE</filter>
    </table>

  </table>

  <!-- La table ADRFIR contient les entreprises qui sont présentées dans
        les tâches ADR05, ADRV5, ...
       Comme pour la table ADRDOS, nous allons exporter les données des
        entreprises dont l'identifiant commence par DT- ainsi que les
        adresses qui leur sont liées.
  -->
  <table id="ADRFIR">
    <!-- Seuls les dossiers dont l'identifiant commence par 'DT-' doivent
          être exportés. Nous filtrons donc l'export de la table ADRFIR.
         Afin d'illustrer les différentes manières de filtrer, nous allons
          cette fois lister tous les dossiers, séparés par des virgules.
    -->
    <filter datafield="ADRFIR.ID_PK">DT-00000, DT-00001, DT-00002, DT-00003, DT-00004, DT-00005, DT-00006, DT-00007, DT-00008, DT-00009,
      DT-00010, DT-00011, DT-00012, DT-00013, DT-00014, DT-00015, DT-00016, DT-00017, DT-00018, DT-00019</filter>

    <!-- Export des données liées, en premier les adresses ADR07. Le lien
          entre le dossier ADR05 et l'adresse ADR07 est précisé dans la
          page "ADRTIERS", dans le champ "LIENFIRME" qui lie l'adresse
          à une entreprise.
    -->
    <table id="ADRADR">
      <filter datafield="ADRADR.ADRTIERS.LIENFIRME" use="ADRFIR.ID_PK" />
      <filter datafield="ADRADR.TSKSRC">ADR07</filter>
    </table>
  </table>
</dump>

Utilisation générale d’une tâche d’export

Basé sur la configuration montrée ci-dessus, il est possible d’exporter les données de plusieurs bénéficiaires et entreprises.

Voici l’écran du SYSXE

Export

  1. Le seul input nécessaire afin de pouvoir lancer l’export est la sélection d’un fichier de configuration.

  2. Une fois le fichier sélectionné et la tâche lancée, le fichier est envoyé sur le serveur, lu par le système et les tables sont exportées en suivant les instructions du fichier de configuration. La progression est affichée table par table.

Lignes

  1. Un rapport succint est affiché afin de présenter la liste des tables ainsi que le nombre d’entrées exportées sur chacune d’entre-elles.

  2. Le système demande ensuite à l’utilisateur où il désire stocker les fichiers résultants de l’export

  • L’ajout en GED permet également de stocker cet export dans la GED ce qui permettra ensuite de retrouver l’export effectué sans devoir le refaire ce qui garanti que les données seront toujours les mêmes.
  1. Une fois l’emplacement des fichiers choisis, le client télécharge l’archive d’export et l’extrait. Il est alors possible soit d’archiver ces dossiers sur un support externe, modifier les données à l’aide d’un éditeur CSV ou de recréer une archive afin d’importer les données sur un autre serveur.