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 de integratie configureert, maak je twee velden aan: één in BlueDolphin en één in TOPdesk. De integratie gebruikt deze velden om elk BlueDolphin-object te koppelen aan het bijbehorende TOPdesk-asset. Wanneer een object wijzigt in BlueDolphin, gebruikt de integratie deze koppeling om het juiste asset in TOPdesk te vinden en bij te werken. Voorbeeld: Het object Applicatiefunctie wordt gesynchroniseerd naar TOPdesk. In BlueDolphin slaat de eigenschap TOPdesk Asset ID het TOPdesk asset-ID op. In TOPdesk slaat het veld bluedolphin-id van het asset het ID van het BlueDolphin-object op.
Je hebt ook een BlueDolphin Public API-sleutel nodig.

Stap 1: Voeg de eigenschap TOPdesk Asset ID toe in BlueDolphin

Ga vanuit het hoofdmenu naar Admin. Klik onder Configuratie op Objectdefinities en open vervolgens de objectdefinitie die je wilt synchroniseren met TOPdesk (bijvoorbeeld Applicatiefunctie).
Klik onder het tabblad Objecteigenschappen op Voeg objecteigenschappen toe.
Vul in het venster Voeg objecteigenschap toe de volgende velden in:
1. Naam veld: Vul TOPdesk Asset ID in.
2. Normale waarde: Laat leeg.
3. Vragenlijst: Selecteer geen optie.
Klik op OK.

Herhaal deze stappen voor elke objectdefinitie die je wilt synchroniseren.

Stap 2: Maak het veld bluedolphin-id aan in TOPdesk

Ga in TOPdesk naar Modules > Asset Management.
Open Template Designer.
Open het assetsjabloon dat overeenkomt met je BlueDolphin-objectdefinitie.
Voeg een veld toe met de naam bluedolphin-id aan het sjabloon.
Sla het sjabloon op.

Stap 3: Maak een Public API-sleutel aan in BlueDolphin

LET OP: Je moet de Admin-rol hebben om een API-sleutel aan te maken.

Navigeer vanuit het hoofdmenu naar Admin.
Klik onder Identiteit en toegang op Public API keys
Klik op het
-icoon om een nieuwe sleutel aan te maken.
Vul in
1. Naam: bijvoorbeeld TOPdesk integratie
2. Scope: User Key Management
3. Vervaldatum
  Je kunt de vervaldatum niet meer wijzigen nadat de sleutel is aangemaakt.
Kopieer de sleutel en bewaar deze veilig. Je hebt deze nodig bij het configureren van de integratie.
WAARSCHUWING: Bewaar je API-sleutel als een wachtwoord. Deel deze niet en maak er geen screenshot van.
Klik op Maak.

LET OP:
Zorg dat de waarden in BlueDolphin en TOPdesk overeenkomen om conflicten te voorkomen:

Als het aantal decimalen verschilt, worden waarden afgerond of worden er nullen toegevoegd om ze gelijk te maken.
Als een BlueDolphin-tekstveld langer is dan de limiet in TOPdesk, wordt de tekst verwijderd zonder inkorting.

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 Maak een abonnement aan 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 Entiteit (MAAK, UPDATE)
Webhook URL		BlueDolphin webhook endpoint. Zie Maak een abonnement
BlueDolphin configuratie (Bron)	API URL (Verplicht)	Selecteer de URL uit een keuzelijst voor de betreffende regio.
	API Key (Verplicht)	BlueDolphin API Key: Maak nieuwe API Key
	Bedrijfsonderdeel	Selecteer het BlueDolphin bedrijfsonderdeel/werkruimte uit de keuzelijst.
	Objectdefinitie	Selecteer de BlueDolphin Objectdefinitie die je wilt koppelen uit de keuzelijst.
	Asset ID Veld (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 Veld (Verplicht)	Asset veld-ID in TOPdesk waar BlueDolphin het ID van het BlueDolphin object opslaat. Standaard moet dit “bluedolphin-id” zijn.
	BlueDolphin Titelveld (Verplicht)	Asset veld-ID in TOPdesk dat door BlueDolphin wordt gebruikt om te controleren of er al een Asset bestaat voor een bepaald objecttitel. Moet ingesteld zijn op de waarde “name”. Voeg geen integratiemapping toe die een BlueDolphin veld koppelt aan “Asset Naam” behalve “object_title”

Voor TOPdesk naar BlueDolphin, zie het artikel TOPdesk Configuratie.

Integratie van BlueDolphin met TOPdesk