> 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/ph-v1.8/access/public-health-product-suite/health-campaign-management-hcm/microplanning/map-facility-to-catchment-area.md).

# Map Facility To Catchment Area

System role involved: National facility boundary assigner, Facility boundary assigner

1. You must first select the language before you can log in. Currently, 3 languages are supported:

* English
* Portuguese
* French

Select the preferred language and click on 'Continue' to go to the login page.

(Note: Getting an account on the HCM Microplanning platform: The microplanning users with different roles will have their account created by the system admin and will be provided with a username and password to log in to the account).

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2FSUgmLHK0huIjIbZYG1QJ%2FScreenshot%202024-11-26%20at%202.53.37%20PM.png?alt=media&amp;token=037730bf-989b-434c-b931-250c54d76b06" alt=""><figcaption></figcaption></figure>

2. On the login page, enter the 'Username', 'Password', and the 'City' you are working in to log in to the HCM Microplanning platform. You need to use the login credentials belonging to the "Facility boundary assigner" or "National facility boundary assigner" roles.

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2FH1tKaHdUBjb0w6JA5gJE%2FScreenshot%202024-11-26%20at%202.54.33%20PM.png?alt=media&amp;token=f4345860-4721-490b-bf7c-eb3e2d1409fa" alt=""><figcaption></figcaption></figure>

Once you log in, you will be landing on the homepage to take the next action.

3. Once you are on the home page, you will be able to see the "My Microplan" segment.

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2Fi1tC12J6hSX5SUpP9TXY%2FScreenshot%202024-11-26%20at%202.55.16%20PM.png?alt=media&amp;token=58a29b7d-11e6-4aa3-86c9-394db381276e" alt=""><figcaption></figcaption></figure>

This is the view of the "My Microplans" segment.

By clicking on the "My Microplan" segment, you can see the list of Microplans that you are part of.&#x20;

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2FPq7kAnVhyphoJljn8qzU%2FScreenshot%202024-11-26%20at%202.56.53%20PM.png?alt=media&amp;token=fd35047e-c8a6-4bed-b95b-4ef36c174dd4" alt=""><figcaption></figcaption></figure>

This is the dashboard that will show you the list of microplans assigned to you.

4. Once you choose the microplan on which you want to act, you will be redirected to an activity selection screen.

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2FGtU9rCKuhWtY16p740jN%2FScreenshot%202024-11-26%20at%202.57.37%20PM.png?alt=media&amp;token=9b6a15bc-ea42-44ac-9f99-70be2e3a9805" alt=""><figcaption></figcaption></figure>

This is the view for the activity selection screen.

Once here, if you are logged in as a "Facility boundary assigner" role, you will have to click on the "Assign Facilities To Villages" tab.

This is the second step, without finalizing the facility-boundary assignment mapping, you will not be able to move ahead with the next activity.

5. You will click on the "Assign Facilities To Villages" tab, which will redirect you to the facility assignment screen where you will need to assign the facilities under your jurisdiction to their respective catchment boundaries (Example: villages).

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2F7vNbSpQoaNxK9g2Ziq0u%2FScreenshot%202024-11-26%20at%202.58.31%20PM.png?alt=media&amp;token=5029e573-c17a-4b81-9100-15b85fd20ab0" alt=""><figcaption></figcaption></figure>

This is the dashboard view you will see when you log in as either the "Facility boundary assigner" or "National facility boundary assigner" role.

In this dashboard, you will be able to:

* Search and filter facilities as per the "Facility name", "Facility type", "Facility status", and "Administrative area".
* Tabular view of data having below points:
* Facility Name: This indicates the name of the facility assigned to you.
* Facility Type: This indicates the type of facility assigned to you.
* Facility Status: This indicates the status of the facility assigned to you.
* Capacity: This indicates the storage capacity of the facility. It can be either ‘Bales’ for the LLIN campaign or ‘SPAQs’ for the SMC campaign.
* Assigned Villages: This indicates the count of villages that are assigned to the chosen facility.
* Serving Population: This indicates the sum of the target population of the villages that will be served by the chosen facility.
* Fixed Post: This indicates if the facility is fixed post or not.
* Administrative Area: This indicates the administrative boundary to which the facility is mapped.
* Assign: Assign indicates that you can either assign some villages or administrative boundaries to the facility for defining the catchment area or you can de-assign the some villages or administrative boundaries that are already assigned to the chosen facility.

