# Create Program

## Description

Create Program screen helps to create a new program. This document provides step-by-step instructions to create a new program. The user with a Program Manager and Administrator role can create a new program.

## Prerequisites

The user must have a Program Manager role to create a new program.

Note:

Refer the [Create User and Assign Role](https://docs.openg2p.org/~/changes/xKUM0sBXFkyR8F24yAMq/pbms/functionality/administration/role-based-access-control/user-guides/assign-roles-to-users) guide to know how to assign role for a User.

## Procedure

## Programs

1. Click the main menu icon ![](https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/8OB4tqV7ZFODV0mhFdjA/image.png) and select ***Programs***.
2. The ***Programs*** screen is displayed.

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/H2dkZIGu1Blo71BT8qVN/programs.png" alt=""><figcaption><p>Choose the Programs screen</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/e8jNYJ09Ba3ZQJVSvNs0/Program-screen.png" alt=""><figcaption><p>Programs screen</p></figcaption></figure>

***Programs*** screen provides dashboard view which lists all the available Program Names, Target Type, Number of Enrolled Beneficiaries against each program, State (whether active/inactive), and the Beneficiaries list.

In ***Programs*** screen, the available features and their descriptions are:

<table><thead><tr><th width="130">Feature</th><th>Description</th></tr></thead><tbody><tr><td>Create</td><td>Click the <em><strong>Create</strong></em> button to create new program</td></tr><tr><td><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/x4RGFVbnbjJV4GPp7wt0/image.png" alt="" data-size="original"></td><td>Click the <em><strong>Export All</strong></em> button to download the details in excel format</td></tr><tr><td>&#x3C;</td><td>Click the <em><strong>Left</strong></em> arrow to go the previous screen</td></tr><tr><td>></td><td>Click the <em><strong>Right</strong></em> arrow to go the next screen</td></tr><tr><td>Filters</td><td><p>Click the <em><strong>Filters</strong></em> link and select the appropriate options.</p><p>The valid values are:</p><ul><li>Archived</li><li>Add Customer Filter</li></ul><p>The advanced filter option allows you to define conditions and criteria to refine the search results.</p><ul><li>Select the <em><strong>Add Customer filter</strong></em> and then select the appropriate option in the first drop-down to display the specific data based on the option selected.</li><li>Select the criteria in second and third drop-down to refine the search results.</li><li>Click the <em><strong>Apply</strong></em> button to display the data based on the search</li></ul><p><em>Note: To enhance the search, click the <strong>Add a condition</strong> button and follows the steps given in <strong>Add Customer Filter</strong> option</em></p></td></tr><tr><td>Group By</td><td><ul><li>Click the <em><strong>Group By</strong></em> link, select <strong>Add Custom Group</strong> and then select the appropriate options in the drop-down to display the specific data based on the option selected.</li><li>Click the <em><strong>Apply</strong></em> button to display the data based on the search</li></ul></td></tr><tr><td>Favorites</td><td><ul><li><p>Click the <em><strong>Favorites</strong></em> link, select <strong>Save current search</strong> and then check the appropriate options. The valid values are:</p><ul><li>Use by default</li><li>Share with all users</li></ul></li><li>Click the <em><strong>Save</strong></em> button to display the data based on the search</li></ul></td></tr><tr><td>Search</td><td>This field is filled when the available option are selected in Filers, Group By, Favorites</td></tr></tbody></table>

### Create Program

3. Click the ***Create Program*** button. The ***Set Program Settings*** screen is displayed.

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/yC49a6HQw5rpKxhbqay4/Set-Program-Settings.png" alt=""><figcaption><p>Set program settings</p></figcaption></figure>

#### Set Program Settings

In ***Set Program Settings*** screen, the features and their descriptions are:

| Feature                  | Description                                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------------------------ |
| Program Name             | Enter the Program name                                                                                 |
| Target Type              | <p>Choose one of the Target Type. The valid values are:</p><ul><li>Groups</li><li>Individual</li></ul> |
| Currency                 | <p>Select the appropriate currency option. The valid values are:</p><ul><li>EUR</li><li>USD</li></ul>  |
| Is Reimbursement Program | Check the option if the reimbursement program is required                                              |

In ***Set Program Settings*** screen, you can find the below tabs.

* Configure the Default Eligibility Criteria
* Configure the Cycle Manager
* Configure the Entitlement Manager
* PMT Configuration
* Map Portal Form

**Configure the Default Eligibility Criteria**

4. Click the ***Configure the Default Eligibility Criteria*** tab, the fields available in the tab are displayed.

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/QBKKJ5UxbAA4BJ7DWHJH/Set-Program-Settings-Eligibility%20Criteria.png" alt=""><figcaption><p>Configure the Default Eligibility Criteria</p></figcaption></figure>

<table><thead><tr><th width="185">Feature</th><th>Description</th></tr></thead><tbody><tr><td>Eligibility manager</td><td>Default option is selected by default</td></tr><tr><td>Admin Area</td><td>Enter the admin area</td></tr><tr><td>Filter</td><td></td></tr><tr><td>Match all records</td><td>Retrieves the data which matches all records</td></tr><tr><td><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/jPhQbc90Lo2YcGxW8qp8/image.png" alt="" data-size="original"></td><td><p>Click the <em><strong>Records</strong></em> button. The <em><strong>Selected records</strong></em> screen is displayed.</p><p><em>Note:</em></p><ul><li><em>By default the list of three records are listed in the <strong>Selected records</strong> screen.</em></li><li><em>Click the <strong>Cancel</strong> button to close the <strong>Selected records</strong> screen.</em></li></ul></td></tr><tr><td><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/F9hP3GMGl9RUvZsIuKPj/image.png" alt="" data-size="original"></td><td>Click the <em><strong>Refresh</strong></em> button to refresh the screen</td></tr><tr><td>Add filter</td><td><p>Click the <em><strong>Add filter</strong></em> button to set eligibility criteria using Domain Filters. You may set multiple eligibility criteria.</p><ol><li>Click the <em><strong>Add filters</strong></em> button. The multiple criteria fields are displayed.</li><li>Select the multiple criteria such as ID, condition and count.</li><li>Click the <strong>x</strong> button to remove the entry in the criteria fields.</li><li>Click the <strong>+</strong> button to add new multiple criteria field.</li><li>Click the <strong>...</strong> option to display fields in <em><strong>Any of</strong></em> section. The multiple criteria fields are displayed.</li></ol><p><em>Note: You can click the <strong>...</strong> option to add n number of <strong>Any of</strong> section</em></p><ol start="6"><li>The value chosen in the multiple criteria fields are displayed in the <em><strong>Code editor</strong></em>.</li><li>In the Match records chose one of the followings:</li></ol><ul><li>Select <em><strong>All</strong></em> to display the data belongs to <em><strong>All</strong></em> section</li><li>Select <em><strong>Any</strong></em> to display the data belongs to <em><strong>Any</strong></em> <em><strong>of</strong></em> section</li></ul></td></tr></tbody></table>

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/9ZVF1NsASPkLCuE0bztx/Selected-records.png" alt=""><figcaption><p>Selected records screen</p></figcaption></figure>

**Configure the Cycle Manager**

5. Click the ***Configure the Cycle Manager*** tab, the fields available in the tab are displayed.

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/JGb1NzVeNpT0mhpubwck/Configure-the-cycle-manager.png" alt=""><figcaption><p>Configure the cycle manager</p></figcaption></figure>

<table><thead><tr><th width="247">Feature</th><th>Description</th></tr></thead><tbody><tr><td>Auto-approve Entitlements</td><td><p>Check the option if the auto-approve entitlements is required.</p><p><em>Note:</em></p><p><em>Set entitlements via rules, without any manual approvals.</em></p></td></tr><tr><td>Approver Group</td><td><p>Select the approver group in the drop-down.</p><p><em>Note:</em></p><p><em>The group name of the user who has permission to approve cycles. See</em> <a href="../../administration/role-based-access-control/user-guides/assign-roles-to-users"><em>Create User and Assign Role</em></a><em>.</em></p></td></tr><tr><td>One-time Distribution</td><td><p>Check the option if the distribution happens one-time</p><p>Note:</p><ul><li>If one-time distribution option is checked, the recurrence distribution option is not displayed.</li><li>If one-time distribution option is not checked, the recurrence distribution option is displayed.</li></ul></td></tr><tr><td>Recurrence</td><td><p>You can choose recurrence option, if the time period is repeated for a cycle</p><p>Enter the number and select the appropriate option in the drop-down. The valid values are:</p><ul><li>Days</li><li>Weeks</li><li>Months</li><li>Years</li></ul></td></tr><tr><td>Day of Month</td><td><p>Select the appropriate option in the drop-down. The valid values are:</p><ul><li><p>Date of month</p><ul><li>Enter the date of month if date of month option is selected in the drop-down</li></ul></li><li><p>Day of month</p><ul><li>Enter the day of month if day of month option is selected in the drop-down</li></ul></li></ul></td></tr></tbody></table>

**Configure the Entitlement Manager**

6. Click the ***Configure the Entitlement Manager*** tab, the fields available in the tab are displayed.

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/4ufvir2WgccFXzxoshZe/Configure-the-entitlement-manager.png" alt=""><figcaption><p>Configure the entitlement manager</p></figcaption></figure>

| Feature                               | Description                                                                                                                                                                                                                                                                                                           |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Entitlement manger                    | <p>Select the parameters for entitlements. The valid values are:</p><ul><li>Default</li><li>In-Kind</li><li>Cash</li></ul>                                                                                                                                                                                            |
| ID Type to store in entitlements      | Enter the ID Type to store in entitlements                                                                                                                                                                                                                                                                            |
| Amount Per Cycle                      | Enter the amount of disbursement of a group or individual per cycle.                                                                                                                                                                                                                                                  |
| Amount Per Individual In Group        | Enter the amount of disbursement per individual in a group when the program target type is "group".                                                                                                                                                                                                                   |
| Maximum number of individual in group | <p>Enter the maximum number of individuals who get disbursements per group.</p><p><em>Note:</em></p><p><em>It is an optional field</em></p>                                                                                                                                                                           |
| Transfer Fee(%)                       | <p>Enter the fee incurred for disbursement as a percentage of disbursement.</p><p><em>Note:</em></p><p><em>It is an optional field</em></p>                                                                                                                                                                           |
| Transfer Fee Amount                   | <p>Enter the fee incurred for disbursement as an absolute amount.</p><p><em>Note:</em></p><p><em>It is an optional field</em></p>                                                                                                                                                                                     |
| Entitlement Validation Group          | <p>Enter the group name of the user who has permission to approve entitlements.</p><p><em>Note:</em></p><p><em>See</em> <a href="../../administration/role-based-access-control/user-guides/assign-roles-to-users"><em>Create User and Assign Role</em></a> <em>guide to know how to assign role for a User.</em></p> |

**PMT Configuration**

7. Click the ***PMT Configuration*** tab, the field available in the tab is displayed.

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/cE035fmmh4nvWzLDinPj/PMT-configuration.png" alt=""><figcaption><p>PMT Configuration</p></figcaption></figure>

| Feature    | Description                        |
| ---------- | ---------------------------------- |
| Enable PMT | Check the option to enable the PMT |

**Map Portal Form**

8. Click the ***Map Portal Form*** tab, the fields available in the tab are displayed.

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/V8YO4Ry2ApEc5YhjiAH1/Map-portal-form.png" alt=""><figcaption><p>Map portal form</p></figcaption></figure>

| Feature                               | Description                                                                |
| ------------------------------------- | -------------------------------------------------------------------------- |
| Multiple Form Submission Program Form | Check the option if the multiple form submission program form is required. |
| Program Form                          | Enter the name of the program form                                         |

9. Click the ***Next*** button.
10. The ***Set Program Settings*** dialog box is displayed.
11. Select the option ***Yes,*** to import the matching registrants to this program
12. Select the option ***No***, not to import the matching registrants to this program
13. Click the ***Back*** button to go previous screen
14. Click the ***Create*** button to create New Program
15. Click the ***Cancel*** button to go to the Program dashboard screen

You can view newly created Program listed in the Program dashboard screen.

<figure><img src="https://content.gitbook.com/content/JZcdob2emEcLMvLyIxqT/blobs/QcvF6iKhz20bj8Xu2bpu/New-program-listed.png" alt=""><figcaption><p>Created new program listed in program dashboard screen</p></figcaption></figure>
