Catchment Population import

OpenLMIS enables bulk updates of catchment populations for specific geographic zones through file imports. There are two modes of operation, based on the CATCHMENT_POPULATION_CALC_AUTO flag:

1. When the flag is set to True:

   • Only geographic zones at the lowest level can be updated.

   • Parent zones will automatically summarize the catchment population from their child zones.

2. When the flag is set to False:

   • The system will rely solely on user input, with no automatic calculation for parent zones.

   • Geographic zones at each level can be updated.

How to Import the Data

1. Create a file named geographicZone.csv.

2. Ensure the file contains the following two column headers:

   • code (Geographic zone identifier).

   • catchmentPopulation (Updated population value).

3. Add or modify values depending on whether you created new, or used exported file.

4. Save the file with the name geographicZone.csv. It must be in .csv format.

5. Create a .zip file containing the geographicZone.csv file. The .zip file name does not matter.

6. Go to the Administration panel and select Data Import.

7. Select Population from drop-down menu.

8. Click Select File and choose your .zip file created in point 5.

9. Click Import button, located at the bottom-right corner.

10. A pop-up message will appear, informing you whether the import was successful or if any issues occurred during file processing (e.g., attempting to update a non-lowest geographic level when the flag was set to true).

11. Afterward, go to the Administration panel and select Geographic Zones.

12. Verify if the data from the file has been successfully reflected there.