Exercício – Criar e chamar um conector personalizado por meio de um fluxo de trabalho dos Aplicativos Lógicos do Azure

  • 10 minutos

Você tem uma API Web chamada API Print Framer que calcula o custo de uma moldura de imagem com base nas dimensões enviadas a ela. Os desenvolvedores em toda a empresa desejam usar essa API nos fluxos de trabalho dos Aplicativos Lógicos do Azure, mas não há nenhuma forma de estabelecer essa conexão no momento.

Neste exercício, você criará um conector personalizado para a API Print Framer e o usará para enviar e receber dados de um fluxo de trabalho de aplicativo lógico para uma API Web. Primeiro, precisamos de um fluxo de trabalho de aplicativo lógico.

Criar um fluxo de trabalho de aplicativo lógico

  1. No menu do portal do Azure ou na Home page, em Serviços do Azure, selecione Criar um recurso. O painel Criar um recurso será exibido.

  2. No painel de menu à esquerda, selecione Integração, pesquise e selecione Aplicativo Lógico.

  3. No painel Criar Aplicativo Lógico, em Informações Básicas, insira os valores a seguir para cada configuração.

    Configuração Valor
    Detalhes do projeto
    Subscription Assinatura do Concierge
    Grupo de recursos Selecionar Grupo de recursos de área restrita
    Detalhes da Instância
    Nome do Aplicativo Lógico Forneça um nome exclusivo. Lembre-se do nome para uso posterior.
    Publicação Fluxo de trabalho
    Região Selecione uma região perto de você.
    Habilitar a análise de logs Não
    Plano
    Tipo de plano Consumo
    Redundância de zona
    Redundância de zona Manter como padrão (desabilitado)

    A área restrita gratuita permite criar recursos em um subconjunto das regiões globais do Azure. Selecione uma região na seguinte lista ao criar recursos:

    • Oeste dos EUA 2
    • Centro-Sul dos Estados Unidos
    • Centro dos EUA
    • Leste dos EUA
    • Europa Ocidental
    • Sudeste Asiático
    • Leste do Japão
    • Brazil South
    • Australia Southeast
    • Índia Central

  4. Selecione Examinar + criar, e, em seguida, selecione Criar após a validação bem-sucedida.

  5. Depois que o portal criar o recurso de aplicativo lógico, selecione Acessar recurso.

    O portal do Azure mostra uma galeria com gatilhos e padrões de fluxo de trabalho usados com frequência.

  6. Selecione o Designer de aplicativo lógico no menu à esquerda e escolha Adicionar um gatilho.

  7. Procure e selecione Quando uma solicitação HTTP é recebida.

    O designer de fluxo de trabalho agora exibe o gatilho selecionado.

  8. Selecione Mostrar tudo na seção Parâmetros avançados.

  9. Escolha GET no menu suspenso Método.

  10. Insira {height}/{width} como uma cadeia de caracteres literal no campo Caminho relativo.

    Captura de tela mostrando as informações do gatilho de solicitação.

  11. Selecione Salvar na barra de ferramentas do designer.

Agora temos um fluxo de trabalho de aplicativo lógico básico. Vamos adicionar um conector personalizado para chamar a API Print Framer personalizada no fluxo de trabalho.

Criar um conector personalizado dos Aplicativos Lógicos do Azure no portal do Azure

  1. No menu do portal do Azure ou na Home page, em Serviços do Azure, selecione Criar um recurso. O painel Criar um recurso será exibido.

  2. Na caixa de pesquisa, procure e selecione Conector Personalizado dos Aplicativos Lógicos.

  3. No painel Conector Personalizado dos Aplicativos Lógicos, selecione Criar.

  4. No painel Criar conector personalizado dos aplicativos lógicos, em Informações Básicas, insira os valores a seguir para cada configuração.

    Configuração Valor
    Detalhes do projeto
    Subscription Assinatura do Concierge
    Grupo de recursos Selecionar Grupo de recursos de área restrita
    Detalhes da instância
    Nome do conector personalizado PrintFramerConnector
    Região Selecione uma região próxima de você e com suporte na área restrita.
    Associar ao Ambiente de Serviço de Integração Deixar desmarcado

  5. Selecione Examinar + criar. Depois que a validação tiver êxito, selecione Criar.

  6. Após a implantação ser concluída, selecione Ir para o recurso.

Importar a definição de OpenAPI

