Patrones de operación válidos en Jitterbit Studio

Introducción

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

Operaciones inválidas

Para proyectos nuevos, el lienzo de diseño resalta elementos inválidos de forma predeterminada cuando se selecciona Highlight Invalid Items. Para desactivar esta opción, desactiva la selección:

highlight invalid items

Cuando seleccionas Highlight Invalid Items, las operaciones o componentes inválidos se muestran con un contorno rojo y un icono inválido junto a su nombre en el lienzo de diseño:

operation invalid

En el panel de proyecto, los nombres de flujos de trabajo y componentes inválidos aparecen en rojo itálico y se muestran con un icono inválido:

invalid operation

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

El icono 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 de una operación. Los siguientes ejemplos ilustran este requisito:

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

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

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

Patrones de validación

Las operaciones deben seguir ciertos patrones de validación antes de poder implementarlas en la nube de Harmony y ejecutarlas en agentes de Jitterbit. Estos patrones garantizan que los agentes admitan 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 herramientas de Control de flujo tools 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 un origen y un destino?
Las actividades funcionan como origen si proporcionan datos dentro de una operación. Las actividades funcionan como destino si reciben datos dentro de una operación. Para obtener más información sobre orígenes versus destinos y las partes de la operación, consulta Creación y configuración de operaciones.
¿Qué patrones son válidos con mi endpoint?
Las páginas de actividad individuales en Conectores documentan los patrones que puedes usar con cada tipo de actividad específico. En cada página de actividad, los patrones específicos que puedes usar aparecen en la sección "Pasos siguientes", que generalmente es la última sección en cada página de actividad.
¿Puedo combinar una actividad de Salesforce con cualquier otro conector?
Cuando una actividad de Salesforce, Salesforce Service Cloud o ServiceMax recibe datos como destino, la actividad de origen puede asociarse con cualquier tipo de endpoint. Cuando una de estas actividades proporciona datos como origen, la actividad de destino debe asociarse con el conector API, Base de datos, Recurso compartido de archivos, FTP, HTTP, Almacenamiento local, Almacenamiento temporal o Variable. Una operación también puede incluir solo una actividad de NetSuite, Salesforce, Salesforce Service Cloud, SAP, ServiceMax o SOAP.
¿Qué pasa si mi caso de uso no se ajusta a un patrón válido?
Si 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 usando 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 operaciones.

Consejo

A medida que te familiarices con los patrones, estas generalizaciones pueden ser útiles:

Los conectores basados en archivos como FTP, HTTP y Almacenamiento temporal se pueden usar sin transformaciones.
Los conectores de aplicaciones como Salesforce, NetSuite y Workday generalmente requieren transformaciones.
Los scripts se pueden agregar casi en cualquier lugar de una operación.
Las operaciones masivas, como las que usan actividades masivas de Salesforce, tienen patrones específicos y no pueden usar transformaciones.

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. Puedes usar 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 herramientas de Control de flujo tools + Actividad de origen + Script(s) + Actividad de destino + Script(s)

Ejemplo

Caso de uso: Respaldar archivos de pedidos de clientes de FTP al almacenamiento en la nube.

operation simple file transfer

Esta operación archiva archivos moviéndolos desde un servidor FTP al 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 punto de conexión:

^A Si una cadena de operaciones contiene una actividad de API, debe ser la única actividad de API o API SOAP Request en la cadena de operaciones, y debe ser el origen de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un script o desde una acción de operación "on success" u "on failure".

^B Solo se pueden usar actividades que no sean de carga masiva en esta ubicación.

Patrón de script

Script(s) o herramientas de Control de flujo tools + Actividad de destino

Ejemplo

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

operation generate timestamp

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 usarlo en operaciones posteriores.

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

Patrón de transformación

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

Ejemplo

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

operation FTP read

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 de conexión, siempre que incluyas 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 API SOAP Request en la cadena de operaciones, y debe ser el origen de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un script o desde una acción de operación "on success" u "on failure".

^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 En una operación que incluye una actividad de Salesforce, Salesforce Service Cloud o ServiceMax, los conectores permitidos para las otras actividades dependen de la dirección de los datos. Cuando la actividad de Salesforce, Salesforce Service Cloud o ServiceMax recibe datos como destino, la actividad de origen se puede asociar con cualquier tipo de punto de conexión. Cuando proporciona datos como origen, la actividad de destino debe asociarse con el conector API, Base de datos, Recurso compartido de archivos, FTP, HTTP, Almacenamiento local, Almacenamiento temporal o Variable.

Patrón de archivo de dos destinos

Se puede usar el patrón de archivo de dos destinos para almacenar datos inactivos (en su formato original) de un sistema de producción en un sistema de almacenamiento seguro para su posterior recuperación.

