So erstellen Sie einen REST-Connector

Written by Chris Bouveret
Juli 24, 2024

Konnektoren sind für die Entwicklung einer Anwendung mit Simplifier unerlässlich.
Sie dienen der Persistenz von Daten und können sich mit verschiedenen, externen IT-Landschaften verbinden, um auf die benötigten Daten zuzugreifen.

Sobald ein Konnektor konfiguriert ist, können verschiedene Aufrufe direkt hinzugefügt und getestet werden. Im Simplifier gibt es bereits mehrere vorkonfigurierte Konnektortypen wie SOAP, REST, SQL oder SAP RFC und so weiter, die mit wenigen Klicks mit den APIs verknüpft werden können. In diesem Beispiel erstellen wir einen REST-Konnektor, der auf die Daten einer To-Do-Listen-API zugreifen kann.

SCHRITT 1: Allgemeine Konnektivität

Wenn Sie in der Konnektorkachel “Neuen Konnektor hinzufügen” auswählen, wird eine Eingabemaske mit den notwendigen Informationen angezeigt. An dieser Stelle sind der Name, der Konnektortyp und die Dienst-URL relevant. Name: REST_ToDo Connectortyp: REST-Dienst-URL https://mockdata.simplifier.io/rest/api.php

Konnektor erstellen
Konnektor erstellen

SCHRITT 2: Erstellen eines Connector-Anrufs

Nach dem Speichern gehen wir direkt zur Maske, um Konnektoraufrufe zu erstellen. Das markierte Plus auf der rechten Seite öffnet die Eingabemaske zum Anlegen eines Konnektor-Anrufs.

Keine Konnektoraufrufe
Keine Konnektoraufrufe

In diesem Beispiel definiert der nächste Screenshot einige Eingabeparameter, die es uns ermöglichen, Daten abzufragen – ich werde diese kurz erklären.
In diesem Fall setzt der Parameter “pathParams[1]” den konstanten Wert “todos” nach der Ziel-URL und kann um weitere Parameter, auch dynamische Parameter, wie z.B. “pathParams[2]”, erweitert werden.
Alle Parameter, die mit pathParams angegeben werden, werden durch “/” getrennt und der Ziel-URL hinzugefügt.
Das Format für die Übertragung wird mit “postFormat” angegeben und sendet die Daten, in diesem Beispiel im JSON-Format.
Die Verwendung von “verb” entscheidet, ob der Aufruf Daten lesen (GET), schreiben (POST) oder löschen (DELETE) soll.
Parameter ohne konstanten Wert sollten mit einem Alias versehen werden, da dies zu Komplikationen führen könnte.

Konnektoraufruf erstellen
Konnektoraufruf erstellen

SCHRITT 3: Testen des Connector-Anrufs

Nachdem alle relevanten Parameter eingegeben sind, testen wir den Aufruf, indem wir über den Button “Speichern & Testen” eine ID eingeben. Im Screenshot sehen Sie an dem grün umrandeten Kästchen mit den Ausgabewerten, dass der Aufruf mit der ID 252 erfolgreich war.

Konnektoraufruf testen
Konnektoraufruf testen

Wenn Sie eine ID eingeben, die nicht vorhanden ist, können keine Werte zurückgegeben werden. Das rot umrandete Feld zeigt an, dass der Anruf in diesem Fall falsch ist.

Konnektoraufruf Fehler testen
Konnektoraufruf Fehler testen

Schlussfolgerung

Mit Hilfe von Konnektoren ist der Zugriff auf verschiedene APIs einfach zu verwalten und somit kann die Anwendung an verschiedene IT-Systeme angebunden werden. Sie können auch mehrfach verwendet werden und haben einen reduzierten Wartungsaufwand. Das spart Zeit und reduziert Fehler, wenn Änderungen an der Datenstruktur vorgenommen werden. Übrigens, testen Sie dieses Beispiel selbst und schauen Sie es sich mit Ihrer eigenen Freemium-Instanz genauer an. Dieser Steckverbinder und einige weitere sowie Beispielanwendungen mit Steckverbindern sind bereits enthalten.

Viel Spaß beim Ausprobieren.

Mit freundlicher Verfügung von mindsquare

Was this article helpful?

 
Related Articles