Aller au contenu
For the complete DHIS2 documentation index, see llms.txt.
Guides de l'utilisateur
Échange de données

Application Import/Export

In a primary health system, the HMIS typically involves a distributed application, where the same application is running in different geographical locations (PHCs,CHCs, hospitals, districts, and state). Many of these physical locations do not have Internet connectivity, and hence they work off-line. At some point (normally at the district level), the data needs to be synchronised in order to have a consolidated database for the a particular geographical region. For this, it is important to be able to export data from one location (which is working offline, say at the health facility level) and import into another one (say at the district level). This feature of exporting and importing is thus a crucial function of a HMIS. This feature also helps us overcome the dependency on the Internet to some degree, as data updates can be transferred via USB key where there is no connectivity, or through email where there is limited Internet connectivity. DHIS2 provides robust export-import functionality to fulfil these needs.

Pour accéder à l'application Import/Export, cherchez Import/Export dans la barre d'en-tête supérieure. L'application Import/Export offre un certain nombre de services dont les détails sont présentés ci-dessous.

Importation de données

Enregistreur de la progression des importations

No matter what you import ("Data", "Events", "Org unit geometry", "Metadata" or "Tracked Entity Instances" data), you can always view the progress of the import by looking at the "Job Summary" at the top of the page.

Résumés des importations

Au moment de remplir la demande d'importation, nous affichons les résumés d'importation au-dessus du formulaire d'importation. Les éventuelles incompatibilités ou erreurs sont indiquées dans le tableau sous le résumé principal de l'importation.

Importation de métadonnées

L'importation de métadonnées est accessible à partir de la barre latérale en cliquant sur Importation de métadonnées.

  1. Choisissez un fichier à télécharger

  2. Sélectionnez un format : JSON , CSV ou XML

  3. Sélectionnez les paramètres appropriés pour :

    • Identificateur
    • Mode rapport d'importation
    • Mode d'économie d'énergie
    • Stratégie d'importation
    • Mode atomique
    • Mode Fusion

  4. Cliquez sur Options avancées si vous souhaitez ajuster un ou plusieurs des paramètres suivants avant l'importation :

    • Mode Flush
    • Ignorer le partage
    • Ignorer la validation
    • Async
    • Stratégie inclusive

  5. Cliquez sur le bouton Importer pour télécharger le fichier et lancer le processus d'importation.

Conseil

Il est fortement recommandé d'utiliser l'option "Dry run " pour tester avant d'importer des données, pour s'assurer que vous gardez le contrôle sur toute modification de vos métadonnées, et pour vérifier les problèmes d'éléments de données ou de noms d'unités d'organisation désynchronisés

N.B.

Si une unité d'organisation, par exemple Nduvuibu MCHP, avait une référence inconnue à un objet dont l'ID est aaaU6Kr7Gtpidn, cela signifie que l'objet avec ID aaaU6Kr7Gtpidn n'était pas présent dans votre fichier importé, et qu'il n'a pas été trouvé dans la base de données existante.

Vous pouvez contrôler cela en utilisant l'option Identificateur pour indiquer si vous souhaitez autoriser ou non l'importation d'objets ayant de telles références non valables. Si vous choisissez d'importer des références non valides, vous devrez alors corriger la référence manuellement dans le DHIS2 ultérieurement.

Correspondance des identificateurs dans DXF2

Le format DXF2 prend actuellement en charge la correspondance de deux identificateurs, l'identificateur interne de DHIS2 (connu sous le nom d'UID), et utilisant également un identificateur externe appelé "code". Lorsque l'importateur essaie de rechercher des références (comme celle ci-dessus), il passe d'abord au champ UID, puis au champ code. Cela vous permet d'importer à partir de systèmes existants sans disposer d'un UID pour chaque objet de méta-données. Par exemple, si vous importez des données d'établissement à partir d'un système existant, vous pouvez laisser le champ ID complètement vide (DHIS2 le remplira pour vous) et mettre les identificateurs propres au système existant dans le champ de code ; cet identifiant doit être unique. Cela fonctionne non seulement pour les unités d'organisation, mais aussi pour toutes sortes de métadonnées, ce qui permet d'importer facilement des données à partir d'autres systèmes.

Importation de données

