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:

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)https://www.w3.org/TR/REC-xml/#sec-cdata-sect) 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>"
}

Reprocesamiento de esquemas XML reflejados

Debido a los cambios realizados en las versiones de Harmony 10.25 y 10.27, es posible que observe un comportamiento diferente en proyectos creados antes de estas versiones. Estos cambios afectan a los esquemas XML que se han replicado y es más probable que afecten las asignaciones que utilizan funciones XML que involucran espacios de nombres, como el SelectNodes Función. En este caso, las asignaciones que antes eran válidas pueden ahora ser inválidas debido a un error relacionado con la sintaxis de la función XML.

Compare las diferencias entre este ejemplo de esquema XML reflejado anterior a la versión 10.25 y uno creado en la versión 10.25 o posterior:

• Ejemplo de esquema XML anterior a la versión 10.25: En proyectos creados antes de la versión 10.25, los esquemas XML reflejados utilizan el prefijo de espacio de nombres predeterminado para documentos XML: xsi Como se muestra resaltado en rojo arriba, xmlns:xsi declara el espacio de nombres y los campos no asignados se muestran en el esquema con el atributo xsi:nil="true".
• Ejemplo de esquema XML en la versión 10.25 y posteriores: En los proyectos creados en la versión 10.25 y posteriores, resaltados en verde arriba, los esquemas XML reflejados usan el prefijo de espacio de nombres ns Para declarar un espacio de nombres calificado. Los campos no asignados no se muestran en el esquema.

En las versiones 10.25 y 10.26, si importó un proyecto con un esquema XML reflejado que se creó antes de la versión 10.25, el esquema se volvió a procesar y se modificó para utilizar el prefijo de espacio de nombres calificado.

A partir de la versión 10.27, los proyectos importados cuyos esquemas XML reflejados se crearon antes de la versión 10.25 conservan el prefijo de espacio de nombres de esquema XML predeterminado, de modo que el esquema sea idéntico al de su creación. Este cambio significa que cualquier proyecto anterior a la versión 10.25 que se importe a la versión actual funcionará según su diseño original.

Para forzar la actualización de un esquema XML anterior a la versión 10.25 para utilizar el prefijo de espacio de nombres actualizado, puede regenerar el esquema actualizándolo o reconfigurando la actividad que proporciona el esquema.