Solución de problemas de funcionamiento en Jitterbit Integration Studio

Introducción

Si experimenta problemas al ejecutar una operación, se recomiendan las siguientes acciones de solución de problemas.

Pruebe la conexión

Para cualquier operación que utilice conectores, en la conexión, haga clic en el botón Probar para comprobar que la conexión es correcta.

Para Connector SDK basados en conectores implementados en operaciones que se ejecutan en agentes privados, hacer clic en el botón Probar garantiza que se descargue la última versión del conector al agente (a menos que se use la política Deshabilitar actualización automática del conector política de la organización)

Consultar los registros de operación

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

Según el tipo de agente, puede hacer lo siguiente para recuperar archivos de registro y datos adicionales:

• Habilitar el registro de depurar de operación (para agentes de la nube o para agentes privados)
• Habilitar el registro detallado del conector (solo agentes privados)
• Consultar los registros de agentes (solo para agentes privados)

Posibles errores en los registros de operación

Las siguientes secciones cubren los errores que pueden estar presentes en un registro de operación y su resolución.

Advertencia de subelemento adicional

Un extra subelement La advertencia en los mensajes de registro generalmente se puede ignorar. Esta advertencia indica que la carga útil de la API de un conector devolvió más de nodos o campos de datos que los definidos en el esquema de datos de respuesta.

Caracteres no permitidos en las asignaciones de esquema XML

Dependiendo de la actividad del conector, estos caracteres no son válidos y generarán un error de tiempo de ejecución:

\x00(NULO)	\x0E(cambiar hacia afuera)
\x01(inicio del encabezado)	\x0F(cambio hacia adentro)
\x02(inicio del texto)	\x1A(carácter sustituto)
\x03(fin del texto)	\x1B(escapar)
\x04(fin de la transmisión)	\x1C(separador de archivos, separador de información cuatro)
\x05(consulta)	\x1D(separador de archivos, separador de información tres)
\x06(reconocer)	\x1E(separador de archivos, separador de información dos)
\x07(campana)	\x1F(separador de archivos, separador de información uno)
\x08(retroceso)	\xD800 a \xDFFF(Caracteres sustitutos altos UTF-16)
\x0B(pestaña vertical)	\xFFFE
\x0C(avance de página)	\xFFFF

Cuando los datos de entrada o salida que se suministran o devuelven de una transformación adyacente a una actividad de conector basada en XML contienen uno de los caracteres anteriores, se devuelve un error específico que hace referencia a dicho carácter en tiempo de ejecución. Por ejemplo, cuando \x1Ecarácter de control está presente en la transformación de respuesta para Epicor Kinetic Obtener actividad BAQ, este error se devuelve en tiempo de ejecución:

The Exception is Invalid white space character (0x1e) in text to output

Elementos XML no compatibles cuando se integran en JSON

Secciones de datos de caracteres (CDATA) no son compatibles con XML incrustado en JSON destinado a enviarse a través de una transformación. Incluir secciones CDATA puede provocar que aparezca el siguiente error en un registro de operación en tiempo de ejecución:

Transformation failed. Error: The operation "Operation" failed.
Error: Failed to convert XML file to JSON.
org.jitterbit.integration.server.engine.EngineSessionException: org.xml.sax.SAXParseException ...

Para solucionar esto, utilice un secuencia de comandos Jitterbit a Replace el &, <, >, ', y " caracteres de toda la sección CDATA, incluida su definición (<![CDATA[ ... ]]>), con &amp, &lt, &gt, &apos, &quot respectivamente. Si es necesario, se puede reemplazar toda la cadena XML que contiene la sección CDATA si la sección no se ajusta a su caso de uso.

El siguiente ejemplo se considera inválido sin reemplazos:

{
  "name": "Jitterbit",
  "data": "<xml><content><![CDATA[<greeting>Hello, world!</greeting>]]></content></xml>"
}