How to configure IRS through admin console

Overview

After setting up system data, we need to create the campaign, which we can create using workbench user interface

Setup Localisation

Localisation is required to get started with workbench ui. To setup localisation, follow these steps - Loading Localisation

Update Roles In MDMS Config

• Port forward mdms v2 using below cmd

kubectl port-forward svc/mdms-v2 -n egov 8080:8080

• Search for admin schema using below curl

curl --location 'http://localhost:8080/mdms-v2/v2/_search' --header 'Content-Type: application/json' --data '{  "RequestInfo": {  "apiId": "hcm",  "ver": ".01",  "ts": 1718000364924,  "action": "_search",  "did": "1",  "key": "1",  "authToken": "9cd4a306-8bed-4e91-9306-2a2250cec891"  },  "MdmsCriteria": {  "tenantId": "mz",  "isActive": true,  "schemaCode": "HCM-ADMIN-CONSOLE.adminSchema",  "uniqueIdentifiers": [  "user.all"  ]  } }'

• In the response, check for mdms list and copy the id value from the first object and keep
• import below curl and replace the id in object Mdms with above copied value

curl --location 'http://localhost:8080/mdms-v2/v2/_update/HCM-ADMIN-CONSOLE.adminSchema' --header 'Content-Type: application/json' --data '{  "RequestInfo": {  "apiId": "hcm",  "ver": ".01",  "ts": 1718000364924,  "action": "_search",  "did": "1",  "key": "1",  "authToken": "9cd4a306-8bed-4e91-9306-2a2250cec891",  "userInfo": {  "uuid": "1f1bfedb-b86d-4319-9370-5c5d95b1e93f"  }  },  "Mdms": {  "id": "2005d578-6274-47da-a88e-93044c2e2320",  "tenantId": "mz",  "schemaCode": "HCM-ADMIN-CONSOLE.adminSchema",  "uniqueIdentifier": "user.all",  "data": {  "title": "user",  "$schema": "http://json-schema.org/draft-07/schema#",  "properties": {  "enumProperties": [  {  "enum": [  "Registrar",  "Distributor",  "Supervisor",  "National Supervisor",  "Provincial Supervisor",  "District Supervisor",  "Team Supervisor",  "Helpdesk User",  "Monitor Local",  "Logistical Officer",  "Health Facility Worker",  "Warehouse Manager"  ],  "name": "HCM_ADMIN_CONSOLE_USER_ROLE",  "isRequired": true,  "description": "User Role",  "orderNumber": 3  },  {  "enum": [  "Temporary",  "Permanent"  ],  "name": "HCM_ADMIN_CONSOLE_USER_EMPLOYMENT_TYPE",  "isRequired": true,  "description": "Employement Type",  "orderNumber": 4  }  ],  "numberProperties": [  {  "name": "HCM_ADMIN_CONSOLE_USER_PHONE_NUMBER",  "type": "number",  "maximum": 9999999999,  "minimum": 1000000000,  "isUnique": true,  "isRequired": true,  "description": "Phone Number",  "orderNumber": 2,  "errorMessage": "HCM_ADMIN_CONSOLE_USER_PHONE_NUMBER_ERROR"  }  ],  "stringProperties": [  {  "name": "HCM_ADMIN_CONSOLE_USER_NAME",  "type": "string",  "maxLength": 128,  "minLength": 2,  "isRequired": true,  "description": "User Name",  "orderNumber": 1  },  {  "name": "HCM_ADMIN_CONSOLE_BOUNDARY_CODE_MANDATORY",  "type": "string",  "isRequired": true,  "description": "Boundary Code (Mandatory)",  "orderNumber": 5,  "errorMessage": "HCM_ADMIN_CONSOLE_BOUNDARY_CODE_MANDATORY_ERROR"  }  ]  },  "campaignType": "all"  },  "isActive": true,  "auditDetails": {  "createdBy": "a1fc1a17-f324-479f-bd2a-f2e9b9d0fd83",  "lastModifiedBy": "13f801d0-03da-4fe7-8299-250f5396e2bc",  "createdTime": 1717754171827,  "lastModifiedTime": 1718781116871  }  } }'

• Send the request to update

Setup Campaign Steps

1. Open Workbench UI - https://<domain_name>/workbench-ui/employee/user/language-selection , Select a Language and Login with Superuser username and password , Then click on Setup-campaign
2. Select type of campaign as IRS-mz and click next
3. Give Name of the campaign as IRS and click next
4. Select the boundaries where you want to run the campaign and click next
5. Select the start and end date of the campaign and click next. *Note that deliveries would work only from start date, not before this.
6. Select start and end dates for cycles as campaign start date and end date and click next.
7. Configure conditions for delivery step -

   1. Click on Add Resources to be delivered button
   2. Click on Add New Resource
   3. Use Resource type as Spray and resource variant as 50ml and create resources for names Sumishield, Fludora, Delt, Acetellic, DOT and Bendiocarb one by one.
   4. After all the resources are created. Click on Add Resources to be delivered and add all the resources.
   5. Click on Add more delivery conditions and select reeds, clay respectively and select all resources as step 4 then click next
8. Download the Target template and update overall targets for villages and rooms in columns Household Target at a village level, Room Target at a village level ie 100, 300 for each row. And go back to workbench ui and select updated target file to upload and click next.
9. Download the template for facility data and add one or more facilities using below steps. Then upload the saved file in workbench ui and click next.

   1. Select Facility Type as Warehouse
   2. Facility Status as Permanent
   3. Capacity as 1000000
   4. Boundary Code (check in sheet Boundary Data in downloaded template and choose any)
   5. Facility Usage as Active
10. Download the template for user details. In this downloaded template add users with role Distributor, National Supervisor, Provincial Supervisor, District Supervisor, Team Supervisor and a Warehouse Manager and fill up other details. Then upload the saved file back in workbench ui and click next.
11. This step shows overview of all the steps data. Edit any step if required otherwise click on create campaign.

After Campaign Creation Steps

On successful creation wait for 5 minutes for internal processes to complete, then go to the home page and select My Campaign

1. Select the Upcoming tab and select the created campaign.
2. Check for the timeline and progress of creation of the campaign data. If it shows Campaign successfully created , check for the download button for user credentials and download credentials.
3. Share the credentials with users and start using mobile apk from project start date.