Connector Builder

O Connector Builder é uma ferramenta de integração de API sem código que permite conectar qualquer aplicativo de Cloud 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 Cloud e On-Premises 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 packages na Control Room são a base de qualquer tipo de automação. Um package é criado para executar certas tarefas e a Control Room inclui vários packages para realizar várias tarefas. Embora a Control Room forneça vários packages, é possível querer criar e usar os packages próprios ou os packages de terceiros que no momento estão indisponíveis na Control Room para as automações. Um conector é um package 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 API Tasks. 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 API Tasks. Consulte File streaming using file variable 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 packages não disponíveis na Control Room.
  • Para criar packages usando APIs privadas (internas).
  • Para incluir ações adicionais aos Packages existentes disponíveis na Control Room.
  • Para criar pacotes personalizados se os Packages 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 packages usando a ferramenta Connector Builder, é necessário gerenciar os packages. Gerenciar os packages inclui atualizar os packages, publicar os packages, corrigir quaisquer erros e gerenciar as versões do package.

Recursos