Patrones de operación válidos en Jitterbit Studio

Introducción

Las operaciones deben ser válidas antes de que puedas implementarlas. Esta página cubre cómo identificar operaciones inválidas, los patrones de validación que las operaciones deben seguir y ejemplos de cada patrón.

Operaciones inválidas

Para nuevos proyectos, el lienzo de diseño resalta los elementos inválidos por defecto cuando se selecciona Resaltar elementos inválidos. Para desactivar esta opción, desmarca esta selección:

resaltar elementos inválidos

Cuando seleccionas Resaltar elementos inválidos, las operaciones o componentes inválidos se muestran con un contorno rojo y un ícono inválido junto a su nombre en el lienzo de diseño:

operación inválida

En el panel del proyecto, los nombres de los flujos de trabajo y componentes inválidos se listan en cursiva roja y se muestran con un ícono inválido:

operación inválida

Haz clic en el ícono inválido junto al nombre de la operación para mostrar un mensaje que enumera los errores de validación para la operación.

El ícono inválido no se muestra si la operación es invá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 la operación sea válida. Este requisito incluye componentes utilizados como pasos de una operación, así como otros componentes utilizados en apoyo a una operación. Los siguientes ejemplos ilustran este requisito:

Un componente utilizado directamente como un paso en la operación, como una actividad, transformación o script.
Un endpoint del cual depende una actividad utilizada en la operación.
Un componente que un script en la operación llama.

Las reglas de validación dependen del tipo de componente. Para más información, consulta Validez del componente.

Para una referencia completa de los mensajes de error de validación y sus resoluciones, consulta Solución de problemas de diseño de operaciones.

Patrones de validación

Las operaciones deben seguir ciertos patrones de validación antes de que puedas implementarlas en la nube de Harmony y ejecutarlas en los agentes de Jitterbit. Estos patrones aseguran que los agentes soporten y esperen todas las partes de un proyecto.

La siguiente leyenda muestra la definición de las líneas de flujo utilizadas en los diagramas de patrones:

Línea de flujo	Definición
	Un componente requerido.
	Un componente opcional.
	Cero o más scripts o Control de Flujo herramientas son válidos.

Preguntas frecuentes (FAQ)

A medida que diseñas operaciones, las siguientes preguntas frecuentes pueden ser útiles:

¿Cuál es la diferencia entre una fuente y un destino?
Las actividades funcionan como una fuente si proporcionan datos dentro de una operación. Las actividades funcionan como un destino si reciben datos dentro de una operación. Para obtener información adicional sobre fuentes versus destinos y las partes de la operación, consulta Creación y configuración de operaciones.
¿Qué patrones son válidos con mi punto final?
Las páginas de actividades individuales bajo Conectores documentan los patrones que puedes usar con cada tipo específico de actividad. En cada página de actividad, los patrones específicos que puedes usar aparecen en la sección "Próximos pasos", que suele ser la última sección de cada página de actividad.
¿Qué pasa si mi caso de uso no se ajusta a un patrón válido?
Si un cierto arreglo de operación deseado no se adhiere a un patrón válido, es posible que puedas usar una combinación de operaciones que cada una siga un patrón válido. Para hacerlo, crea cada operación por separado y luego encadénalas utilizando acciones de operación.
¿Cuáles son los errores de validación comunes?
Los problemas más comunes incluyen operaciones que no coinciden con ningún patrón válido, transformaciones sin actividades requeridas y desajustes de esquema. Para obtener una lista completa de errores de validación y cómo resolverlos, consulta Solución de problemas de diseño de operaciones.

Consejo

A medida que te familiarices con los patrones, estas generalizaciones pueden ayudar:

Conectores basados en archivos como FTP, HTTP y Almacenamiento Temporal se pueden usar sin transformaciones.
Conectores de aplicaciones como Salesforce, NetSuite y Workday generalmente requieren transformaciones.
Scripts se pueden agregar casi en cualquier lugar de una operación.
Operaciones masivas como Salesforce Bulk tienen patrones específicos y no pueden usar transformaciones.

