Loading a Single Baseline via the Admin Screen

To load a single file, use the Livelihood Explorer admin screens instead of the Dagster pipelines.

1. On a desktop copy of the BSS, enable editing and set calculations to automatic.

2. Open the admin screen: http://livelihoodsstage.fews.net/admin

3. Ensure Source Organization and Livelihood Zone exist.

   1. Source Organization should already exist. If not, use the guidance on the BSS Setup page.

   2. Livelihood Zone: Be sure to enter a code, country, and name. Enter a description of the Livelihood Zone if available. Save.

4. Add seasons

   1. Learn more about adding Season definitions.

5. Add Livelihood Zone Baseline

   1. Choose the Livelihood Zone code.

   2. Add name.

   3. Choose the Primary Livelihood System.

   4. Choose Source organization.

   5. Choose file > select your BSS file.

   6. Choose BSS language.

   7. Upload profile report if available. This can be added later.

   8. Choose the start and end date for the reference year.

   9. Add a valid from date. Leave the valid to date blank.

   10. Choose the Data Collection start and end dates.

   11. Add a publication date if available.

   12. Choose the currency.

   13. Add descriptions in any languages available.

   14. Click save.

6. Tell the Hub it has been uploaded so we can run the pipelines manually. It may take up to 10 minutes for the partition to appear in the pipeline. In Dagster, the Hub will complete the following steps:

   1. Materialize missing partitions.

   2. Run imported_communities for relevant partition.

   3. imported_baseline - run upstream all that haven’t been run (depth of 4) for relevant partition - make sure activity groups are included, back to corrected files

   4. Review unrecognized_labels to see if there are any missing.

   5. At each step, check for errors and needed corrections and create tickets as needed.