Naar de hoofdinhoud

Integratie van BlueDolphin met ServiceNow

Geschreven door BlueDolphin support
Deze week bijgewerkt

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 ServiceNow als records in de tabellen. Een objectdefinitie in BlueDolphin staat gelijk aan een tabel in ServiceNow.

LET OP:

  • Om het ID van een tabelrecord in BlueDolphin op te slaan, dat gebruikt wordt om een record na aanmaak bij te werken, moet er een eigenschap worden aangemaakt op het betreffende object. De naam van deze eigenschap moet overeenkomen met het “Entity ID Field” in de marketplace-configuratie.

  • Om een BlueDolphin-object-ID in ServiceNow op te slaan, dat gebruikt wordt om een record na aanmaak bij te werken, moet er een aparte kolom worden aangemaakt op het betreffende recordtype. Standaard kan dit veld “bluedolphin-id” heten. Het definiëren van het BlueDolphin ID Field doe je door een nieuwe kolom toe te voegen in de betreffende tabel in ServiceNow. De naam van de eigenschap moet hetzelfde zijn als “BlueDolphin ID Field” in de marketplace-configuratie.

Zorg ervoor dat waarden in BlueDolphin en ServiceNow consistent zijn geconfigureerd om mogelijke conflicten te voorkomen.


Configuratie die toegevoegd moet worden voor ServiceNow

  1. Zodra je de template met de naam - BIF: BlueDolphin Object -> ServiceNow Entity (CREATE, UPDATE) hebt geïnstalleerd, kom je op de configuratiepagina terecht.

  2. Vul in het gedeelte Algemene Configuratie alle verplichte velden in aan de hand van de onderstaande tabel.

  3. Klik op Verifieer en Koppel om te controleren of de connectorgegevens juist zijn.

  4. Als de verbinding succesvol is, verschijnt er rechtsonder een melding dat je verbonden bent en verschijnt het veld Integratie Mapping.

  5. In de Integratie Mapping koppel je ServiceNow-velden aan de BlueDolphin-objectdefinities die je wilt koppelen. Dit is de één-op-één mappingtabel van BlueDolphin Object Type-eigenschappen of vragenlijstvelden naar de ServiceNow-velden.

  6. Klik rechtsonder op Activeer.

  7. Neem de waarde van de Webhook-URL, objectdefinitie-ID en de workspace-ID om een webhook aan te maken met deze informatie voor ObjectCreated en ObjectUpdated. Zie het gedeelte Abonnementen voor meer informatie

Algemene Configuratievelden

Vul alle gegevens in zoals beschreven in de tabel,

Sectie

Veld

Beschrijving

Flow Naam

Template naam - BIF: BlueDolphin Entity -> BlueDolphin Object (CREATE, UPDATE)

Webhook URL

BlueDolphin webhook endpoint. Zie het gedeelte Abonnementen.

Algemene Configuratie

API URL

BlueDolphin API URL
Voor EU-tenants: https://public-api.eu.bluedolphin.app

Tenant Naam

Je tenantnaam vind je in de BlueDolphin-URL achter "app/"
of
onder Admin-> Algemeen veld ->Database

API Key

BlueDolphin API Key: Nieuwe API Key aanmaken

Entity ID Field (Verplicht)

Objecteigenschap in BlueDolphin om het ID van de nieuw aangemaakte ServiceNow-tabelrij op te slaan.

Objectdefinitie ID

BlueDolphin Objectdefinitie ID die je wilt koppelen.

Admin-> Configuratie-> Objectdefinitie:

Selecteer de objectdefinitie die je wilt gebruiken en kopieer en plak het laatste deel van de URL.

Object definition ID.jpeg

Workspace ID

BlueDolphin Workspace ID die je wilt koppelen.

Admin-> Configuratie-> Bedrijfsonderdelen

Selecteer de workspace die je wilt gebruiken en kopieer en plak het laatste deel van de URL.

LET OP: Tenants zonder workspace moeten de “get workspace”-call van de publieke API gebruiken om deze op te halen.

workspace ID.jpeg

Instance URL

(Verplicht)

Adres-URL van de ServiceNow API. Verwijder het pad gedeelte van de URL en eventuele schuine strepen aan het einde.

Bijvoorbeeld:

Gebruikersnaam

ServiceNow-gebruikersnaam

Wachtwoord

ServiceNow-gebruikerswachtwoord

ServiceNow Tabel

Tabel uit ServiceNow die je wilt koppelen aan BlueDolphin

BlueDolphin ID Field

(Verplicht)

Tabelkolom in ServiceNow om het ID van het BlueDolphin-object op te slaan. Standaard moet dit “bluedolphin-id” zijn

BlueDolphin Titelveld (Verplicht)

Titelkolom in ServiceNow waar de BlueDolphin-objecttitel wordt opgeslagen.

Je kunt ook het artikel ServiceNow naar BlueDolphin configuratie bekijken.

Was dit een antwoord op uw vraag?