Synchronization¶

Cette section traite des opérations 'pull' et 'push' sur les données et les métadonnées.

Data value push¶

Pour lancer une opération push (envoi) d'une valeur de données vers un serveur distant, il faut d'abord configurer l'URL et les informations d'identification du serveur concerné dans Paramètres du système > Synchronisation, puis envoyer une requête POST à la ressource suivante :

/api/33/synchronization/dataPush

Metadata pull¶

Pour lancer une opération pull (extraction) de métadonnées à partir d'un document JSON distant, vous pouvez effectuer une requête POST avec un url comme charge à la ressource suivante :

/api/33/synchronization/metadataPull

Note

The supplied URL will be checked against the config property metadata.sync.remote_servers_allowed in the dhis.conf file. If the base URL is not one of the configured servers allowed then the operation will not be allowed. See failure example below.
Some examples where the config set is metadata.sync.remote_servers_allowed=https://server1.org/,https://server2.org/ - supply https://server1.org/path/to/resource -> this will be accepted - supply https://server2.org/resource/path -> this will be accepted - supply https://oldserver.org/resource/path -> this will be rejected

Sample failure response

 {
  "httpStatus": "Conflict",
  "httpStatusCode": 409,
  "status": "ERROR",
  "message": "Provided URL is not in the remote servers allowed list",
  "errorCode": "E1004"
}

Availability check¶

Pour vérifier la disponibilité du serveur de données distant et les informations d'identification de l'utilisateur, vous pouvez envoyer une requête GET à la ressource suivante :

/api/33/synchronization/availability