Opciones de operación en Jitterbit 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 de componentes en Pestaña Flujos de trabajo del panel del proyecto).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones de componentes en Pestaña Componentes del panel del proyecto).
• El lienzo de diseño (ver Menú de acciones de componentes 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
• Ejecutar en agente dedicado
• Habilitar modo de registro de depuración hasta
• Ejecutar operación de éxito incluso si no hay archivos fuente coincidentes
• Habilitar fragmentación
• Opciones de operación masiva de Salesforce

Tiempo de espera de la operación

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

Es posible 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 el fragmentado 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). Utilice 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.

Depuración

La sección Depuración incluye opciones para ejecutar una operación en un agente dedicado y habilitar el modo de depuración.

Ejecutar en agente dedicado

Dirija esta operación para que se ejecute en un agente específico como medida temporal de solución de problemas. Esta opción se aplica solo a grupos de agentes privados configurados con una clase de grupo de agentes de Alta Disponibilidad (HA). Úselo para reproducir fallos en un agente específico o para eludir un agente problemático mientras mantiene el resto del grupo operativo.

Para habilitar esta opción, selecciona la casilla Ejecutar en agente dedicado, luego configura lo siguiente:

• Seleccionar un agente: Selecciona el agente específico dentro del grupo de HA que se utilizará para la ejecución de esta operación. Si el agente que seleccionas se elimina mientras esta opción está activa, la ejecución en agente dedicado se desactiva automáticamente y la operación vuelve a la ejecución estándar del grupo de agentes.

• Hasta: Selecciona una fecha hasta dos semanas a partir de hoy. La ejecución en agente dedicado se desactiva automáticamente en esta fecha, y la operación vuelve al comportamiento estándar de ejecución del grupo de agentes.

• Aplicar a operaciones secundarias: Si la operación tiene operaciones secundarias, esta casilla aparece. Selecciónala para dirigir todas las operaciones secundarias a ejecutarse en el mismo agente que la operación principal.

Cuando Ejecutar en agente dedicado está habilitado, aparece una advertencia.

Habilitar Modo de Depuración Hasta

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

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

El registro de depuración genera diferentes tipos de registros según el tipo de 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 activador falla. Esto permite que otras operaciones activadas 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 Chunking

El chunking 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 el chunking, 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

Utilice la fragmentación en estas situaciones:

• Procesa grandes conjuntos de datos con miles de registros.
• Utiliza servicios web con límites de registros. Por ejemplo, Salesforce permite solo 200 registros por llamada.
• Quiere utilizar múltiples núcleos de CPU para procesamiento paralelo.

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

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

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

  Nota

  Cuando utilice una actividad masiva de (Salesforce, Salesforce Service Cloud o ServiceMax), cambie este valor predeterminado a un número mucho mayor, como 10,000.

• Número de registros por archivo: El número de registros a escribir 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 las 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 las actividades basadas en archivos configuradas: HTTP, API, FTP, Compartir Archivo, 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, Compartir Archivo, Almacenamiento Local, Almacenamiento Temporal, o Variable. Predeterminado: Ninguno.

  Importante

  Cuando se utilizan actividades de Variable, solo las operaciones en la misma cadena de operaciones 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, con cada fragmento de origen produciendo 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 que limiten 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 tienes 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 manera aislada, varios fragmentos pueden ser procesados en paralelo. Esto se aplica solo si los registros de la fuente son independientes entre sí a nivel de nodo de fragmento. Se pueden llamar servicios web en paralelo utilizando el fragmentado, mejorando el rendimiento.

Al utilizar el fragmentado en una operación donde el destino es una base de datos, ten 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 configuras la variable de Jitterbit jitterbit.target.db.commit_chunks a 1 o true cuando el fragmentado está habilitado, cada fragmento se confirma en 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.

Usa variables con fragmentado

Dado que el fragmentado 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 fragmentado, 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 fragmentado 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.