Patrones de operación válidos y errores de validación

Introducción

Las operaciones deben ser válidas para poder desplegarse. Esta página explica cómo identificar operaciones no válidas y visualizar los errores de validación asociados, así como cómo resolverlos mediante un patrón de operación válido. También se proporcionan ejemplos de configuraciones de operación comunes.

Errores de validación

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

Al seleccionar Resaltar elementos no válidos, las operaciones o componentes no válidos se resaltan en rojo y tienen un Icono no válido junto a su nombre en el tela de diseño:

En el panel del proyecto, los nombres de los flujos de trabajo y componentes no válidos se enumeran en cursiva roja y se muestran con un icono no válido:

Haga clic en el icono no válido junto al nombre de la operación para mostrar un mensaje que enumera los errores de validación de la operación.

Las operaciones con un error implícito pueden ser inválidas por cualquiera de los motivos enumerados en Errores de operación implícitas al final de esta página.

El El icono de inválido no se muestra si la operación no es válida porque contiene otros componentes con errores implícitos. Los componentes del proyecto utilizados como parte de una operación deben ser válidos para que operación sea válida. Esto incluye los componentes utilizados como pasos de una operación, así como otros componentes utilizados como apoyo a una operación. Por ejemplo:

• Un componente utilizado directamente como paso en la operación, como una actividad, una transformación o un secuencia de comandos.
• Un extremo del que depende una actividad utilizada en la operación.
• Un componente llamado por un secuencia de comandos en la operación.

Las reglas de validación dependen del tipo de componente y están cubiertas colectivamente bajo Validez del componente.

Patrones de validación

Se deben seguir ciertos patrones de validación para que las operaciones se implementen en la nube de Harmony y se ejecuten en agentes de Jitterbit. Estos patrones garantizan que el agente respalde y cumpla con las expectativas de todas las partes de un proyecto:

• Patrón de archivo
• Patrón de Secuencia de comandos
• Patrón de Transformación
• Patrón de archivo de dos objetivos
• Patrón de archivo HTTP de dos destinos
• Patrón de dos transformaciones
• Patrón de origen masivo de Salesforce
• Patrón de destino masivo de Salesforce

La siguiente leyenda muestra la definición de las líneas de flujo que se muestran en las ilustraciones del patrón de validación:

Línea de flujo	Definición
	Un componente obligatorio.
	Un componente opcional.
	Cero o más secuencia de comandos(s) o Control de flujo herramientas son válidos.

Preguntas frecuentes (preguntas frecuentes)

Al diseñar operaciones, puede ser útil considerar las respuestas a estas preguntas frecuentes:

• ¿Cuál es la diferencia entre una fuente y un destino?
  Las actividades se consideran fuente si proporcionan datos dentro de una operación. Se consideran destino si reciben datos dentro de una operación. Para obtener más información sobre orígenes y destinos, y las partes de la operación, consulte Creación y configuración de operaciones.
• ¿Qué patrones son válidos con mi extremo?
  Los patrones que se pueden utilizar con cada tipo específico de actividad están documentados dentro de las páginas de actividad individuales en Conectores. En cada página de actividad, los patrones específicos que se pueden usar se incluyen en la sección "Próximos pasos", que suele ser la última sección.
• ¿Qué pasa si mi caso de uso no se ajusta a un patrón válido?
  Si una determinada disposición de operación no sigue un patrón válido, puede usar una combinación de operaciones que sigan un patrón válido. Para ello, cree cada operación por separado y encadénelas mediante acciones de operación.

• ¿Cómo puedo recordar estos patrones?
  Las operaciones que no siguen un patrón válido se marcan como inválidas y no se pueden desplegar. A medida que se familiarice con los patrones, generalizaciones como estas pueden resultar evidentes:

  • Conectores genéricos basados en archivos, como FTP, HTTP y almacenamiento temporal, se pueden utilizar sin una transformación.
  • En la mayoría de los casos, conectores de aplicación para actividades que no sean masivas, como las de Epicor, ServiceNow y Workday, requieren una transformación.
  • Se pueden agregar Secuencias de comandos prácticamente en cualquier lugar.

• ¿Existen ejemplos de cómo otros han establecido operaciones? Para ver ejemplos comunes que utilizan estos patrones, consulte Ejemplos de patrones de operación comunes al final de esta página, o consulte cada página de actividad individual en Conectores.

Patrón de archivo