L'importation de données est accessible à partir de la barre latérale en cliquant sur Importation de données.

  1. Choisissez un fichier à télécharger

  2. Sélectionnez un format : JSON, CSV, XML, ADX ou PDF

  3. Sélectionnez les paramètres appropriés pour :

    • Stratégie
    • Préchauffer le cache

  4. Cliquez sur Options avancées si vous souhaitez ajuster un ou plusieurs des paramètres suivants avant l'importation :

    • Schéma d'identification d'un élément de données
    • Schéma d'identification d'une unité d'organisation
    • Schéma d'identification
    • Ignorer un contrôle existant

  5. Cliquez sur le bouton Importer pour télécharger le fichier et lancer le processus d'importation.

Conseil

Il est fortement recommandé d'utiliser l'option Test à blanc pour tester avant d'importer des données, afin de s'assurer que vous gardez le contrôle sur toute modification de vos métadonnées, et pour vérifier les problèmes d'éléments de données ou de noms d'unités d'organisation désynchronisés

Données PDF

Le DHIS2 prend en charge l'importation de données au format PDF. On peut l'utiliser pour importer des données obtenues à partir des formulaires de saisie de données PDF hors ligne. Veuillez vous référer à la section Gestion des ensembles de données pour savoir comment produire un formulaire PDF pouvant être utilisé pour la saisie de données hors ligne.

Pour importer un fichier de données PDF, naviguez jusqu'à l'élément Importation de données PDF dans le menu latéral. Téléchargez le fichier PDF complété et cliquez sur Importer.

Importation d'événements

L'importation d'événements est accessible à partir de la barre latérale en cliquant sur Importation d'événements.

  1. Sélectionnez un format : JSON , CSV ou XML

  2. Cliquez sur Options avancées si vous souhaitez ajuster un ou plusieurs des paramètres suivants avant l'importation :

    • Schéma d'identification des événements
    • Schéma d'identification d'un élément de données
    • Schéma d'identification d'une unité d'organisation
    • Schéma d'identification

  3. Cliquez sur le bouton Importer pour télécharger le fichier et lancer le processus d'importation.

Importation depuis Earth Engine

L'Importation de données depuis Earth Engine est accessible à partir de la barre latérale en cliquant sur Importation depuis Earth Engine.

Importez des données démographiques de haute résolution depuis WorldPop à l'aide de Google Earth Engine. Un compte Google Earth Engine est nécessaire pour utiliser cet importateur.

Sélectionnez les données de Earth Engine à importer

La première section du formulaire sert à configurer les données de Earth Engine à importer.

  1. Sélectionnez les données de Earth Engine à importer. Actuellement, les choix portent sur Population et Groupes d'âge de la population.

  2. Après la sélection d'un ensemble de données, une période doit être sélectionnée. Une seule période peut être importée à la fois.

  3. Choisissez la manière dont les données doivent être arrondies. Par défaut, les données ne sont pas arrondies.

  4. Sélectionnez les unités d'organisation vers lesquelles les données seront importées. Si vous sélectionnez des unités d'organisation niveau établissement, vous devez choisir une géométrie associée à l'établissement. Sans géométrie associée à l'établissement, Earth Engine ne peut pas déterminer la population.

Sélectionnez les éléments de données vers lesquels les données de Earth Engine doivent être importées

Après avoir configuré l'ensemble de données de Earth Engine, vous devez sélectionner l'élément de données vers lequel les données doivent être importées. Pour les ensembles de données scindés en sous-groupes, tels que "Groupes d'âge de la population", l'élément de données DHIS2 doit avoir des sous-éléments sous la forme de combinaisons d'options de catégorie, lesquelles correspondent aux sous-groupes de l'ensemble de données de Earth Engine.

Configuration des éléments de données pour l'importation depuis Earth Engine

Lors de la configuration des éléments de données DHIS2 qui vont contenir des données de Earth Engine, si vous prévoyez d'importer des données vers plusieurs niveaux d'unité organisationnelle, assurez-vous que ces niveaux soient ajoutés en tant que niveaux d'agrégation dans la configuration des éléments de données.

Lorsque certains ensembles de données de Earth Engine contiennent des sous-groupes, l'élément de données DHIS2 doit être configuré avec les combinaisons d'options de catégorie correspondantes. Par exemple, l'ensemble de données « Groupes d'âge de la population » est divisé en sous-groupes de genre (homme, femme) et d'âge (par intervalle de 5 ans).

