Cet article de blog vous apprendra comment configurer des champs de saisie dynamiques sur une action de connecteur API dans l'Okta Workflows Connector Builder. Votre carte ressemblera à ceci:
Fiche d’action avec champs de saisie dynamiques.
- Créer des didacticiels de connecteur d’API.
- Configurer les champs de saisie dynamiques du connecteur API.
- Ressources.
Créer des tutoriels sur les connecteurs d'API
Dans deux articles de blog précédents, vous avez appris à créer un connecteur avec des champs de saisie statiques :
- Okta Workflows Tutorial: Build a Connector for OpenWeather API.
- Okta Workflows Tutorial: Build a Connector for Spotify API (with OAuth 2.0).
Vous avez également appris à configurer les champs de sortie dans :
Configurer les champs d'entrée dynamiques du connecteur API
Les champs de saisie dynamique vous permettent de charger des valeurs de saisie en fonction de la sélection d'un autre champ.
Vous pouvez configurer des champs de saisie dynamiques de deux manières :
- Un champ d'option contrôle un autre champ d'option.
- Un champ d'option contrôle un champ de saisie.
Un champ d’option contrôle un autre champ d’option
Cliquez sur Edit dans une action de connecteur pour commencer à configurer les options d'action.
Options d’action du connecteur.
L'action comporte trois champs de saisie d'option :
- Division.
- Département.
- Région.
Les trois champs ont Field Type défini sur Dropdown.
Action avec trois champs d'options.
Développez (cliquez sur la flèche vers le bas à droite) le champ Division pour voir ses détails. Division est un champ statique avec deux options (Hardware et Software) :
Champ des options de division.
Ensuite, développez le champ d'option Department. Le champ Department obtient ses valeurs à partir d'un flux d'assistance.
- La liste déroulante Department (Département) obtient ses valeurs du flux d'assistance Department List (Liste des départements).
- Étant donné que la liste déroulante Department dépend d'une valeur de la liste déroulante Division, la valeur Division est mappée au flow d'assistance, qui renvoie une liste au format JSON.
- Aperçu de la sortie affiche une sortie JSON de flux d'assistance.
Le champ des options Department utilise un flux d'assistance pour ses valeurs.
Lorsque vous sélectionnez la division Hardware, le flux d'assistance charge le JSON suivant avec trois divisions :
[
{
"value":"Systems",
"key":"Systems"
},
{
"value":"Embedded",
"key":"Embedded"
},
{
"value":"Supply Chain",
"key":"Supply Chain"
}
]Voici à quoi ressemble la liste bsp:
Liste du département matériel.
Lorsque vous sélectionnez la division Logiciel, le flux d'aide charge le JSON suivant avec trois divisions différentes :
[
{
"value":"Engineering",
"key":"Engineering"
},
{
"value":"Quality Assurance",
"key":"Quality Assurance"
},
{
"value":"IT",
"key":"IT"
}
]Voici à quoi ressemble la liste bsp:
Liste du département logiciel.
Le flux d'assistance Liste des services ressemble à ceci :
Flux d'assistance Department List (Liste des départements).
La condition if Helper Input == 'Hardware' (Entrée d'assistance == « Matériel ») renvoie le JSON de la liste du matériel :
Hardware If list.
Une valeur de Software renverra la liste des logiciels.
Cette section vous a montré comment créer un champ de saisie dynamique dans action Options.
- Lorsque vous choisissez Hardware (Matériel), la liste Department (Département) obtient les valeurs du département Hardware (Matériel) d'un flux d'assistance.
- Lorsque vous choisissez Software, la liste Department obtient les valeurs de département Software d'un flow d'assistance.
Dans la section suivante, vous apprendrez à sélectionner une valeur dans Options et à charger la liste dans Inputs.
Un champ d'option contrôle un champ de saisie
Cette option fonctionne de la même manière. Vous sélectionnez une valeur de liste dans Options, et une liste est chargée dans la section Inputs en fonction de cette valeur.
Vous sélectionnez une région (DE - pour l'Allemagne) :
Setting a region
La liste People charge les noms de la région DE :
Liste des personnes.
La configuration est similaire à ce que vous avez vu dans la section précédente.
La section Options contient une liste statique de Régions (liste des pays).
Liste des régions.
La sélection du champ Region est utilisée comme entrée dans un flux d'assistance (Employee List) pour charger les personnes de cette région.
Liste des personnes.
Dans la section précédente, le flux d'assistance utilisait une logique if-else pour créer une liste dynamique. Dans cet exemple, le flux d'assistance appelle une API pour obtenir la liste.
Le flux d'assistance se présente comme suit :
Flux permettant de récupérer les personnes d’une région.
Le flux d'assistance comporte les étapes suivantes :
- La carte Helper Flow (Flux d’assistance) a une Region input (Entrée de région).
- L’élément Compose configure une URL. L’exemple utilise Random User API.
- La carte Raw Request (Requête brute) appelle l'API.
- La carte Get obtient l'objet results qui contient la liste des personnes.
- Le flux d'assistance doit renvoyer un objet JSON représentant les valeurs de la liste. La carte Map prend la liste et renvoie une liste JSON ci-dessous.
- La carte Return renvoie la liste.
JSON pour créer une liste déroulante :
[
{
"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"
}
]La carte Map appelle le flux suivant pour configurer les valeurs de la liste au format JSON :
Configurer les valeurs de la liste au format JSON.
Cette section vous a montré comment créer un champ de saisie dynamique dans l'action Inputs.
- Vous effectuez une sélection de Region dans Options. Dans Inputs, un champ de saisie est chargé avec des noms basés sur la région sélectionnée.
La carte finale ressemble à ceci :
Fiche d’action avec champs de saisie dynamiques.
Après qu'un constructeur d'automatisation utilisant le connecteur ait fait des sélections, vous pouvez utiliser les champs dans d'autres cartes de flux :
Utilisation des champs dans d'autres cartes de flux.
Ressources
📚 Création d'un connecteur personnalisé dans Okta Workflows, une série de vidéos.
📖 Documentation du générateur de connecteurs Okta Workflows.
🍫 Obtenez de l'aide auprès de spécialistes Workflows pendant les heures de bureau communautaires hebdomadaires.
📺 Apprenez grâce aux vidéos Workflows.
🛟 Obtenez de l'aide auprès du support : discutez d'un sujet Workflows ou posez une question.
🙋🏻♀️ Obtenez de l'aide de la communauté : rejoignez le canal #okta-workflows sur MacAdmins Slack.
