Exercício - Criar e chamar um conector personalizado a partir de um fluxo de trabalho nas Aplicações Lógicas do Azure

  • 10 minutos

Tem uma API Web chamada de API Print Framer que calcula um custo para uma moldura de imagem com base nas dimensões que envia para a mesma. Os desenvolvedores de toda a sua empresa querem usar essa API em seus fluxos de trabalho dos Aplicativos Lógicos do Azure, mas atualmente não há como fazer essa conexão.

Neste exercício, você criará um conector personalizado para a API do Print Framer e o usará para enviar e receber dados de um fluxo de trabalho de aplicativo lógico para uma API da 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 página inicial , em Serviços do Azure, selecione Criar um recurso. O painel Criar um recurso é exibido.

  2. No painel de menu esquerdo, selecione Integração e, em seguida, localize e selecione Aplicativo lógico.

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

    Definição Value
    Detalhes do Projeto
    Subscrição Subscrição de Assistente
    Grupo de recursos Selecionar grupo de recursos Sandbox
    Detalhes da instância
    Nome da Aplicação Lógica Indique um nome exclusivo. Lembre-se do nome para uso posterior.
    Publicar Fluxo de Trabalho
    País/Região Selecione uma região perto de si.
    Habilite a análise de log Não
    Planear
    Tipo de plano Consumo
    Redundância de zona
    Redundância entre zonas Deixar como padrão (desativado)

    O sandbox gratuito permite-lhe criar recursos num subconjunto das regiões globais do Azure. Selecione uma região na seguinte lista quando criar recursos:

    • E.U.A. Oeste 2
    • E.U.A. Centro-Sul
    • E.U.A. Central
    • E.U.A. Leste
    • Europa Ocidental
    • Sudeste Asiático
    • Leste do Japão
    • Sul do Brasil
    • Austrália Sudeste
    • Índia Central

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

  5. Depois que o portal criar seu recurso de aplicativo lógico, selecione Ir para recurso.

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

  6. Selecione Designer de aplicativo lógico no menu à esquerda e, em seguida, selecione 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. Selecione GET na lista suspensa 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 Solicitar.

  11. Na barra de ferramentas do estruturador, selecione Guardar.

Agora temos um fluxo de trabalho de aplicativo lógico básico. Vamos adicionar um conector personalizado para que possamos chamar nossa API de moldura de impressão personalizada de nosso fluxo de trabalho.

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

  1. No menu do portal do Azure ou na página inicial , em Serviços do Azure, selecione Criar um recurso. O painel Criar um recurso é exibido.

  2. Na caixa de pesquisa, localize e selecione Logic Apps Custom Connector.

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

  4. No painel Criar conector personalizado de aplicativos lógicos, em Noções básicas, insira os seguintes valores para cada configuração.

    Definição Value
    Detalhes do projeto
    Subscrição Subscrição de Assistente
    Grupo de recursos Selecionar grupo de recursos Sandbox
    Detalhes da instância
    Nome do conector personalizado PrintFramerConnector
    País/Região Selecione uma região próxima a você e também suportada pela área restrita.
    Associe-se ao ambiente de serviço de integração Deixar desmarcado

  5. Selecione Rever + criar. Depois que a validação for bem-sucedida, selecione Criar.

  6. Após a conclusão da implantação, 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, em seguida, selecione PrintFramerConnector.

  2. Na página Descrição geral, selecione Editar.

    Captura de tela mostrando o editor para conector personalizado.

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

Configurar o conector personalizado

O ficheiro OpenAPI informa o conector personalizado sobre as 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, digite Obter uma estimativa para um quadro de imagem. Talvez seja necessário rolar para baixo para ver essa parte do painel de configuração.

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

  3. No painel Segurança, certifique-se de que Sem Autenticação está selecionado.

    Importante

    Para esta demonstração, pode para permitir o acesso à API sem qualquer autenticação. Para APIs do mundo real, que contêm dados confidenciais ou exigem uma subscrição paga, a autenticação é essencial.

  4. No painel Definição, na caixa de texto Resumo, insira Estimar o custo de um quadro 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 em seu fluxo de trabalho de aplicativo lógico.

  1. No portal do Azure ou na página inicial, em Recursos do Azure, selecione Todos os recursos e, em seguida, selecione o recurso de aplicativo lógico que você criou na unidade 3.

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

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

  4. Na caixa de pesquisa Escolha uma operação, selecione Personalizado e, em seguida, selecione PrintFramerConnector.

  5. Em Ações, selecione Estimar o custo de um quadro de imagem.

  6. Na caixa Estimar o custo de uma moldura, 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:

    A captura de tela mostra 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 recebidos de cada solicitação HTTP que aciona nosso fluxo de trabalho agora estão vinculados aos parâmetros de altura e largura que passam para o PrintFramerConnector.

Concluir o fluxo de trabalho

Finalmente, o fluxo de trabalho precisa de uma maneira de exibir os resultados. Você pode usar a ação Resposta para mostrar a estimativa:

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

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

  3. No campo Corpo, insira O custo aproximado do quadro é:$.

  4. Na lista de conteúdo dinâmico que se abre, selecione Corpo na seção Estimar o custo de um quadro de imagem.

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

    A captura de tela mostra a configuração para a ação

  5. Quando terminar, selecione Salvar para salvar seu fluxo de trabalho.

Testar o fluxo de trabalho

O fluxo de trabalho agora está concluído e chamará a API da Web usando o conector personalizado. Agora, você só precisa enviar uma solicitação que aciona 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 HTTP GET URL, selecione Copiar URL.

  3. Abra um novo separador do browser e cole o URL na barra de endereço.

  4. No URL colado, substitua o parâmetro {height} por 10. Substitua o parâmetro {width} por 4. Prima Enter.

    O painel do navegador exibe um custo aproximado.

  5. Tente introduzir outras alturas e larguras.

Parabéns! Você criou um fluxo de trabalho de aplicativo lógico que pode chamar sua API interna do Print Framer usando um conector personalizado!