Errores y reglas de validación de componentes en Jitterbit Integration Studio

Introducción

Los componentes deben ser válidos para poder desplegarse. Esta página explica cómo identificar componentes no válidos y ver los errores de validación asociados a ellos, así como también cómo resolverlos.

Errores de validación

Esta sección cubre cómo identificar componentes de proyecto no válidos y ver los errores de validación asociados con componentes no válidos.

Para los proyectos nuevos, los elementos no válidos se resaltan de forma predeterminada en el tela de diseño, con la selección predeterminada de Resaltar elementos no válidos. Para desactivar esta opción, desmarque esta opción:

Cuando se selecciona Resaltar elementos no válidos, los componentes no válidos se delinean con un borde rojo en el tela de diseño:

En el panel del proyecto, los nombres de los componentes no válidos también aparecen en cursiva y en color rojo. Además, los componentes no válidos que tienen un error implícito se muestran con un Icono de error. Este icono no se muestra si el componente no es válido porque contiene otros componentes con errores implícitos. Por ejemplo, un flujo de trabajo puede no ser válido porque contiene operaciones u otros componentes que no son válidos, o una operación puede no ser válida porque contiene otros componentes que no son válidos, como se muestra a continuación:

Para mostrar los errores de validación de los componentes identificados como implícitamente no válidos, haga clic en el botón icono de error junto al nombre del componente. Un cuadro de diálogo muestra los errores de validación del componente. Para obtener información detallada sobre qué hace que los componentes no sean válidos y cómo resolver los errores de validación, consulte Reglas de validación, próximo.

Reglas de validación

Se deben seguir ciertas reglas de validación para que los componentes del proyecto se implementen en la nube de Harmony y para que las operaciones en las que se utilizan se ejecuten en agentes de Jitterbit. Estas reglas garantizan que el agente respalde y espere todas las partes de un proyecto. Las reglas de validación para flujos de trabajo y operaciones se tratan en estas páginas:

• Validez del Flujo de trabajo
• Validez de la operación

Las reglas para otros componentes individuales del proyecto se detallan a continuación.

Los nombres deben ser únicos

Los nombres de algunos tipos de componentes del proyecto deben ser únicos para cada tipo de componente.

Dependiendo de qué componente no sea válido, se devuelve la variación adecuada de este mensaje de error si no se cumple esta regla:

[Operation / Connection / Activity / Transformation / Script / Email / Variable] names must be unique.

Al crear un nuevo componente de proyecto desde cero, la validación de campo incluida en la pantalla de configuración de componentes no le permitirá proporcionar el mismo nombre para varios componentes de proyecto. Sin embargo, puede recibir este mensaje de error si, por ejemplo, ha importado un proyecto que contiene componentes con nombres duplicados.

Si recibe uno de estos errores, asegúrese de haber asignado un nombre único a cada componente del proyecto y cambie el nombre de los duplicados cuando sea necesario. Los vínculos de documentación para cada componente del proyecto se proporcionan en Componentes del proyecto página.

Los componentes del proyecto deben ser válidos

Las reglas de validación dependen del tipo de componente.

Actividades

Para que una actividad sea válida, debe estar configurada correctamente. Si una actividad no se ha configurado o está mal configurada, se devuelve este mensaje de error de validación:

Activity is not configured properly.

Este mensaje aparece en algunos escenarios comunes:

• Cuando se agregan nuevas actividades a una operación desde la paleta de componentes de diseño, todavía no están configuradas, por lo que puede recibir este mensaje de error si agregó una nueva actividad sin configurarla aún. Para resolverlo, abra la pantalla de configuración de la actividad y configure la actividad.
• Si la actividad está configurada parcialmente o si no se ha cumplido con la validación de campos individuales dentro de la configuración de la actividad, también puede recibir este mensaje de error. Para resolverlo, abra la configuración de la actividad y complete todos los campos obligatorios con datos válidos.

Algunos conectores están disponibles y solo se pueden usar en ambientes asociados con un grupo de agentes privados. Aunque no se pueden crear nuevas conexiones y actividades mediante estos conectores en agentes de la nube, es posible migrar o importar proyectos creados con estos conectores a un ambiente de agente de la nube. En esta situación, las conexiones y actividades creadas mediante conectores solo para agentes privados no son válidas y se muestra este mensaje de error:

