`DHIS2` new tracker api

mtuchi commented 1 week ago

Description

Since DHIS2 version 2.36, the tracker API has been re-implemented and the old API endpoints will be removed in v2.42 Learn More here

Tracker API Warning

Tasks

Re-implement our upsert operation to use the new tracker api
Maybe use common.http ?
what else needs to change ?

josephjclark commented 6 days ago

Maybe duplicate of https://github.com/OpenFn/adaptors/issues/62

josephjclark commented 6 days ago

We should do a patch on 5.x which enforces api version <41, and has clear documentation.

the adaptor docs and readme need to clearly state that the adaptor only supports <41 (some functions may work but some will break... the generic http functions should be OK)
we should log a clear warning if the credential specifies an api version >=42
If we're really good we'll list the compatible APIs

Then we do 6.x, reworking APIs and removing axios. The 6.x adaptor will only work with DHIS2 >= 38, so again we need to warn in the console if using an old version, and clearly document the compatibility.

So implementations using dhis2 37 would not be able to migrate to adaptor 6.x and use any new features from there. Is that OK? Do we mind?

OpenFn / adaptors

`DHIS2` new tracker api #754