Solución de problemas del SDK de Conectores
Solución de problemas
Esta página proporciona consejos y sugerencias para solucionar problemas al usar el SDK de Conectores de Jitterbit. Consulta la página de problemas conocidos para obtener información adicional.
P: He registrado mi conector, editado el archivo de manifiesto y construido el conector; sin embargo, no lo veo en el archivo de registro del agente como cargado. ¿Qué podría estar mal?
R: Si no ves que el conector se esté cargando, o ves un mensaje de error en el registro, verifica que la construcción se haya
realizado correctamente. Descomprime el archivo JAR que se creó y revisa el archivo MANIFEST.MF
dentro, verifica que los archivos estén
todos presentes y que el contenido del manifiesto coincida con lo que pretendías. Si estás ejecutando en Windows, hay un
problema conocido con la construcción de archivos JAR donde la última entrada de un manifiesto se ignora si no hay un retorno de
carro/salto de línea al final. Si, al abrir el archivo en un editor de texto, no ves una línea en blanco
al final, agrégala y prueba a reconstruir y reiniciar tu agente.
Verifica que el registro del conector se haya realizado correctamente utilizando la API de registro para recuperar los conectores registrados para la organización que estás utilizando. El nombre bajo el cual se registra el conector debe ser el mismo que el nombre utilizado en el archivo JSON que describe la interfaz de usuario de Integration Studio y en los archivos fuente de Java. Revisa tanto los registros del agente como los del servidor Tomcat en busca de mensajes que indiquen que el conector ha sido visto y registrado correctamente.
P: Mi conector no aparece en la interfaz de usuario de Integration Studio. ¿Qué podría estar mal?
R: Verifica estos puntos:
- Verifica que el archivo de interfaz de usuario del conector (por defecto,
adapter.json
) sea un JSON válido; el agente reportará errores en el registro si hay algún problema. - Verifica en los registros del agente que el conector ha sido registrado con Harmony; los registros deberían listar la
información proporcionada en el archivo
MANIFEST.MF
, incluyendo el nombre del conector registrado, autor, clave del conector, ID de tipo de entidad de punto final y IDs de actividad. - Usa esta colección de Postman para ver qué adaptadores (conectores) está devolviendo Harmony.
- Verifica que el registro del conector se haya realizado correctamente utilizando la API de registro para recuperar los conectores registrados para la organización que estás utilizando.
- El nombre bajo el cual se registra el conector debe ser el mismo que el nombre utilizado en el archivo JSON que describe la interfaz de usuario de Integration Studio y en los archivos fuente de Java. Revisa tanto los registros del agente como los del servidor Tomcat en busca de mensajes que indiquen que el conector ha sido visto y registrado correctamente.
- Ocasionalmente, puede ser necesario incrementar la versión en el
MANIFEST.MF
del conector, reconstruir y luego volver a implementar para que los cambios se propaguen. - Si usas un agente privado de Windows, intenta reiniciar el agente.
Q: ¿Dónde están los archivos de registro que debo revisar para depurar problemas con el conector?
A: Los archivos de registro son los del servidor Tomcat del agente Jitterbit. Se encuentran en un directorio del agente Jitterbit:
<JITTERBIT_HOME>/tomcat/logs
En el sistema operativo Windows, el registro se llama catalina.<date_stamp>.out
; en el sistema operativo Linux (y el agente de Docker), el archivo de registro actual se llama catalina.out
y a medida que se hace más grande, se cambia a catalina.<date_stamp>.out
.
Q: Al intentar ejecutar operaciones con mi conector, devuelven un error de conversión de tipo autorreferencial en los registros de operación. ¿Cómo puedo solucionar esto?
A: Si el error de conversión de tipo se parece a
Caused by: java.lang.ClassCastException: org.jitterbit.connector.connectorName.ConnectorNameConnection cannot be cast to org.jitterbit.connector.connectorName.ConnectorNameConnection
,
sigue este procedimiento:
- Detén el agente.
- Elimina el archivo JAR del conector del directorio de conectores del agente.
- Reinicia el agente.
- Agrega nuevamente el archivo JAR del conector.