Esta publicación de blog te enseñará cómo configurar campos de entrada dinámicos en una acción de conector API en el Creador de conectores de Okta Workflows. Tu tarjeta se verá así:
Tarjeta de acción con campos de entrada dinámicos.
- Crear tutoriales de conectores API.
- Configurar campos de entrada dinámicos del conector API.
- Recursos.
Crear tutoriales de conectores API
En dos publicaciones de blog anteriores, aprendiste a crear un conector con campos de entrada estáticos:
- Tutorial de Okta Workflows: Construir un conector para la API de OpenWeather.
- Tutorial de Okta Workflows: Cree un conector para la API de Spotify (con OAuth 2.0).
También aprendiste cómo configurar campos de salida en:
Configurar campos de entrada dinámicos del conector API
Los campos de entrada dinámicos de acción le permiten cargar valores de entrada en función de la selección de otro campo.
Puede configurar campos de entrada dinámicos de dos maneras:
- Un campo de opción controla otro campo de opción.
- Un campo de opciones controla un campo de entrada.
Un campo de opción controla otro campo de opción
Haz clic en Editar en una acción de conector para comenzar a configurar las opciones de acción.
Opciones de acción del conector.
La acción tiene tres campos de entrada de opción:
- División.
- Departamento.
- Región.
Los tres campos tienen Field Type establecido en Dropdown.
Acción con tres campos de opción.
Expande (haz clic en la flecha hacia abajo en el lado derecho) el campo Division para ver sus detalles. Division es un campo estático con dos opciones (Hardware y Software):
Campo de opciones de Division.
A continuación, expande el campo de opciones Department. El campo Department obtiene sus valores de un flujo auxiliar.
- El menú desplegable Department obtiene sus valores del flujo auxiliar Department List.
- Dado que el menú desplegable Department depende de un valor del menú desplegable Division, el valor de Division se asigna al flujo auxiliar, que devuelve una lista en formato JSON.
- Vista previa de salida muestra una salida JSON del flujo auxiliar.
El campo de opciones del departamento utiliza un flujo de ayuda para sus valores.
Cuando seleccionas la división de Hardware, el flujo auxiliar carga el siguiente JSON con tres divisiones:
[
{
"value":"Systems",
"key":"Systems"
},
{
"value":"Embedded",
"key":"Embedded"
},
{
"value":"Supply Chain",
"key":"Supply Chain"
}
]La lista se ve así:
Lista del departamento de hardware.
Cuando selecciona la división Software, el flujo auxiliar carga el siguiente JSON con tres divisiones diferentes:
[
{
"value":"Engineering",
"key":"Engineering"
},
{
"value":"Quality Assurance",
"key":"Quality Assurance"
},
{
"value":"IT",
"key":"IT"
}
]La lista se ve así:
Lista de departamentos de software.
El flujo auxiliar Department List (Lista de Departamentos) se ve así:
Flujo auxiliar Department List (Lista de Departamentos).
La condición if Helper Input == ‘Hardware’ devuelve la lista JSON de hardware:
Lista If de hardware.
Un valor de Software devolverá la lista de software.
Esta sección le mostró cómo crear un campo de entrada dinámico en las Opciones de acción.
- Cuando elige Hardware, la lista de Department obtiene los valores del departamento de Hardware de un flujo auxiliar.
- Cuando eliges Software, la lista Department obtiene los valores del departamento Software de un flujo auxiliar.
En la siguiente sección, aprenderá cómo seleccionar un valor en Opciones y cargar la lista en Entradas.
Un campo de opción controla un campo de entrada
Esta opción funciona de manera similar. Selecciona un valor de lista en Options, and (Opciones, y) una lista se carga en la sección Inputs (Entradas) basada en ese valor.
Selecciona una región (DE - para Alemania):
Estableciendo una región
La lista People carga nombres de la región DE:
Lista de personas.
La configuración es similar a la que viste en la sección anterior.
La opción Opciones tiene una lista de Regiones estática (lista de países).
Lista de regiones.
La selección del campo Región se utiliza como entrada en un flujo de ayuda (Lista de empleados) para cargar las personas de esa región.
Lista de personas.
En la sección anterior, el flujo auxiliar utilizaba la lógica if-else para crear una lista dinámica. En este ejemplo, el flujo auxiliar llama a una API para obtener la lista.
El flujo auxiliar se ve así:
Flujo para obtener personas de una región.
El flujo auxiliar tiene los siguientes pasos:
- La tarjeta Helper Flow tiene Region input.
- El Compose configura una URL. El ejemplo usa Random User API.
- La tarjeta Raw Request llama a la API.
- La tarjeta Get obtiene el objeto results que contiene la lista de personas.
- El flujo auxiliar necesita devolver un objeto JSON que represente los valores de la lista. La tarjeta Map toma la lista y devuelve una lista JSON a continuación.
- La tarjeta Return devuelve la lista.
JSON para crear una lista desplegable:
[
{
"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 tarjeta Map llama al siguiente flujo para configurar los valores de la lista en formato JSON:
Configure los valores de la lista en formato JSON.
En esta sección se mostró cómo crear un campo de entrada dinámico en la acción Inputs.
- Realiza una selección de Region en Options. En Inputs, un campo de entrada se carga con nombres basados en la región seleccionada.
La tarjeta final se ve así:
Tarjeta de acción con campos de entrada dinámicos.
Después de que un generador de automatización que usa el conector realiza selecciones, puede usar los campos en otras tarjetas de flujo:
Usar campos en otras tarjetas de flujo.
Recursos
📚 Creación de un conector personalizado en Okta Workflows, una serie de videos.
📖 Documentación del Creador de conectores de Okta Workflows.
🍫 Obtenga ayuda de especialistas de Workflows durante el horario de atención virtual de la comunidad semanal.
📺 Aprende de Workflows videos.
🛟 Obtenga ayuda del soporte técnico: analice un tema de Workflows o haga una pregunta.
🙋🏻♀️ Obtén ayuda de la comunidad: únete al canal #okta-workflows en MacAdmins Slack.
