Ir para o conteúdo

Conector GraphQL v2 no Jitterbit Studio

Resumo

O conector GraphQL v2 estabelece acesso a GraphQL.

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

O conector GraphQL v2 é acessado a partir da aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

Os endpoints criados com este conector sã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 v2, consulte a página abrangente de detalhes da conexão GraphQL v2. Detalhes de configuração como estes estão incluídos nessa página:

  • Getting Started: Primeiros passos para estabelecer uma conexão.
  • Advanced Features: Visualizações definidas pelo usuário e configuração de SSL.
  • Data Model: O modelo de dados que o conector usa para representar o endpoint.
  • Advanced Configurations Properties: 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 v2 específica e suas atividades são chamados de endpoint GraphQL:

Tipos de atividades GraphQL v2

  • Query: Recupera registros de uma tabela no GraphQL e é destinado a ser usado como uma origem em uma operação.

  • Execute: Executa um procedimento no GraphQL e é destinado a ser usado como um 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 Disable Auto Connector Update.

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

O conector GraphQL requer memória virtual de heap adicional 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 Configure OAuth connections.

Solução de problemas

Se você tiver problemas com o conector GraphQL v2, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Test 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 Disable Auto Connector Update).

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

  3. Ative o log de debug 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 registro detalhado de conectores, consulte Registro detalhado para conectores usando agentes privados Jitterbit.

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

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