Configure Zenya DOC

Quick reference:
Settings -> Integrations -> Zenya connections

Table of Contents

 

About Zenya DOC

Infoland Zenya DOC is a document management solution which provides easy access to all kinds of documents and resources within an organization and extends its functionalities to integrate with other tools that provide for example quality manuals and care protocols, for instance Vilans KICK protocols.

The Zenya DOC live tile can be added to your Workspace as two different views:

  • Browse documents (this includes your ten most recently opened items)
  • Favorites

The content within the live tile is determined based on your account and access level in Zenya DOC. 

 

Browse documents

By typing in the search bar, you can search for all documents you have access to within the Zenya DOC archives. Once you entered your search query, all documents are listed based on their relevance. Each item includes the content type, so you know what type of document you are opening.

The Zenya DOC algorithm determines the content of the most recently used items list. By clicking on an item you will be redirected to the Zenya DOC portal where you can view the item without having to logon. 

If your organization has an integration with third party document solutions, for example Vilans KICK, you can also find these documents and will be redirected to the item in the third party application to open it.

  zenya_browse.PNG

 

 

Favorites

The “Favorites” view allows you to have quick access to items you have marked as favorite within the Zenya DOC portal or from the “Browse documents” live tile. You can also unmark an item as favorite to remove it from the list. 

Zenya_favorites.PNG

Back to top

 

Requirements

There are a few requirements in order to use the Zenya DOC integration in Workspace:

  • A fully operational Zenya environment.
  • User provisioning from the same source as Workspace 365 (most likely Azure AD).
  • An API key and related configuration.
  • The username is based on email address or UPN. The UPN of the user in the Workspace must match 100% with the user in Zenya DOC.
    • Example: If "user@domain.com" exists in the Workspace, in Zeya DOC the UPN must also be "user@domain.com". 

Given the environment and user provisioning are in place, an administrator can log in to the Zenya Admin console:

  1. Navigate to Application management > System settings > API-keys.
  2. Add new API-key and fill out the configuration as described below.

    zenya_applicatiebeheer.png

  3. Titel: provide a recognizable name for the API configuration, e.g. “Workspace365”.
  4. Sleutel: automatically generated unique customer specific GUID. This key must be used in the Workspace365 integration connector.
  5. Toegang beperkt tot specifieke gebruikers (groepen): this value should be left on the default value “No”. Changing it to “Yes” allows you to configure API access for specific users or groups instead of the whole organization.
  6. Servers die deze API sleutel mogen gebruiken: to increase security, you can configure the IP-address of the Workspace environment. Doing this prevents API access from other unauthorized sources. Multiple IP-addresses can be configured if needed.
    If you are hosted on our True SaaS platform, add our IP range 20.103.81.112/28.
  7. Gebruik "sliding token expiration": always set the to “Yes” as the integration depends on it and authentication will fail if it is not configured properly.

Back to top

 

Configuration

Step 1. Create Zenya DOC connection

The admin account you use to create the Zenya DOC connection has to be known in Zenya. This is only required when setting up the connection, once the connection is made the admin can be removed from Zenya.

In order to use the Zenya DOC integration you will first have to configure the App connector.

  1. Go to the Workspace Settings page.
  2. Navigate to Integrations.
  3. Select Zenya connections.
  4. Here, you can configure the following:
    1. Zenya DOC App name.
    2. Server URL, or portal URL.
    3. API key: you can request an API key for Zenya DOC with your system administrator or Infoland directly.
    4. Username: from v3.63, we show personalized information from Zenya DOC based on what is configured here. If you set it to "Email address" (which is default), make sure users have an email address configured in Workspace 365 to retrieve information from the live tile.

      ZenyaSettingsScreen.png

 

Step 2. Activate the app

  1. Go to the App store (or click on "+ Add tiles").
  2. Make sure Manage apps is selected.
  3. Click on Add new app and select Zenya DOC.
  4. You can choose a different logo, change the color and decide whether to open Zenya DOC from the Workspace in the current window or a new window.
  5. You can determine who has access to the Zenya DOC live tile and who will become app owner
  6. If you followed the previous steps, you can select the connection from the drop-down. If not, you can create a new connection by clicking on Add.

    zenya_2.png

  7. Click Save when you're done configuring the app.
  8. Add the app from the App store to Workspace, e.g. to an existing or new Shared group.
  9. Once added to your Workspace, right-click the tile to edit (configure) the desired app settings. Use the arrows pointing up or downwards to change position of the tabs (Browse documents and Favorites), which will determine what you see first from the live tile overview.
  10. Tip: you can add the Zenya DOC tile twice to your Workspace- one for "Browse documents" and the other one for "Favorites". 

Back to top

 

Troubleshooting (log files)

For further troubleshooting we recommend taking a look at the error logs from Zenya, because it can contain more detailed information. 

To access these log files:

  1. Log in to iProva
  2. Go to the activities log
  3. Apply the following filters and search: 
    • Section: iProva suite
    • Activities: logins
    • Login attempts: not successful login attempts

You will be presented with a record of failed login attempts. Please read the description for more detailed information.

Back to top