Sur l'interface DHIS2, cela signifie que vous devez avoir une catégorie Homme/Femme et une catégorie de tranche d'âge de 5 ans (<1an, 1-4ans, 5-9ans, 10-14ans... 80+yans). Ces catégories permettent de former des combinaisons.

Conseil de professionnel : pour faire correspondre automatiquement la combinaison d'options de catégorie au sous-groupe de Earth Engine, ajoutez un code à chaque combinaison qui correspond au nom du groupe de Earth Engine. Par exemple, avec « Groupes d'âge de la population », les groupes sont nommés : F_0, F_1, F_5..., M_0, M_1, M_5...

Exécutez l'importation{ #run-the-import }

Après la sélection des combinaisons d'éléments de données et des options de catégorie, le bouton Aperçu s'active. Après avoir examiné les données que vous souhaitez importer, vous pouvez d'abord effectuer un essai ou procéder à l'importation proprement dite.

Importation de Géométrie d'Unité d'Organisation

Accessible depuis la barre latérale en cliquant sur Importation de la Géométrie de l'Unité d'Organisation. Deux formats de géométrie sont pris en charge : GeoJSON et GML. GeoJSON est le format recommandé et peut également être utilisé pour importer des géométries associées (zones désservie).

Importation GeoJSON

  1. Téléchargez un fichier en utilisant le format GeoJSON.

  2. Par défaut, l'identifiant de la fonctionnalité GeoJSON doit correspondre à celui de l'unité d'organisation.

  3. Cochez Correspondance de la propriété GeoJSON avec le schéma de l'unité d'organisation pour établir une correspondance avec une caractéristique appropriée. Saisissez le nom de la propriété GeoJSON et sélectionnez le schéma d'identification de l'unité d'organisation (Id, Code ou Nom).

  4. Cochez Importer en tant que géométrie associée pour importer les entités GeoJSON en tant que géométries associées aux unités d'organisation (par exemple les zones desservies). Sélectionnez l'attribut géométrique où les données doivent être importées. Cela nécessite un attribut de type GeoJSON appliqué à l' Unité d'organisation. Cet attribut peut être défini dans l'application Maintenance.

  5. Cliquez sur le bouton démarrer l'importer pour télécharger le fichier et lancer le processus d'importation.

Conseil

Il est fortement recommandé d'utiliser l'option Test à blanc pour tester avant d'importer des données, afin de s'assurer que vous gardez le contrôle de toute modification de vos géométries d'unités d'organisation.

Importation GML

  1. Téléchargez un fichier en utilisant le format GML (Langage de balisage géographique).

  2. Cliquez sur le bouton Importer pour télécharger le fichier et lancer le processus d'importation.

Importation d'instances d'entités suivies

Tracked Entity Instances Import can be accessed from the sidebar by clicking on TEI Import.

  1. Choisissez un fichier à télécharger

  2. Sélectionnez un format : JSON ou XML

  3. Sélectionnez les paramètres appropriés pour :

    • Identificateur
    • Mode rapport d'importation
    • Mode d'économie d'énergie
    • Stratégie d'importation
    • Mode atomique
    • Mode Fusion

  4. Cliquez sur Options avancées si vous souhaitez ajuster un ou plusieurs des paramètres suivants avant l'importation :

    • Mode Flush
    • Ignorer le partage
    • Ignorer la validation
    • Stratégie inclusive

  5. Cliquez sur le bouton Importer pour télécharger le fichier et lancer le processus d'importation.

Tip

It is highly recommend to use the Dry run option to test before importing data; to make sure you keep control over any changes to your Tracked Entity Instances.

Exportation de données

Exportation de métadonnées

L'exportation de métadonnées est accessible à partir de la barre latérale en cliquant sur Exportation de métadonnées.

  1. Choisissez la liste des objets que vous souhaitez exporter.

  2. Sélectionnez un format: *JSON *

  3. Choisissez un type de compression: Zip , gzip ou non compressé.

  4. Vous êtes libre de cocher Ignorer les paramètres de partage et d'accès ou non.

  5. Cliquez sur Exporter les métadonnées, ce qui ouvrira une nouvelle fenêtre de navigateur web qui vous présentera un fichier à télécharger sur votre ordinateur local.

