Opciones de operación en Jitterbit Integration Studio

Introducción

Configura las opciones de operación para controlar los tiempos de espera, el registro y el procesamiento de datos. La mayoría de las operaciones funcionan bien con la configuración predeterminada, pero puedes personalizarlas para necesidades específicas.

Acceder a las opciones de operación

Puedes acceder a la opción de Configuración para operaciones desde estas ubicaciones:

• La pestaña Flujos de trabajo del panel del proyecto (ver Menú de acciones del componente en Pestaña Flujos de trabajo del panel del proyecto).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña Componentes del panel del proyecto).
• El lienzo de diseño (ver Menú de acciones del componente en Lienzo de diseño).
• El lienzo de diseño haciendo doble clic en la operación (esto abre Configuración directamente).

Después de que se abra la pantalla de configuración de la operación, selecciona la pestaña Opciones:

Configurar opciones de operación

Las siguientes secciones describen cada opción de operación:

• Tiempo de espera de la operación
• Qué registrar
• Habilitar modo de registro de depuración hasta
• Ejecutar operación de éxito incluso si no hay archivos de origen coincidentes
• Habilitar fragmentación
• Opciones de operación masiva de Salesforce

Tiempo de espera de la operación

Establece cuánto tiempo se ejecuta la operación antes de ser cancelada. El valor predeterminado es de 2 horas, lo cual funciona para la mayoría de las operaciones.

Puede que desee ajustar esta configuración por las siguientes razones:

• Aumentar el tiempo de espera para conjuntos de datos grandes que tardan más en procesarse. Las operaciones programadas que procesan grandes volúmenes de datos pueden necesitar tiempos de espera más largos. Si sus conjuntos de datos superan los límites de tiempo de espera, consulte Habilitar Fragmentación para opciones que dividen grandes conjuntos de datos en lotes más pequeños y controlan el número de registros escritos por archivo de salida.

• Disminuir el tiempo de espera para operaciones sensibles al tiempo que deben completarse rápidamente.

Ingrese un número y seleccione Segundos, Minutos o Horas en el menú desplegable.

Qué registrar

Elija qué información aparece en los registros de operaciones:

• Todo: Registra toda la actividad de la operación (recomendado).
• Solo Errores: Registra solo operaciones con un estado de tipo error (como Error, Fallo de SOAP o Éxito con Error Secundario). Use esta configuración si tiene problemas de rendimiento y no necesita registros detallados. Las operaciones secundarias exitosas no se registran. Las operaciones principales (de nivel raíz) siempre se registran, ya que requieren registro para funcionar correctamente.

Habilitar Modo de Depuración Hasta

Active el registro detallado para la solución de problemas. Seleccione una fecha hasta dos semanas a partir de hoy. El modo de depuración se desactiva automáticamente en esta fecha.

Cuando habilita el modo de depuración para operaciones con operaciones secundarias, puede aplicar la misma configuración a todas las operaciones secundarias utilizando la casilla de verificación También Aplicar a Operaciones Secundarias.

El registro de depuración genera diferentes tipos de registros según el tipo de su agente:

Ejecutar operación de éxito incluso si no hay archivos fuente coincidentes

Esta opción obliga a que una operación tenga éxito incluso cuando su desencadenador falla. Esto permite que otras operaciones desencadenadas para ejecutarse En Éxito de esta operación se ejecuten independientemente del resultado de la operación inicial. Se aplica solo cuando la operación inicial contiene una actividad fuente para uno de estos conectores:

• API
• Compartición de Archivos
• FTP
• HTTP
• Almacenamiento Local
• SOAP
• Almacenamiento Temporal
• Actividad de Variable

Por defecto, cualquier operación En Éxito se ejecuta solo si tiene un archivo fuente coincidente para procesar. Esta opción puede ser útil para configurar partes posteriores de un proyecto sin requerir el éxito de una operación dependiente.

Habilitar Fragmentación

La fragmentación divide grandes conjuntos de datos en fragmentos más pequeños (lotes). Esto hace que el procesamiento sea más rápido y ayuda a cumplir con los límites de registros de la API. Para habilitar la fragmentación, su operación debe contener una transformación o una actividad de uno de estos conectores:

• Base de Datos
• NetSuite
• Salesforce
• Salesforce Service Cloud
• ServiceMax
• Actividad SOAP

Usa el procesamiento por lotes en estas situaciones:

• Procesas grandes conjuntos de datos con miles de registros.
• Utilizas servicios web con límites de registros. Por ejemplo, Salesforce permite solo 200 registros por llamada.
• Quieres usar múltiples núcleos de CPU para procesamiento en paralelo.

Cuando una actividad de Salesforce, Salesforce Service Cloud o ServiceMax está en la operación, el procesamiento por lotes se habilita automáticamente.

Cuando esta configuración está habilitada, configura estos campos:

• Tamaño del Lote: El número de registros en cada lote. El valor predeterminado es 1 para la mayoría de las operaciones y 200 para las operaciones de Salesforce.

  Nota

  Cuando uses una actividad de (Salesforce, Salesforce Service Cloud o ServiceMax) en modo masivo, cambia este valor predeterminado a un número mucho mayor, como 10,000.

