Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Waar gaat dit artikel over?

Workplace Analytics is the product in which comprehensive dashboards can be made available to a customer regarding reservation data from het product waarmee uitgebreide dashboards beschikbaar kunnen worden gemaakt voor een klant met betrekking tot reserveringsgegevens van Workplace Management (WPM). More information about these dashboards can be found hereMeer informatie over deze dashboards vindt u hier: Dashboards.

To set up these dashboards for a Workplace Management customer, an integration needs to be established between the Workplace Management client and the Workplace Analytics client. Most of this integration work is on the Workplace Analytics side. In Workplace Management, only the setup of the External App and fowarding the relevant integration information to the Workplace Analytics team is required. This article focuses on setting up the Workplace Management part of the integration.

 Who should read this article?

This article is written for implementation consultants.

Prerequisites before setting up the integration

Before setting up the integration on the Workplace Management side, the following prerequisites are important:

...

The reservation module needs to be activated (the integration is based on reservable objects and reservations)

...

Om deze dashboards in te stellen voor een Workplace Management klant, moet een integratie tot stand worden gebracht tussen de Workplace Management client en de Workplace Analytics client. Het meeste van dit integratiewerk vindt plaats aan de kant van Workplace Analytics. In Workplace Management is alleen het instellen van de Externe App en het doorsturen van de relevante integratie-informatie naar het Workplace Analytics team vereist. Dit artikel richt zich op het opzetten van het Workplace Management deel van de integratie.

Wie moet dit artikel lezen?

Dit artikel is geschreven voor implementatie consultants.

Vereisten voor het opzetten van de integratie

Voordat de integratie aan de kant van Workplace Management wordt opgezet, zijn de volgende vereisten belangrijk:

  1. De reserveringsmodule moet worden geactiveerd (de integratie is gebaseerd op reserveerbare objecten en reserveringen)

  2. Inkomende webservices en het gebruik van een registratiesleutel moeten worden ingeschakeld. Dit kan gedaan worden via Client settings → 'Authentication' tab → 'Access rules' include. This include should show the following four linesDeze include moet de volgende vier regels bevatten:

If this is not the case, you will get an error, when trying to activate the module activation for Workplace Analytics. Contact Customer Support (support@spacewell.com) if the access rules are not set up correctly.

How to enable the integration on the Workplace Management side

...

Als dit niet het geval is, krijgt u een foutmelding wanneer u probeert de module te activeren voor Workplace Analytics. Neem contact op met de klantenservice (support@spacewell.com) als de toegangsregels niet correct zijn ingesteld.

Hoe de integratie inschakelen aan de kant van Workplace Management

Gebruik gewoon de optie 'Module-activatie' op het startpaneel van de beheerder om 'Workplace Analytics-integratie' te selecteren:

...

Via the module activation, the External App and a dedicated webservice user are created and configured, necesarry for the integration. Once you start this module activation, you will receive a pop-up with the information that you will need to provide to the Workplace Analytics de module-activatie worden de Externe App en een speciale webservice-gebruiker aangemaakt en geconfigureerd, noodzakelijk voor de integratie. Zodra u deze module-activatie start, ontvangt u een pop-up met de informatie die u moet verstrekken aan het Workplace Analytics-team:

...

Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFFAE6

As shown Zoals weergegeven in the het pop-upupvenster:

  • Make sure you use a client-specific URL Zorg ervoor dat je een klant-specifieke URL gebruikt (fmd.axxerion.com instead of in plaats van axpr15.axxerion.com), as this will ensure that the integration will keep working in case the customer is ever moved to another cluster.

  • The secret key must be revealed by you via the steps in the pop-up. To be able to do this, you will need to have the Partner password enabled for your user.

Once the module activation is done, it is still possible to request the information needed by the Workplace Analytics team. Go to Module settings → Integrations → Workplace Analystics and use the button.

...

  • omdat dit ervoor zorgt dat de integratie blijft werken als de klant ooit naar een ander cluster wordt verplaatst.

  • De geheime sleutel moet door jou worden onthuld via de stappen in het pop-upvenster. Om dit te kunnen doen, moet het partnerwachtwoord zijn ingeschakeld voor je gebruiker.