Connector is only available on private agents.

Las actividades pueden estar sujetas a sus propias reglas de validación exclusivas, que se describen en la documentación de la actividad. Por ejemplo, una de esas actividades es la Actividad de reconocimiento para RabbitMQ conector.

Si una actividad no es válida por alguna otra razón que no se puede determinar fácilmente, se devuelve este mensaje de error:

Activity is invalid.

Para resolverlo, consulte la documentación de cada actividad disponible en Conectores.

Secuencias de comandos

Para que un secuencia de comandos sea válido, debe estar configurado correctamente. Si un secuencia de comandos no está configurado, se devuelve este mensaje de error de validación:

Script is not configured properly.

Este mensaje aparece con mayor frecuencia cuando se ha agregado un nuevo secuencia de comandos a una operación y está vacío. Para resolverlo, abra la pantalla de configuración del secuencia de comandos y luego cree un secuencia de comandos en el editor.

Además, para que un Jitterbit Script para que sea válido, no debe tener ningún error de validación dentro del secuencia de comandos en sí. Si un Jitterbit Script contiene errores de validación, se devuelve un mensaje de error de validación específico o este mensaje de error de validación:

Script is invalid.

Para resolverlo, abra el editor de secuencia de comandos y ver los errores del secuencia de comandos. También recomendamos probar el secuencia de comandos para garantizar que el resultado sea el esperado. Hay documentación adicional disponible en Secuencias de comandos.

Transformaciones

Para que una transformación sea válida, debe estar configurada correctamente. Si una transformación no se ha configurado o está mal configurada, se devuelve este mensaje de error de validación:

Transformation is not configured properly.

Este mensaje aparece con mayor frecuencia cuando se ha agregado una nueva transformación a una operación y aún no se ha configurado. Para resolverlo, abra la pantalla de configuración de la transformación y luego configure la transformación según corresponda.

Además, para que una transformación sea válida, no debe tener ningún error de validación dentro de la propia transformación. Para que se considere válida, una transformación debe cumplir estas reglas:

• Un mapeo no puede contener referencias a campos o variables inexistentes.
• Una asignación no puede contener conflictos de tipos de datos.
• Un nodo de bucle de destino no puede tener múltiples fuentes.
• Se debe proporcionar un esquema para una actividad de origen o destino adyacente.

Además, es posible que ciertos campos de destino requieran una asignación o no la permitan. Las asignaciones no válidas se indican visualmente en la pantalla de configuración de la transformación (consulte Validez de la asignación de la Transformación).

Dependiendo del error, se devuelve la variación apropiada de estos posibles mensajes de error si no se cumple esta regla:

Mapping refers to a non-existent [source / target / variable] field $[path].

Potential data type conflict in mapping.

Target field $[node.name] [must be mapped / cannot be mapped].

Mappings of a target loop node depend on more than one source loop node.

[Source / Target] schema must be provided.

Para resolverlo, pruebe estos consejos de solución de problemas:

• Si tiene referencias a campos inexistentes, conflictos de tipos de datos u otras asignaciones no válidas, busque la asignación no válida y desasignela o verifique el esquema para asegurarse de que se tengan en cuenta todos los campos y de que tengan tipos de datos compatibles. Si tiene referencias a variables inexistentes, verifique que la variable variable existe.
• Si tiene un nodo de bucle de destino que depende de más de un nodo de bucle de origen, siga las instrucciones proporcionadas en Mapeo desde una fuente de múltiples instancias a un destino de una sola instancia en Estructuras de datos.
• Si tiene actividades de origen o destino adyacentes a la transformación, asegúrese de proporcionar un esquema para cada una. Los esquemas de archivos se pueden proporcionar desde dentro de la actividad durante su configuración (consulte la documentación de cada conector), o bien definiendo un esquema directamente desde dentro de la transformación.

Además, si una transformación no es válida por alguna otra razón que no se puede determinar fácilmente, se devuelve este mensaje de error:

Transformation is invalid.

Para obtener información más detallada, consulte Validez del mapeo de Transformación, así como páginas adicionales en Transformaciones.