Ir para o conteúdo

Conector GraphQL no Jitterbit Studio

Resumo

O conector GraphQL estabelece acesso a GraphQL.

Importante

Recomendamos usar o conector GraphQL v2 para conectar a 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 através da conexão.

Acessa-se o conector GraphQL a partir da aba Endpoints e conectores do projeto da paleta de componentes de design (consulte Paleta de componentes de design).

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 de conexão

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

  • Primeiros passos: Etapas iniciais para estabelecer uma conexão.
  • Recursos avançados: Visualizações definidas pelo usuário e configuração de 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

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

Tipos de atividades GraphQL

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

  • Executar: Executa um procedimento no GraphQL e destina-se a ser usado como destino em uma operação.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado apenas com agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política organizacional Desabilitar atualização automática de conector.

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

O conector GraphQL requer memória virtual adicional de heap para ser executado com sucesso. Consulte 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ê tiver problemas com o conector GraphQL, recomenda-se seguir estas etapas de solução de problemas:

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

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

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

  4. Ative o log 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 log detalhado do conector, consulte Log 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.