Usar APIs externas em fluxos de trabalho

Importante

Este recurso está atualmente no modo de visualização. Os Termos de Uso Suplementares para Visualizações do Microsoft Azure incluem termos legais adicionais que se aplicam aos recursos do Azure que estão em versão beta, em versão prévia ou ainda não lançados em disponibilidade geral.

Você pode usar fluxos de trabalho para automatizar alguns processos de negócios por meio do Microsoft Purview e o conector HTTP e analisar a ação JSON permitem integrar seus fluxos de trabalho a aplicativos externos.

Conector HTTP

Os conectores HTTP usam a arquitetura REST (Transferência de Estado Representacional), que permite que os fluxos de trabalho do Microsoft Purview interajam diretamente com aplicativos de terceiros usando solicitações da Web.

O conector HTTP está disponível em todos os modelos de fluxo de trabalho.

Observação

Para criar ou editar um fluxo de trabalho, você precisa da função de administrador de fluxo de trabalho no Microsoft Purview. Você também pode entrar em contato com o administrador do fluxo de trabalho em sua coleção ou entrar em contato com o administrador da coleção para obter permissões.

1. Para adicionar um conector HTTP, clique no + ícone no modelo em que deseja adicionar e selecione conector HTTP.

   

2. Depois de selecionar o conector HTTP, você verá os seguintes parâmetros:

   1. Host – Solicitar URL que você deseja chamar quando esse conector for executado.
   2. Método – selecione um dos métodos a seguir. GET, PUT, PATCH, POST e DELETE. Esses métodos correspondem a operações de criação, leitura, atualização e exclusão.
   3. Caminho – opcionalmente, você pode inserir o Caminho da URL de solicitação. Você pode usar conteúdo dinâmico para este parâmetro.
   4. Cabeçalhos – opcionalmente, você pode inserir cabeçalhos HTTP. Cabeçalhos HTTP permitem que o cliente e o servidor passem informações adicionais com uma solicitação ou resposta HTTP
   5. Consultas – opcionalmente, você pode passar consultas.
   6. Corpo – opcionalmente, você pode passar o corpo HTTP ao invocar a URL
   7. Autenticação – o conector HTTP é integrado às credenciais do Purview. Dependendo da URL, você pode invocar o ponto de extremidade com Nenhum (sem autenticação) ou pode usar credenciais para criar uma autenticação básica. Para saber mais sobre credenciais, confira o artigo credenciais do Microsoft Purview.

   

3. Por padrão, as configurações seguras são ativadas para conectores HTTP. Para desativar entradas e saídas seguras, selecione o ícone de reticências (...) para ir às configurações.

   

4. Agora você é apresentado com as configurações do conector HTTP e pode ativar entradas e saídas seguras OFF.

   

Analisar a ação JSON

A ação de análise JSON nos fluxos de trabalho permite que você pegue um JSON de entrada de HTTP (ou qualquer outra ação/conector) e analise o JSON para extrair valores para uso em seu fluxo de trabalho.

A ação JSON de análise está disponível em todos os fluxos de trabalho.

A ação JSON de análise tem dois parâmetros:

• Conteúdo – uma variável que deve conter o JSON que você deseja analisar.
• Esquema – o esquema do JSON de entrada, que permite que o fluxo de trabalho analise as informações de entrada. Você pode fornecer o seu próprio ou usar o botão Gerar de exemplo . Se você gerar a partir de um exemplo, você inserirá uma carga JSON de exemplo e um esquema será gerado automaticamente para você.

Ações e conectores no fluxo de trabalho após a ação de análise JSON poderão usar os valores extraídos do JSON selecionando Adicionar conteúdo dinâmico para quaisquer parâmetros.

Próximas etapas

Para obter mais informações sobre fluxos de trabalho, confira estes artigos:

• Fluxos de trabalho no Microsoft Purview
• Fluxo de trabalho de aprovação para termos de negócios
• Gerenciar solicitações e aprovações de fluxo de trabalho