Exportation de métadonnées avec des dépendances

L'exportation de métadonnées avec dépendances vous permet de créer des exportations ordinaires pour les objets de métadonnées. Ce type d'exportation comprendra les objets de métadonnées et les objets liés à l'objet de métadonnées, c'est-à-dire les métadonnées appartiennant à l'objet principal.

Tableau : Types d'objets et leurs dépendances

Type d'objet Dépendances incluses dans l'exportation
Ensembles de données Eléments de données

Sections

Indicateurs

Types d'Indicator

Attributs

Formulaires de saisie

Ensemble de données

Légendes

Combinaisons de catégories

Catégorie

Options de catégorie

Combinations d'options de catégorie

Ensemble d'options
Programmes Formulaire de saisie

Entité suivie

Etapes de programme

Attributs de programme

Indicateurs de programme

Règles de programme

Actions de la règle de programme

Variables de la règle de programme

Attributs du programme

Eléments de données

Combinaison de catégories

Catégories

Options de catégorie

Combinaisons d'options de catégorie

Ensemble d'options
La combinaison de catégories < Catégories\
Options de catégorie\
\
Combinaisons d'options de catégorie\
\
Attributs>>
Tableau de bord \
Graphiques \
Graphiques d'évènements \
\
Tableau croisé dynamique \
\
Rapports d'évènements \
\
Cartes\
\
Rapports\
\
Ressources>
Groupes d'éléments de données Eléments de données

Combinaisons de catégories

Catégories

Options de catégories

Combinaisons d'options de catégorie

Ensemble d'options

Attributs

Ensemble de légendes

Légendes
Ensemble d'options Option

  1. Sélectionnez un type d'objet : Ensembles de données, Programmes, Combinaison de catégories, Tableau de bord, Groupes d'éléments de données ou Ensembles d'options.

  2. Sélectionnez un objet.

  3. Sélectionnez un format: *JSON *

  4. Choisissez un type de compression: Zip , GZip ou non compressé.

  5. Cliquez sur Exporter les dépendances des métadonnées, ce qui ouvrira une nouvelle fenêtre de navigateur web qui vous présentera un fichier à télécharger sur votre ordinateur local.

Exportation de données

L'exportation de données est accessible à partir de la barre latérale en cliquant sur Exportation de données.

  1. Sélectionnez les unités d'organisation à partir desquelles les données seront exportés.

  2. Indiquez si l'exportation doit inclure les descendants des unités d'organisation sélectionnées à l'étape 1 ou uniquement les unités d'organisation sélectionnées manuellement.

  3. Sélectionnez les ensembles de données qui seront exportés.

  4. Définissez les dates de début et de fin

  5. Sélectionnez un format : JSON, CSV, XML, ADX

  6. Sélectionnez un mode de compression : Zip , GZip ou Non compressé.

  7. Cliquez sur Options avancées si vous souhaitez ajuster un ou plusieurs des paramètres suivants avant l'exportation :

    • Inclure les éléments supprimés
    • Schéma d'identification d'un élément de données
    • Schéma d'identification d'une unité d'organisation
    • Schéma d'identification

  8. Cliquez sur Exporter les données, ce qui ouvrira une nouvelle fenêtre de navigateur web qui vous présentera un fichier à télécharger sur votre ordinateur local.

Exportation d'événements

L'exportation d'événements est accessible à partir de la barre latérale en cliquant sur Exportation d'événements.

Vous pouvez exporter des données d'événement ou de suivi en utilisant les formats JSON, CSV ou XML.

  1. Sélectionnez une unité d'organisation.

  2. Sélectionnez l'inclusion :

    • Sélectionnée : Exporter les données de l'événement uniquement pour l'unité sélectionnez une unité d'organisation.

    • Directement en dessous : Exporter les données de l'événement, ce qui comprend le premier niveau des unités d'organisation à l'intérieur des sélections, ainsi que l'unité d'organisation sélectionnée elle-même.

    • Tous en dessous : Exporter les données d'événements pour toutes les unités d'organisation à l'intérieur des sélections ainsi que pour l'unité d'organisation sélectionnée elle-même.

  3. Sélectionnez un programme et une étape du programme (le cas échéant).

  4. Définissez les dates de début et de fin

  5. Sélectionnez un format : JSON , CSV ou XML

  6. Choisissez un mode de compression: Zip , GZip ou non compressé.

  7. Cliquez sur Options avancées si vous souhaitez ajuster un ou plusieurs des paramètres suivants avant l'exportation :

    • Inclure les éléments supprimés
    • Schéma d'identification d'un élément de données
    • Schéma d'identification d'une unité d'organisation
    • Schéma d'identification

  8. Cliquez sur Exporter les événements, ce qui ouvrira une nouvelle fenêtre de navigateur web qui vous présentera un fichier à télécharger sur votre ordinateur local.

