Konnektoren definieren die Verbindung (Einstiegspunkt) zu einem externen System. Über eine solche Verbindung können Sie verschiedene Anfragen an das verbundene System senden. Wir bezeichnen ein solches konkretes Paar aus Anfrage und Antwort als „Konnektor-Aufruf“. Um einen Konnektor-Aufruf im Bearbeitungsmodus einer User Story (Process Designer) zu verwenden, müssen Sie mindestens einen Konnektor-Aufruf für jeden Konnektor erstellen.
Schritt 1
Wählen Sie einen Konnektor aus der Übersicht aus und klicken Sie auf der rechten Seite auf die Schaltfläche “Aufrufe bearbeiten”. Sie können auch auf den ausgewählten Konnektor doppelklicken, um zur Seite mit den Aufrufen zu navigieren. Fügen Sie in der Aufruf-Übersicht für jede Konnektor-Operation einen neuen Aufruf hinzu.
Schritt 2
Für SQL-, REST-, SOAP-, SAP RFC- und OData V2-Konnektoren haben Sie die Möglichkeit, den Connector Wizard zu verwenden. Er hilft Ihnen, Ihre Konnektor-Aufrufe einfacher und schneller zu erstellen, da er automatisch Aufrufe vorschlägt, die im Backend-System verfügbar sind.
Weitere Informationen zum Connector Wizard finden Sie in der Dokumentation zum Konnektor-Aufruf des jeweiligen Konnektor-Typs.
Klicken Sie andernfalls auf das Pluszeichen oben rechts und geben Sie einen eindeutigen Aufrufnamen ein, der die Operation beschreibt (z. B. lesen, schreiben, aktualisieren, löschen, suchen, …).
Name des Konnektor-Aufrufs
Eindeutiger Name ohne Leerzeichen zur Beschreibung der Operation.
Beschreibung
Beschreibung der Operation.
Schritt 3
Für die Konfiguration eines Konnektor-Aufrufs müssen Sie Eingabe- und Ausgabeparameter in den folgenden Tabellen angeben:
Jeder Konnektor-Aufruf hat seine eigenen spezifischen Parameter. Der Screenshot unten zeigt den “Advanced”-Modus für die Erstellung eines Konnektor-Aufrufs.
Es gibt einen “Advanced”-Modus für jeden Konnektortyp. Für die beiden Konnektortypen SQL und REST gibt es auch einen “Easy”-Modus. Dieser Modus kann für SQL und REST im Dialog über den Schalter in der oberen rechten Ecke des Dialogs umgeschaltet werden.
Im Folgenden wird der “Advanced”-Modus erläutert:
Beide Registerkarten “Eingabeparameter” und “Ausgabeparameter” haben die gleiche Struktur. Es gibt einen Schalter für die Validierung “Parameter anhand von Datentypen validieren”, ein Suchfeld und eine Tabelle.
Parameter anhand von Datentypen validieren
Sie können die Eingabe- und Ausgabeparameter im Backend validieren. Es wird Folgendes validiert:
- Basistyp gegen Typsicherheit
- Domänentyp gegen Sicherheit und Einschränkungen
- Strukturen gegen Typsicherheit und zugrunde liegende Eigenschaftstypen
- Sammlungen gegen Typsicherheit und die zugrunde liegenden Typen / Eigenschaftskategorien
Wenn die Validierung nicht erfolgreich ist, wird der Client über alle fehlgeschlagenen Validierungen benachrichtigt und gleichzeitig in das Konnektor- oder Systemprotokoll geschrieben.
Für jeden neuen Konnektor-Aufruf ist dieses Flag standardmäßig gesetzt. Bereits vorhandene Konnektor-Aufrufe haben dieses Kontrollkästchen nicht aktiviert, um die Kompatibilität zu gewährleisten.
Suchfeld
Das Suchfeld kann verwendet werden, um nach allen Einträgen der jeweiligen Felder zu suchen. Die Suche filtert live die Einträge der Tabelle. Sie können nach “Parametername”, “Alias”, “Konstanter Wert”, “Datentyp” und “Beschreibung” filtern.
Tabelle
Die Tabelle besteht aus zwei Bereichen, einem Bereich für die erforderlichen Parameter und einem Bereich für die optionalen Parameter. Parameter können über die beiden “Plus”-Schaltflächen hinzugefügt werden.
Die Eingabefelder für “Parametername”, “Alias” und “Beschreibung” haben ebenfalls ein Erweiterungssymbol. Dies kann verwendet werden, um die Eingabe zu erweitern. Dies ist als Hilfe gedacht, wenn einer der Werte einen längeren Text enthält.
– Parameter duplizieren
dupliziert einen Parameter am Ende der erforderlichen oder optionalen Liste
– Nach oben verschieben
verschiebt einen Parameter an den Anfang der erforderlichen oder optionalen Liste, je nachdem, wo sich der Parameter befindet
– Nach unten verschieben
verschiebt einen Parameter an das Ende der erforderlichen oder optionalen Liste, je nachdem, wo sich der Parameter befindet
– In optional / In erforderlich verschieben
verschiebt einen Parameter entweder in die erforderliche oder die optionale Liste
– Parameter löschen
löscht einen Parameter aus der Liste
Die folgenden Eigenschaften können pro Parameter gepflegt werden:
Parametername
Der technische Pfad oder Name innerhalb einer REST-API-Definition oder Web Service Description Language oder CSV-Header-Spalte.
Alias
Eine aussagekräftige, nicht-technische Beschreibung für den technischen Parameter. Diese Formulierung wird im Editiermodus für eine User Story (Process Designer) zur Datenzuordnung mit UI-Elementen verwendet.
Konstanter Wert
Ein konstanter Wert wie SAP-Mandant oder Firmencode, der von keiner Business-App überschrieben werden kann. Der Wert wird validiert, so dass es nicht möglich ist, einen konstanten Wert mit einem falschen Basistyp in Konnektor-Aufrufen und Business-Objekten zu verwenden.
Datentyp
Zugewiesener Simplifier-Datentyp zur Validierung von Daten, bevor diese von einem Backend-System zurückkommen oder an dieses gesendet werden.
Beschreibung
Optionale Beschreibung des Parameters.
Beispiel für die Erstellung eines REST-Konnektor-Aufrufs im “Easy”-Modus: https://community.simplifier.io/doc/current-release/integrate/connectors/rest-connector/creating-rest-connector-call/
Schritt 4
Nachdem Sie die Parameter fertiggestellt haben, können Sie die Konnektor-Aufrufeinstellungen speichern.