Patrón de archivo

El patrón de archivo está destinado para su uso con actividades de origen y destino que interactúan con archivos. Se puede utilizar este patrón para almacenar datos inactivos (en su formato de archivo original) de un sistema de producción a un sistema de almacenamiento seguro para su recuperación posterior.

Script(s) o Control de Flujo tools + Actividad de Origen + Script(s) + Actividad de Destino + Script(s)

Ejemplo

Caso de uso: Hacer una copia de seguridad de los archivos de pedidos de clientes desde FTP a almacenamiento en la nube.

operación transferencia de archivo simple

Esta operación archiva archivos moviéndolos de un servidor FTP a un almacenamiento temporal sin ninguna transformación.

En este patrón, las actividades de origen y destino pueden asociarse con cualquiera de los siguientes tipos de puntos finales:

^A Si una cadena de operaciones contiene una actividad de API, debe ser la única actividad de API o solicitud de API SOAP en la cadena de operaciones, y debe ser la fuente de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un script o una acción de operación "en éxito" o "en fallo".

^B Solo se pueden usar actividades no masivas en esta ubicación.

Patrón de script

Script(s) o Control de Flujo herramientas + Actividad Objetivo

Ejemplo

Caso de uso: Generar y guardar una marca de tiempo de informe diario.

operación generar marca de tiempo

Esta operación utiliza un script para generar una marca de tiempo formateada y un nombre de informe, luego lo escribe en una variable global para su uso en operaciones posteriores.

En este patrón, la actividad objetivo puede asociarse con cualquiera de los siguientes tipos de punto final:

Patrón de transformación

Script(s) o Control de Flujo herramientas + (Grupo: Actividad Fuente + Script[s] o Control de Flujo herramientas) + Transformación + (Grupo: Script[s] o Control de Flujo herramientas + Actividad Objetivo) + Script[s] ^{E, F}

Ejemplo

Caso de uso: Sincronizar contactos de Salesforce a una base de datos.

operación FTP leer

Esta operación consulta contactos recientes de Salesforce, transforma los datos para que coincidan con el esquema de la base de datos e inserta los registros en una tabla de base de datos de clientes.

En este patrón, las actividades de origen y destino pueden asociarse con cualquier tipo de punto final, 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 operaciones contiene una actividad de API, debe ser la única actividad de API o de solicitud SOAP de API en la cadena de operaciones, y debe ser la fuente de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un script o una acción de operación "en éxito" o "en fallo".

^B Solo se pueden usar actividades no masivas en esta ubicación.

^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, 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 ninguna otra actividad excepto aquellas asociadas con los conectores de API, Base de Datos, Compartición de Archivos, FTP, HTTP, Almacenamiento Local, Almacenamiento Temporal, o Variable.

Patrón de archivo de dos objetivos

Puedes utilizar el patrón de archivo de dos objetivos para almacenar datos inactivos (en su formato original) desde un sistema de producción a un sistema de almacenamiento seguro para su recuperación posterior.

Script(s) o Control de Flujo tools + (Grupo: Actividad de Origen 1 + Script[s]) o Control de Flujo tools + Transformación + Actividad de Destino 1 / Actividad de Origen 2 + Script(s) o Control de Flujo tools + Actividad de Destino 2 + Script(s) o Control de Flujo tools ^{C, D}

Ejemplo

Caso de uso: Crear un caso de Salesforce y archivar la respuesta.

operación crear caso

Esta operación recupera datos de tickets de soporte de una API, los transforma para crear un Caso de Salesforce y luego archiva la respuesta de Salesforce en una variable global. La respuesta de Salesforce pasa sin cambios al segundo objetivo sin transformación adicional.

En este patrón, la actividad de destino secundaria archiva una respuesta de la actividad intermedia, que funciona tanto como el primer objetivo como la segunda fuente.

