WorkZone Teams

Prerequisite:
  • The WorkZone Teams app is currently only supported on WorkZone Cloud Edition.
  • Your organization must use Entra ID in order to use Microsoft Teams with WorkZone.
  • You must have the WorkZone Teams application installed and configured. See Install WorkZone Teams.

The WorkZone Teams app allows you to work with WorkZone directly from Microsoft Teams. With WorkZone Teams, you can add WorkZone cases as custom tabs to Microsoft Teams and collaborate on them directly from your Teams channels or private chats.

  • You can add up to 16 WorkZone cases as custom tabs in Teams. Each tab will display the selected WorkZone case and all of its documents, including their most important details, such as document ID, title, type, and state.

Add a WorkZone tab to the Teams chat or channel

Note: Only team owners and members can add new tabs to a channel or a chat.
  1. In Teams, open a channel or a private chat.
  2. On the navigation ribbon of this channel or chat, click Add a tab +.
  3. In the Add a tab dialog, select WorkZone Teams from the list of available custom tabs.
  4. In the WorkZone Teams dialog, provide your WorkZone server address, select a WorkZone case to add as a custom tab, and click Save.
    Tip: You can select a WorkZone case from the drop-list or search for it (the search covers only your most recently used cases) by typing relevant search criteria.

    The selected WorkZone case will appear on this Teams channel or chat as a custom tab. You can rename it as needed (this name change will apply only to the selected custom tab in Teams, it will not affect the case title in WorkZone).

    Tip: Click the case title at the top of the WorkZone tab to open this case in WorkZone Client.

Configure the displayed columns

You can select which columns to display, sort them by content, and adjust their width and order for each case opened in the custom WorkZone tab. You can display different columns for each WorkZone custom tab. Your custom column settings are stored locally in the browser, which means that they will disappear if you use a different browser or clear the browsing data.

  1. In Teams, open the relevant WorkZone custom tab.
  2. In the top right corner of the case title, click . The Column settings dialog with the list of all available columns is then displayed.
  3. Add, remove, resize, or reorder the columns as needed.
    • Select the check box next to the column title, and then click the relevant arrow to move this column from Available columns to Current columns, or vice versa.
    • Note: The Title column is always visible and cannot be removed.
    • Reorder the currently displayed columns by dragging and dropping them to the needed location in the Current columns pane.
    • Adjust the column width by specifying the new width (in pixels) in the Width field next to the column title in the Current columns pane.
  4. Click Save to save your changes (or Cancel to discard your changes, or Reset - to restore the default column configuration).
  5. Tip: You can also customize some of the column views directly on the WorkZone tab:
    • Adjust the column width by pulling the divider in the top right corner of the column's header.
    • Sort the displayed documents by the needed column. Click the header of the column that you want to use for sorting the list. Click the header again to change the sorting order.

Work with case documents

You can perform the following actions with the case documents displayed in the custom WorkZone tabs in Teams:

Edit document title

  1. In Teams, open the relevant WorkZone custom tab.
  2. Hover the mouse to the right from the document title, and click ... More options.
  3. From the sub menu, select Edit Title.
  4. In the following dialog, enter the new title, and click Save.

Edit document state

Note: You cannot edit the state for an Archived document.
  1. In Teams, open the relevant WorkZone custom tab.
  2. Hover the mouse to the right from the document title, and click ... More options.
  3. From the sub menu, select Edit State.
  4. In the following dialog, select a new state, and click Save.

Open a case document

You can open the case documents displayed in the custom WorkZone tabs directly from Teams. You can open the case documents in the corresponding Office app (for Word, Excel, and PowerPoint documents) or in WorkZone Client.

  • To open a document in WorkZone Client:
    1. Open the relevant WorkZone custom tab.
    2. Hover the mouse to the right from the document title, and click ...More options.
    3. From the sub menu, select Open in WorkZone. The document will open in WorkZone Client.
  • To open a document in the corresponding Office app (for Word, Excel, and PowerPoint documents only):
    1. Open the relevant WorkZone custom tab.
    2. Hover the mouse to the right from the document title, and click ...More options.
    3. From the sub menu, select Open.

Recycle an existing document

You can recycle (that is, soft delete) an existing case document that is displayed in the custom WorkZone tabs in Teams. The recycled document and all of its supplementary documents (if any) will be moved to the recycle bin. It will disappear from the regular lists, but will not be removed from the database, so you can restore it or hard delete it later, if needed. See Delete a document into recycle bin in the WorkZone Client User Guide for more information about the recycle functionality.

  1. In Teams, open the relevant WorkZone custom tab.
  2. Hover the mouse to the right from the document title, and click ...More options.
  3. From the sub menu, select Recycle.
  4. For documents, where it is mandatory to provide a reason for recycling, select the Recycle reason from the droplist and provide the Recycle comment (this step may be optional or mandatory, depending on the retention policy).
  5. Click Yes in the confirmation dialog.  The selected document and all of its supplementary documents (if any) will be moved to the recycle bin.

Add a new case document

You can add new documents to a WorkZone case, which is already displayed as a custom tab in Teams. You can either create a new Word, Excel, or PowerPoint document and then save it on the case displayed in Teams, or to upload one or more of the existing documents from your file system.

Add a new Word, Excel, or PowerPoint document

  1. In Teams, open the needed WorkZone custom tab.
  2. Click New.
  3. From the drop-list, select the needed document type (Word, Excel or PowerPoint). A new document of the selected type is then opened.
  4. Edit your document.
  5. Click Save.
    Tip: By default, your new document will be saved on the case from the selected WorkZone custom tab, but you can choose to save it on another case, if needed.

Upload a new document from the file system

  1. In Teams, open the needed WorkZone custom tab.
  2. Click Upload.
  3. In the displayed dialog, select one or more documents that you want to upload, and click Open.

    -Or-

    Drag and drop the needed files from the file system to the WorkZone case tab in Teams.

    Tip:

    • You can drag and drop the whole folder to upload all the documents it contains.
    • All documents uploaded from the file system will get the DOK type and inherit the classification from the case. You can change them in WorkZone Client, if needed.