6. You will click on the ‘Assign’ button, which will redirect you to the boundary assignment/assignment dashboard.&#x20;

Here, you can see 2 different tabs, one that shows the list of villages, that are not assigned to any facility called the ‘Unassigned Villages’ tab, and the other that shows the list of villages, that are already assigned to the chosen facility called "Assigned Villages" tab.

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2FnthxgjO8OKDB2RaQ33K9%2FScreenshot%202024-11-26%20at%203.01.58%20PM.png?alt=media&amp;token=7250ec3f-e1af-4a4b-87ab-8b66a83dc337" alt=""><figcaption></figcaption></figure>

This is the view for de-assigning or assigning the villages to the chosen facility.

7. In the "Unassigned Villages" tab, you will see the list of villages that are yet to be assigned to a facility for defining their service boundary.

On this page, you can filter out the villages as per their administrative hierarchy and administrative areas from the filter segment above.

You can select one or more villages that can be considered as the catchment boundaries for the chosen facility and then click on "Add to facility" to add the selected villages to the chosen facility.

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2FcGGTi910K2slKdyLbXpB%2FScreenshot%202024-11-26%20at%203.02.51%20PM.png?alt=media&amp;token=c7a026a9-bfff-42e9-97a8-e35db6239e26" alt=""><figcaption></figcaption></figure>

This is the view that you will get once you choose the villages for the facility assignment.

8. Once the villages are assigned to the facility, you will be able to see the assigned villages in the "Assigned Villages" tab. The assigned villages define the catchment boundary for the chosen facility.

On this page, you can filter out the villages as per their administrative hierarchy and administrative areas from the filter segment above.

You can select one or more villages that can be de-assigned from the chosen facility. Once de-assigned, the village will not be part of the catchment boundary of the facility anymore. The de-assigned villages can be reassigned to the chosen facility from the "Unassigned Villages" tab.

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2Frf8f6kAVxXJCZpPaC1g6%2FScreenshot%202024-11-26%20at%203.03.37%20PM.png?alt=media&amp;token=72f33383-788e-4095-bdb4-d3af51fe4a7c" alt=""><figcaption></figcaption></figure>

This is the view that you will get once the villages are assigned to the chosen facility. You can choose to de-assign the villages from this dashboard.

9. Once all the villages under the campaign boundary are assigned to their catchment or service facilities, then, if you are logged in as a ‘National facility boundary assigner’, you can see a button called "Proceed To Finalise Facility Assignment".

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2FEBfcIEKcOiuOTFn4jWUP%2FScreenshot%202024-11-26%20at%203.04.30%20PM.png?alt=media&amp;token=2c00850b-f36c-4b0b-af02-3611d2de0300" alt=""><figcaption></figcaption></figure>

This is the button you will see as a "National facility boundary assigner" once all the villages under the campaign boundary have been assigned to their catchment facility.

10. If you are logged in as a "National facility boundary assigner", you can see and click on "Proceed To Finalise Facility Assignment" to finalise the facility assignment for the campaign boundary.

Here, once you click on this button, you will be shown a pop-up asking you to verify the facility assignment and then finalize the assignment. Once finalized, you can make any changes to the facility assignment.

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2FhqZfCNuGDI5DEf5u9vb4%2FScreenshot%202024-11-26%20at%203.05.14%20PM.png?alt=media&amp;token=4ef161e4-84ba-4b94-a90d-700be35507a1" alt=""><figcaption></figcaption></figure>

This is the warning pop-up you will see when you try to click on the "Proceed To Finalise Facility Assignment"’ button.

11. Once you click on the button shown in the pop-up called "I Want To Finalise", you will see the activity completion screen showing the facility assignment is completed successfully.

<figure><img src="https://637188494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVdFjJNtaUlTFjgyyYVV%2Fuploads%2FqnljMeIt2db6nZT51xhB%2FScreenshot%202024-11-26%20at%203.05.41%20PM.png?alt=media&amp;token=0d8a2d54-1828-4de9-83c1-d5c0d688152b" alt=""><figcaption></figcaption></figure>

This is the screen you will see when the facility assignment is completed.

You can now click on the "Go back to home" button to go back to the "My Microplans" dashboard, as your assigned activity has been completed.


---

# 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/ph-v1.8/access/public-health-product-suite/health-campaign-management-hcm/microplanning/map-facility-to-catchment-area.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.
