- Introduced
serverargument: Theserverargument now accepts the server URL without the/apisuffix, simplifying the configuration of DHIS2 credentials and API calls.
- Deprecated
base_urlinkhis_cred(): Thebase_urlargument is now deprecated in favour of the newserverargument. - Deprecated default
base_urlvalue: The default value previously used for thebase_urlargument is no longer supported. Users should provide an explicitserverURL moving forward.
- Improved testing: Test coverage has been enhanced to automatically skip tests when the target server is unreachable or down, ensuring smoother testing workflows in offline or server downtime conditions.
-
Improved Authentication: Now supports optional authentication for API calls using the
authargument. This strengthens security by allowing you to control access to your data. -
Clearer Error Messages: Provides more informative error messages to help you identify and troubleshoot issues more efficiently.
- Improved Credential Handling:
khis_has_cred(): Now ensures credentials are valid before returning TRUE, preventing unauthorized access.khis_cred(): Includes validation to accept only valid credentials, reducing errors.
-
Introduced experimental functions for enhanced data retrieval:
get_data_elements_with_category_options(): Fetch data elements along with their associated category option values.get_organisations_by_level(): Retrieve organizations filtered by level.get_analytics_by_level(): Obtain analytics table dataget_data_sets_by_level(): Retrieve data set reporting rate metrics.
-
Added the
khis_base_url()to obtain the DHIS2 API URL. -
Introduced
get_organisation_unit_levels()to retrieve the available organisation levels in the DHIS2 instance.
-
Made the package generic to support any DHIS2 instance and updated the documentation accordingly.
-
Modified the
khis_cred()to require thebase_urlargument and deprecated the default value.
-
Updated the
khis_cred_clear()to reset thebase_urlback to KHIS API. -
Updated the
khis_cred()to allowbase_urlbe set from the config file.
- Initial CRAN submission.