El patrón de archivo está diseñado para usarse con actividades de origen y destino que interactúan con archivos. Permite almacenar datos inactivos (en su formato original) desde un sistema de producción a un sistema de almacenamiento seguro para su posterior recuperación.

Secuencia de comandos(s) o Control de flujo herramientas + Actividad de origen + Secuencia de comandos(es) + Actividad de destino + Secuencia de comandos(es)

En este patrón, las actividades de origen y destino se pueden asociar con cualquiera de estos tipos de extremo:

• API ^A
• Compartir archivos
• FTP
• HTTP
• Almacenamiento local
• NetSuite
• Salesforce ^B
• Salesforce Service Cloud ^B
• ServiceMax ^B
• Almacenamiento temporal
• Variable

^A Si una cadena de operación contiene una actividad de API, debe ser la única actividad de API o de solicitud SOAP de API en la operación y debe ser el origen de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un secuencia de comandos ni desde una acción de operación "en caso de éxito" o "en caso de error".

^B En esta ubicación solo se pueden utilizar actividades no masivas.

Patrón de Secuencia de comandos

Secuencia de comandos(s) o Control de flujo herramientas + Actividad objetivo

En este patrón, la actividad de destino se puede asociar con cualquiera de estos tipos de extremo:

• API
• Compartir archivos
• FTP
• HTTP
• Almacenamiento local
• Almacenamiento temporal
• Variable

Patrón de Transformación

Secuencia de comandos(s) o Control de flujo herramientas + (Grupo: Actividad de origen + Secuencia de comandos[s] o Control de flujo herramientas) + Transformación + (Grupo: Secuencia de comandos[s] o Control de flujo herramientas + Actividad objetivo) + Secuencia de comandos[s] ^{E, F}

En este patrón, las actividades de origen y/o destino pueden asociarse con cualquier tipo de extremo, siempre que se incluya al menos una actividad. Una transformación no puede existir por sí sola en una operación sin una actividad.

^A Si una cadena de operación contiene una actividad de API, debe ser la única actividad de API o de solicitud SOAP de API en la operación y debe ser el origen de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un secuencia de comandos ni desde una acción de operación "en caso de éxito" o "en caso de error".

^B En esta ubicación solo se pueden utilizar actividades no masivas.

^C Se debe incluir al menos una actividad; una transformación no puede existir por sí sola.

^D Si se utiliza una consulta de Salesforce, Salesforce Service Cloud o ServiceMax como actividad de origen, entonces se requiere una actividad de destino.

^E Las operaciones no pueden incluir más de una actividad de NetSuite, Salesforce, Salesforce Service Cloud, SAP, ServiceMax o SOAP.

^F Las operaciones que incluyen una actividad de Salesforce, Salesforce Service Cloud o ServiceMax no pueden contener también ninguna otra actividad excepto aquellas asociadas con la API, Base de datos, Compartir archivos, FTP, HTTP, Almacenamiento local, Almacenamiento temporal, o Variable conectores.

Patrón de archivo de dos objetivos

El patrón de archivo de dos destinos permite almacenar datos inactivos (en su formato original) desde un sistema de producción a un sistema de almacenamiento seguro para su posterior recuperación.

Secuencia de comandos(s) o Control de flujo herramientas + (Grupo: Actividad de origen 1 + Secuencia de comandos[s]) o Control de flujo herramientas + Transformación + Actividad de destino 1 / Actividad de origen 2 + Secuencia de comandos(s) o Control de flujo herramientas + Actividad objetivo 2 + Secuencia de comandos(es) o Control de flujo herramientas ^{C, D}

En este patrón, la segunda actividad de destino se utiliza para archivar una respuesta de la actividad intermedia, que funciona tanto como primer destino como segunda fuente.

La respuesta de la actividad intermedia pasa los datos de respuesta sin procesar a un segundo objetivo sin transformarlos. Esto puede considerarse un archivo o una transferencia de datos (a veces denominada transferencia directa).

Las actividades de origen y destino deben estar asociadas con ciertos tipos de extremo según dónde se utilicen en el patrón:

• Actividad de origen 1 ^A: Si se utiliza, la primera actividad de origen se puede asociar con cualquier tipo de extremo.

