Saltar al contenido

Invocar herramienta de operación en Jitterbit Studio

Introducción

La herramienta Invocar Operación es un componente del proyecto que se utiliza como un paso en una operación para ejecutar una operación específica que existe en el proyecto actual. Se puede usar como un paso de operación en cualquier lugar donde se pueda usar un script como un paso de operación.

Información

Las funciones RunOperation, RaiseError y CancelOperationChain proporcionan la funcionalidad subyacente para esta herramienta.

Consejo

Si necesitas ejecutar una operación que existe en un proyecto diferente, puedes exponerla como una API de API Manager y luego llamarla desde el proyecto actual. Alternativamente, puedes usar importación selectiva para importar la operación a tu proyecto actual.

Crear una instancia de Invocar Operación

Se puede crear una nueva instancia de la herramienta Invocar Operación desde estas ubicaciones:

Una herramienta Invocar Operación existente se puede editar desde estas ubicaciones:

Configurar una herramienta de Invocar Operación

La pantalla de configuración de Invocar Operación incluye estos campos y acciones:

configuración de invocar operación

  • Nombre: Ingrese un nombre para identificar la instancia de la herramienta Invocar Operación.

  • Usar nombre de operación: Cuando está seleccionado, el nombre de la instancia de la herramienta Invocar Operación coincide con el nombre de la operación seleccionada en el campo Operación. El campo Nombre se desactiva y se ajusta automáticamente al nombre de la operación cuando se cambia:

    coincidencia de invocar operación

    Nota

    Si múltiples instancias de la herramienta Invocar Operación invocan la misma operación, solo una puede usar el nombre exacto de la operación. Esto se debe a las reglas de validación de componentes del proyecto de Studio. La opción Usar nombre de operación estará desactivada en otras instancias de herramientas que llamen a la misma operación. Un tooltip describe por qué.

  • Operación: Use el menú para seleccionar una operación en el proyecto actual.

  • Tipo de ejecución: Seleccione si las operaciones posteriores se ejecutan sincrónicamente o asincrónicamente:

    • Sincrónicamente: Cuando está seleccionado, la operación invocada (hija) o cadena de operaciones se ejecuta secuencialmente desde la operación invocadora (padre).

    • Asincrónicamente: Cuando está seleccionado, la operación invocada (hija) o cadena de operaciones se ejecuta simultáneamente junto a la operación invocadora (padre).

    Para más información, consulte Sincronía.

  • Manejo de errores: Estas opciones de manejo de errores están habilitadas cuando se selecciona Sincrónico como el Tipo de ejecución:

  • Generar error si la operación falla: Cuando se selecciona y la operación invocada falla, la operación iniciadora (en la que se encuentra la herramienta Invoke Operation) falla y detiene el procesamiento. El procesamiento continuará para cualquier acción de operación en caso de fallo configurada en la operación iniciadora.

    Se escribe un error fatal en los mensajes de registro de la operación iniciadora, que se puede ver desde los [registros de operación](/es/integration-studio/design/operations/logs/) o la [pestaña de Mensajes](/es/management-console/runtime/#messages-tab) de la página de [Runtime](/es/management-console/runtime/):
    
    ```
    Error Fatal <mensaje> Este error fue generado por una llamada a la función RaiseError.
    ```
    
  • Cancelar cadena de operaciones si la operación falla: Cuando se selecciona y la operación invocada falla, la operación iniciadora (en la que se encuentra la herramienta Invoke Operation) continúa procesando. El procesamiento se detendrá al completar esa operación y no continuará para ninguna acción de operación en caso de fallo o En caso de éxito configurada en la operación iniciadora.

    Importante

    Si ambas opciones de manejo de errores están habilitadas, se genera un error para la operación iniciadora y no se produce ningún procesamiento adicional en la operación iniciadora ni en las operaciones encadenadas por las acciones configuradas de En caso de fallo.

  • Guardar Cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para guardar y cerrar la configuración.

  • Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

Una vez configurada, la instancia de Invoke Operation se nombra igual que el nombre de la operación que está llamando.

Nota

Una cadena de operaciones creada utilizando la herramienta Invoke Operation no tiene una referencia de operación visual o línea en el lienzo de diseño.

Acciones

La barra de acciones para una herramienta de Invocar Operación tiene estas acciones:

invocar operación

Icono Descripción
Ir a la Operación invocada navega al flujo de trabajo donde reside la operación especificada. La operación se muestra con un borde azul que la delimita.
Editar abre la pantalla de configuración.
Cortar coloca una copia del componente en tu portapapeles y elimina el componente original del proyecto (ver Reutilización de componentes).
Copiar coloca una copia del componente en tu portapapeles (ver Reutilización de componentes).
Eliminar quita el componente como un paso de operación de la operación.

Sincronización

Las operaciones llamadas usando la herramienta Invocar Operación o la función RunOperation se ejecutan de manera sincrónica por defecto, pero se pueden configurar para que se ejecuten de manera asincrónica como parte de una cadena de operaciones cuando sea necesario.

  • Sincrónicamente: La cadena de operaciones (hijo) invocada se ejecuta secuencialmente desde la operación invocadora (padre). El grupo de agentes esperará a que la cadena de operaciones invocada termine antes de procesar los siguientes pasos en la cadena de operaciones invocadora:

    Operation AOperation AOperation BOperation AOperation BOperation AOperation AOperation BOperation BOperation AOperation AOperation Bstart sync invoke when complete end

  • Asincrónicamente: La cadena de operaciones (hijo) invocada se ejecuta simultáneamente junto a la operación invocadora (padre). El grupo de agentes continuará procesando los pasos en la cadena de operaciones invocadora mientras procesa de manera independiente la cadena de operaciones invocada. No hay garantía de cuál operación o cadena se completará primero:

    Operation AOperation BOperation AOperation BOperation AOperation AOperation BOperation BOperation AOperation Bstart async invoke end

Cuando hay dos o más agentes en un grupo, múltiples agentes en el grupo pueden estar involucrados en el procesamiento de cadenas de operaciones completas. Para aprovechar el ahorro de tiempo que las llamadas asincrónicas pueden aportar a los flujos de trabajo, se requieren dos o más agentes.

Importante

La sincronicidad depende del contexto de la operación y puede combinarse según sea necesario para cumplir con varios casos de uso. El diagrama a continuación es un ejemplo de esta complejidad:

Operation AOperation BOperation BOperation COperation AOperation BOperation COperation AOperation AOperation BOperation BOperation COperation COperation AOperation BOperation BOperation Cstart async invoke sync invoke when complete end

Opciones de configuración

Ciertas opciones relacionadas con la sincronicidad de la cadena de operaciones se pueden configurar en la sección [Operation Engine] del archivo jitterbit.conf.

Además, la variable jitterbit.operation.max_async_chain_length se puede utilizar para anular el valor MaxAsyncOperationChainLength del archivo jitterbit.conf, siempre que MaxAsyncOperationChainLengthOverrideAllowed esté configurado como true.