The Survey module allows employees to create surveys for citizens and let them fill out surveys. Later survey results are available on the Survey results dashboard.
Key Features
The Survey module allows employees to -
Create new surveys
Get aggregated views of survey results in charts format
Download survey results
The module allows citizens to -
Get notifications on new surveys
Fill in the survey forms
Section Overview
This section contains all docs and information required to understand the Survey module, its key features, functional scope, and configuration details. Click on the links below to learn more about deploying, configuring, customizing, and using the Survey module.
Click on the embedded links within the content to browse topic details
Use the Contents links available on the right side of the screen to move to a specific heading
Find the list of Related Docs links at the bottom of each page to browse through additional product details
Contact Us
Reach out to us through any of the below-mentioned contact channels for any assistance or additional information on Survey module deployment.
Citizen Engagement Module
Objective
To enable engagement between government and citizens. Any designated government employee can share any documents, make alerts about any events or broadcast messages to all the citizens. This module helps the government to conduct citizen surveys and polls.
Major Features
→ Documents: This is to enable employees to create, edit, delete circulars & notices, tenders and similar documents and share them with citizens.
→ Public Events: This is to enable employees to create, edit, delete public events like vaccination drives, festivals, etc. with citizens.
→ Public Broadcast Messages: This is to enable mass broadcasting of important messages with the masses, citizens get an alert notification just like events.
→ Surveys: This feature enables employees to conduct surveys using different types of questionnaires.
Overview
As with any other module, this module also has two sides Employee Flow and Citizen Flow
Employee Side Flow
All the features in this module have similar flows where employees can see a list of all the created items, search through them, filter them, create new ones, edit created ones and delete or mark them inactive(in case of surveys).
Citizen Side Flow
Since the goal of this module is to increase engagement with citizens, every registered citizen gets a notification on the creation of a new document, new events, publishing of new message or survey.
The Survey module allows employees to create surveys for citizens who fill in the details. Later, the survey results are available on the Survey results dashboard.
Key Features
The Survey module enables employees to create new surveys and share them with citizens for their responses and insights.
Employee user scope of action includes
Create new surveys
View surveys
Edit surveys
Citizen user scope of action includes
Respond to surveys
View surveys
Using Surveys
This section guides you through the details of using the Surveys module for each role. Click on the relevant role below to learn more about how to use the Surveys.
This section illustrates the steps for employee roles at the ULB level
Employees can
Create New Surveys
Log in to the employee portal using your credential.
Click on the Surveys Inbox option on the home screen.
To create a survey, navigate to the Inbox and click on the New Survey option. Alternatively, you can click on Create New Survey. This opens the survey form page.
By default, one ULB is selected from the dropdown for which the survey is being created. Enter the Survey Name and Survey Description.
Enter the Questions and Question Type from the drop-down list. A maximum of 30 questions can be added.
The Question created can be marked as mandatory by clicking the Required checkbox.
Additional questions can be added to the survey by clicking on the Add Question hyperlink.
Enter the Survey Start Date, Survey Start Time, Survey End Date and Survey End Time details and click on Create Survey button.
The system displays the Survey Created Successfully message along with the Survey ID.
If a survey is created with the same name that already exists, the system displays the Survey name already exists message.
View Surveys
Click on the Surveys Inbox option on the home screen.
This displays all the Surveys created for the city. Click on the Survey Title hyperlink available in the list of surveys Inbox of the employee dashboard.
Or, enter the Survey Name or any other search parameter to search for the application.
Click on the Survey Title hyperlink to open the survey.
Scroll down the survey page to review the filled-in details.
Survey Results
Once the survey is completed, an employee can view the survey results. Click on the Bar Graph hyperlink to view the results.
Employees can view the corresponding citizens' Email and Phone Numbers.
Employees can also view the statistics of the feedback provided.
Edit Surveys
Search for the applications that are Active. Click on the Survey Title to open the survey.
Click on the Take Action button and click on the Edit Survey option.
For Active surveys, only the end date/time and survey description can be edited.
After editing the Survey End Date/Time click on the Edit Survey button.
The system displays the Survey Updated Successfully message along with the Survey ID.
Activate/Deactivate Surveys
Click on the Mark Inactive option to deactivate active surveys.
Click on the Yes, Mark Inactive button.
The system displays the Survey Updated Successfully message along with the Survey ID.
Click on the Mark Active option to activate inactive surveys.
Enter the Survey Start Date/Time and Survey End Date/Time and click on the Save button.
The system displays the Survey Updated Successfully message along with the Survey ID.
Delete Surveys
Click on the Delete button to delete an Active/Inactive Survey.
Click on the Delete button.
The system displays the message Survey Deleted Successfully.
Surveys Citizen User Manual
Learn how to answer the survey
Citizen Users
Citizens represent individuals, communities, or business entities who are the system end-users. The Survey module allows the citizens to interact and provide their feedback. It can include a set of questions or prompts for citizens to respond to, with options to select answers and to provide open-ended responses.
The Citizen role can –
A Citizen can Respond/View the survey in 3 ways i.e.
Survey menu on the screen
Notification icon
What’s New tab
Respond To Surveys
Enter your registered Mobile Number and click on the Next button.
Enter the OTP received on the mobile and click on the Next button.
Navigate to the Surveys menu option on the screen. Alternatively, click on the Surveys card available.
The system displays all the active surveys. Click on the Yet to Respond hyperlink below the survey.
The system displays the corresponding survey. Click on the Submit button, once all questions are answered.
The system displays the Response Submitted Successfully message along with the survey name.
The responses cannot be edited from the citizen's end once the survey form is submitted. The citizen user can view the Survey form.
To view the submitted response, click on Already Responded hyperlink.
The system navigates to the Survey form.
View Survey
The citizen can also view the survey from the notification icon.
Click on the Notifications icon and to respond to the survey click on Participate hyperlink.
The Survey is also displayed under the What’s New tab.
Click on View All and to respond to the survey click on Participate hyperlink.
- This page lists all created documents in reverse-chronological order with the latest created document appearing on the top and the first created one at the end. This table supports pagination and employees have the option to specify the list size for the page.
- Inbox has a search feature that helps employees quickly find documents based on selected ULB, document name and posted by fields.
- Inbox also has a filter option where employees can filter the documents based on categories.
Employees can add new documents using the Add New Document button. A form gets rendered which can be used to fill in necessary details and upload documents if any or add links to document stored somewhere else.
This page provides complete information about the created document. By clicking on the name of any document employee gets navigated to the details page.
Here, employees can take action to edit or delete the document.
Edit Documents
To make some changes in the listed document employees have to navigate to the Details page and then click on the Take Action button → Edit Document Details button. This redirects the user to the edit form where fields are pre-populated with previously entered details. Employees can edit and update the details accordingly.
API
curl 'https://qa.digit.org/egov-document-uploader/egov-du/document/_update' \
-H 'authority: qa.digit.org' \
-H 'sec-ch-ua: "Google Chrome";v="95", "Chromium";v="95", ";Not A Brand";v="99"' \
-H 'accept: application/json, text/plain, */*' \
-H 'content-type: application/json;charset=UTF-8' \
-H 'sec-ch-ua-mobile: ?0' \
-H 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.69 Safari/537.36' \
-H 'sec-ch-ua-platform: "Windows"' \
-H 'origin: https://qa.digit.org' \
-H 'sec-fetch-site: same-origin' \
-H 'sec-fetch-mode: cors' \
-H 'sec-fetch-dest: empty' \
-H 'referer: https://qa.digit.org/digit-ui/employee/engagement/documents/update-response' \
-H 'accept-language: en-US,en;q=0.9' \
--data-raw '{"DocumentEntity":{"tenantIds":null,"document":{"filestoreId":{"fileStoreId":"fe264c03-76b3-49b8-ab78-81bfb95aee67"},"documentLink":""},"postedBy":"Trupti","uuid":"DOC-2021-11-12-000194","name":"Demo document creation updates=d","category":"CATEGORY_TENDERS","description":"We are looking to build a fully functional garbage disposal plant. We are looking to get it done in next 3 years with aggressive pricing and 10 years warranty and maintenance.","filestoreId":"fe264c03-76b3-49b8-ab78-81bfb95aee67","documentLink":"","active":true,"auditDetails":{"createdBy":"cf209669-88e4-4da8-951b-a0173b3edcae","lastModifiedBy":"cf209669-88e4-4da8-951b-a0173b3edcae","createdTime":1636701323373,"lastModifiedTime":1636701323373},"tenantId":"pb.amritsar","fileType":"application/pdf","fileSize":460618},"RequestInfo":{"apiId":"Rainmaker","authToken":"d06ff5e6-8929-44f2-8ae7-b67883db1bce","userInfo":{"id":18397,"uuid":"cf209669-88e4-4da8-951b-a0173b3edcae","userName":"TRUPTI","name":"Trupti","mobileNumber":"8970064765","emailId":"","locale":null,"type":"EMPLOYEE","roles":[{"name":"HRMS Admin","code":"HRMS_ADMIN","tenantId":"pb.derabassi"},{"name":"NoC counter employee","code":"NOC_CEMP","tenantId":"pb.amritsar"},{"name":"PT Field Inspector","code":"PT_FIELD_INSPECTOR","tenantId":"pb.nawanshahr"},{"name":"State Administrator","code":"STADMIN","tenantId":"pb.jalandhar"},{"name":"TL Field Inspector","code":"TL_FIELD_INSPECTOR","tenantId":"pb.amritsar"},{"name":"FSM Employee Application Creator","code":"FSM_CREATOR_EMP","tenantId":"pb.jalandhar"},{"name":"FSM Administrator","code":"FSM_ADMIN","tenantId":"pb.phagwara"},{"name":"NoC Doc Verifier","code":"NOC_DOC_VERIFIER","tenantId":"pb.nawanshahr"},{"name":"Counter Employee","code":"CEMP","tenantId":"pb.amritsar"},{"name":"WS Counter Employee","code":"WS_CEMP","tenantId":"pb.amritsar"},{"name":"NoC Field Inpector","code":"NOC_FIELD_INSPECTOR","tenantId":"pb.jalandhar"},{"name":"WS Field Inspector","code":"WS_FIELD_INSPECTOR","tenantId":"pb.amritsar"},{"name":"PT Doc Verifier","code":"PT_DOC_VERIFIER","tenantId":"pb.jalandhar"},{"name":"FSM Administrator","code":"FSM_ADMIN","tenantId":"pb.amritsar"},{"name":"Employee","code":"EMPLOYEE","tenantId":"pb.jalandhar"},{"name":"WS Field Inspector","code":"WS_FIELD_INSPECTOR","tenantId":"pb.jalandhar"},{"name":"WS Clerk","code":"WS_CLERK","tenantId":"pb.jalandhar"},{"name":"PT Doc Verifier","code":"PT_DOC_VERIFIER","tenantId":"pb.nawanshahr"},{"name":"PT Counter Approver","code":"PT_APPROVER","tenantId":"pb.jalandhar"},{"name":"TL Admin","code":"TL_ADMIN","tenantId":"pb.nawanshahr"},{"name":"TL Creator","code":"TL_CREATOR","tenantId":"pb.amritsar"},{"name":"TL Counter Employee","code":"TL_CEMP","tenantId":"pb.jalandhar"},{"name":"TL Approver","code":"TL_APPROVER","tenantId":"pb.nawanshahr"},{"name":"PT Counter Employee","code":"PT_CEMP","tenantId":"pb.jalandhar"},{"name":"FSM Employee Dashboard Viewer","code":"FSM_DASHBOARD_VIEWER","tenantId":"pb"},{"name":"Collection Operator","code":"COLL_OPERATOR","tenantId":"pb.jalandhar"},{"name":"NoC Field Inpector","code":"NOC_FIELD_INSPECTOR","tenantId":"pb.amritsar"},{"name":"SW Counter Employee","code":"SW_CEMP","tenantId":"pb.amritsar"},{"name":"Grievance Officer","code":"GO","tenantId":"pb.amritsar"},{"name":"SW Clerk","code":"SW_CLERK","tenantId":"pb.amritsar"},{"name":"FSM Employee Application Creator","code":"FSM_CREATOR_EMP","tenantId":"pb.amritsar"},{"name":"FSM Employee Report Viewer","code":"FSM_REPORT_VIEWER","tenantId":"pb.amritsar"},{"name":"FSM Employee Report Viewer","code":"FSM_REPORT_VIEWER","tenantId":"pb"},{"name":"SW Document Verifier","code":"SW_DOC_VERIFIER","tenantId":"pb.amritsar"},{"name":"WS Approver","code":"WS_APPROVER","tenantId":"pb.jalandhar"},{"name":"TL Approver","code":"TL_APPROVER","tenantId":"pb.amritsar"},{"name":"NoC Doc Verifier","code":"NOC_DOC_VERIFIER","tenantId":"pb.jalandhar"},{"name":"Employee","code":"EMPLOYEE","tenantId":"pb.nawanshahr"},{"name":"HRMS Admin","code":"HRMS_ADMIN","tenantId":"pb.jalandhar"},{"name":"SW Field Inspector","code":"SW_FIELD_INSPECTOR","tenantId":"pb.amritsar"},{"name":"FSM Employee Application Creator","code":"FSM_CREATOR_EMP","tenantId":"pb.phagwara"},{"name":"Customer Support Representative","code":"CSR","tenantId":"pb.amritsar"},{"name":"HRMS Admin","code":"HRMS_ADMIN","tenantId":"pb.amritsar"},{"name":"TL Approver","code":"TL_APPROVER","tenantId":"pb.jalandhar"},{"name":"WS Approver","code":"WS_APPROVER","tenantId":"pb.amritsar"},{"name":"PT Counter Employee","code":"PT_CEMP","tenantId":"pb.nawanshahr"},{"name":"NoC counter employee","code":"NOC_CEMP","tenantId":"pb.nawanshahr"},{"name":"WS Document Verifier","code":"WS_DOC_VERIFIER","tenantId":"pb.jalandhar"},{"name":"TL Field Inspector","code":"TL_FIELD_INSPECTOR","tenantId":"pb.nawanshahr"},{"name":"Counter Employee","code":"CEMP","tenantId":"pb.nawanshahr"},{"name":"PT Counter Employee","code":"PT_CEMP","tenantId":"pb.amritsar"},{"name":"PT Field Inspector","code":"PT_FIELD_INSPECTOR","tenantId":"pb.amritsar"},{"name":"TL Creator","code":"TL_CREATOR","tenantId":"pb.nawanshahr"},{"name":"Customer Support Representative","code":"CSR","tenantId":"pb"},{"name":"Grievance Officer","code":"GO","tenantId":"pb.nawanshahr"},{"name":"PT Doc Verifier","code":"PT_DOC_VERIFIER","tenantId":"pb.amritsar"},{"name":"Employee","code":"EMPLOYEE","tenantId":"pb.amritsar"},{"name":"TL Counter Employee","code":"TL_CEMP","tenantId":"pb.amritsar"},{"name":"HRMS Admin","code":"HRMS_ADMIN","tenantId":"pb"},{"name":"FSM Administrator","code":"FSM_ADMIN","tenantId":"pb.nawanshahr"},{"name":"WS Counter Employee","code":"WS_CEMP","tenantId":"pb.jalandhar"},{"name":"TL Creator","code":"TL_CREATOR","tenantId":"pb.jalandhar"},{"name":"Super User","code":"SUPERUSER","tenantId":"pb"},{"name":"Universal Collection Employee","code":"UC_EMP","tenantId":"pb.amritsar"},{"name":"PT Field Inspector","code":"PT_FIELD_INSPECTOR","tenantId":"pb.jalandhar"},{"name":"State Administrator","code":"STADMIN","tenantId":"pb.amritsar"},{"name":"PT Counter Approver","code":"PT_APPROVER","tenantId":"pb.amritsar"},{"name":"TL Field Inspector","code":"TL_FIELD_INSPECTOR","tenantId":"pb.jalandhar"},{"name":"TL doc verifier","code":"TL_DOC_VERIFIER","tenantId":"pb.nawanshahr"},{"name":"WS Clerk","code":"WS_CLERK","tenantId":"pb.amritsar"},{"name":"Counter Employee","code":"CEMP","tenantId":"pb.jalandhar"},{"name":"NoC Doc Verifier","code":"NOC_DOC_VERIFIER","tenantId":"pb.amritsar"},{"name":"NoC counter employee","code":"NOC_CEMP","tenantId":"pb.jalandhar"},{"name":"WS Document Verifier","code":"WS_DOC_VERIFIER","tenantId":"pb.amritsar"},{"name":"Grievance Officer","code":"GO","tenantId":"pb.jalandhar"},{"name":"NoC Field Inpector","code":"NOC_FIELD_INSPECTOR","tenantId":"pb.nawanshahr"},{"name":"FSM Administrator","code":"FSM_ADMIN","tenantId":"pb.derabassi"},{"name":"Super User","code":"SUPERUSER","tenantId":"pb.nawanshahr"},{"name":"FSM Employee Application Creator","code":"FSM_CREATOR_EMP","tenantId":"pb.nawanshahr"},{"name":"FSM Administrator","code":"FSM_ADMIN","tenantId":"pb"},{"name":"State Administrator","code":"STADMIN","tenantId":"pb.nawanshahr"},{"name":"PT Counter Approver","code":"PT_APPROVER","tenantId":"pb.nawanshahr"},{"name":"Collection Operator","code":"COLL_OPERATOR","tenantId":"pb.amritsar"},{"name":"TL doc verifier","code":"TL_DOC_VERIFIER","tenantId":"pb.amritsar"},{"name":"FSM Administrator","code":"FSM_ADMIN","tenantId":"pb.jalandhar"},{"name":"TL Counter Employee","code":"TL_CEMP","tenantId":"pb.nawanshahr"},{"name":"TL Admin","code":"TL_ADMIN","tenantId":"pb.amritsar"},{"name":"Super User","code":"SUPERUSER","tenantId":"pb.jalandhar"},{"name":"Property Tax Collection Employee","code":"PT_COLLECTION_EMP","tenantId":"pb.amritsar"},{"name":"NoC counter Approver","code":"NOC_APPROVER","tenantId":"pb.amritsar"},{"name":"TL doc verifier","code":"TL_DOC_VERIFIER","tenantId":"pb.jalandhar"},{"name":"Collection Operator","code":"COLL_OPERATOR","tenantId":"pb.nawanshahr"},{"name":"Super User","code":"SUPERUSER","tenantId":"pb.amritsar"},{"name":"FSM Employee Dashboard Viewer","code":"FSM_DASHBOARD_VIEWER","tenantId":"pb.amritsar"},{"name":"Super User","code":"SUPERUSER","tenantId":"pb.derabassi"},{"name":"SW Approver","code":"SW_APPROVER","tenantId":"pb.amritsar"},{"name":"TL Admin","code":"TL_ADMIN","tenantId":"pb.jalandhar"}],"active":true,"tenantId":"pb.amritsar","permanentCity":null}}}' \
--compressed
Delete Documents
Employees can remove documents from the listing by navigating to the inbox → selecting the document → moving to the document details page → clicking on the take action button and then the Delete option. A prompt screen asks for confirmation of the action and on selecting Yes Delete the selected document is deleted.
Citizen Screens
Citizens can view all uploaded documents on information & updated section on the home page. Here, all the categories are listed and also enable search by document title. Selecting any category fetches all the documents for the selected category.
Citizens can view, open or download the uploaded documents or the link.
MDMS contains and fetches the static data like forms config and Document Categories.
MDMS KEYS: API + "DocumentUploader", ["UlbLevelCategories"]
Localization
Localization keys are added under the ‘rainmaker-common’ locale module. In future, if any new labels are implemented in the Trade License (Citizen) these should also be pushed to the locale DB under rainmaker-tl locale module. Below is an example of a few locale labels.