Esta postagem do blog ensinará como configurar campos de entrada dinâmicos em uma ação do conector de API no Construtor de Conectores do Okta Workflows. Seu cartão terá esta aparência:
Card de ação com campos de entrada dinâmicos.
- Criar tutoriais de conectores de API.
- Configure campos de entrada dinâmicos do conector de API.
- Recursos.
Criar tutoriais de conector de API
Em dois posts anteriores do blog, você aprendeu como criar um conector com campos de entrada estáticos:
- Okta Workflows Tutorial: Build a Connector for OpenWeather API.
- Tutorial do Okta Workflows: Criar um conector para a API do Spotify (com OAuth 2.0).
Você também aprendeu como configurar campos de saída em:
Configurar campos de entrada dinâmicos do conector de API
Os campos de entrada dinâmicos de ação permitem carregar valores de entrada com base em outra seleção de campo.
Você pode configurar campos de entrada dinâmicos de duas maneiras:
- Um campo de opção controla outro campo de opção.
- Um campo de opção controla um campo de entrada.
Um campo de opção controla outro campo de opção
Clique em Editar em uma ação do conector para começar a configurar as opções de ação.
Opções de ação do conector.
A ação tem três campos de entrada de opção:
- Divisão.
- Departamento.
- Região.
Todos os três campos têm Tipo de campo definido como Dropdown.
Ação com três campos de opção.
Expanda (clique na seta para baixo no lado direito) o campo Divisão para ver seus detalhes. Divisão é um campo estático com duas opções (Hardware e Software):
Campo de opções de divisão.
Em seguida, expanda o campo de opção Departamento. O campo Departamento obtém seus valores de um fluxo auxiliar.
- A lista suspensa Departamento obtém seus valores do fluxo auxiliar Lista de departamentos.
- Como a lista suspensa Departamento depende de um valor da lista suspensa Divisão, o valor da Divisão é mapeado para o fluxo auxiliar, que retorna uma lista no formato JSON.
- Visualizar saída mostra uma saída JSON do fluxo auxiliar.
O campo Department options usa um fluxo auxiliar para seus valores.
Quando você seleciona a divisão Hardware, o fluxo auxiliar carrega o seguinte JSON com três divisões:
[
{
"value":"Sistemas",
"key":"Systems"
},
{
"value":"Incorporado",
"key":"Embedded"
},
{
"value":"Cadeia de suprimentos",
"key":"Supply Chain"
}
]A lista se parece com isto:
Lista do departamento de hardware.
Quando você seleciona a divisão Software, o fluxo auxiliar carrega o seguinte JSON com três divisões diferentes:
[
{
"value":"Engineering",
"key":"Engineering"
},
{
"value":"Quality Assurance",
"key":"Quality Assurance"
},
{
"value":"IT",
"key":"IT"
}
]A lista se parece com isto:
Lista do departamento de software.
O fluxo auxiliar da Lista de Departamentos se parece com isto:
Fluxo auxiliar da Lista de Departamentos.
A condição if Helper Input == ‘Hardware’ retorna a lista de hardware JSON:
Lista de hardware Se.
Um valor de Software retornará a lista de software.
Esta seção mostrou como criar um campo de entrada dinâmico em Options de ação.
- Quando você escolhe Hardware, a lista Department obtém os valores do departamento Hardware de um fluxo auxiliar.
- Quando você escolhe Software, a lista Departamento recebe os valores do departamento Software de um fluxo auxiliar.
Na próxima seção, você aprenderá como selecionar um valor em Options e carregar a lista em Inputs.
Um campo de opção controla um campo de entrada
Esta opção funciona de forma semelhante. Você seleciona um valor de lista em Opções, e uma lista é carregada na seção Entradas com base nesse valor.
Você seleciona uma região (DE - para Alemanha):
Definindo uma região
A lista People carrega nomes da região DE:
Lista de pessoas.
A configuração é semelhante ao que você viu na seção anterior.
As Opções têm uma lista Região estática (lista de países).
Lista de regiões.
A seleção do campo Region é usada como entrada em um fluxo auxiliar (Employee List) para carregar as pessoas dessa região.
Lista de pessoas.
Na seção anterior, o fluxo auxiliar usou a lógica if-else para criar uma lista dinâmica. Neste exemplo, o fluxo auxiliar chama uma API para obter a lista.
O fluxo auxiliar se parece com isto:
Fluxo para obter pessoas de uma região.
O fluxo auxiliar tem as seguintes etapas:
- O card Helper Flow tem Region input.
- O Compose configura uma URL. O exemplo usa a API Random User.
- O card Raw Request chama a API.
- O cartão Get obtém o objeto results que contém a lista de pessoas.
- O fluxo auxiliar precisa retornar um objeto JSON representando os valores da lista. O card Map pega a lista e retorna uma lista JSON abaixo.
- O card **Return** retorna a lista.
{ "label": "Select an option", "options": [ {"value": "option1", "label": "Option 1"}, {"value": "option2", "label": "Option 2"}, {"value": "option3", "label": "Option 3"} ] }
[{
"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"
}]O card Map chama o seguinte fluxo para configurar valores de lista no formato JSON:
Configure os valores da lista no formato JSON.
Esta seção mostrou como criar um campo de entrada dinâmico em ação Inputs.
- Você faz uma seleção de Região em Opções. Em Inputs, um campo de entrada é carregado com nomes com base na região selecionada.
O card final tem esta aparência:
Card de ação com campos de entrada dinâmicos.
Depois que um criador de automação usando o conector faz seleções, você pode usar os campos em outros cartões de fluxo:
Usando campos em outros cards de fluxo.
Recursos
📚 Como criar um conector personalizado no Okta Workflows, uma série de vídeos.
📖 Documentação do Okta Workflows Connector Builder.
🍫 Obtenha ajuda de especialistas em Workflows durante o horário de atendimento da comunidade semanal.
📺 Aprenda com os vídeos do Workflows.
🛟 Obtenha ajuda do suporte: discuta um tópico do Workflows ou faça uma pergunta.
🙋🏻♀️ Obtenha ajuda da comunidade: junte-se ao canal #okta-workflows no MacAdmins Slack.
