Ir para o conteúdo

Conector GraphQL

Resumo

O conector GraphQL estabelece acesso a GraphQL.

Importante

Recomendamos usar o conector GraphQL v2 para conectar-se ao GraphQL pois permite propriedades de configuração adicionais.

O conector GraphQL fornece uma interface para criar uma conexão GraphQL, a base usada para gerar instâncias de atividades GraphQL. Essas atividades, uma vez configuradas, interagem com GraphQL por meio da conexão.

O conector GraphQL é acessado na aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).

Nota

Este conector pode ser usado apenas com agentes privados. Além disso, é um Connector SDK, que pode ser referenciado pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.

Documentação de Conexão

Além da conexão GraphQL, veja os detalhes abrangentes da conexão GraphQL página. Detalhes de configuração como estes estão incluídos nessa página:

  • Introdução: Passos iniciais para estabelecer uma conexão.
  • Recursos avançados: Visualizações definidas pelo usuário e configuração SSL.
  • Modelo de dados: O modelo de dados que o conector usa para representar o endpoint.
  • Propriedades de configurações avançadas: Propriedades que podem ser definidas para configurar uma conexão para configurações básicas e avançadas.

Documentação da Atividade

Juntas, uma conexão GraphQL específica e suas atividades são chamadas de endpoint GraphQL:

Tipos de atividade GraphQL

  • Consulta: Recupera registros de uma tabela no GraphQL e deve ser usado como fonte em uma operação.

  • Executar: Executa um procedimento no GraphQL e deve ser usado como um alvo em uma operação.

Pré-requisitos e Versões de API Suportadas

O conector GraphQL requer o uso de uma versão de agente 10.1 ou posterior. Essas versões de agente baixam automaticamente a versão mais recente do conector quando necessário.

Este conector requer o uso de um agente privado.

Consulte a documentação para obter informações sobre os nós e campos do esquema.

O conector GraphQL requer tamanho de heap de memória virtual adicional para ser executado com sucesso. Veja estas instruções sobre como aumentar o tamanho de heap do Jitterbit Tomcat para ajustar o heap conforme necessário.

Autenticação OAuth

A autenticação OAuth é suportada conforme descrito em Configurar conexões OAuth.

Solução de Problemas

Se você tiver problemas com o conector GraphQL, estas etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar na configuração de conexão para garantir que a conexão seja bem-sucedida e que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política da organização Desativar atualização automática do conector).

  2. Verifique os registros de operação para qualquer informação escrita durante a execução da operação.

  3. Habilite registro de depurar de operação para agentes privados para gerar arquivos de log e dados adicionais.

  4. Habilite conector verbose logging para este conector usando esta entrada de configuração específica de nome e nível do registrador:

    <logger name="org.jitterbit.connector.verbose.logging.GraphQL" level="TRACE"/>

  5. Verifique os logs do agente para mais informações.