La respuesta de la actividad intermedia pasa a través de los datos de respuesta sin procesar a un segundo objetivo sin transformarlo. Puedes pensar en esto como un archivo o como un paso de datos (a veces referido como un passthrough).

Las actividades de origen y destino deben estar asociadas con ciertos tipos de puntos finales dependiendo de dónde las utilices en el patrón:

Actividad de Origen 1 ^A: Si se utiliza, la primera actividad de origen puede asociarse con cualquier tipo de punto final.
Actividad de Destino 1 / Actividad de Origen 2: La primera actividad de destino (también referida como la segunda actividad de origen) puede asociarse con cualquiera de los siguientes tipos de puntos finales:
- NetSuite
- Salesforce ^{B, D}
- Salesforce Service Cloud ^{B, D}
- SAP
- ServiceMax ^{B, D}
- SOAP
Nota

Una variación de este patrón utilizando HTTP como la actividad intermedia es el patrón de archivo HTTP de dos objetivos.
Actividad de destino 2: La segunda actividad de destino puede estar asociada con cualquiera de los siguientes tipos de punto final:

^A Si una cadena de operación contiene una actividad de API, debe ser la única actividad de API o solicitud de API SOAP en la cadena de operación, y debe ser la fuente de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un script o una acción de operación "en éxito" o "en fallo".

^B Solo se pueden usar actividades no masivas en esta ubicación.

^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 ninguna otra actividad excepto aquellas asociadas con los conectores de API, Base de Datos, Compartición de Archivos, FTP, HTTP, Almacenamiento Local, Almacenamiento Temporal, o Variable.

Patrón de archivo HTTP de dos objetivos

Puedes usar el patrón de archivo HTTP de dos objetivos para almacenar datos inactivos (en su formato original) desde un sistema de producción a un sistema de almacenamiento seguro para su recuperación posterior utilizando protocolos y servicios HTTP.

Script(s) o Control de Flujo tools + Actividad de Origen 1 + Script(s) o Control de Flujo tools + Transformación + Script(s) o Control de Flujo tools + Actividad de Destino 1 / Actividad de Origen 2 + Actividad de Destino 2 + Script(s) o Control de Flujo tools

Ejemplo

Caso de uso: Procesar un pago y registrar la respuesta.

operación de procesamiento de pagos

Esta operación consulta registros de pagos pendientes desde una base de datos, transforma los datos para que coincidan con el formato de solicitud de la API de pagos, agrega encabezados de autenticación a través de un script, publica en la API del gateway de pagos y archiva la respuesta HTTP en un almacenamiento temporal para fines de auditoría.

En este patrón, la segunda actividad de destino archiva una respuesta de la actividad intermedia, que funciona tanto como el primer objetivo como la segunda fuente. Este patrón difiere del Patrón de archivo de dos objetivos porque la actividad intermedia es una actividad HTTP.

La respuesta de la actividad HTTP intermedia pasa a través de los datos de respuesta sin procesar a un segundo objetivo sin transformarlo. Puedes pensar en esto como un archivo o como un paso de datos (a veces referido como un passthrough).

Las actividades de origen y destino deben estar asociadas con ciertos tipos de puntos finales dependiendo de dónde las uses en el patrón:

Actividad de Origen 1 ^A: Si se utiliza, la primera actividad de origen puede asociarse con cualquier tipo de punto final.
Actividad de Destino 1 / Actividad de Origen 2: La primera actividad de destino (también conocida como la segunda actividad de origen) puede asociarse con cualquiera de los siguientes tipos de puntos finales:
- HTTP ^C
Actividad de Destino 2: La segunda actividad de destino puede asociarse con cualquiera de los siguientes tipos de puntos finales:

^A Si una cadena de operación contiene una actividad de API, debe ser la única actividad de API o Solicitud API SOAP en la cadena de operación, y debe ser la fuente de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un script o una acción de operación "en éxito" o "en fallo".

^B Solo se pueden utilizar actividades no masivas en esta ubicación.

