In diesem Blogbeitrag erfahren Sie, wie Sie dynamische Eingabefelder für eine API-Connector-Aktion im Okta Workflows Connector Builder einrichten. Ihre Karte sieht dann so aus:
Aktionskarte mit dynamischen Eingabefeldern.
- Tutorials zum Erstellen von API-Konnektoren.
- Einrichten dynamischer Eingabefelder für API-Konnektoren.
- Ressourcen.
Tutorials zum Erstellen von API-Konnektoren
In zwei vorherigen Blogbeiträgen haben Sie gelernt, wie man einen Konnektor mit statischen Eingabefeldern erstellt:
- Okta Workflows Tutorial: Erstellen eines Konnektors für die OpenWeather API.
- Okta Workflows Tutorial: Erstellen eines Konnektors für die Spotify-API (mit OAuth 2.0).
Sie haben auch gelernt, wie Sie Ausgabefelder einrichten in:
Einrichten dynamischer Eingabefelder für API-Konnektoren
Aktions-Eingabefelder ermöglichen es Ihnen, Eingabewerte basierend auf einer anderen Feldauswahl zu laden.
Sie können dynamische Eingabefelder auf zwei Arten einrichten:
- Ein Optionsfeld steuert ein anderes Optionsfeld.
- Ein Optionsfeld steuert ein Eingabefeld.
Ein Optionsfeld steuert ein anderes Optionsfeld.
Klicken Sie in einer Konnektoraktion auf Bearbeiten, um mit der Einrichtung der Aktionsoptionen zu beginnen.
Optionen für Konnektoraktionen.
Die Aktion hat drei Options-Eingabefelder:
- Abteilung.
- Abteilung.
- Region.
Alle drei Felder haben Feldtyp auf Dropdown gesetzt.
Aktion mit drei Optionsfeldern.
Erweitern Sie das Feld Division (klicken Sie auf den Abwärtspfeil auf der rechten Seite), um dessen Details anzuzeigen. Division ist ein statisches Feld mit zwei Optionen (Hardware und Software):
Feld für Abteilungsoptionen.
Erweitern Sie als Nächstes das Optionsfeld Department. Das Feld „Department“ bezieht seine Werte aus einem Hilfs-Flow.
- Das Dropdown-Menü Abteilung bezieht seine Werte aus dem Hilfs-Flow Department List.
- Da die Dropdown-Liste Department von einem Wert aus der Dropdown-Liste Division abhängt, wird der Wert Division dem Hilfs-Flow zugeordnet, der eine Liste im JSON-Format zurückgibt.
- Preview output zeigt eine JSON-Ausgabe des Hilfs-Flows.
Das Optionsfeld Abteilung verwendet einen Hilfs-Flow für seine Werte.
Wenn Sie die Abteilung Hardware auswählen, lädt der Hilfs-Flow das folgende JSON mit drei Abteilungen:
[{
"value":"Systeme",
"key":"Systems"
},
{
"value":"Eingebettet",
"key":"Embedded"
},
{
"value":"Lieferkette",
"key":"Supply Chain"
}
]Die Liste sieht wie folgt aus:
Liste der Hardwareabteilung.
Wenn Sie die Software -Abteilung auswählen, lädt der Hilfs-Flow das folgende JSON mit drei verschiedenen Abteilungen:
[
{
"value":"Engineering",
"key":"Engineering"
},
{
"value":"Quality Assurance",
"key":"Quality Assurance"
},
{
"value":"IT",
"key":"IT"
}
]Die Liste sieht wie folgt aus:
Software-Abteilungsliste.
Der Hilfs-Flow Department List sieht wie folgt aus:
Hilfs-Flow für Abteilungslisten.
Die Helper Input == ‘Hardware’ if-Bedingung gibt die Hardware-Liste im JSON-Format zurück:
Hardware If-Liste.
Ein Wert von Software gibt die Softwareliste zurück.
In diesem Abschnitt wurde gezeigt, wie Sie ein dynamisches Eingabefeld in Aktionsoptionen erstellen.
- Wenn Sie Hardware auswählen, ruft die Liste Abteilung die Werte der Hardware -Abteilung von einem Hilfs-Flow ab.
- Wenn Sie Software wählen, erhält die Liste Department die Software Abteilungswerte aus einem Hilfs-Flow.
Im nächsten Abschnitt erfahren Sie, wie Sie einen Wert in Optionen auswählen und die Liste in Eingaben laden.
Ein Optionsfeld steuert ein Eingabefeld
Diese Option funktioniert ähnlich. Sie wählen einen Listenwert in Optionen aus, und eine Liste wird im Abschnitt Eingaben basierend auf diesem Wert geladen.
Sie wählen eine Region aus (DE – für Deutschland):
Festlegen einer Region
Die People -Liste lädt Namen aus der DE-Region:
Personenliste.
Die Einrichtung ähnelt der im vorherigen Abschnitt.
Die Optionen haben eine statische Region -Liste (Länderliste).
Regionsliste.
Die Auswahl aus dem Feld Region wird als Eingabe in einen Hilfs-Flow (Employee List) verwendet, um die Personen aus dieser Region zu laden.
Personenliste.
Im vorherigen Abschnitt verwendete der Hilfs-Flow eine If-Else-Logik, um eine dynamische Liste zu erstellen. In diesem Beispiel ruft der Hilfs-Flow eine API auf, um die Liste abzurufen.
Der Hilfsfluss sieht wie folgt aus:
Flow zum Abrufen von Personen aus einer Region
Der Hilfs-Flow hat die folgenden Schritte:
- Die Karte Helper Flow hat die Region-Eingabe.
- Der Compose richtet eine URL ein. Das Beispiel verwendet die Random User API.
- Die Karte Raw Request ruft die API auf.
- Die Karte Get ruft das Objekt results ab, das die Personenliste enthält.
- Der Hilfs-Flow muss ein JSON-Objekt zurückgeben, das die Listenwerte darstellt. Die Karte Map nimmt die Liste entgegen und gibt eine JSON-Liste zurück.
- Die Return -Karte gibt die Liste zurück.
JSON zum Erstellen einer Dropdown-Liste:
[
{
"value": "Sekleta Lesko",
"key": "Sekleta Lesko"
},
{
"value": "Sacha Thomas",
"key": "Sacha Thomas"
},
{
"value": "Jamie Price",
"key": "Jamie Price"
},
{
"value": "Terra Hamilton",
"key": "Terra Hamilton"
},
{
"value": "Gerald Küsters",
"key": "Gerald Küsters"
}
]Die Map -Karte ruft den folgenden Flow auf, um Listenwerte im JSON-Format einzurichten:
Listenwerte im JSON-Format einrichten.
In diesem Abschnitt wurde gezeigt, wie Sie ein dynamisches Eingabefeld in der Aktion Eingaben erstellen.
- Sie treffen eine Region -Auswahl unter Options. In Inputs wird ein Eingabefeld mit Namen basierend auf der ausgewählten Region geladen.
Die endgültige Karte sieht wie folgt aus:
Aktionskarte mit dynamischen Eingabefeldern.
Nachdem ein Automatisierungs-Builder, der den Konnektor verwendet, Auswahlen getroffen hat, können Sie die Felder in anderen Flow-Karten verwenden:
Verwendung von Feldern in anderen Flow-Karten.
Ressourcen
📚 Erstellen eines benutzerdefinierten Konnektors in Okta Workflows, einer Videoserie.
📖 Okta Workflows Connector Builder documentation.
🍫 Erhalten Sie Hilfe von Workflows-Spezialisten während der wöchentlichen Community-Sprechstunden.
📺 Lernen Sie von Workflows Videos.
🛟 Holen Sie sich Hilfe vom Support: diskutieren Sie ein Workflows-Thema oder stellen Sie eine Frage.
🙋🏻♀️ Erhalten Sie Hilfe von der Community: Treten Sie dem #okta-workflows-Kanal auf MacAdmins Slack bei.
