Conectores internos em Aplicativos Lógicos do Azure

Os conectores internos fornecem maneiras de controlar o agendamento e a estrutura do fluxo de trabalho, executar seu próprio código, gerenciar ou manipular dados e concluir outras tarefas nos fluxos de trabalho. Diferente dos conectores gerenciados, alguns conectores internos não são vinculados a um serviço, sistema ou protocolo específico. Por exemplo, você pode iniciar quase todos os fluxos de trabalho em um agendamento usando o gatilho Recorrência. Ou você pode fazer com que o fluxo de trabalho aguarde até que seja chamado usando o gatilho Solicitação. Todos os conectores internos são executados nativamente no runtime dos Aplicativos Lógicos do Azure. Alguns não exigem a criação de uma conexão antes do uso.

Para um número menor de serviços, sistemas e protocolos, os Aplicativos Lógicos do Azure fornecem uma versão interna acompanhado da versão gerenciada. O número e o intervalo de conectores internos variam de acordo com a criação de um aplicativo lógico de Consumo executado em Aplicativos Lógicos do Azure multilocatário ou de um fluxo de trabalho de aplicativo lógico Standard executado em Aplicativos Lógicos do Azure de locatário único. Na maioria dos casos, a versão interna fornece melhores condições de desempenho, recursos, preços e assim por diante. Em alguns casos, alguns conectores internos estão disponíveis apenas em um tipo de fluxo de trabalho de aplicativo lógico e não em outros.

Por exemplo, um fluxo de trabalho Standard pode usar conectores gerenciados e conectores internos para o Armazenamento de Blobs do Azure, o Azure Cosmos DB, os Hubs de Eventos do Azure, o Barramento de Serviço do Azure, o FTP, o IBM DB2, o IBM MQ, o SFTP e o SQL Server. Um fluxo de trabalho de Consumo não tem as versões internas. Um fluxo de trabalho de Consumo pode usar conectores internos para o Gerenciamento de API do Azure e Serviço de Aplicativo do Azure, enquanto um fluxo de trabalho Standard não tem esses conectores internos.

Além disso, nos fluxos de trabalho Standard, alguns conectores internos com atributos específicos são informalmente conhecidos como provedores de serviços. Alguns conectores internos dão suporte a apenas uma maneira de autenticar uma conexão com o serviço subjacente. Outros conectores internos podem oferecer uma opção, como usar uma cadeia de conexão, o Microsoft Entra ID ou uma identidade gerenciada. Todos os conectores internos são executados no mesmo processo do runtime dos Aplicativos Lógicos do Azure. Para obter mais informações, examine Locatário único versus multilocatário nos Aplicativos Lógicos do Azure.

Este artigo fornece uma visão geral sobre conectores internos em fluxos de trabalho de Consumo versus fluxos de trabalho Standard.

Conectores internos de Consumo versus Standard

A tabela a seguir lista as galerias atuais e em expansão de coleções de operações internas disponíveis para fluxos de trabalho de Consumo versus Padrão. Para fluxos de trabalho Standard, um asterisco (*) marca conectores internos com base no modelo do provedor de serviços, que é descrito em mais detalhes posteriormente.

Consumo

Standard

Gerenciamento de API do Azure Serviço de Aplicativo do Azure Verificação de Aplicativos Lógicos do Azure Operações em lote Control Operações de dados Data/Hora Arquivo simples HTTP Código embutido Conta de integração Operações do Liquid Solicitação Agendamento Variáveis Operações XML

AS2 (v2) Pesquisa de IA do Azure* Gerenciamento de API do Azure Automação do Azure* Armazenamento de Blobs do Azure* Azure Cosmos DB* Publicação da Grade de Eventos do Azure* Hubs de Eventos do Azure* Armazenamento de Arquivos do Azure* Verificação de Azure Key Vault* OpenAI do Azure* Armazenamento de Filas do Azure* Barramento de Serviço do Azure* Armazenamento de Tabelas do Azure* Operações em lote Control Operações do Mapeador de Dados Operações de dados Data/Hora EDIFACT Sistema de arquivos* Arquivo simples FTP* HTTP IBM 3270* IBM CICS* IBM DB2* Arquivo de Host IBM* IBM IMS* IBM MQ* Código embutido Conta de integração JDBC* Operações do Liquid Solicitação RosettaNet SAP* Agendamento SFTP* SMTP* SQL Server* SWIFT Variáveis Operações de fluxo de trabalho X12 Operações XML

Conectores internos baseados no provedor de serviços

Nos fluxos de trabalho Standard, um conector interno que tem os seguintes atributos é informalmente conhecido como um provedor de serviços:

