Connector Builder

O Connector Builder é uma ferramenta de integração de API sem código que permite conectar qualquer aplicativo de Nuvem ou serviço personalizado. Crie conectores (pacotes) personalizados para vários aplicativos ou serviços da web que usam APIs e depois use-os nas automações.

Nota:
  • O Connector Builder está disponível com Nuvem e No local da AWS e GCP.
  • O Connector Builder requer a licença Enterprise Platform. Para mais informações sobre as versões compatíveis com este recurso, consulte Enterprise Platform.

Visão geral

Conectores ou pacotes na Control Room são a base de qualquer tipo de automação. Um pacote é criado para executar certas tarefas e a Control Room inclui vários pacotes para realizar várias tarefas. Embora a Control Room forneça vários pacotes, é possível querer criar e usar os pacotes próprios ou os pacotes de terceiros que no momento estão indisponíveis na Control Room para as automações. Um conector é um pacote que conecta a Control Room com qualquer aplicativo via API e pode realizar uma ou mais operações no aplicativo, por exemplo, criar ou atualizar recursos. Observe que o conector e o pacote são usados de modo intercambiável. Ambos se referem à integração personalizada criada com o Connector Builder.

Você também pode importar arquivos de definição de API usando o Connector Builder para criar conectores personalizados. O Connector Builder oferece suporte às versões 2.x e 3.x do Open API.

Fluxo de arquivos no Connector Builder

O Connector Builder agora oferece suporte à transmissão de arquivos, permitindo que você crie pacotes personalizados para operações baseadas em arquivos, que você pode usar em Tarefas de API. O streaming de arquivos permite que os pacotes processem arquivos diretamente da fonte de dados. A transmissão de um arquivo binário a partir da fonte elimina a necessidade de baixar e carregar os arquivos com ações individuais.

Nota:
  • Não há restrições quanto ao tipo e tamanho do arquivo.
  • Atualmente, os parâmetros do corpo GraphQL não são compatíveis.
Ações com download de arquivo
Para ações que envolvem download de arquivos, marque a caixa Transmitir arquivos durante o download. Depois de marcar essa caixa de seleção, o sistema transmite o arquivo para download e você pode atribuir uma variável de arquivo a essa transmissão de arquivo. Essa caixa de seleção está disponível para todos os métodos HTTPS.
Ações com upload de arquivo
Para ações que envolvem upload de arquivos, adicione um parâmetro de corpo relevante de acordo com os requisitos do provedor da API. As configurações de ação na página do editor exibem uma opção para procurar arquivos.
Se o provedor da API exigir uma entrada de arquivo binário, selecione Binário como o tipo de corpo da solicitação. Quando você seleciona Binário, isso garante que o sistema use uma transmissão de arquivo para o upload.
Se o provedor da API exigir um parâmetro de dados do formulário na solicitação, selecione Dados do formulário como o tipo de solicitação e adicione uma chave com o tipo Arquivo. Isso permite que você selecione uma variável de arquivo como entrada para upload usando a ação criada.

Você também pode combinar os pacotes personalizados com os pacotes compatíveis com transmissão de arquivos pré-construídos no seu fluxo de trabalho de Tarefas de API. Consulte Transmissão de arquivo utilizando a variável de arquivo para mais informações sobre os pacotes integrados que permitem transmissão de arquivos.

Benefícios

O Connector Builder é útil nestas situações:

  • Para criar pacotes não disponíveis na Control Room.
  • Para criar pacotes usando APIs privadas (internas).
  • Para incluir ações adicionais aos Pacotes existentes disponíveis na Control Room.
  • Para criar pacotes personalizados se os Pacotes disponíveis na Control Room não atenderem às suas necessidades.

Exemplo de fluxo de trabalho

O exemplo a seguir descreve como criar, editar, configurar ações e personalizar conectores personalizados:

  1. Criar conector personalizado
  2. Configurar ação no editor de conector
  3. Usar o editor de conector
  4. Publicar conector personalizado
Fluxo de trabalho do Connector Builder
Nota: Ao criar pacotes usando a ferramenta Connector Builder, é necessário gerenciar os pacotes. Gerenciar os pacotes inclui atualizar os pacotes, publicar os pacotes, corrigir quaisquer erros e gerenciar as versões do pacote.

Recursos