Zodra de module is geactiveerd, is het nog steeds mogelijk om de informatie op te vragen die het Workplace Analytics-team nodig heeft. Ga naar Module-instellingen → Integraties → Workplace Analystics en gebruik de knop.

...

Technische achtergrondinformatie

Expand
titleTechnical background information

The following information describes the technical details of setting up the integration on the Workplace Management side without the use of the Module activation. These are all automatically taken care of in the module activation. This is therefore only relevant as technical background information and can be used for debugging, if the setup does not work properly.

Navigate to client settings, ‘Setup’ and make a note of the client reference

Image Removed

Click tab ‘Authentication’:

Image Removed

Scroll down, click tab ‘External apps’:

Image Removed

Click ‘Create analytics’:

Image Removed

Make a note of the External App reference and set commission to ‘Active’:

Image Removed
  • Open the tab ‘Trust relations’

  • Make a note of the ‘Access ID’

  • Make sure that the ‘Key type’ is set to ‘Integration secret key’, change if necessary

  • Check if the ‘Authorized system user’ is set to an active user with access to Analytics data, change if necessary

  • Click on ‘password protected’

If ‘password protected’ is not shown, make sure that your user is member of the group ‘license editor’.

Image RemovedImage Removed
  • Click ‘Reveal secret key’

  • Provide your password. Note that when your user is a partner user, using the partner password is currently not supported, which means that you need to generate a personal password for your user. This is supported from the january release onwards, so from that time on you can use the partner password.

Image Removed

Now you have all the information that Analytics needs to connect, forward this info to them:

  • server: the Axxerion subdomain that the client is using (for example ‘myclient.axxerion.com’)

  • client reference: the unique identifier of the client Axxerion environment, (for example ‘clientabc’)

  • external app ID: see notes above

  • access ID: see notes above

  • secret key: see notes above

    De volgende informatie beschrijft de technische details van het opzetten van de integratie aan de kant van Werkplekbeheer zonder gebruik te maken van de moduleactivering. Dit wordt allemaal automatisch geregeld in de moduleactivering. Dit is daarom alleen relevant als technische achtergrondinformatie en kan worden gebruikt voor debugging, als de setup niet goed werkt.

    Navigeer naar clientinstellingen, 'Instellingen' en noteer de clientreferentie

    Image Added

    Klik op het tabblad 'Authenticatie':

    Image Added

    Scroll naar beneden en klik op het tabblad 'Externe apps':

    Image Added

    Klik op 'Analytics maken':

    Image Added

    Noteer de verwijzing naar de Externe App en zet de opdracht op 'Actief':

    Image Added
    • Open het tabblad 'Vertrouwensrelaties

    • Noteer de 'Toegangs-ID'.

    • Controleer of het 'Sleuteltype' is ingesteld op 'Integratie geheime sleutel', wijzig dit indien nodig

    • Controleer of de 'Geautoriseerde systeemgebruiker' is ingesteld op een actieve gebruiker met toegang tot Analytics-gegevens.

    • Klik op 'beveiligd met wachtwoord

    Als 'wachtwoordbeveiliging' niet wordt weergegeven, controleer dan of je gebruiker lid is van de groep 'licentie-editor'.

    Image AddedImage Added
    • Klik op 'Geheime sleutel onthullen

    • Geef je wachtwoord op. Merk op dat wanneer je gebruiker een partnergebruiker is, het gebruik van het partnerwachtwoord momenteel niet wordt ondersteund, wat betekent dat je een persoonlijk wachtwoord voor je gebruiker moet genereren. Dit wordt ondersteund vanaf januari, dus vanaf dan kun je het partnerwachtwoord gebruiken.

    Image Added

    Nu heb je alle informatie die Analytics nodig heeft om verbinding te maken:

    1. server: het Axxerion-subdomein dat de klant gebruikt (bijvoorbeeld 'myclient.axxerion.com')

    2. klantreferentie: de unieke identificatie van de client Axxerion omgeving, (bijvoorbeeld 'clientabc')

    3. externe app ID: zie opmerkingen hierboven

    4. toegang ID: zie opmerkingen hierboven

    5. geheime sleutel: zie opmerkingen hierboven