Hi ,
Welcome to the Support Portal. How can we help?
Follow

Zenya DOC

Quick reference:
Settings -> Integrations -> Zenya connections

Table of Contents

 

Introduction

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.

 

Overview

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.

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

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

zenya_applicatiebeheer.png

  • Titel: provide a recognizable name for the API configuration, e.g. “Workspace365”.
  • Key: automatically generated unique customer specific GUID. This key must be used in the Workspace365 integration connector.
  • Access restricted to specific users (groups): 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.
  • Servers which are allowed to use the API-key: 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.
    Currently we are working on a True SaaS architecture. If you've already been migrated, it should be 20.103.81.112/28. For more information, see Workspace 365 hosting migration. If you do not know the IP address of your Workspace instance, please contact us. 
  • Use 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

In order to use the Zenya DOC integration you will first have to configure the App connector. Go to the Workspace Settings > Integrations > Zenya connections. 

Here, you can configure the Zenya DOC App name, server URL (portal URL) and the API key.

zenya_connections.PNG

API key: you can request an API key for Zenya DOC with your system administrator or Infoland directly. 
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". 

Back to top 

 

Activate the app

Go to the App store (or click on "+ Add tiles"). Make sure Manage apps is selected.

manage_apps.PNG

Click on Add new app and select Zenya DOC.

zenya.PNG

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. You can determine who has access to the Zenya DOC live tile and who will become app owner. 

new_app_zenya.PNG

 

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". 

Click Save when you're done configuring the app. It is then ready to be added from the App store to Workspace. Once added to your Workspace, right-click the tile to configure (edit) 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.  

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