• Baseia-se no modelo de extensibilidade do Azure Functions.

• Fornece acesso de um fluxo de trabalho Standard a um serviço, como Armazenamento de Blobs do Azure, Barramento de Serviço do Azure, Hubs de Eventos do Azure, SFTP e SQL Server.

  Alguns conectores internos dão suporte a apenas uma maneira de autenticar uma conexão com o serviço subjacente. Outros conectores internos podem oferecer uma opção, como usar uma cadeia de conexão, o Microsoft Entra ID ou uma identidade gerenciada.

• É executado no mesmo processo que o runtime de Aplicativos Lógicos do Azure reprojetado.

Esses conectores internos baseados no provedor de serviço estão disponíveis junto com as versões do conector gerenciado.

Em contraste, um conector interno que não é um provedor de serviços tem os seguintes atributos:

• Não se baseia no modelo de extensibilidade do Azure Functions.

• É implementado diretamente como um trabalho dentro do runtime de Aplicativos Lógicos do Azure, como Agenda, HTTP, Solicitação e operações XML.

Conectores internos personalizados

No caso de fluxos de trabalho Standard, você pode criar um conector interno próprio com o mesmo modelo de extensibilidade de conector interno usado por conectores internos baseados no provedor de serviços, como o Armazenamento de Blobs do Azure, os Hubs de Eventos do Azure, o Barramento de Serviço do Azure, o SQL Server, entre outros. Essa implementação de interface é baseada no modelo de extensibilidade do Azure Functions e fornece a capacidade de criar conectores internos personalizados que qualquer pessoa pode usar em fluxos de trabalho Standard.

Para fluxos de trabalho de consumo, você não pode criar conectores internos próprios, mas pode criar conectores gerenciados próprios.

Para saber mais, consulte a seguinte documentação:

• Conectores personalizados nos Aplicativos Lógicos do Azure
• Criar conectores internos personalizados para fluxos de trabalho Standard

Conectores internos gerais

Você pode usar os seguintes conectores internos para executar tarefas gerais, por exemplo:

• Execute fluxos de trabalho usando agendamentos personalizados e avançados. Para obter mais informações sobre agendamento, examine o Comportamento de recorrência para conectores em Aplicativos Lógicos do Azure.

• Organize e controle a estrutura do fluxo de trabalho, por exemplo, usando loops e condições.

• Trabalhe com variáveis, datas, operações de dados, transformações de conteúdo e operações em lote.

• Comunique-se com outros pontos de extremidade usando gatilhos e ações HTTP.

• Receba e resposta a solicitações.

• Chame suas próprias funções (Azure Functions) ou outros fluxos de trabalho de Aplicativos Lógicos do Azure que possam receber solicitações e assim por diante.

Agendar

Recorrência: dispare um fluxo de trabalho com base na recorrência especificada.

Janela deslizante
(Somente fluxo de trabalho de consumo)
Dispare um fluxo de trabalho que precisa manipular dados em partes contínuas.

Atraso: pause o fluxo de trabalho pela duração especificada.

Atrasar até: pause o fluxo de trabalho até a data e a hora especificadas.

HTTP

Chame um ponto de extremidade HTTP ou HTTPS usando a ação ou gatilho HTTP.

Você também pode usar esses outros gatilhos e ações HTTP internos:

• HTTP + Swagger
• HTTP + Webhook

Solicitar

Quando uma solicitação HTTP é recebida: aguarde uma solicitação de outro fluxo de trabalho, aplicativo ou serviço. Esse gatilho torna o fluxo de trabalho resgatável sem a necessidade de ser verificado ou sondado em um agendamento.

Resposta: responda a uma solicitação recebida pelo gatilho quando uma solicitação HTTP é recebida no mesmo fluxo de trabalho.

Batch

Mensagens em lotes: dispare um fluxo de trabalho que processa mensagens em lotes.

Enviar mensagens para o lote: chame um fluxo de trabalho existente que é iniciado atualmente com um gatilho de mensagens em lotes.

Sistema de Arquivos
(Somente fluxo de trabalho Standard)

Conecte-se a um sistema de arquivos no computador de rede para criar e gerenciar arquivos.

FTP
(Somente fluxo de trabalho Standard)

Conecte-se a um servidor FTP ou FTPS em sua rede virtual do Azure para poder trabalhar com seus arquivos e pastas.

SFTP
(Somente fluxo de trabalho Standard)

Conecte-se a um servidor SFTP em sua rede virtual do Azure para poder trabalhar com seus arquivos e pastas.

SMTP
(Somente fluxo de trabalho Standard)

Conecte-se a um servidor SMTP para poder enviar emails.

Conectores internos para serviços e sistemas específicos

Você pode usar os conectores internos a seguir para acessar serviços e sistemas específicos. Nos fluxos de trabalho Standard, alguns desses conectores internos também são informalmente conhecidos como provedores de serviços, que podem diferir de seus equivalentes conectores gerenciados de algumas maneiras.

Azure AI Search
(Somente fluxo de trabalho Standard)

Conecte-se à Pesquisa de IA para realizar operações de indexação e pesquisa de documentos no fluxo de trabalho.

Gerenciamento de API do Azure

Chame seus próprios gatilhos e ações nas APIs definidas, gerenciadas e publicadas por você usando o Gerenciamento de API do Azure.

Observação: não há suporte ao usar a camada de Consumo para o Gerenciamento de API.

Serviço de Aplicativo do Azure
(Somente fluxo de trabalho de consumo)

Chame os aplicativos criados e hospedados no Serviço de Aplicativo do Azure, por exemplo, Aplicativos de API e Aplicativos Web.

Quando o Swagger é incluído, as ações e gatilhos definidos por esses aplicativos são exibidos como quaisquer outros gatilhos e ações de primeira classe nos Aplicativos Lógicos do Azure.

Automação do Azure
(Somente fluxo de trabalho Standard)

Conecte-se às suas contas de Automação do Azure para criar e gerenciar trabalhos de Automação do Azure.

Armazenamento de Blobs do Azure
(Somente fluxo de trabalho Standard)

Conecte-se à sua conta de Armazenamento de Blobs do Azure para criar e gerenciar o conteúdo do blob.

Azure Cosmos DB
(Somente fluxo de trabalho Standard)

Conecte ao Azure Cosmos DB para que você possa acessar e gerenciar documentos do Azure Cosmos DB.

Publicação da Grade de Eventos do Azure
(Somente fluxo de trabalho Standard)

Conecte-se à Grade de Eventos do Azure para programação baseada em eventos usando a semântica publicação/assinatura.

Hubs de eventos do Azure
(Somente fluxo de trabalho Standard)

Como consumir e publicar eventos por meio de um hub de eventos. Por exemplo, obtenha uma saída do seu fluxo de trabalho com os Hubs de Eventos e, em seguida, envie essa saída para um provedor de análise em tempo real.

Armazenamento de Arquivos do Azure
(Somente fluxo de trabalho Standard)

Conecte-se à sua conta de Armazenamento do Microsoft Azure para criar, atualizar e gerenciar arquivos.

Azure Functions

Chame funções hospedadas no Azure para executar seu próprio código (C# ou Node.js) do fluxo de trabalho.

Azure Key Vault
(Somente fluxo de trabalho Standard)

Conecte-se ao Azure Key Vault para armazenar, acessar e gerenciar segredos.

Aplicativos Lógicos do Azure
(Fluxo de trabalho de consumo)

-ou-

Operações de fluxo de trabalho
(Fluxo de trabalho Standard)

Chame outros fluxos de trabalho que são iniciados com o gatilho Solicitação nomeado quando uma solicitação HTTP é recebida.

OpenAI do Azure
(Somente fluxo de trabalho Standard)

Conecte-se ao Azure OpenAI para realizar operações em grandes modelos de linguagem.

Barramento de Serviço do Azure
(Somente fluxo de trabalho Standard)

Gerencie mensagens assíncronas, filas, sessões, tópicos e assinaturas de tópicos.

Armazenamento de Tabelas do Azure
(Somente fluxo de trabalho Standard)

Conecte-se à conta de Armazenamento do Azure para que você possa criar, atualizar, consultar e gerenciar tabelas.

Armazenamento de Filas do Azure
(Somente fluxo de trabalho Standard)

Conecte-se à sua conta de Armazenamento do Microsoft Azure para criar, atualizar e gerenciar filas.

IBM 3270
(Somente fluxo de trabalho Standard)

Chame aplicativos do 3270 controlados por tela nos mainframes IBM por meio do fluxo de trabalho.

IBM CICS
(Somente fluxo de trabalho Standard)

Chame programas do CICS em mainframes IBM por meio do fluxo de trabalho.

IBM DB2
(Somente fluxo de trabalho Standard)

Conectar-se ao IBM DB2 na nuvem ou no local. Atualizar uma linha, obter uma tabela e muito mais.

Arquivo de Host IBM
(Somente fluxo de trabalho Standard)

Conecte-se ao Arquivo de Host IBM e gere ou analise o conteúdo.

IBM IMS
(Somente fluxo de trabalho Standard)

Chame programas do IMS em mainframes IBM por meio do fluxo de trabalho.

IBM MQ
(Somente fluxo de trabalho Standard)

Conectar-se a locais do IBM MQ ou ao Azure para enviar e receber mensagens.

JDBC
(Somente fluxo de trabalho Standard)

Conecte-se a um banco de dados relacional usando drivers JDBC.

SAP
(Somente fluxo de trabalho Standard)

Conecte-se ao SAP para enviar ou receber mensagens e invocar ações.

SQL Server
(Somente fluxo de trabalho Standard)

Conecte-se ao SQL Server no local ou a um Banco de Dados SQL do Azure na nuvem para que você possa gerenciar registros, executar procedimentos armazenados ou executar consultas.

Executar o código dos fluxos de trabalho

Os Aplicativos Lógicos do Azure fornecem as seguinte ações internas para executar seu próprio código no fluxo de trabalho:

Azure Functions

Chame funções hospedadas no Azure para executar seu próprio código (C# ou Node.js) do fluxo de trabalho.

Código Embutido

- Execute o código JavaScript do fluxo de trabalho Consumo ou Padrão.

- Execute o código de script C# do fluxo de trabalho Standard.

- Execute o código de script do PowerShell do fluxo de trabalho Standard.

Operações de função local
(Somente fluxo de trabalho Standard)

Criar e executar códigos do .NET Framework por meio do fluxo de trabalho.

Controlar o fluxo de trabalho

Os Aplicativos Lógicos do Azure fornecem as seguintes ações internas para estruturar e controlar as ações no fluxo de trabalho:

Condição

Avalie uma condição e execute ações diferentes com base em se a condição é verdadeira ou falsa.

For Each

Execute as mesmas ações em cada item em uma matriz.

Escopo

Agrupe ações em Escopos, que obtém seus próprios status após as ações no escopo concluírem a execução.

Switch

Agrupe ações em Casos, que recebem valores exclusivos, exceto para o caso padrão. Execute somente esse caso cujo valor atribuído coincide com o resultado de uma expressão, objeto ou token. Se nenhuma correspondência existir, execute o caso padrão.

Encerrar

Interrompe um fluxo de trabalho em execução ativa.

Until

Repita ações até que a condição especificada seja verdadeira ou algum estado seja alterado.

Gerenciar ou manipular dados

Os Aplicativos Lógicos do Azure fornecem as seguintes ações internas para trabalhar com saídas de dados e seus formatos:

Operações de Dados

Realize as operações com os dados.

Texto da parte: divida o conteúdo em partes para usar em soluções de IA ou com operações de serviço de IA, como operações do Azure OpenAI e Azure AI Search. Para obter mais informações, consulte Analisar ou conteúdo em partes.

Compor: crie uma única saída de várias entradas com vários tipos.

Criar tabela CSV: crie uma tabela CSV (separada por valores vírgula) de uma matriz com objetos JSON.

Criar tabela HTML: crie uma tabela HTML de uma matriz com objetos JSON.

Matriz de filtro: crie uma matriz de itens na outra matriz que atendem aos seus critérios.

Juntar-se: crie uma cadeia de caracteres de todos os itens em uma matriz e separe esses itens com o delimitador especificado.

Analisar um documento: crie uma cadeia de caracteres tokenizada para usar em soluções de IA ou com operações de serviço de IA, como operações do Azure OpenAI e Azure AI Search. Para obter mais informações, consulte Analisar ou conteúdo em partes.

Analisar o JSON: crie tokens amigáveis de propriedades e seus valores em conteúdo de JSON. Você pode usar essas propriedades no fluxo de trabalho.

Selecionar: crie uma matriz com objetos JSON transformando itens ou valores em outra matriz e mapeando esses itens para propriedades especificadas.

Data/Hora

Realize as operações com os carimbos de data/hora.

Adicionar horário: adicionar número especificado de unidades a um carimbo de data/hora.

Converter fuso horário: converter um carimbo de data/hora do fuso horário de origem para o fuso horário de destino.

Horário atual: retornar o carimbo de data/hora atual como uma cadeia de caracteres.

Obter horário futuro: retornar o carimbo de data/hora atual mais as unidades de tempo especificadas.

Obter horário passado: retornar o carimbo de data/hora atual menos as unidades de tempo especificadas.

Subtrair de horário: subtrair um número de unidades de tempo de um carimbo de data/hora.

Variáveis

Realize as operações com as variáveis.

Acrescentar à variável de matriz: inserir um valor como o último item em uma matriz armazenada por uma variável.

Acrescentar à variável de matriz: inserir um valor como o último caractere em uma cadeia de caracteres armazenada por uma variável.

Diminuir variável: diminuir uma variável em um valor constante.

Incrementar variável: aumentar uma variável em um valor constante.

Inicializar variável: criar uma variável e declarar seu tipo de dados e o valor inicial.

Definir a variável: atribuir um valor diferente em uma variável existente.

Operações XML

Execute operações com XML.

Compor XML com esquema: crie XML a partir de JSON usando um esquema para um fluxo de trabalho padrão.

Analisar XML com esquema: analise XML usando um esquema para um fluxo de trabalho padrão.

Transformar XML: converta XML usando um mapa.

Validar XML: valide XML de entrada ou saída usando um esquema.

Operações internas B2B (entre empresas)

Os Aplicativos Lógicos do Azure dão suporte a cenários de comunicação B2B (entre empresas) por meio de várias operações internas B2B. Se você tiver um fluxo de trabalho de Consumo ou Standard e as operações B2B que deseja usar, talvez precisará criar e vincular uma conta de integração ao recurso de aplicativo lógico. Em seguida, use essa conta de integração para definir seus artefatos B2B, como parceiros comerciais, contratos, mapas, esquemas, certificados, etc.

• fluxo de trabalho de Consumo

  Para usar qualquer operação B2B em um fluxo de trabalho, você precisa criar e vincular uma conta de integração ao recurso de aplicativo lógico. Depois de criar sua conta de integração, você precisa definir seus artefatos B2B, como parceiros comerciais, contratos, mapas, esquemas, certificados, etc. Em seguida, você poderá usar as operações B2B para codificar e decodificar mensagens, transformar o conteúdo, entre outros.

• Fluxo de trabalho Standard

  Algumas operações B2B exigem que você crie e vincule uma conta de integração ao recurso de aplicativo lógico. A vinculação permite compartilhar artefatos entre vários fluxos de trabalho Standard e os fluxos de trabalho filho. De acordo com a operação B2B que você deseja usar, conclua uma das seguintes etapas antes de usar a operação:

  • Para operações que exigem mapas ou esquemas, você pode:

    • Carregar esses artefatos no seu recurso de aplicativo lógico usando o portal do Azure ou o Visual Studio Code. É possível usar esses artefatos em todos os fluxos de trabalho filho no mesmo recurso de aplicativo lógico. Para obter mais informações, examine Adicionar mapas a serem usados com fluxos de trabalho nos Aplicativos Lógicos do Azure e Adicionar esquemas a serem usados com fluxos de trabalho nos Aplicativos Lógicos do Azure.

    • Vincule o seu recurso de aplicativo lógico à sua conta de integração.

  • Para operações que exigem uma conexão com a sua conta de integração, crie a conexão ao adicionar a operação ao seu fluxo de trabalho.

Para saber mais, consulte a seguinte documentação:

• Fluxos de trabalho de integração empresarial B2B (entre empresas)
• Criar e gerenciar contas de integração para fluxos de trabalho B2B

AS2 (v2)
(Somente fluxo de trabalho Standard)

Codificar e decodificar mensagens que usam o protocolo AS2.

EDIFACT

Codificar e decodificar mensagens que usam o protocolo EDIFACT.

Arquivo simples

Codificar e decodificar mensagens XML entre parceiros comerciais.

Pesquisa de artefato da conta de integração

Obter metadados personalizados para artefatos, como parceiros comerciais, contratos, esquemas e assim por diante, em sua conta de integração.

Operações do Liquid

Converta os seguintes formatos usando modelos Liquid:

- JSON para JSON
- JSON para TEXTO
- XML para JSON
- XML para TEXTO

RosettaNet

Codificar e decodificar mensagens que usam o RosettaNet.

SWIFT
(Somente fluxo de trabalho Standard)

Codificar e decodificar transações SWIFT (Global Interbank Financial Telecommuncation) em formato de mensagem XML de arquivo simples.

X12

Codificar e decodificar mensagens que usam o protocolo X12.

Operações XML

Execute operações com XML.

Compor XML com esquema: crie XML a partir de JSON usando um esquema para um fluxo de trabalho padrão.

Analisar XML com esquema: Analise XML usando um esquema para um fluxo de trabalho padrão.

Transformar XML: converta XML usando um mapa.

Validar XML: valide XML de entrada ou saída usando um esquema.

Próximas etapas

Criar APIs personalizadas que podem ser chamadas a partir dos Aplicativos Lógicos do Azure