Partilhar via


Utilize a atividade WebHook para chamar um ponto de extremidade e aguardar a sua conclusão

Uma atividade de webhook pode controlar a execução de pipelines através de código customizado. Com a atividade do webhook, o código pode chamar um endpoint e passar-lhe uma URL de retorno de chamada. A execução do pipeline aguarda o retorno de chamada antes de prosseguir para a próxima atividade.

Pré-requisitos

Para começar, você deve preencher os seguintes pré-requisitos:

Adicionar uma atividade do WebHook a um pipeline através da interface do utilizador

Para usar uma atividade WebHook em um pipeline, conclua as seguintes etapas:

Criação da atividade

  1. Crie um novo pipeline em seu espaço de trabalho.

  2. Pesquise por WebHook no painel Atividades do pipeline e selecione-o para adicioná-lo à tela do pipeline.

    Nota

    A menos que sua tela tenha uma resolução muito alta, você provavelmente precisará expandir a lista de atividades da barra de ferramentas usando o botão elipsis ... para encontrar a atividade WebHook.

    Captura de tela da interface do usuário do Fabric com o painel Atividades e a atividade WebHook realçados.

  3. Selecione a nova atividade WebHook na tela se ela ainda não estiver selecionada.

    Captura de tela mostrando a guia Configurações gerais da atividade WebHook.

Consulte as orientações para as configurações gerais para configurar a aba Configurações gerais.

Configurações de atividade do WebHook

  1. Selecione o separador Configurações, escolha uma ligação existente na lista suspensa Ligação ou crie uma nova ligação, e especifique os seus detalhes de configuração.

    Captura de tela mostrando a guia Configurações de atividade do WebHook destacando a guia e onde escolher uma nova conexão.

  2. Ao criar uma nova conexão, você vê a caixa de diálogo de criação de conexão onde você pode fornecer a URL base e as credenciais para se conectar.

    Captura de tela mostrando a nova caixa de diálogo de conexão para a atividade WebHook.

Usando gateway de dados no local ou de rede virtual (VNET)

  1. Ao criar sua conexão, agora você pode optar por usar um gateway de dados local (OPDG) ou um gateway de dados VNET. Para obter orientação sobre como criar e configurar seu OPDG, consulte como criar gateway de dados local.

  2. Se você quiser usar um gateway VNET, consulte como criar um gateway de dados VNET.

  3. Depois de criar e configurar o seu gateway com êxito, ele deve aparecer no menu gateway de dados na caixa de diálogo de conexão.

    Captura de ecrã mostrando o diálogo de ligação do gateway de dados para a atividade WebHook.

  4. Depois de escolher ou criar sua conexão, preencha os campos obrigatórios restantes, adicione os cabeçalhos necessários ou defina as configurações avançadas. A atividade WebHook suporta apenas o método POST.

  5. Use a saída da atividade como entrada para qualquer outra atividade e faça referência à saída em qualquer lugar em que o conteúdo dinâmico seja suportado na atividade de destino.

Guardar e executar ou agendar o pipeline

Normalmente, você usa a saída da atividade WebHook com outras atividades, mas uma vez configurada, ela também pode ser executada diretamente sem outras atividades. Se você estiver executando-o para invocar uma API REST que execute alguma ação e não precise de nenhuma saída da atividade, seu pipeline também poderá conter apenas a atividade da Web. Para executar a atividade, mude para a guia Página Inicial no topo do editor de pipeline e clique no botão para salvar o seu pipeline. Selecione Executar para executá-lo diretamente ou Agendar para agendá-lo. Você também pode visualizar o histórico de execução aqui ou definir outras configurações.

Captura de tela mostrando a guia Página Inicial no editor de pipeline com os botões Nome da guia, Salvar, Executar e Agendar realçados.