Script(s) o herramientas de Control de flujo tools + (Grupo: Actividad de origen 1 + Script(s) o herramientas de Control de flujo tools + Transformación + Actividad de destino 1 / Actividad de origen 2 + Script(s) o herramientas de Control de flujo tools + Actividad de destino 2 + Script(s) o herramientas de Control de flujo tools ^{C, D}

Ejemplo

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

operation create case

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 se pasa sin cambios al segundo destino sin transformación adicional.

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

La respuesta de la actividad intermedia pasa los datos de respuesta sin procesar a un segundo destino sin transformarlos. Se puede pensar en esto como un archivo o como un paso de datos (a veces denominado passthrough).

Las actividades de origen y destino deben asociarse con ciertos tipos de puntos de conexión según dónde se usen en el patrón:

Actividad de origen 1 ^A: Si se utiliza, la primera actividad de origen se puede asociar con cualquier tipo de punto de conexión.
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 los siguientes tipos de puntos de conexión:
- 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 de destino 2: La segunda actividad de destino puede asociarse con cualquiera de los siguientes tipos de punto de conexión:

^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 el origen de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un script o desde una acción de operación "al tener éxito" o "al fallar".

^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 En una operación que incluye una actividad de Salesforce, Salesforce Service Cloud o ServiceMax, los conectores permitidos para las otras actividades dependen de la dirección de los datos. Cuando la actividad de Salesforce, Salesforce Service Cloud o ServiceMax recibe datos como destino, la actividad de origen puede asociarse con cualquier tipo de punto de conexión. Cuando proporciona datos como origen, la actividad de destino debe asociarse con el conector API, Base de datos, Recurso compartido de archivos, FTP, HTTP, Almacenamiento local, Almacenamiento temporal o Variable.

Patrón de archivo HTTP de dos destinos

Se puede utilizar el patrón de archivo HTTP de dos destinos para almacenar datos inactivos (en su formato original) de un sistema de producción en un sistema de almacenamiento seguro para su posterior recuperación mediante protocolos y servicios HTTP.

Script(s) o herramientas de Control de flujo tools + Actividad de origen 1 + Script(s) o herramientas de Control de flujo tools + Transformación + Script(s) o herramientas de Control de flujo tools + Actividad de destino 1 / Actividad de origen 2 + Actividad de destino 2 + Script(s) o herramientas de Control de flujo tools

Ejemplo

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

operation payment processing

Esta operación consulta registros de pagos pendientes de una base de datos, transforma los datos para que coincidan con el formato de solicitud de la API de pago, agrega encabezados de autenticación a través de un script, publica en la API de la puerta de enlace de pago y archiva la respuesta HTTP en 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 destino como la segunda fuente. Este patrón difiere del Patrón de archivo de dos destinos porque 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. Se puede considerar esto como un archivo o como un paso de datos (a veces denominado passthrough).

Las actividades de origen y destino deben asociarse con ciertos tipos de punto de conexión según dónde se usen en el patrón:

Actividad de Origen 1 ^A: Si se usa, la primera actividad de origen puede asociarse con cualquier tipo de punto de conexión.
Actividad de Destino 1 / Actividad de Origen 2: La primera actividad de destino (también denominada segunda actividad de origen) puede asociarse con cualquiera de los siguientes tipos de punto de conexión:
- HTTP ^C
Actividad de Destino 2: La segunda actividad de destino puede asociarse con cualquiera de los siguientes tipos de punto de conexión:

^A Si una cadena de operaciones contiene una actividad de API, debe ser la única actividad de API o API SOAP Request en la cadena de operaciones, y debe ser el origen de la primera operación. Es decir, ninguna otra operación puede llamar a esta operación desde un script o desde una acción de operación "on success" u "on failure".

^B Solo se pueden usar 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 indicando éxito {"success": true} o fallo {"success": false} en lugar de la respuesta real.

Patrón de dos transformaciones

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

Ejemplo

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

operation netsuite customer

Esta operación recupera datos de clientes pendientes de una API de CRM, los transforma para crear un registro de cliente de 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 destino como la segunda fuente), la transforma y luego opcionalmente la escribe en un segundo destino.

Las actividades de origen y destino deben asociarse con ciertos tipos de punto de conexión según dónde se usen en el patrón:

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

^A Si una cadena de operaciones contiene una actividad de API, debe ser la única actividad de API o API SOAP Request 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 desde una acción de operación "on success" u "on failure".

^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.

Patrón de origen masivo de Salesforce

Script(s) o Flow Control herramientas + Actividad de origen + Script(s) o Flow Control herramientas + Actividad de destino + Script(s) o Flow Control herramientas

Ejemplo

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

operation salesforce bulk query

Esta operación utiliza una actividad de Bulk Query de Salesforce para extraer todas las cuentas creadas este año, luego escribe los datos en un servidor FTP para importación al almacén de datos. Usa este patrón para extraer conjuntos de datos grandes (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 Bulk Query de Salesforce, actividad de Bulk Query de Salesforce Service Cloud, o actividad de Bulk Query de ServiceMax. La actividad de destino puede estar asociada con cualquiera de los siguientes tipos de endpoint:

Patrón de destino masivo de Salesforce

Script(s) o Flow Control herramientas + Actividad de origen + Script(s) o Flow Control herramientas + Actividad de destino + Script(s) o Flow Control herramientas

Ejemplo

Caso de uso: Cargar datos de clientes de forma masiva en Salesforce.

operation salesforce bulk upsert

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

En este patrón, la actividad de origen puede estar asociada con cualquiera de los siguientes tipos de endpoint:

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