De Embed module in Actimo kan worden gebruikt om een dashboard url direct in de app te embedden. Met behulp van interpolatie kun je bepalen welke gegevens en medewerker te zien krijgt in je dashboard.

Vereiste: Dashboardtool zoals PowerBI, Targit of andere die kan reageren op een parameter in een url.

API-document: https://app.swaggerhub.com/apis-docs/Actimo/Actimo

API-sleutel: Laat een Admin op je platform contact opnemen met support@actimo.com of ga via je integratiespecialist.

De beschreven stroom

Als de stroom loopt, zou deze moeten werken zoals te zien is in de onderstaande afbeelding.

Je url zal de actimo api aanroepen en de GUID gebruiken om de overeenkomstige werknemer-id te vinden om de benodigde gegevens te tonen. Bij het beëindigen van de flow roep je de actimo api aan om de GUID te vervangen door een nieuwe en zorg je ervoor dat de combinatie veilig blijft.

Actimo voorbereiden

• Ga naar Admin (beheerdersrechten vereist) en maak een aangepast veld genaamd "GUID". Merk op dat je bij het aanroepen van dit veld het veldlabel moet vinden. Het wordt data1, data2, enz. Je kunt dit zien door naar een contactpersoon te kijken in de UI met het tabblad Ontwikkelaar geopend.

• Voeg handmatig een willekeurige GUID toe aan je testcontact in de UI of via onze API (zie onderstaande oproepen).

• Maak een bericht aan in Actimo en voeg een insluitmodule toe.

De benodigde API-aanroepen

Je moet deze API-aanroep doen na elke keer dat een contactpersoon je url heeft gebruikt. Dit beschermt je dashboard zodat niemand de combinatie Employee ID + GUID kan hergebruiken om toegang te krijgen tot je Dashboard.

• Doe een PUT-verzoek om een medewerker in Actimo (Contacten) bij te werken met een nieuwe GUID.

PUT: https://a.actimo.com/api/v1/contacts/"contact id"

Nogmaals, merk op dat aangepaste velden data1, data2 enz. worden genoemd. Je kunt deze namen zien op het tabblad Ontwikkelaar in de UI.

Voeg payload toe aan de body met de benodigde gegevens die je wilt bijwerken bij de contactpersonen. Hier is een voorbeeld van hoe ik het doe.

Vragen?

Vragen over de API kunnen worden gesteld aan een van onze integratiespecialisten via support@actimo.com. Als je wordt aangenomen bij Actimo heb je al direct contact met een specialist.

Laat ons ook weten of dit nuttig was door op de onderstaande emoji's te klikken of feedback te sturen via support@actimo.com.