Saltar al contenido

Conector GraphQL para Jitterbit Studio

Resumen

El conector GraphQL establece acceso a GraphQL.

Importante

Se recomienda 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 utilizada para generar instancias de actividades de GraphQL. Estas actividades, una vez configuradas, interactúan con GraphQL a través de la conexión.

El conector GraphQL se accede desde la pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).

Nota

Este conector solo se puede utilizar con agentes privados. Además, es un conector basado en Connector SDK, que puede ser mencionado por Jitterbit al comunicar cambios realizados en conectores construidos con el Connector SDK.

Los puntos finales creados con este conector se incluyen en el informe de uso de puntos finales y cuentan para su licencia.

Documentación de conexión

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

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

Documentación de actividad

Juntos, una conexión GraphQL específica y sus actividades se denominan un punto final de GraphQL:

Tipos de actividad 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 destino 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 de 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 funcionar correctamente. Consulte estas instrucciones sobre cómo aumentar el tamaño del montón de Jitterbit Tomcat para ajustar el montón según sea necesario.

Autenticación OAuth

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

Solución de problemas

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

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

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

  3. Habilita el registro de depuración de operaciones para agentes privados para generar archivos de registro y datos adicionales.

  4. Habilita el registro detallado del conector para este conector agregando esta entrada de configuración de registro al archivo logback.xml de tu agente privado:

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

    Para más información sobre el registro detallado del conector, consulta Registro detallado para conectores que utilizan agentes privados de Jitterbit.

  5. Revisa los registros del agente para más información.

  6. Para consideraciones adicionales de solución de problemas, consulta Solución de problemas de operaciones.