SafeWorkplace-ContactTracing

KO | EN

gitlite — search

#android #docker #javascript #python #cli #nodejs #html5 #game #scala #golang #bot #statistics

SafeWorkplace-ContactTracing

★ 10 Open GitHub ↗

Contact Tracing App to help business maintain a safe office workplace by tracing and identifying the employees and visitors who have come in contact with someone tested positive for COVID.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Safe Workplace Contact Tracing App – Power Platform Solution

[![GitHub Release Date](https://img.shields.io/github/release-date/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing?label=Released&style=for-the-badge)](https://github.com/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/releases)
[![GitHub labels](https://img.shields.io/github/labels/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/bug?label=Report%20Issues&style=for-the-badge)](https://github.com/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/issues/new?assignees=Adramca&labels=bug%2C+under+review&template=bug_report.md)
[![Twitter Follow](https://img.shields.io/twitter/follow/akaesny?color=blue&label=Click%20Here%20Follow%20us&style=for-the-badge)](https://twitter.com/akaesny)

[![GitHub All Releases](https://img.shields.io/github/downloads/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/total?color=green&style=for-the-badge&label=💻1.Download%20Core%20Package)](https://github.com/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/releases/latest/download/ContactTracing_Core_Managed.zip)

[![GitHub All Releases](https://img.shields.io/github/downloads/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/total?color=green&style=for-the-badge&label=📲2.Download%20Mobile%20Package)](https://github.com/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/releases/latest/download/SafeWorkplace_CanvasApp.zip)

## Overview

In response to COVID-19, the Safe Workplace Contact Tracing application is a solution that provides SMB organizations with the ability to track the location of both employees and visitors while they are physically on company premises. As this information is collected, Human Resource departments, when required, can provide accurate tracing of all locations visited by an employee or a visitor due to COVID-19 concerns.

The Safe Workplace Contact Tracing App features include the following:

- Ability to configure location zones, so employees can easily identify areas where they will have the ability to report their location
- Provide employees with the ability to easily report their whereabouts, selecting the zone where they are at any point in time,as well as their movements across different zones on company premises
- Provide functionality for HR resources to track visitors’ locations while on premises, and to capture basic information about them and their health for reporting purposes  
- Ability for employees or HR users assisting visitors entering company premises, to complete required survey certifying overall health
- Provide the HR department with the functionality needed to effectively inquire and report on an employee’s whereabouts,interactions and location/contact tracing data

## Navigating the App

- Download and deploy the Safe Workplace Model Driven App (Admin)
- Download and deploy the Safe Workplace CanvasApp (Employee)
- Use the Model Driven App to manage master data and dashboards (Human Resource Admin)
- Use the mobile CanvasApp to track employee location and presence (Business Admin)
- Use the mobile CanvasApp to record employee health (Business Admin/Employee)
- Use the Model Driven App to report employee and visitor health status and presence (Human Resource Admin)
- Use the Model Driven App to create visitor contact & health information, and report health updates & presence (Human Resource designated Coordinators)

## Demo Videos

> Click 👇 to see the demo videos (`ctrl + click` to open in Vimeo)

Employee | Coordinator | HR / Admin
------------ | ------------- | -------------
[<img src="https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/VideoImage_Employee.png" width="200">](https://vimeo.com/430412668) | [<img src="https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/VideoImage_Coordinators.png" width="200">](https://vimeo.com/432872258) | [<img src="https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/VideoImage_Admin.png" width="200">](https://vimeo.com/432867472)

## Deploying Safe Workplace Contact Tracing App

This document provides step by step instructions to setup the Safe Workplace App.

### Step 1. Download the Deployment Packages

Download the latest deployment packages

1. Core (Model-driven App) Package 👉 [![Download Contact Tracing Solution](https://raw.githubusercontent.com/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/master/assets/icons/DownloadButton.svg)](https://github.com//AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/releases/latest/download/ContactTracing_Core_Managed.zip)

2. Canvas App Package 👉 [![Download Contact Tracing Solution](https://raw.githubusercontent.com/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/master/assets/icons/DownloadButton.svg)](https://github.com//AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/releases/latest/download/SafeWorkplace_CanvasApp.zip)

### Step 2. Sign Up for Power Apps and Create an Environment

If you do not already have Power Apps, sign up for Power Apps and
purchase an appropriate license.  Additional information regarding
purchasing Power Apps and Licensing can be access here:

- [Power Apps Pricing](https://powerapps.microsoft.com/pricing/)

- [Purchase Power Apps](https://docs.microsoft.com/power-platform/admin/signup-for-powerapps-admin)

Once you have purchased Power Apps, create an environment with a Common
Data Service database.

1. Sign into [Power Platform Admin Center](https://aka.ms/ppac)

2. Create a Common Data Service environment with the database. For  more information, see [Create and Manage Environments](https://docs.microsoft.com/en-us/power-platform/admin/create-environment)

> [NOTE] While creating the database, if you select a security group for the database, the apps can be shared only with users who are members of the security group.

3. Create appropriate users in your environment. For more information, see [Create Users and Assign Security Roles](https://docs.microsoft.com/en-us/power-platform/admin/create-users-assign-online-security-roles)

![IMG1](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2001.png)

### Step 3. Install the Apps

Follow the steps before installing and configuring the Safe Workplace Tracing App

*Install the app using the deployment packages*

1. Navigate to the location where you downloaded the deployment packages.

2. Go to <https://make.powerapps.com> and login, if needed, with your admin credentials to the environment

![IMG2](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2002.png)

3. Click on **Solutions** from the left navigation

![IMG3](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2003.png)

4. Click on **Import** from top ribbon. This will open a pop-up window, where you select **Solution Package**

![IMG4](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2004.png)

5. Select *Choose file* and navigate to the location of package named "**ContactTracing_Core_Managed.zip**"

6. Ensure the solution name is correct and select **Next**

![IMG5](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2005.png)

7. On the next window, select the "*Enable any SDK message…*" checkbox. Then click on **Import**

![IMG6](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2006.png)

8. The import process will start running

9. *(optional)* After the import is complete, select *Download Log File* and save it. This is just for future reference should any issues arise. Finally, select **Close**

![IMG7](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2007.png)

10. You should now see "*Safe Workplace – Contact Tracing*" on the list of installed solutions

![IMG8](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2008.png)

11. Click on **Apps** in the left navigation pane to access the apps installed. The Safe Workplace Admin app should now be listed

12. Click on Import Canvas App on the top menu

![Step12](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Step12.png)

13. Choose the package file to import. Make sure you select the "**SafeWorkplace_CanvasApp.zip**" file from the location where you downloaded the packages

![Step13](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Step13.png)

14. Once the upload is completed, the following validation page is displayed

![Step14](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Step14.png)

15. Click on the action icon next to the item marked with a *red exclamation icon* to setup the common data service connection for the Canvas App. Once the icon is clicked, the *Import Setup* form is displayed

![Step15](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Step15.png)

16. Click the "**Create New**" button. This will open a new browser window. Click the "**Create a Connection button**" there. This will open the new connection form to choose a Connection for creation

![Step16](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Step16.png)

17. Select the Common Data Service option. Click the "+" icon on the right. On the confirmation message to request creation, click the "*CREATE*" button. The following message is displayed

![Step17](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Step17.png)

18. The application might ask you to login to your environment. Once the process is completed, the data connection is added

![Step18](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Step18.png)

19. Go back to the import setup. The newly created connection should be there. Select it and then click **SAVE**

![Step19](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Step19.png)

20. The Related resource for data connection is now resolved, the import button should be enabled now. Click **IMPORT**

21. Once the import is completed, the following message should be displayed

![Step21](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Step21.png)

22. Click the Apps button again. The Safe Workplace Canvas App should now be displayed.

![IMG9](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2009.png)

Installation will add the configuration for the Safe Workplace Contact Tracing app

Select the Admin App to open the model driven app that lets you configure the remainder of the deployment settings.  The admin app has several entities that allow you to add and manage data for your system.  You can use the area picker in the lower part of the left navigation pane to select a different area (Safe Place or Administration). Please review the demo of the solution for more infromation on how to use the Administration options of the app.

![IMG10](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2010.png)

### Step 4: Update the App Branding and Tracking Level

You can change the app icon or display name of the Admin and mobile apps
to match the branding of your organization.

1. Select the Safe Workplace Admin App on the list of apps. Click on the Settings option on the main navigation menu on the top left navigation

![IMG11](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2011.png)

2. The App settings form will open on the right side of the screen.

3. Click on the **Edit App Name** link. This will open the app designer form

![IMG12](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2012.png)

4. Click on the Properties Tab of the App details section. The following elements can be changed:
    1. To select a custom image for the app icon as per your organization branding, uncheck the "*Use Default Image*" checkbox and then select the icon file of your choice

2. If necessary, update the Description or Display Name of the app

3. Select **Save and Close and then Publish**

![IMG13](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2013.png)

To update the App Name and sharing settings for the mobile app, follow these steps

1. Select the Safe Workplace App on the list of apps. Click the Settings option on the main navigation menu on the top left navigation

2. The App settings form will open on the right side of the screen.

3. Click on the **Edit App Name** link and then enter the new App Name.

4. Select **Yes or No** in the Pass Assignment option to allow the app to be shared with users without a Per user Plan

5. Select **Save** in the lower-right corner to save changes

### Step 5: Add Azure Application Insights Key to Mobile Apps for Telemetry (Optional)

Optionally, you can use Azure Application Insights to collect detailed telemetry for your mobile apps (canvas apps) to get insights on the app usage. For additional information, see [Analyze app telemetry using Application Insights](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/application-insights).

### Step 6: Share Canvas App with Users in the Organization

For employees to use the canvas app on their mobile devices, the app must be shared with them.  It is easier to use Azure AD groups to easily share apps with groups of users.

> NOTE: Make sure the user and/or group already has access to the environment. Typically, you would have already added users or groups while setting up your environment. You can also follow the steps below to add users to your environment and provide the correct access before sharing. For more information on how to create users and assign security see [Create Users and Assign Security Roles](https://docs.microsoft.com/en-us/power-platform/admin/create-users-assign-online-security-roles)

1. Sign into [Power Apps](https://make.powerapps.com/)

2. Select **Apps** to view list of Apps

3. Select the mobile app then select **Share**

![IMG14](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2014.png)

4. You can share the app with all the users in your tenant, by using "*Everyone*" as the option to choose users, but this will not allow you to assign security roles. In order to assign security roles, you need to select Azure AD group or individual users that the app will be shared with, in order to be able to select the proper security role for them

![IMG15](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2015.JPG)

> NOTE: Read more about [Safe Workplace security roles](https://github.com/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing#security-role-definations)

5. Next, permission to the entities will need to be provided. To assign the respective user role necessary, first select the Common Data Service User role. You can then assign the applicable role for the user, Safe Workplace Super User, Safe Workplace Coordinator, or Safe Workplace Employee)

![IMG16](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2016.png)

![IMG17](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2017.png)

![IMG18](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2018.png)

### Step 7: Pin Mobile App to Home Screen on your Phone (Optional)

As an option you can pin your mobile app to your home screen, to avoid the need to open the Power Apps application to access the Safe Workplace App. To do so, follow these steps

1. Open your Power Apps application on your mobile device

2. The Safe Workplace App should be listed, Click **"…"** icon. The following options should be displayed at the bottom: Details, Open, Pin to Home, Favorite

![IMG19](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2019.jpg)

3. Click **Pin to Home** option

![IMG20](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2020.jpg)

4. Then, click the Icon indicated here to add the app to the home screen

![IMG21](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2021.jpg)

5. Click the **add to home screen** option as shown on the image

![IMG22](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2022.jpg)

6. Click the **add** option. Once completed, the app will be displayed as any other icon on the home screen of your mobile device

![IMG23](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2023.jpg)

### Step 8: Share the Model Driven App with Organization Admins

The Model Driven app must be shared with organization admins for use. To do so, be sure the user and/or group to which the app is being shared already has access to the environment.

1. Sign into [Power Apps](https://make.powerapps.com/)

2. Select **Apps** to view a full list of Apps

3. Select **Model Driven App** and select **Share**

4. Specify the Azure AD group or admin users the app will be shared with.  Assign the Safe Workplace Super User (Admin) security role and share

### Step 9: Set Flows Connections and Enable them for Execution

You must set the connections and enable the following flows to help with various processes in the solution. The following flows will need to go through the steps indicated below:
  
- CDS: Flow > Automated Presence Checkout
- CDS: Flow > Health Notification to HR
- CDS: Flow > Set Preferred location in Contact

Follow these steps:

1. Sign into [Power Automate](https://flow.microsoft.com/)

2. Go to the Environment drop down selection located on the top right corner of the form, and click it to select the proper environment where the application has been installed.

3. In the left pane select **Solutions**. From the solution list, select **Safe Workplace - Core** to open solution.

![IMG24](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2024.png)

4. In the solution, filter on **Flow** to find all the flows.

![IMG25](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2025.png)

5. Select the flow name to open the flow definition. For example, **CDS: Flow > Automated Presence Checkout**

6. Double click on the flow name to open it. which will take you to the details form.  It should look like this

![IMG26](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2026.png)

7. Click the **Edit** button on the menu. A screen confriming the connections for the flow will be displayed. It will look like this:

![IMG27](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2027.png)

8. Click **Continue** to update all your connections, click **Save** to save the changes to the flow, then click the **Back** arrow to go back to the flow details page

![IMG28](https://aka-enterprise-solutions.github.io/SafeWorkplace-ContactTracing/assets/screenshots/Safe%20Workplace%20IMG%2028.png)

9. Select **Turn On** and then close the browser session for the flow being edited. the flow is now active.

10. Perform steps 4-8 for each of the flows listed above

> NOTE: An additional change that could be done by an administrator user is to update the “delay until 4.5 hours” step in the flow, which is now set to wait for that specific period of time before emails are triggered, reminding the users to checkout of zones they have not done so for a while. User can open the flow step and change the value to any other amount of time that makes sense according to their company policies. Save the changes made to the flow

### Step 10: Prepare the apps for testing and use

Once the installation is completed, there are a couple of setup steps you need to follow in order to allow the users to start using the app right away. For users to be able to report their presence, locations and zones need to be configured. To do so, follow these steps:

- Create a New Location Record
  
On the administration section, users will find the location option under the master details section. To create a new location, follow these steps:

1. Click on the Locations options
2. The system will display the active locations view, with the list of all locations created
3. To edit one of the existing locations, select the location record and click on the Edit button. This will open the Location information form. Make any changes and then Save the changes
4. To create a new Location, click on the “+ New” button. This will open a brand-new location information form
5. Provide a name. This is the only required field
6. Enter the address details for the location (optional)
7. Click on the save and close button

- Create a New Zone Record

On the administration section, users will find the zones option under the master details section. To create a new zone, follow these steps:

1. Click on the Zones options
2. The system will display the active zones view, with the list of all zones created
3. To edit one of the existing zones, select the zone record and click on the Edit button. This will open the zone information form. Make any changes and then Save the changes
4. To create a new zone, click on the “+ New” button. This will open a brand-new zone information form
5. Provide a name.
6. Select the location for the zone. Click on the lookup to see the list of active locations and select one
7. Enter the capacity and exposure level values(optional)
8. Click on the save and close button

> NOTE: Please review the [HR Admin Video](https://vimeo.com/432867472) to get more details on how to setup these items.

### Security Role Definations

- Safe Workplace Super User
  - Super user role provides access to all entities, health dashboards related to Safe Workplace App. User can run "*Contact Tracing*" and "*Employee Zone*" reports.
  - With this role, users can create/update/deactivate following entites: Tracer Contacts, Presences, Locations, Zones, Health Questionnaries and Health Changes.
  - Super user also receive email notifications when heath changes are reported.

- Safe Workplace Coordinator
  - This role has create/update permissions to following entities: Tracer Contacts (with type Guest), Presenses, Health Questionnaries and Health Changes
  - Coordinator role can check-in Guests to company Locations and record a Guest’s presence within a location by identifying the Zone a Guest enter and exit on a given date and within a given time.
  - Coordinator can create Health Questionnaires to track a Guest’s health and report any changes in their health via the Health Change entity
  - Coordinator cannot modify employee – related records or run tracing reports

- Safe Workplace Employee
  - Employee users only have access to the mobile app to document their presence within the organization’s location and zone by checking in and checking out of a selected location.
  - An Employee can record their health status via the Health Questionnaire and report an illness, using the canvas app as well.

### Bypassing Consent

Once your Canvas App is installed you may observe that each users need to provide consent on the connectors. This can be bypassed by executing a PowerShell command by the admin.

Open "*Windows PowerShell ISE*" and copy-paste below command. Click execute command button.

`Install-Module -Name Microsoft.PowerApps.Administration.PowerShell`

`Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber`

`Set-AdminPowerAppApisToBypassConsent -AppName {APPID}`

Replace {APPID} with the App Id of "*Safe Workplace*". To know more on [getting your App Id](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/get-sessionid#get-an-app-id)

### Issues and Feedback

To report any issues or provide feedback regarding the Safe Workplace Contact Tracing App, [click here](https://github.com/AKA-Enterprise-Solutions/SafeWorkplace-ContactTracing/issues/new?assignees=Adramca&labels=bug%2C+under+review&template=bug_report.md)

SafeWorkplace-ContactTracing

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README