Dit artikel is vertaald met behulp van AI en kan kleine onnauwkeurigheden bevatten. Raadpleeg de Engelse versie voor volledige nauwkeurigheid.
BlueDolphin-objecten worden gesynchroniseerd naar TOPdesk als assets met bijbehorende sjablonen. Een objectdefinitie in BlueDolphin staat gelijk aan een sjabloon in TOPdesk.
Voorbereiding
Voordat je begint met de configuratiestappen in BlueDolphin, zorg ervoor dat de volgende velden zijn aangemaakt (of al bestaan):
Je moet een nieuwe eigenschap aanmaken op de geselecteerde objectdefinitie om het TOPdesk-ID in BlueDolphin op te slaan.
Een veld om het BlueDolphin Object-ID op te slaan in het asset-sjabloon in TOPdesk
Maak in BlueDolphin een eigenschap aan met de naam TOPdesk Asset ID op het object om een asset-ID op te slaan voor het bijwerken van een asset na aanmaak. Je vult deze eigenschap in bij het tekstvak Asset ID Field in de BlueDolphin Marketplace-interface.
Maak in TOPdesk een veld aan met de naam bluedolphin-id op het TOPdesk asset-sjabloon om een BlueDolphin Object-ID op te slaan voor het bijwerken van een asset na aanmaak.
Definieer het BlueDolphin ID Field via Modules->Asset Management->Template Designer in TOPdesk. Je vult deze eigenschap in bij het tekstvak BlueDolphin ID Field in de BlueDolphin Marketplace-interface.
LET OP:
Zorg ervoor dat de waarden in BlueDolphin en TOPdesk overeenkomen om conflicten te voorkomen:
Als het aantal decimalen verschilt, zal het systeem afronden of nullen toevoegen om de waarden gelijk te maken.
Als een BlueDolphin-tekstveld langer is dan de toegestane lengte in TOPdesk, wordt de tekst volledig genegeerd (niet afgekapt).
Configuratie toe te voegen vanuit BlueDolphin
Na het installeren van het sjabloon "BIF: BlueDolphin Entity -> BlueDolphin Object (CREATE, UPDATE)", word je doorgestuurd naar de configuratiepagina.
Gebruik de webhook-URL, objectdefinitie-ID en workspace-ID om een webhook aan te maken voor ObjectCreated- en ObjectUpdated-events. Raadpleeg het artikel Een abonnement aanmaken voor meer informatie
Vul in het gedeelte Algemene Configuratie alle verplichte velden in zoals hieronder weergegeven. Raadpleeg de Configuratievelden-tabel voor uitleg.
Klik op Verifieer en Koppel om de connectorgegevens te bevestigen.
Als dit gelukt is, verschijnt “Verbonden” onderaan en wordt het veld Integratie Mapping zichtbaar.
Koppel in Integratie Mapping de BlueDolphin-velden aan de TOPdesk-velden. Hiermee maak je een één-op-één koppeling tussen BlueDolphin-eigenschappen of vragenlijsten en TOPdesk-sjabloonvelden.
Klik rechtsonder op Activeer.
Algemene configuratievelden
Vul alle gegevens in zoals beschreven in de tabel,
Sectie | Veld | Beschrijving |
Flow Naam |
| BIF: BlueDolphin Object → TOPdesk Entity (CREATE, UPDATE) |
Webhook URL |
| BlueDolphin webhook endpoint. Zie Een abonnement aanmaken |
BlueDolphin configuratie (Bron) | API URL | Selecteer de URL uit een dropdown voor de juiste regio. |
| API Key (Verplicht) | BlueDolphin API Key: Nieuwe API Key aanmaken |
| Bedrijfsonderdeel | Selecteer het BlueDolphin bedrijfsonderdeel/werkruimte uit de lijst. |
| Objectdefinitie
| Selecteer de BlueDolphin Objectdefinitie die je wilt koppelen uit de lijst. |
| Asset ID Field (Verplicht) | Moet ingesteld zijn als “TOPdesk Asset ID.” Selecteer de objecteigenschap van de gekozen objectdefinitie in BlueDolphin om het ID van het nieuw aangemaakte asset op te slaan. |
TOPdesk configuratie (Doel) | Instance URL (Verplicht) | Adres-URL van de TOPdesk API. Verwijder het pad gedeelte van de URL en eventuele schuine strepen aan het einde.
Bijvoorbeeld: https://your-instance.topdesk.net/tas/api/assetmgmt Moet zijn: https://your-instance.topdesk.net |
| Gebruikersnaam (Verplicht) | TOPdesk accountnaam |
| API Key (Verplicht) | TOPdesk API Key |
| Asset type (Verplicht) | Sjabloon uit TOPdesk dat je wilt koppelen aan BlueDolphin |
| BlueDolphin ID Field (Verplicht) | Assetveld-ID in TOPdesk waar BlueDolphin het ID van het BlueDolphin-object opslaat. Standaard is dit “bluedolphin-id” |
|
(Verplicht) | Assetveld-ID in TOPdesk dat door BlueDolphin wordt gebruikt om te controleren of er al een asset bestaat voor een bepaalde objecttitel. Moet ingesteld zijn op de waarde “name”.
Voeg geen integratiemapping toe die een BlueDolphin-veld koppelt aan “Asset Name” behalve “object_title” |
Voor de koppeling van TOPdesk naar BlueDolphin, zie het artikel TOPdesk Configuratie.