Exportation d'instances d'entités suivies

Tracked entity instances export can be accessed from the sidebar by clicking on TEI export.

Vous pouvez exporter des données d'événement ou de suivi en utilisant les formats JSON, CSV ou XML.

  1. Sélectionnez les unités d'organisation à inclure.

  2. Choisissez si vous voulez filtrer par programme ou type d'entité suivie.

  3. Sélectionnez un format : JSON , CSV ou XML

  4. Cliquez sur Options avancées si vous souhaitez ajuster un ou plusieurs des paramètres suivants avant l'exportation :

    • Filtrer par date de dernière mise à jour
    • Mode d'utilisateur assigné
    • Inclure les éléments supprimés
    • Inclure tous les attributs
    • Schéma d'identification d'un élément de données
    • Schéma d'identification des événements
    • Schéma d'identification d'une unité d'organisation
    • Schéma d'identification

  5. Click Export tracked entity instances which will open a new fenêtre de navigateur web qui vous présentera un fichier à télécharger sur votre ordinateur local.

Aperçu des tâches

La page d'aperçu des tâches peut être consultée dans la barre latérale en cliquant sur Aperçu des tâches.

Cette page vous permet de vérifier l'état d'avancement de toutes les importations que vous avez lancées au cours de cette session. Vous pouvez voir la liste de toutes les tâches sur le côté gauche et des détails relatifs à une tâche spécifique sélectionnée sur le côté droit.

Filtrage par type de tâche d'importation

Par défaut, les tâches de tous les types d'importation sont affichées dans la liste des tâches, mais vous pouvez filtrer les catégories qui vous intéressent en cliquant sur les filtres des types de tâches au-dessus de la liste des tâches.

Recréer une ancienne tâche

Vous pouvez recréer les tâches d'importation précédemment exécutées en cliquant sur le bouton Recréer une tâche situé au bas de la page, à condition que vous ayez sélectionné une tâche dans la liste. Cela vous amènera à la page d'importation appropriée et vous permettra de remplir tous les détails du formulaire conformément à la tâche que vous avez choisie de recréer.

Schémas

Les différents schémas utilisés dans de nombreuses pages d'importation et d'exportation sont également connus sous le nom de schémas d'identification et sont utilisés pour relier les objets de métadonnées à d'autres métadonnées lors de l'importation, et pour restituer les métadonnées dans le cadre du processus d'exportation.

Tableau : Valeurs disponibles

Schéma Description
ID, UID Correspondre avec l'identifiant permanent DHIS2. il s'agit du schéma d'identification par défaut.
CODE Correspondre avec le code DHIS2, principalement utilisé pour échanger des données avec un système externe.
NOM Correspondre avec le nom DHIS2. Veuillez noter que c'est l'élément disponible en tant que nom.de l'objet qui est utilisé, et non le nom traduit. Notez également que les noms ne sont pas toujours uniques. Lorsque des noms sont déjà utilisés, ils ne peuvent plus l'être.
ATTRIBUT:ID Correspondre avec l'attribut de métadonnées. Cet attribut doit être assigné au type sur lequel vous faites correspondre, d'autant plus que la propriété unique est définie sur vrai. Cette fonctionnalité permet principalement d'échanger des données avec des systèmes externes. Il présente certains avantages par rapport à CODE puisque plusieurs attributs peuvent être ajoutés. Il peut donc se synchroniser avec plus d'un système.

Schéma d'identification

Le schéma d'identification s'applique à tous les types d'objets, mais peut également être écrasé par des types d'objets plus spécifiques.