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 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

Remarque

L'URL fournie sera vérifiée par rapport à la propriété de configuration system.remote_servers_allowed dans le fichier dhis.conf. Si l'URL de base n'est pas l'un des serveurs configurés autorisés, l'opération ne sera pas autorisée. Voir l'exemple d'échec ci-dessous.
Quelques exemples où le jeu de configuration est system.remote_servers_allowed=https://server1.org/,https://server2.org/ - fournir https://server1.org/path/to/resource -> l'opération sera acceptée - fournir https://server2.org/resource/path -> l'opération sera acceptée - fournir https://oldserver.org/resource/path -> l'opération sera rejetée

Exemple de réponse en cas d'échec

 {
  "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