Agora, use o arquivo OpenAPI que você salvou anteriormente para definir o conector personalizado.

  1. No portal do Azure ou na Página Inicial, selecione Todos os recursos, e depois selecione PrintFramerConnector.

  2. Na página Visão Geral, selecione Editar.

    Captura de tela mostrando o editor do conector personalizado.

  3. Na seção Conectores personalizados, selecione Arquivo OpenAPI e, em seguida, selecione Importar. Abra o arquivo JSON salvo no último exercício.

Configurar o conector personalizado

O arquivo OpenAPI informa o conector personalizado das operações que estão disponíveis na API Web. Há algumas outras propriedades que você precisa definir para o conector personalizado.

  1. Na seção Informações Gerais, na caixa Descrição, insira Obter uma estimativa para uma moldura de imagem. Talvez você precise rolar a página para baixo para ver essa parte do painel de configuração.

  2. Na caixa de texto Host, insira a URL de exemplo que você anotou anteriormente.

  3. No painel Segurança, verifique se a opção Sem autenticação está selecionada.

    Importante

    Para esta demonstração, não há problemas em permitir acesso à API sem nenhuma autenticação. Para as APIs do mundo real, que contêm dados confidenciais ou exigem uma assinatura paga, a autenticação é essencial.

  4. No painel Definição, na caixa de texto Resumo, insira Estimar o custo de uma moldura de imagem.

  5. Em Visibilidade, selecione Importante.

  6. Na parte superior do painel, selecione Atualizar conector.

Adicionar o conector personalizado ao fluxo de trabalho do aplicativo lógico

Agora, você pode usar o conector personalizado no fluxo de trabalho do aplicativo lógico.

  1. No portal do Azure ou na Página Inicial, em Recursos do Azure selecione Todos os recursos e escolha o aplicativo lógico que você criou na unidade 3.

  2. No menu de recurso do aplicativo lógico, selecione Visão geral. Na barra de ferramentas do painel Visão geral, selecione Editar.

  3. No designer, escolha Nova etapa>Adicionar uma ação.

  4. Na caixa de pesquisa Escolher uma ação, selecione Personalizado e depois PrintFramerConnector.

  5. Em Ações, selecione Estimar o custo de uma moldura de imagem.

  6. Na caixa Estimar o custo de uma moldura de imagem, coloque o cursor no campo Altura. Na lista de conteúdo dinâmico que é aberta, selecione altura.

    A captura de tela a seguir ilustra essa seleção:

    Captura de tela mostrando o conector personalizado e o parâmetro

  7. Retorne ao conector personalizado e coloque o cursor no campo Largura. Na lista de conteúdo dinâmico, selecione largura.

    Os parâmetros de altura e largura que recebemos de cada solicitação HTTP que dispara o fluxo de trabalho agora estão associados aos parâmetros de altura e largura que passamos para o PrintFramerConnector.

Concluir o fluxo de trabalho

Por fim, o fluxo de trabalho precisa de uma forma de exibir os resultados. Você pode usar a ação de resposta para mostrar a estimativa:

  1. No designer de fluxo de trabalho, selecione Nova etapa.

  2. Na caixa de pesquisa Escolher uma operação, insira Resposta e selecione a ação chamada Resposta.

  3. No campo Corpo, insira O custo aproximado da moldura é: US$.

  4. Na lista de conteúdo dinâmico que é aberta, selecione Corpo na seção Estimar o custo de uma moldura de imagem.

    A captura de tela a seguir mostra essa seleção:

    Captura de tela mostrando a configuração da ação

  5. Quando você concluir, selecione Salvar para salvar as alterações.

Testar o fluxo de trabalho

O fluxo de trabalho está concluído e chamará a API Web por meio do conector personalizado. Agora, basta enviar uma solicitação que dispare o fluxo de trabalho, o que você pode fazer usando o navegador.

  1. No designer de fluxo de trabalho, expanda a ação Quando uma solicitação HTTP é recebida.

  2. Ao lado do campo URL HTTP GET, selecione Copiar URL.

  3. Abra uma nova guia do navegador e cole a URL na barra de endereços.

  4. Na URL colada, substitua o parâmetro {height} por 10. Substitua o parâmetro {width} por 4. Pressione Enter.

    O painel do navegador exibirá um custo aproximado.

  5. Tente inserir outras alturas e larguras.

Parabéns! Você criou um fluxo de trabalho de aplicativo lógico que pode chamar a API interna Print Framer por meio de um conector personalizado.