Integration of coLab dashlet

enaio® coLab • 11.10 »

The coLab dashlet creates a direct connection to coLab project rooms from various enaio® clients (enaio® client, enaio® webclient, and enaio® webclient as a desktop application). The dashlet is integrated into the content preview of the corresponding enaio® client and provides the user with various coLab functions, especially for managing the project rooms.

The coLab dashlet is part of the 'colab' microservice.

To integrate the coLab dashlet, follow these steps

  1. Setting for the dashlet in enaio® webclient

    Add the following entry to the dashlets.json file located in the <enaio-service-manager-path>\config\apps\osweb\public\dashlets\ directory:

    {
    "iconId": "1073742729",
    "objectTypes": "*",
    "platforms": [
        "web",
        "desktop_app",
        "mobile",
        "mobile_app"
    ],
    "title_DE": "Colab Dashlet-DE",
    "title_EN": "Colab Dashlet-EN",
    "title_FR": "Colab Dashlet-FR",
    "uri": "http://<service-manager-IP>/colab/dashlet?osId={OBJECTIDENT}&sessionguid={sessionguid}&locale={guilanguage}"
    }

    • Multiple clients can be specified.

      Example: "platforms": ["mobile","desktop_app"]

    • The title for the languages must contain the string 'colab dashlet'.

    • Specify the address in which the 'colab' microservice is integrated as the address of the service manager.

  2. Setting for the dashlet in enaio® client:

    Add the following entry in enaio® enterprise-manager in order to integrate the coLab dashlet in enaio® client:

    http://<service-manager-IP>/colab/dashlet?osId={OBJECTIDENT}&sessionguid={sessionguid}&locale={localename}                    

    Specify the address in which the 'colab' microservice is integrated as the address of the service manager.

  3. Automatic authentication via a session GUID

    A new key needs to be added to colab-prod.yml, as shown in the following example, in order to enable automatic authentication via a session GUID. If the key is not specified, this option is considered disabled and the user needs to manually authenticate in the dashlet window of the client.

    global:
      service:
        baseUrl: 'http://localhost/colab'
        language: de
        o365-enabled: true
        api-enabled: true
        allowed-register-types: 6488069
        easy-share-enabled: false
        sessionguid-login-enabled: true

You can find additional information on installing and configuring dashlets under: