Install and configure WorkZone Teams

Prerequisite:

  • WorkZone Teams app is currently supported with WorkZone Cloud Edition only.
  • Your organization must use Entra ID.

The installation process consists of three parts:

  1. Installing WorkZone Teams on the server.
  2. Installing WorkZone Teams on the client.
  3. Updating the Cross Origin Resource Sharing (CORS) in OData

Installing WorkZone Teams on the server

WorkZone Teams server-side application is hosted in cloud and deployed by the KMD technicians.

Installing WorkZone Teams on the client

Prerequisite: You must have the appPackage.zip app manifest (provided by the KMD technicians).
  1. Start Microsoft Teams (either the web version or the desktop version).
  2. Upload the WorkZone Teams app. See Upload your custom app in Microsoft Teams article from Microsoft.
  3. Publish the WorkZone Teams app to your organization. See Publish your app to your org article from Microsoft.

Updating the Cross Origin Resource Sharing (CORS) in OData

After installing the WorkZone Teams, add it to the allowed Cross Origin Resource Sharing (CORS) origins in OData by editing the

C:\Program Files (x86)\KMD\WorkZone\IIS\WorkZone\OData\web.config

file on the server with WorkZone. Add the WorkZone Teams URL to the existing values under:

<add key="allowCorsOrigin" value="[WorkZone Teams_URL]" />

(where "[WorkZone Teams_URL]" is the actual URL). See AllowedCorsOrigins parameter in the Command line configuration for more information about allowing specific origins of the web client to be accessed.

Upgrade WorkZone Teams

If you are upgrading from earlier versions, uninstall the old version of WorkZone Teams before installing the new version.