> For the complete documentation index, see [llms.txt](https://docs.digit.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digit.org/health/v1.5/setup/installation/project-data-setup.md).

# Project Data Setup

## Overview

This step involves the execution of the Postman collection for the minimum setup data required to run a campaign from the field worker app.

## Restart Zuul service

* Before you start loading the project data, execute the below command to restart the Zuul gateway.
* Check if all the services are up and running by using the following command:

```
kubectl get pods -n egov
```

<div align="left"><figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/V4mMZB3OXz9qx88X408E/Screenshot%202024-08-01%20at%202.23.52%20PM.png" alt="" width="375"><figcaption></figcaption></figure></div>

* If all the services are running with Ready 1/1, then restart the Zuul service by using the command given below:

```
kubectl delete pods {zuul-pod-name} -n egov
```

## Steps to Load Project Data

All file examples in this document refer to the default branches in the health campaign DevOps and configuration repositories for example purposes. If you have replaced these repositories with your fork or clone, refer to the same here.&#x20;

**Create an environment variable file and add the below variables in Postman:**

* Click on New, and Environment, then add the following variables:

<div align="left"><figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/b3DzkqOBMlS74KNnvAad/Screenshot%202024-04-03%20at%201.22.15%20AM.png" alt="" width="375"><figcaption></figcaption></figure></div>

* **URL -** domain\_name provided in infra-as-code/terraform/sample-aws/input.yaml
  * e.g. https\://{**domain\_name**}
* **tenantId** - mz
* **apiUserName** and **apiPassword** - newly created superuser credentials
* **startDate** and **endDate** in epoch format - [`epoch converter`](https://www.epochconverter.com/)&#x20;
* **boundaryCode** -  use the default value (**VFTw0jbRf1y**) if Master data is unchanged <br>

  <div align="left"><figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/MR4mdWJLxo2kCHCGsCV9/Screenshot%202024-04-03%20at%2011.42.14%20AM.png" alt="" width="563"><figcaption></figcaption></figure></div>
* **Import the seed data script**

### Seed Data Postman Script

{% file src="/files/H3pq7XCDIiEJqbObyLQI" %}

* This collection includes all the scripts to create users, projects, staff, and product variants.
* Import the HCM setup script in Postman - [import guide](https://learning.postman.com/docs/getting-started/importing-and-exporting/importing-data/)
* Choose the new environment created in the environment tab:

![](https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/0YtWJQ372PIsTLpcAZDg/environment-editor-select-env-v10-20.jpg)

* Once Env is selected then click on the imported HCM setup collection click run:&#x20;

<div align="left"><figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/ad0w2lGeGW7hf10yFpui/click%20on%20run.png" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/Gh6hIwZLWJlmuBAiCUG6/Screenshot%202024-04-03%20at%2012.12.32%20PM.png" alt="" width="375"><figcaption></figcaption></figure></div>

## **Loading Localisation**&#x20;

Localisation is required to load and show data in different available languages. You can add localisation for English, French, and Portuguese by following the instructions below. If only one specific language is required, download and run that language-specific collection.&#x20;

#### Prepare To Setup

* Create a port forward to the localisation pod by executing the below command:

```shell
kubectl port-forward svc/egov-localization -n egov 8080:8080
```

* Replace the **URL** variable in the Postman Environment to <http://localhost:8080>

#### **All Languages (English, French, Portuguese)**

* Define locale code for localeEnglish, localeFrench and localePortuguese in the environment file.
  * localeEnglish - en\_MZ
  * localeFrench - fr\_MZ
  * localePortuguese - pt\_MZ
* **Download the below file for all localisations (English, French, and Portuguese) data to be loaded at once:**

{% file src="/files/KfG9HMA1CkgyI9xz2YXF" %}
All Localisations Collection
{% endfile %}

* Import the downloaded file into Postman and select all language localisation collections and click on run. See the screenshot below for reference:

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/T2EvpoHPxf7vBG19l719/Screenshot%20from%202024-08-09%2006-15-35.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/WVzte4bQnA9W8kAmjiFJ/Screenshot%20from%202024-08-09%2006-15-48.png" alt=""><figcaption></figcaption></figure>

#### Instructions for installation of HCM in English

* To add localisations specific to the English language only, download the file given below:

{% file src="/files/MB2V427Bs4mqs1WmzhOI" %}
English Localisation Collection
{% endfile %}

Import the downloaded file into Postman, select the English collection, and click on run. See the screenshot below for reference:

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/hH43YlEbOLo9V1f9X5AC/Screenshot%20from%202024-08-09%2006-16-03.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/AO5cE2TNhfP4w0l0UiwB/Screenshot%20from%202024-08-09%2006-16-13.png" alt=""><figcaption></figcaption></figure>

#### Instructions for installation of HCM in French

* To add localisations specific to the French language only, download the file given below:

{% file src="/files/SHerGrtiTn9qLanemmTJ" %}

Import the downloaded file into Postman, select the French collection, and click on the run. See the screenshot below for reference:

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/psZg391MOPseNUTlnYRl/Screenshot%20from%202024-08-09%2006-16-24.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/B5uIOyyB4c1XBSZO7n4w/Screenshot%20from%202024-08-09%2006-16-32.png" alt=""><figcaption></figcaption></figure>

#### Instructions for installation of HCM in Portuguese

* To add localisations specific to the Portuguese language only, download the file given below:

{% file src="/files/evU5Gh1chQVkKIccXVA4" %}
Portuguese Localisation Collection
{% endfile %}

Import the downloaded file into Postman, select the Portuguese collection, and click on the run. See the screenshot below for reference:

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/go2CFs5v9z6pNXP2gOxg/Screenshot%20from%202024-08-09%2006-16-44.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/8VKysij1RLqQNTZOJqsD/Screenshot%20from%202024-08-09%2006-16-51.png" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.digit.org/health/v1.5/setup/installation/project-data-setup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
