Noções básicas sobre conectores

Você está vendo a documentação da Apigee X.
Veja a documentação da Apigee Edge.

O que é um conector?

Um conector fornece um mecanismo para se conectar facilmente com aplicativos e tecnologias por configurações, em vez de exigir que os clientes escrevam códigos. Com um conjunto amplo de conectores, a plataforma é mais útil para os clientes, reduz os transtornos nas vendas e acelera o processo de desenvolvimento de fluxos de integração. Normalmente, os conectores são classificados de duas maneiras diferentes: basicamente, uma combinação de uma tarefa e um gatilho.

1. Conectores de aplicativos: criados para se comunicar especificamente com um tipo de aplicativo, como Salesforce, SAP ou Oracle EBS. O protocolo de comunicação subjacente é transparente para o usuário; assim, o usuário só precisa selecionar o objeto de negócio e a operação que quer usar, que está disponível no aplicativo como uma interface. Os objetos de negócio são exibidos ao usuário nos termos que o aplicativo usa, como pedido de vendas, cotação, fatura, envio, conta do cliente etc.
2. Conectores de tecnologia: são desenvolvidos para se comunicar com uma tecnologia específica, como um banco de dados, um sistema de enfileiramento ou um sistema de arquivos. O "objeto comercial" geralmente é especificado nos termos dessa tecnologia, como uma tabela em um banco de dados, um tópico em um sistema de enfileiramento ou um diretório e um nome de arquivo em um sistema de arquivos.

Os conectores fornecem duas funções principais à plataforma.

1. Conversão de protocolo: o conector sabe como se conectar ao tipo de aplicativo ou tecnologia no próprio protocolo nativo, como o JDBC para um banco de dados ou o SAP RFC para SAP. Depois, ele normaliza o protocolo (como as APIs REST baseadas em OpenAPI Spec) para a Integração da Apigee.
2. Conversão de formato de dados: o conector entende a camada de objeto de dados do aplicativo ao qual ele está conectado como uma tabela de banco de dados ou como um arquivo CSV. Em seguida, ele a normaliza com uma estrutura padrão que a IA pode consumir, como JSON.

   Casos de uso de conectores

   Padrões de caso de uso:

   1. Operações CRUD ou de API para ler ou atualizar dados em um aplicativo.
      1. Baseados em mensagens em tempo real (síncrona).
      2. Padrões assíncronos para sincronização de informações entre aplicativos, às vezes usados em conjunto com o padrão de publicação/assinatura.
         1. Por exemplo: assinar uma fila e usar uma operação CRUD para atualizar o sistema de destino de forma síncrona.
         2. Operação de consulta para procurar um conjunto de dados no aplicativo, se esse aplicativo for compatível com a consulta.
            1. Semelhante a uma consulta SQL do banco de dados, alguns aplicativos aceitam uma linguagem de consulta.
            2. Alguns padrões, como OData e GraphQL, também surgiram para esse caso de uso.
            3. Os eventos empresariais que ocorrem no aplicativo são enviados para a plataforma.
               1. Nem todos os aplicativos têm essa capacidade para enviar eventos para o conector, mas alguns têm, e essa é uma alternativa altamente desejável para a pesquisa por motivos de eficiência.
               2. Como pesquisar alterações.
                  1. O conector faz login para verificar se os novos registros estão prontos e, se estiverem prontos, transfere-os para serem processados pela plataforma (semelhante a uma assinatura de evento conceitualmente e é a solução alternativa caso os eventos de negócios não estejam disponíveis).
                  2. A frequência pode ser de enquetes rápidas (em intervalos de poucos segundos) até enquetes muito longas, como uma vez por hora. A média é de uma vez a cada 15-30 segundos.
                  3. Importação ou exportação baseada em arquivo.
                     1. Geralmente por meio de uma programação em lote usada para sincronizar muitos registros.
                     2. A frequência pode variar de uma vez por mês para uma vez por dia, por hora ou por minuto, dependendo do caso de uso.
                     3. Necessidade de compatibilidade com opções de criptografia/descriptografia e compactação/descompactação de PGP.
                     4. Publicar/Assinar um sistema de enfileiramento.
                        1. Permite que os aplicativos tenham comunicações assíncronas (independentes).
                        2. Fornece um buffer para consumidores lentos.
                        3. Oferece um mecanismo autônomo para o aplicativo de produtor.

                        Para mais informações sobre as tarefas disponíveis do Conector. Veja mais informações sobre como usar os Gatilhos do Conector.