Konnektoren definieren die Verbindung (Einstiegspunkt) zu einem externen System.
Bei einer solchen Verbindung können Sie mehrere verschiedene Anfragen an das verbundene System senden.
Wir nennen ein solches konkretes Paar von Anforderung / Antwort einen “Konnektor-Ruf”.
Um einen Konnektoraufruf im Bearbeitungsmodus einer User Story (Process Designer) zu verwenden, müssen Sie für jeden Konnektor mindestens einen Konnektoraufruf erstellen.

Schritt 1

Wählen Sie einen Konnektor aus der Übersicht aus und klicken Sie auf der rechten Seite auf die Schaltfläche “Anrufe bearbeiten”.
Sie können auch einen Doppelklick auf den ausgewählten Connector verwenden, um zur Anrufseite zu navigieren.
Fügen Sie in der Anrufübersicht für jeden Konnektorvorgang einen neuen Anruf hinzu.

Schritt 2

Für SQL-, REST-, SOAP-, SAP RFC- und OData V2-Konnektoren haben Sie die Möglichkeit, den Konnektor-Assistenten zu verwenden.
Es hilft Ihnen, Ihre Connector-Aufrufe viel einfacher und schneller zu erstellen, da es automatisch Anrufe vorschlägt, die im Backend-System verfügbar sind. Weitere Informationen zum Connector-Assistenten finden Sie in der Dokumentation zu Connectoraufrufen der einzelnen Connectortypen.

Andernfalls klicken Sie auf das Plus-Symbol oben rechts und geben Sie einen eindeutigen Aufrufnamen ein, der die Operation beschreibt (z.B. Lesen, Schreiben, Aktualisieren, Löschen, Suchen, …).

Konnektor RufnameEindeutiger Name ohne Leerzeichen zur Beschreibung des Vorgangs.BeschreibungBeschreibung des Vorgangs.

Schritt 3

Um einen Konnektoraufruf zu konfigurieren, müssen Sie Eingabe- und Ausgabeparameter in den folgenden Tabellen angeben: Jeder Konnektoraufruf verfügt über eigene spezifische Parameter.
Der folgende Screenshot zeigt den Modus “Erweitert” zum Erstellen eines Connector-Anrufs.
Für jeden Steckertyp gibt es einen “Erweitert”-Modus.
Für zwei Konnektortypen, SQL und REST, gibt es auch einen “Easy”-Modus.
Dieser Modus kann für SQL und REST im Dialogfeld umgeschaltet werden, indem Sie den Schalter in der oberen rechten Ecke des Dialogs verwenden.
Im Folgenden wird der “Erweitert”-Modus erläutert:

Beide Registerkarten “Eingabeparameter” und “Ausgabeparameter” haben die gleiche Struktur.
Es gibt einen Schalter für die Validierung “Parameter gegen Datentypen validieren”, ein Suchfeld und eine Tabelle. Überprüfen von Parametern anhand von Datentypen Sie können den Parameter Input und Output im Back-End überprüfen.
Es validiert:

• Basistyp gegen Typsicherheit
• Domain-Typ gegen Sicherheit und Einschränkungen
• Strukturen für den Typ security und die zugrunde liegenden Eigenschaftstypen
• Auflistungen für die 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 Connectorprotokoll oder das Systemprotokoll geschrieben.
Für jeden neuen Connector-Anruf wird dieses Flag standardmäßig gesetzt.
Bei bereits vorhandenen Connector-Aufrufen ist dieses Kontrollkästchen nicht markiert, um die Kompatibilität zu gewährleisten. Suchfeld Über das Suchfeld kann nach allen Einträgen der jeweiligen Felder gesucht werden.
Die Suchfilter leben die Einträge der Tabelle.
Sie können nach “Parametername”, “Alias”, “Konstanter Wert”, “Datentyp” und “Beschreibung” filtern. Tisch 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”-Tasten hinzugefügt werden.
Zusätzlich können die Parameter per Drag & Drop über das Steuerkreuz-Symbol verschoben werden.
Das Verschieben funktioniert sowohl für die Parameter in einer eigenen Tabelle als auch zwischen den beiden Tabellen (Erforderlich und Optional).
Die Eingabefelder für “Parametername”, “Alias” und “Beschreibung” verfügen ebenfalls über ein Erweiterungssymbol.
Dies kann verwendet werden, um die Eingabe für die Eingabe zu erweitern.
Dies ist als Hilfe gedacht, wenn einer der Werte einen längeren Text enthält.
Schließlich verfügt jeder Parametereintrag über ein Drei-Punkt-Tastenmenü.
Mit dieser Schaltfläche können folgende Aktionen ausgelöst werden: –
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 –
Move to Optional / Move to Requiried verschiebt einen Parameter entweder in die Liste der angeforderten Parameter oder in die optionale Liste –
Parameter löschen löscht einen Parameter aus der Liste   Folgende Eigenschaften können pro Parameter gepflegt werden:
Parametername: Der technische Pfad oder Name innerhalb einer REST-API-Definition, einer Webservice-Beschreibung, einer Sprache oder einer CSV-Header-Spalte.Alias

Eine aussagekräftige, nicht-technische Beschreibung des technischen Parameters.
Diese Formulierung wird im Editiermodus für eine User Story (Process Designer) zum Mapping von Daten mit UI-Elementen verwendet.

Konstanter Wert

Ein konstanter Wert wie SAP Client oder Buchungscode, der von keiner Geschäftsanwendung überschrieben werden kann.
Der Wert wird überprüft, sodass es nicht möglich ist, einen konstanten Wert mit einem falschen Basistyp in Connectoraufrufen und Geschäftsobjekten zu verwenden.

DatentypZugewiesener Vereinfachungsdatentyp zum Überprüfen von Daten, bevor sie zurückkommen oder von einem Backend-System.BeschreibungOptionale Beschreibung des Parameters. Beispiel für das Erstellen eines REST-Konnektoraufrufs im “einfachen” Modus: https://community.simplifier.io/doc/current-release/integrate/connectors/rest-connector/ Erstellen-rest-connector-call/

Schritt 4

Nachdem Sie die Parameter abgeschlossen haben, können Sie die Einstellungen für den Connectoranruf speichern.