• Actividad de destino 1 / Actividad de origen 2: La primera actividad de destino (también denominada segunda actividad de origen) se puede asociar con cualquiera de estos tipos de extremo:

  • NetSuite
  • Salesforce ^{B, D}
  • Salesforce Service Cloud ^{B, D}
  • SAP
  • ServiceMax ^{B, D}
  • SOAP

  Nota

  Una variación de este patrón que utiliza HTTP como actividad intermedia es el Patrón de archivo HTTP de dos destinos.

• Actividad objetivo 2: La segunda actividad objetivo se puede asociar con cualquiera de estos tipos de extremo:

  • API
  • Compartir archivos
  • FTP
  • HTTP
  • Almacenamiento local
  • Almacenamiento temporal
  • Variable

^A Si una cadena de operación contiene una actividad de API, debe ser la única actividad de API o de solicitud SOAP de API en la operación y debe ser el origen de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un secuencia de comandos ni desde una acción de operación "en caso de éxito" o "en caso de error".

^B En esta ubicación solo se pueden utilizar actividades no masivas.

^C Las operaciones no pueden incluir más de una actividad de NetSuite, Salesforce, Salesforce Service Cloud, SAP, ServiceMax o SOAP.

^D Las operaciones que incluyen una actividad de Salesforce, Salesforce Service Cloud o ServiceMax no pueden contener también ninguna otra actividad excepto aquellas asociadas con la API, Base de datos, Compartir archivos, FTP, HTTP, Almacenamiento local, Almacenamiento temporal, o Variable conectores.

Patrón de archivo HTTP de dos objetivos

El patrón de archivo HTTP de dos destinos permite almacenar datos inactivos (en su formato original) desde un sistema de producción a un sistema de almacenamiento seguro para su posterior recuperación mediante protocolos y servicios HTTP.

Secuencia de comandos(s) o Control de flujo herramientas + Actividad fuente 1 + Secuencia de comandos(s) o Control de flujo herramientas + Transformación + Secuencia de comandos(s) o Control de flujo herramientas + Actividad de destino 1 / Actividad de origen 2 + Actividad de destino 2 + Secuencia de comandos(es) o Control de flujo herramientas en este patrón, la segunda actividad objetivo se utiliza para archivar una respuesta de la actividad intermedia, que funciona tanto como primer objetivo como segunda fuente. Este patrón es diferente del Patrón de archivo de dos objetivos en que la actividad intermedia es una actividad HTTP.

La respuesta de la actividad HTTP intermedia pasa los datos de respuesta sin procesar a un segundo destino sin transformarlos. Esto puede considerarse como un archivo o una transferencia de datos (a veces denominada "passthrough").

Las actividades de origen y destino deben estar asociadas con ciertos tipos de extremo según dónde se utilicen en el patrón:

• Actividad de origen 1 ^A: Si se utiliza, la primera actividad de origen se puede asociar con cualquier tipo de extremo.
• Actividad de destino 1 / Actividad de origen 2: La primera actividad de destino (también denominada segunda actividad de origen) se puede asociar con cualquiera de estos tipos de extremo:
  • HTTP ^C
• Actividad objetivo 2: La segunda actividad objetivo se puede asociar con cualquiera de estos tipos de extremo:
  • API
  • Compartir archivos
  • FTP
  • HTTP
  • Almacenamiento local
  • Almacenamiento temporal
  • Variable

^A Si una cadena de operación contiene una actividad de API, debe ser la única actividad de API o de solicitud SOAP de API en la operación y debe ser el origen de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un secuencia de comandos ni desde una acción de operación "en caso de éxito" o "en caso de error".

^B En esta ubicación solo se pueden utilizar actividades no masivas.

^C La actividad HTTP debe recibir un cuerpo de solicitud y generar un cuerpo de respuesta. Una actividad HTTP GET devuelve un mensaje indicando que la operación se ha realizado correctamente. {"success": true} o fracaso {"success": false} en lugar de la respuesta real.

Patrón de dos transformaciones

Secuencia de comandos(s) o Control de flujo herramientas + (Grupo: Actividad de origen 1 + Secuencia de comandos[s] o Control de flujo herramientas) + Transformación 1 + Actividad de destino 1 / Actividad de origen 2 + Transformación 2 + Secuencia de comandos(s) o Control de flujo herramientas + Actividad objetivo 2 + Secuencia de comandos(es) o Control de flujo herramientas

En este patrón, la segunda transformación se utiliza para tomar la respuesta de la actividad intermedia (que funciona tanto como primer objetivo como segunda fuente), transformarla y luego, opcionalmente, escribirla en un segundo objetivo.

