{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":9750,"path":"employee-service-management/emergency-self-report/set-up-emergency-self-report.md","title":"Set up Emergency Self Report","bundle":null,"doc_type":null,"release":"australia","body":"\n# Set up Emergency Self Report\n\nTo set up Emergency Self Report, install the application. Then configure user access, a dedicated knowledge base, and system properties.\n\n**Parent Topic:**[Emergency Self Report](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/employee-service-management/emergency-self-report/emergency-self-report.md)\n\n## Install Emergency Self Report\n\nYou can install Emergency Self Report if you have the admin role.\n\n### Before you begin\n\nRole required: admin\n\n<table id=\"table_kxr_yz3_blb\"><thead><tr><th>\n\nType\n\n</th><th>\n\nInstructions\n\n</th></tr></thead><tbody><tr><td>\n\nCommercial on-premise\n\n</td><td>\n\nVisit the ServiceNow® Store to download and install the application.\n\n</td></tr><tr><td>\n\nFederal hosted\n\n</td><td>\n\nSee the [Federal downloads for the Emergency Response Management and Safe Workplace suite apps \\[KB0030260\\]](https://store.servicenow.com/$appstore.do#!/store/help?article=KB0030260) article in the Store Help Center for more information.\n\n</td></tr><tr><td>\n\nFederal on-premise\n\n</td><td>\n\nIf you are a federal on-premise customer and you would like to install this application, reach out to your sales representative or open a Now Support or HIWAVE ticket. In the ticket, request to be routed to the SHOT team.\n\n See the [Federal downloads for the Emergency Response Management and Safe Workplace suite apps \\[KB0030260\\]](https://store.servicenow.com/$appstore.do#!/store/help?article=KB0030260) article in the Store Help Center for more information.\n\n</td></tr><tr><td>\n\nOn-premise\n\n</td><td>\n\nSee the [Commercial downloads for the Emergency Response Management and Safe Workplace suite apps \\[KB0030258\\]](https://store.servicenow.com/$appstore.do#!/store/help?article=KB0030258) article in the Store Help Center for more information.\n\n</td></tr></tbody>\n</table>If you've subscribed to the Safe Workplace suite and you already have some of the apps installed, refer to the following order of installation for the remaining apps.\n\n-   Emergency Outreach \\(sn\\_imt\\_checkin\\)\n-   Employee Health Screening \\(sn\\_imt\\_monitoring\\)\n-   Workplace PPE Inventory Management \\(sn\\_imt\\_ppe\\)\n-   Employee Readiness Surveys \\(sn\\_imt\\_readiness\\)\n-   COVID-19 Global Health Data Set \\(sn\\_imt\\_c19datafeed\\)\n-   Contact Tracing \\(sn\\_imt\\_tracing\\)\n-   Emergency Self Report \\(sn\\_imt\\_quarantine\\)\n-   Workplace Core \\(sn\\_wsd\\_core\\)\n-   Safe Workplace Dashboard \\(sn\\_imt\\_dashboard\\)\n-   Emergency Response Management for Now Mobile \\(sn\\_imt\\_mobile\\)\n-   Employee Travel Safety \\(sn\\_imt\\_travel\\)\n-   Health and Safety Testing \\(sn\\_imt\\_health\\_test\\)\n-   Vaccination Status \\(sn\\_imt\\_vaccine\\)\n\n### Procedure\n\n1.  Navigate to **System Applications** &gt; **All Available Applications** &gt; **All**.\n\n2.  Search for `Emergency Self Report`.\n\n3.  Click **Install**.\n\n    The Application installation dialog box opens.\n\n4.  Load the demo data by selecting the **Load demo data** check box.\n\n    For information about how to install or reinstall demo data after the initial installation, see the [Work around to install demo data if application is already installed \\[KB0722909\\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0722909) article in the Now Support Knowledge Base.\n\n5.  Click **Install**.\n\n6.  When the installation is complete, click **Close**.\n\n\n### Result\n\nThe Emergency Self Report application is installed on your instance.\n\n## Components installed with Emergency Self Report\n\nSeveral types of components are installed with Emergency Self Report, including tables and user roles.\n\n**Note:** The Application Files table lists the components that are installed with this application. For instructions on how to access this table, see [Find components installed with an application](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/find-components.md).\n\nDemo data is available for this feature.\n\n### Roles installed\n\n<table id=\"table_u1t_gb1_wdb\"><thead><tr><th>\n\nRole title \\[name\\]\n\n</th><th>\n\nDescription\n\n</th><th>\n\nContains roles\n\n</th></tr></thead><tbody><tr><td>\n\nSelf report user \\[sn\\_imt\\_quarantine.crisis\\_task\\_user\\]\n\n</td><td>\n\nAccess the Emergency Self Report Dashboard to report health status.\n\n</td><td>\n\nnotify\\_view\n\n</td></tr><tr><td>\n\nCrisis task users\\[sn\\_imt\\_quarantine.humanResourceTeam\\]\n\n</td><td>\n\nView and manage HR tasks, submit updates for other users, and import crisis tasks.\n\n Also grant the self report user role.\n\n</td><td>\n\nnotify\\_view\n\n</td></tr></tbody>\n</table>### Tables installed\n\n<table id=\"table_fbz_45z_vdb\"><thead><tr><th>\n\nTable\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nCrisis Task\\[sn\\_imt\\_quarantine\\_crisis\\_task\\]\n\n</td><td>\n\nContains all self report crisis tasks, including HR crisis tasks.\n\n</td></tr><tr><td>\n\nCrisis Task Status Log\\[sn\\_imt\\_quarantine\\_crisis\\_task\\_status\\_log\\]\n\n</td><td>\n\nContains a history of all reported health statuses for each user. This table is only populated when the **sn\\_imt\\_quarantine.enable.health.status.log** property is set to `true`.\n\n</td></tr><tr><td>\n\nBulk Import Crisis Tasks\\[sn\\_imt\\_quarantine\\_bulk\\_load\\_crisis\\_task\\]\n\n</td><td>\n\nThe Import Set table for importing reported health statuses from an Excel spreadsheet to create crisis tasks in bulk. When you load data from the Excel file into the application, the imported records are first saved in this import set table. After you run the transform or execute the scheduled import script, the records are copied to the Crisis Task table.\n\n</td></tr></tbody>\n</table>## Configure Emergency Self Report\n\nConfigure Emergency Self Report to align with your business needs.\n\n### Before you begin\n\nRole required: admin\n\n### About this task\n\nComplete the following configurations as needed.\n\n-   Grant app access to the appropriate response team members.\n-   Specify custom system messages to help your users and response team members.\n-   Set system properties to control how you use Emergency Self Report.\n-   Configure user health status choices.\n-   Create a dedicated knowledge base and add it to your Service Portal.\n\n### Procedure\n\n1.  Add the default application user roles to appropriate groups.\n\n    The application provides the following default roles in the sys\\_user\\_role table:\n\n    -   **sn\\_imt\\_quarantine.crisis\\_task\\_user**\n\n        Enables group members or individuals to submit a health alert for themselves. Managers can also submit and monitor alerts for their direct reports.\n\n    -   **sn\\_imt\\_quarantine.humanResourceTeam**\n\n        Enables group members, such as HR or Global Security team members, to manage the reported health alerts.\n\n    For information about how to assign roles to groups, see [Roles](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/t_AssignRoleToGroup.md).\n\n2.  Navigate to **Emergency Self Report** &gt; **UI Configuration**, set the desired message values, and then click **Update**.\n\n<table id=\"table_bj4_pmr_llb\"><thead><tr><th>\n\nProperty name\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nsn\\_imt\\_quarantine.crisisSubmitMessage\n\n</td><td>\n\nConfigure the message that is displayed to users after they submit a health status.\\[Omitted image \"emergency-self-report-message-example.png\"\\] Alt text: Sample information message.\n\n</td></tr><tr><td>\n\nsn\\_imt\\_quarantine.openTasksInfoMessage\n\n</td><td>\n\nConfigure a tooltip for managers who are viewing open tasks for their direct reports.\\[Omitted image \"emergency-self-report-direct-report-msg.png\"\\] Alt text: Message for My direct reports' open tasks.\n\n</td></tr></tbody>\n</table>3.  Navigate to **Emergency Self Report** &gt; **Emergency Self Report Properties**, set the desired property values, and then click **Update**.\n\n<table id=\"table_mzp_gjr_1lb\"><thead><tr><th>\n\nProperty name\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nsn\\_imt\\_quarantine.enable.health.status.log\n\n</td><td>\n\nWhen this property is set to `true`, a new record is created in the Crisis Task Status Log table \\[sn\\_imt\\_quarantine\\_crisis\\_task\\_status\\_log\\] every time that a user health status update is submitted. Crisis task records have a Crisis Task Status Logs related list that shows all health status updates for that crisis task. When this property is set to `false`, the Crisis Task Status Log table is not populated.The default value is `false`.\n\n</td></tr><tr><td>\n\nsn\\_imt\\_quarantine.data.retention.period\n\n</td><td>\n\nSets the number of days that records are stored in the Crisis Task Status Log table \\[sn\\_imt\\_quarantine\\_crisis\\_task\\_status\\_log\\] before they are deleted.The default value is 30 days.\n\n</td></tr><tr><td>\n\nsn\\_imt\\_quarantine.fetchTaskQuery\n\n</td><td>\n\nDetermines the data that is visible in the Emergency Self Report dashboard in the My direct reports' open tasks section.\n\n The default value is to show only P1 and P2 requests, incidents for the last month, and those assigned to the manager's direct reports:\n\n ```\nsys_created_on>=javascript:gs.beginningOfLastMonth()\n^active=true^assigned_to.managerDYNAMIC90d1921e5f510100a9ad2572f2b477fe\n^sys_class_name=incident^ORsys_class_name=sc_task\n^ORsys_class_name=sc_request^priorityIN1,2\n```\n\n</td></tr><tr><td>\n\nsn\\_imt\\_quarantine.healthStatusChangeTaskBehavior\n\n</td><td>\n\nSets the behavior of crisis tasks for users who update their health status after their most recent crisis task is closed. When the value is `update`, the user’s most recent HR crisis task is reopened and their health status is updated with their new reported status. When the value is `create`, a new HR crisis task is created if an open one doesn’t already exist for the user's newly reported status.\n\n The default value is `update`.\n\n</td></tr><tr><td>\n\nsn\\_imt\\_quarantine.healthStatusesToTriggerTaskReopen\n\n</td><td>\n\nSets the health statuses that reopen tasks or create new tasks if reported by a user after their most recent crisis task is closed. By default, the statuses that reopen or create new tasks are **In quarantine** and **Reporting symptoms**.\n\n</td></tr><tr><td>\n\nsn\\_imt\\_quarantine.hrGroup\n\n</td><td>\n\nMembers of the global response team, who will have access to your team's user records. You can add a role to a group to act as a global response team or you can add the role directly to the users.\n\n</td></tr><tr><td>\n\nsn\\_imt\\_quarantine.MaxOrgLevelLimit\n\n</td><td>\n\nNumber of levels in your organization structure. For example, If you have CEO, VP, Director, Manager, and Individual Contributors, you have five levels in your organization structure.\n\n</td></tr><tr><td>\n\nsn\\_imt\\_quarantine.outSickDuration\n\n</td><td>\n\nThe time frame \\(in days\\) after which users are safe to return to work if sick.The default value is 20 days.\n\n</td></tr><tr><td>\n\nsn\\_imt\\_quarantine.quarantineDuration\n\n</td><td>\n\nThe time frame \\(in days\\) after which users are safe to return to work if self-quarantined.The default value is 14 days.\n\n</td></tr></tbody>\n</table>4.  Configure the check-in choices that the user can select.\n\n    1.  Navigate to **System Definition** &gt; **Choice Lists**.\n\n    2.  Set a search filter with the following conditions:\n\n        -   **\\[Table\\] \\[is\\] \\[sn\\_imt\\_quarantine\\_crisis\\_task\\]**\n        -   **\\[Element\\] \\[is\\] \\[request\\_type\\]**\n    3.  Change the label or value for choices in the list, or add new values.\n\n    4.  Click **Update**.\n\n5.  Configure knowledge articles about the emergency event.\n\n    For example, provide local regulations, organization policies, and how-to information.\n\n    1.  Create a knowledge base to contain the application's articles.\n\n    2.  Navigate to **Service Portal** &gt; **Pages**.\n\n    3.  Search for ID `self_report_dashboard` and click the record.\n\n    4.  Click the **Emergency Self Report - Container 2** link.\n\n    5.  Under Column 2, click **Instance of Simple List**.\n\n    6.  On the Table &amp; Filter tab, name the knowledge base by setting the following filter condition: **\\[Knowledge Base\\] \\[is\\] \\[&lt;name&gt;\\]**.\n\n    7.  Associate application articles with the application knowledge base.\n\n\n"}}