Connectors

Met Connectors kunnen klanten externe applicaties buiten het NiCE-ecosysteem koppelen aan hun workflows. Hierdoor kunnen organisaties eenvoudiger gegevens uit zowel frontoffice- als backofficesystemen samenbrengen. Dit zorgt voor een soepele, complete verwerking. Om dit te ondersteunen werkt NiCE samen met zijn OEM-partner Tray, die kant-en-klare connectoren levert voor veel populaire apps. Als een gebruiker een applicatie gebruikt die niet door Tray wordt ondersteund, kan hij/zij deze toch verbinden met zijn/haar workflow via een aangepaste connector. Deze connectoren ondersteunen gangbare authenticatiemethoden en bieden gebruikers de mogelijkheid om API's in te stellen om gegevens op te halen of bij te werken op basis van hun zakelijke behoeften.

Mogelijkheden

• Externe Connectors met lade

  • Integreert ondersteunde applicaties van derden met behulp van de ingebouwde connectoren van Tray.

• Aangepaste Connectors

  • Maakt integratie van niet-ondersteunde of propriëtaire applicaties mogelijk.

  • Ondersteunt de belangrijkste authenticatietypen:

    • Geen authenticatie

    • Token drager

    • OAuth 2.0

    • API-sleutel

    • OAuth 1.0 (Mock)/SAML Mock

  • Maakt configuratie van aangepaste API's mogelijk.

Connectors bekijken en beheren

Een connector beheren:

1. Klik op de app-kiezer en selecteer Orchestrator.

2. Klik in het linkernavigatiepaneel op het tabblad Connectorbeheer .

3. Op de pagina Connectors wordt een lijst met alle geconfigureerde connectoren weergegeven. Gebruikers kunnen schakelen tussen:

   • Lijstweergave: Geeft connectoren weer in een tabelvorm met kolommen voor metagegevens.

   • Tegelweergave: Geeft connectoren weer als individuele kaarten met belangrijke details.

   Gebruik de tegelweergave voor een visueel overzicht en de lijstweergave voor een gedetailleerde vergelijking tussen meerdere connectoren.

4. Voor elke connector worden de volgende belangrijke metagegevens weergegeven:

   Metadata	Beschrijving
   Connectornaam	Identificatie of naam van de connector.
   Beschrijving	Optionele opmerkingen over het doel van de connector.
   Status	Geeft aan of de connector actief of Inactief is. (Als een connector wordt gebruikt in een gepubliceerde workflow, wordt de status weergegeven als Actief, anders als Inactief.)
   Actieve workflows	Aantal workflows dat momenteel de connector gebruikt.
   Laatst gewijzigd	Tijdstempel van de meest recente update van de connector.

5. Connectors zonder actieve workflows of ontbrekende beschrijvingen zijn mogelijk nog steeds geldig, maar worden momenteel niet gebruikt. Gebruik de zoekbalk om connectoren te zoeken op naam of beschrijving. Als er geen connectoren aan de criteria voldoen, wordt er een melding weergegeven met een illustratie en de volgende tekst:

   1. Nieuwe connectors toevoegen

      Uw geconfigureerde connectoren kunnen in de Orchestrator-workflow worden gebruikt om acties uit te voeren, taken te koppelen en uw bedrijf te orkestreren.

   2. Er zijn twee knoppen beschikbaar waarmee gebruikers nieuwe connectoren kunnen maken:

      • + Externe connector: voor integraties met systemen van derden of externe systemen.

      • + Aangepaste API Connector: Voor het definiëren van connectors met behulp van aangepaste API-eindpunten.

6. Volg de stappen in het gedeelte Een Nieuwe Connector maken om de installatie te voltooien.

Een Nieuwe Connector maken

Een nieuwe connector maken:

1. Klik op de app-kiezer en selecteer Orchestrator.

2. Klik in het linkernavigatiepaneel op het tabblad Connectorbeheer .

3. Klik op de knop Nieuwe connector in de rechterbovenhoek van de pagina Connectors.

4. Klik op Externe app voor integratie met systemen van derden of externe systemen.

   1. In het gedeelte Connectorinfo:

      • Toepassing: Selecteer de externe toepassing waarmee u verbinding wilt maken in de vervolgkeuzelijst. (Vereist)

      • Connectornaam: Voer een unieke naam in voor uw connector. (Vereist)

      • Connectorbeschrijving: Geef een korte beschrijving van het doel of de functionaliteit van de connector.

   2. Klik op Volgende om door te gaan naar het gedeelte Bewerkingen. Hier moet u de API-methoden definiëren die de connector zal ondersteunen. Elke operatie omvat:

      • Methode: Kies de HTTP-methode (bijv. POST, PUT, DELETE, GET, PATCH).

      • Werktijdnaam: Geef een beschrijvende naam op voor de werktijd (bijv. Clientrecord maken, Clientlijst Ophalen).

      • Beschrijving: Leg uit wat de bewerking doet en hoe deze samenwerkt met de externe toepassing.

      • Testwerktijd: Klik op de koppeling Testwerktijd om de API-aanroep te valideren en te controleren of deze werkt zoals verwacht.

   3. Zodra alle bewerkingen zijn gedefinieerd en getest, klikt u op Connector opslaan om uw configuratie op te slaan. De connector wordt vervolgens weergegeven in de lijst met Connectors en is klaar voor gebruik in workflows.

5. Klik op Aangepaste API om aangepaste connectoren te maken met behulp van OpenAPI-specificaties. In het gedeelte Connectorinfo:

   • Connectornaam: Voer een unieke naam in voor uw connector. (Vereist)

   • Logo uploaden: Voeg een logo toe om de connector visueel te identificeren.

   • Connectorbeschrijving: Geef een korte beschrijving van het doel of de functionaliteit van de connector.

6. Klik op Volgende om door te gaan naar het gedeelte Authenticatietype. Selecteer in de vervolgkeuzelijst de juiste authenticatiemethode voor uw API:

   • Geen authenticatie: voor open/publieke API's.

   • Token drager: Vereist een tokenstring.

   • OAuth 2.0: Vereist:

     • Client-ID

     • Klantgeheim

     • Autorisatie-URL

     • Token-URL

     • Scopes

   • API-sleutel : Vereist:

     • Naam koptekst

     • Waarde API-sleutel

   • OAuth 1.0 (Mock)/SAML Mock: Vereist:

     • Details veldinvoer

7. Klik op Volgende om door te gaan naar het gedeelte Bewerkingen. Hier moet u een of meer bewerkingen definiëren die de connector ondersteunt:

   1. Klik op Werktijd toevoegen.

   2. Vul de volgende velden in:

      • Werktijdnaam: Een beschrijvende naam voor de API-functie. (Vereist)

      • Werktijdmethode: Kies de HTTP-methode (bijv. POST, PUT, DELETE, GET, PATCH).

      • Beschrijving van de werktijd: Leg uit wat de werktijd doet.

      • URL : Voer de eindpunt-URL in.

      • Headers (JSON): Lever headers in JSON-formaat.

      • Inhoud (JSON): Geef de aanvraaginhoud in JSON-formaat (indien van toepassing).

   3. Klik op Toevoegen en testen om de API-aanroep te valideren en te controleren of deze werkt zoals verwacht. Als de resultaten niet naar wens zijn, klikt u op werktijd configureren om de instellingen aan te passen. Zodra de bewerking succesvol is getest, klikt u op Terug naar lijst.

   4. Klik op Connector opslaan om de installatie te voltooien.

8. De connector wordt nu weergegeven in de Connectors-lijst en kan in workflows worden gebruikt.