Saltar al contenido

Conector GraphQL

Resumen

El conector GraphQL establece acceso a GraphQL.

Importante

Recomendamos utilizar el conector GraphQL v2 para conectarse a GraphQL ya que permite propiedades de configuración adicionales.

El conector GraphQL proporciona una interfaz para crear una conexión GraphQL, la base que se utiliza para generar instancias de actividades GraphQL. Estas actividades, una vez configuradas, interactúan con GraphQL a través de la conexión.

Se accede al conector GraphQL desde la pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).

Nota

Este conector solo se puede utilizar con agentes privados. Además, es un SDK de conector, al que Jitterbit puede hacer referencia cuando comunica cambios realizados en conectores creados con el SDK del conector.

Documentación de Conexión

Además de la conexión GraphQL, consulte los detalles de conexión GraphQL página. Los detalles de configuración como estos se incluyen en esa página:

  • Primeros pasos: Pasos iniciales para establecer una conexión.
  • Funciones avanzadas: Vistas definidas por el usuario y configuración SSL.
  • Modelo de datos: El modelo de datos que utiliza el conector para representar el extremo.
  • Propiedades de configuraciones avanzadas: Propiedades que se pueden definir para configurar una conexión para configuraciones básicas y avanzadas.

Documentación de la Actividad

En conjunto, una conexión GraphQL específica y sus actividades se denominan extremo GraphQL:

Tipos de actividades GraphQL

  • Consulta: Recupera registros de una tabla en GraphQL y está destinado a ser utilizado como fuente en una operación.

  • Ejecutar: Ejecuta un procedimiento en GraphQL y está destinado a ser utilizado como objetivo en una operación.

Requisitos Previos y Versiones de API Compatibles

El conector GraphQL requiere el uso de una versión de agente 10.1 o posterior. Estas versiones del agente descargan automáticamente la última versión del conector cuando es necesario.

Este conector requiere el uso de un agente privado.

Consulte la documentación para obtener información sobre los nodos y campos del esquema.

El conector GraphQL requiere un tamaño de montón de memoria virtual adicional para ejecutarse correctamente. Consulte estas instrucciones sobre cómo aumentar el tamaño de montón de Tomcat de Jitterbit para ajustar el montón según sea necesario.

Autenticación OAuth

La autenticación OAuth es compatible como se describe en Configurar conexiones OAuth.

Solución de Problemas

Si experimenta problemas con el conector GraphQL, se recomiendan estos pasos de solución de problemas:

  1. Haga clic en el botón Probar en la configuración de conexión para garantizar que la conexión sea exitosa y para garantizar que se descargue la última versión del conector al agente (a menos que se utilice la política Deshabilitar actualización automática del conector política de la organización).

  2. Verifique los registros de operación para cualquier información escrita durante la ejecución de la operación.

  3. Habilite el registro de depurar de operación para agentes privados para generar archivos de registro y datos adicionales.

  4. Habilite el registro detallado del conector para este conector utilizando esta entrada de configuración específica de nombre y nivel de registrador:

    <logger name="org.jitterbit.connector.verbose.logging.GraphQL" level="TRACE"/>
    
  5. Verifique los registros del agente para obtener más información.