Las actividades de origen y destino deben estar asociadas con ciertos tipos de extremo según dónde se utilicen en el patrón:

• Actividad de origen 1 ^A: Si se utiliza, la primera actividad de origen se puede asociar con cualquier tipo de extremo.
• Actividad de destino 1 / Actividad de origen 2: La primera actividad de destino (también denominada segunda actividad de origen) se puede asociar con cualquier tipo de extremo, excepto API, Base de datos, Compartir archivos, FTP, HTTP, Almacenamiento local, Almacenamiento temporal, o Variable.
• Actividad de destino 2 ^B: Si se utiliza, la segunda actividad de destino se puede asociar con cualquier tipo de extremo.

^A Si una cadena de operación contiene una actividad de API, debe ser la única actividad de API o de solicitud SOAP de API en la operación y debe ser el origen de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un secuencia de comandos ni desde una acción de operación "en caso de éxito" o "en caso de error".

^B En esta ubicación solo se pueden utilizar actividades no masivas.

^C Las operaciones no pueden incluir más de una actividad de NetSuite, Salesforce, Salesforce Service Cloud, SAP, ServiceMax o SOAP.

^D Las operaciones que incluyen una actividad de Salesforce, Salesforce Service Cloud o ServiceMax no pueden contener también ninguna otra actividad excepto aquellas asociadas con la API, Base de datos, Compartir archivos, FTP, HTTP, Almacenamiento local, Almacenamiento temporal, o Variable conectores.

Patrón de origen masivo de Salesforce

Secuencia de comandos(s) o Control de flujo herramientas + Actividad de origen + Secuencia de comandos(s) o Control de flujo herramientas + Actividad de destino + Secuencia de comandos(s)o Control de flujo herramientas

En este patrón, la actividad de origen debe ser una actividad de consulta masiva de Salesforce, Actividad de consulta masiva de Salesforce Service Cloud, o Actividad de consulta masiva de ServiceMax. La actividad de destino se puede asociar con cualquiera de estos tipos de extremo:

• Compartir archivos
• FTP
• HTTP
• Almacenamiento local
• Almacenamiento temporal
• Variable

Patrón de objetivo masivo de Salesforce

Secuencia de comandos(s) o Control de flujo herramientas + Actividad de origen + Secuencia de comandos(s) o Control de flujo herramientas + Actividad de destino + Secuencia de comandos(s) o Control de flujo herramientas

En este patrón, la actividad de origen se puede asociar con cualquiera de estos tipos de extremo:

• Compartir archivos
• FTP
• HTTP
• Almacenamiento local
• Almacenamiento temporal
• Variable

La actividad de destino se puede asociar con cualquiera de estos tipos de extremo:

• Inserción masiva de Salesforce
• Actualización masiva de Salesforce
• Inserción masiva de Salesforce
• Eliminación masiva de Salesforce
• Eliminación masiva permanente de Salesforce
• Inserción, actualización, inserción adicional, eliminación o eliminación permanente en masa de Salesforce Service Cloud
• Inserción masiva de ServiceMax
• Actualización masiva de ServiceMax
• Inserción masiva de ServiceMax
• Eliminación masiva de ServiceMax
• Eliminación masiva permanente de ServiceMax

Ejemplos de patrones de operación comunes

Esta sección proporciona varios ejemplos comunes de operaciones configuradas con un patrón de operación válido. Estos ejemplos se simplifican para mostrar los componentes básicos de las operaciones comunes y no pretenden abarcar todas las combinaciones posibles. Consulte Patrones de validación más arriba en esta página para conocer todos los arreglos posibles.

Secuencia de comandos

Una operación puede contener simplemente un único secuencia de comandos. En este caso, todas las acciones de la operación las realiza el secuencia de comandos.

Este patrón se utiliza normalmente al comienzo de un flujo de trabajo para crear un " secuencia de comandos de inicio" que ejecuta una o más de varias operaciones de rama en función de una variable del sistema u otro valor de datos.

Los Secuencias de comandos también se pueden usar en cualquier parte de una operación para realizar cálculos complejos que requieren lógica personalizada.

Archivo

Si todo lo que necesita hacer es mover archivos desde una fuente de datos a un destino, puede utilizar una operación sin transformación.

La primera actividad se utiliza como origen y proporciona datos dentro de la operación. La segunda actividad se utiliza como destino y recibe datos dentro de la operación.

