Ir para o conteúdo

Conector GraphQL para Jitterbit Studio

Resumo

O conector GraphQL estabelece acesso ao GraphQL.

Importante

Recomendamos o uso do conector GraphQL v2 para se conectar ao GraphQL, pois permite propriedades de configuração adicionais.

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

O conector GraphQL é acessado na aba Endpoints e conectores do projeto do painel de componentes de design (veja o Painel de componentes de design).

Nota

Este conector pode ser usado apenas com agentes privados. Além disso, é um conector baseado no SDK de Conector, que pode ser mencionado pela Jitterbit ao comunicar alterações feitas em conectores construídos com o SDK de Conector.

Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

Documentação da conexão

Além da conexão GraphQL, consulte a página abrangente de detalhes da conexão GraphQL. 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 de Atividades

Juntas, uma conexão GraphQL específica e suas atividades são referidas como um endpoint GraphQL:

Tipos de atividades GraphQL

  • Consulta: Recupera registros de uma tabela no GraphQL e é destinada a ser usada como uma fonte em uma operação.

  • Executar: Executa um procedimento no GraphQL e é destinada a ser usada como um destino 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 um tamanho adicional de heap de memória virtual para funcionar corretamente. Veja estas instruções sobre como aumentar o tamanho do 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ê encontrar problemas com o conector GraphQL, estas etapas de solução de problemas são recomendadas:

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

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

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

  4. Ative o registro detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

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

    Para mais informações sobre o registro detalhado do conector, consulte Registro detalhado para conectores usando agentes privados Jitterbit.

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

  6. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.