• Número de Registros por Archivo: El número de registros que se escribirán en cada archivo de destino (lote). El valor predeterminado es 0, lo que significa sin límite.

• Número Máximo de Hilos: El número de hilos de procesamiento que se ejecutan al mismo tiempo. El valor predeterminado es 1 para la mayoría de las operaciones y 2 para las operaciones de Salesforce.

Opciones de operación masiva de Salesforce

Las siguientes opciones aparecen solo para operaciones masivas de Salesforce, Salesforce Service Cloud y ServiceMax (excepto las operaciones de Consulta Masiva):

• Escribir registros de éxito en: Elija dónde enviar los registros exitosos después de que se complete la operación masiva. Seleccione entre actividades basadas en archivos configuradas: HTTP, API, FTP, Compartición de Archivos, Almacenamiento Local, Almacenamiento Temporal, o Variable. Predeterminado: Ninguno.

• Escribir registros de fallo en: Elija dónde enviar los registros fallidos después de que se complete la operación masiva. HTTP, API, FTP, Compartición de Archivos, Almacenamiento Local, Almacenamiento Temporal, o Variable. Predeterminado: Ninguno.

  Importante

  Cuando se utilizan actividades de Variable, solo las operaciones en la misma cadena de operación pueden acceder al valor de la variable durante el tiempo de ejecución.

• Enviar registros de éxito a: Elija una notificación por correo electrónico para recibir registros exitosos. Seleccione entre las notificaciones por correo electrónico configuradas. Predeterminado: Ninguno.

• Enviar registros de fallo a: Elija una notificación por correo electrónico para recibir registros fallidos. Seleccione entre las notificaciones por correo electrónico configuradas. Predeterminado: Ninguno.

Información detallada sobre el fragmentado

El fragmentado se utiliza para dividir los datos de origen en múltiples fragmentos (lotes) según el tamaño de fragmento configurado. El tamaño del fragmento es el número de registros de origen (nodos) para cada fragmento. La transformación se realiza luego en cada fragmento por separado, produciendo cada fragmento de origen un fragmento de destino. Los fragmentos de destino resultantes se combinan para producir el destino final.

El fragmentado solo se puede utilizar si los registros son independientes y provienen de una fuente que no es LDAP. Se recomienda utilizar un tamaño de fragmento lo más grande posible, asegurándose de que los datos de un fragmento quepan en la memoria disponible. Para métodos adicionales para limitar la cantidad de memoria que utiliza una transformación, consulte Procesamiento de transformaciones.

Limitaciones de la API

Muchas API de servicios web (SOAP/REST) tienen limitaciones de tamaño. Por ejemplo, un upsert basado en Salesforce acepta solo 200 registros por cada llamada. Con suficiente memoria, podría configurar una operación para usar un tamaño de fragmento de 200. La fuente se dividiría en fragmentos de 200 registros cada uno, y cada transformación llamaría al servicio web una vez con un fragmento de 200 registros. Esto se repetiría hasta que todos los registros hayan sido procesados. Los archivos de destino resultantes se combinarían luego. (Tenga en cuenta que también podría utilizar actividades masivas basadas en Salesforce para evitar el uso de fragmentado.)

Procesamiento paralelo

Si tiene una fuente grande y una computadora con múltiples CPU, se puede utilizar el fragmentado para dividir la fuente para el procesamiento paralelo. Dado que cada fragmento se procesa de forma aislada, varios fragmentos pueden procesarse en paralelo. Esto se aplica solo si los registros de origen son independientes entre sí a nivel de nodo de fragmento. Los servicios web se pueden llamar en paralelo utilizando fragmentado, mejorando el rendimiento.

Al utilizar fragmentado en una operación donde el destino es una base de datos, tenga en cuenta que los datos de destino se escriben primero en numerosos archivos temporales (uno para cada fragmento). Estos archivos se combinan luego en un solo archivo de destino, que se envía a la base de datos para inserción/actualización. Si establece la variable de Jitterbit jitterbit.target.db.commit_chunks en 1 o true cuando el fragmentado está habilitado, cada fragmento se compromete a la base de datos a medida que se vuelve disponible. Esto puede mejorar significativamente el rendimiento, ya que las inserciones/actualizaciones en la base de datos se realizan en paralelo.

Usar variables con fragmentación

Dado que la fragmentación puede invocar multi-hilo, su uso puede afectar el comportamiento de las variables que no se comparten entre los hilos.

Las variables globales y las variables de proyecto están segregadas entre las instancias de fragmentación, y aunque los datos se combinan, los cambios en estas variables no lo están. Solo se preservan los cambios realizados en el hilo inicial al final de la transformación.

Por ejemplo, si una operación —con fragmentación y múltiples hilos— tiene una transformación que cambia una variable global, el valor de la variable global después de que la operación finaliza es el del primer hilo. Cualquier cambio en la variable en otros hilos es independiente y se descarta cuando la operación se completa.

Estas variables globales se pasan a los otros hilos por valor en lugar de por referencia, asegurando que cualquier cambio en las variables no se refleje en otros hilos u operaciones. Esto es similar a la función RunOperation cuando está en modo asíncrono.