Para archivar datos, las actividades de origen y destino se limitan a las que interactúan con archivos. En lugar de una actividad de origen, también se puede usar un secuencia de comandos.

Transformación

Operaciones que hacen uso de transformaciones sirven para diversos casos de uso. Por ejemplo, se pueden crear operaciones que (1) transformen datos de un origen a un destino, (2) transformen datos y luego escriban la respuesta en otro destino, o (3) transformen datos de una llamada a un servicio web convirtiendo la respuesta de la llamada de la aplicación y escribiéndola en un destino.

La operación transforma los datos del origen al destino

Este ejemplo extrae datos de una actividad de origen que luego se transforman y se escriben en una actividad de destino:

La operación transforma los datos y luego escribe la respuesta en otro objetivo

En este ejemplo, cuando se utiliza una actividad HTTP como destino de la transformación, como HTTP PUT o HTTP POST, se puede colocar una actividad de destino adicional directamente después de ésta, o después de otra transformación, para escribir la respuesta HTTP en otro destino.

Esta disposición de operación, utilizada para obtener un token REST, muestra la respuesta HTTP que se escribe en una variable global para su uso en la siguiente operación:

La operación llama a un servicio web

Este ejemplo es para actualizar una aplicación como Salesforce a través de la API de la aplicación, o llamando a un SOAP método de servicio web. La llamada a la aplicación generalmente incluye una estructura de datos de solicitud y respuesta.

En esta disposición la operación tiene tres partes:

• La primera actividad de origen y transformación para construir la estructura de datos de la solicitud.

• La aplicación se llama a sí misma, que funciona como la primera actividad de destino y la segunda actividad de origen.

• Una segunda transformación y objetivo para convertir la respuesta de la llamada de la aplicación y escribir los datos o el archivo en un objetivo.

Llamada de solicitud

Llamada SOAP

Errores de operación implícitos

Las operaciones con un error implícito pueden ser inválidas por cualquiera de las siguientes razones:

Errores de reglas de validación HTTP

Una de las reglas de validación HTTP se aplica a las operaciones que utilizan el patrón de archivo de dos destinos donde una actividad HTTP en la posición Objetivo 1 escribe una respuesta a una segunda actividad de destino (Objetivo 2). En este escenario, la regla de validación exige que una actividad HTTP Objetivo 1 no se utilice en ningún otro patrón de archivo de dos destinos operaciones donde la actividad HTTP Target 1 escribe en una segunda actividad de destino diferente.

Las operaciones que infringen esta regla de validación se reportan como no válidas con un mensaje de error similar a este:

Resolver errores de validación HTTP

Recomendamos seguir las instrucciones del mensaje de error para corregir las operaciones y que sean válidas. Siguiendo estas instrucciones, recomendamos los siguientes pasos:

1. Duplicar la actividad de destino HTTP en la posición Objetivo 1 de una de las operaciones que utilizan el Patrón de archivo HTTP de dos objetivos.

2. Reemplace la actividad de destino HTTP en la posición Target 1 de las operación identificadas con la copia duplicada:

3. Repita este proceso para cualquier operación no válida adicional. Una vez resueltos los errores de validación, vuelva a desplegar las operaciones.

Deshabilitar la regla de validación HTTP

En ciertas situaciones, puede ser conveniente deshabilitar esta regla de validación HTTP de la siguiente manera:

1. Abra la configuración del proyecto:

   

2. En la pestaña Desplegar, deshabilite la Regla de validación HTTP:

   

3. Haga clic en Guardar.

Una vez deshabilitada y guardada la configuración, los errores de validación de operación reportados debido a este error deberían resolverse. Sin embargo, tenga en cuenta que cualquier actividad HTTP Target 1 utilizada en un patrón de archivo de dos destinos la operación escribirá en la actividad Target 2 de la última operación implementada. Esto podría provocar la escritura de datos no válidos.

Volver a habilitar la regla de validación HTTP

Si ya desactivó la regla de validación HTTP y está listo para volver a activarla, siga estos pasos:

1. Abra la configuración del proyecto.

2. En la pestaña Desplegar, habilite la Regla de validación HTTP.

3. Haga clic en Guardar. Tenga en cuenta que este es un cambio en tiempo de diseño y que esta acción no desplegar ningún cambio en la nube de Harmony.

4. Resuelva cualquier error de validación HTTP (consulte Resolver errores de validación HTTP arriba).

5. Vuelva a desplegar el proyecto (consulte Despliegue del proyecto).