^C La actividad HTTP debe recibir un cuerpo de solicitud y producir un cuerpo de respuesta. Una actividad HTTP GET devuelve un mensaje que indica éxito {"success": true} o fallo {"success": false} en lugar de la respuesta real.

Patrón de dos transformaciones

Script(s) o Control de Flujo herramientas + (Grupo: Actividad de Origen 1 + Script[s] o Control de Flujo herramientas) + Transformación 1 + Actividad de Destino 1 / Actividad de Origen 2 + Transformación 2 + Script(s) o Control de Flujo herramientas + Actividad de Destino 2 + Script(s) o Control de Flujo herramientas

Ejemplo

Caso de uso: Crear un cliente de NetSuite y procesar la respuesta.

operación cliente netsuite

Esta operación recupera datos de clientes pendientes de una API de CRM, los transforma para crear un registro de cliente en NetSuite, luego transforma la respuesta de NetSuite y actualiza la base de datos local con el ID de NetSuite para referencia futura.

En este patrón, la segunda transformación toma la respuesta de la actividad intermedia (que funciona tanto como el primer objetivo como la segunda fuente), la transforma y luego opcionalmente la escribe en un segundo objetivo.

Las actividades de origen y destino deben estar asociadas con ciertos tipos de puntos finales dependiendo de dónde se utilicen en el patrón:

Actividad de Origen 1 ^A: Si se utiliza, la primera actividad de origen puede asociarse con cualquier tipo de punto final.
Actividad de Destino 1 / Actividad de Origen 2: La primera actividad de destino (también conocida como la segunda actividad de origen) puede asociarse con cualquier tipo de punto final excepto por API, Base de Datos, Compartición de Archivos, FTP, HTTP, Almacenamiento Local, Almacenamiento Temporal, o Variable.
Actividad de Destino 2 ^B: Si se utiliza, la segunda actividad de destino puede asociarse con cualquier tipo de punto final.

^A Si una cadena de operaciones contiene una actividad de API, debe ser la única actividad de API o Solicitud API SOAP en la cadena de operaciones, y debe ser la fuente de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un script o una acción de operación "al éxito" o "al fallo".

^B Solo se pueden utilizar actividades no masivas en esta ubicación.

^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 ninguna otra actividad, excepto aquellas asociadas con los conectores de API, Base de Datos, Compartición de Archivos, FTP, HTTP, Almacenamiento Local, Almacenamiento Temporal, o Variable.

Patrón de origen masivo de Salesforce

Script(s) o Control de Flujo herramientas + Actividad de Origen + Script(s) o Control de Flujo herramientas + Actividad de Destino + Script(s) o Control de Flujo herramientas

Ejemplo

Caso de uso: Extraer un gran conjunto de datos de Salesforce para análisis.

operación consulta masiva de salesforce

Esta operación utiliza una actividad de Consulta Masiva de Salesforce para extraer todas las cuentas creadas este año, y luego escribe los datos en un servidor FTP para la importación al almacén de datos. Utiliza este patrón para extraer grandes conjuntos de datos (típicamente 50,000 o más registros) de manera eficiente sin transformación.

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 puede estar asociada con cualquiera de los siguientes tipos de punto final:

Patrón de destino masivo de Salesforce

Script(s) o Control de Flujo herramientas + Actividad de Origen + Script(s) o Control de Flujo herramientas + Actividad de Destino + Script(s) o Control de Flujo herramientas

Ejemplo

Caso de uso: Carga masiva de datos de clientes en Salesforce.

operación masiva de upsert en salesforce

Esta operación lee un archivo CSV de datos de clientes desde un servidor FTP, valida los datos con un script y luego realiza un upsert masivo a los objetos de Contacto de Salesforce. Utiliza este patrón para cargar grandes conjuntos de datos (típicamente 50,000 o más registros) de manera eficiente sin una transformación.

En este patrón, la actividad de origen puede asociarse con cualquiera de los siguientes tipos de puntos finales:

La actividad de destino puede asociarse con cualquiera de los siguientes tipos de puntos finales: