Saltar al contenido

Desplegar y ejecutar una operación en Jitterbit Studio

Introducción

Esta página describe cómo desplegar operaciones en la nube de Harmony. Después de desplegar una operación y sus dependencias, puedes ejecutar esas operaciones. Puedes ejecutar una operación utilizando dependencias ya desplegadas, o puedes hacer que las dependencias se desplieguen automáticamente en el momento de la ejecución.

Para obtener información sobre cómo resolver ciertos errores que pueden ocurrir al ejecutar una operación, consulta Solución de problemas de operaciones.

Indicaciones visuales de operaciones con cambios no desplegados

Las operaciones con cambios no desplegados muestran dos indicadores visuales:

Desplegar una operación

Puedes desplegar operaciones utilizando tres métodos:

  • Desplegar: Despliega una operación directamente. Cuando seleccionas esta opción, el sistema despliega inmediatamente la operación y sus dependencias, o informa errores de validación que impiden el despliegue.
  • Desplegar y ejecutar: Funciona igual que la opción Desplegar, excepto que después de un despliegue exitoso, el sistema también ejecuta la operación y cualquier operación posterior. Para más información, consulta Ejecutar una operación más adelante en esta página.
  • Despliegue configurable: Despliega operaciones seleccionadas. Cuando seleccionas esta opción, se abre una pantalla de configuración de despliegue donde puedes elegir qué operaciones desplegar.

Nota

Cuando cambias el nombre de un proyecto que previamente desplegaste, el nuevo nombre del proyecto se despliega y actualiza automáticamente en Harmony. Ninguna otra parte del proyecto se despliega automáticamente.

Desplegar

Puedes acceder a la opción de Desplegar para una operación desde las siguientes ubicaciones:

Cuando seleccionas Desplegar, la operación y sus dependencias se despliegan de inmediato. Para que el despliegue tenga éxito, la operación debe ser válida. Si la operación es inválida, se muestra un cuadro de diálogo con los errores de validación específicos. Para obtener documentación sobre cada error y cómo resolverlo, consulta Validez de la operación.

Desplegar y ejecutar

La opción Desplegar y Ejecutar es accesible desde estas ubicaciones:

Cuando seleccionas Deploy and Run, la operación y sus dependencias se despliegan de inmediato. Para que el despliegue tenga éxito, la operación debe ser válida. Si la operación es inválida, se muestra un diálogo con los errores de validación específicos. Para obtener documentación sobre cada error y cómo resolverlo, consulta Operación de validez.

Si el despliegue tiene éxito, la operación y cualquier operación posterior también se ejecutan. Para más detalles, consulta Ejecutar una operación más adelante en esta página.

Configurable deploy

Puedes acceder a la opción Configurable Deploy desde las siguientes ubicaciones. Esta opción abre una pantalla de configuración de despliegue con la operación y sus dependencias seleccionadas por defecto.

Cuando seleccionas Configurable Deploy, se abre una pantalla de configuración de despliegue donde puedes definir una etiqueta y un comentario y elegir qué flujos de trabajo u operaciones desplegar.

configurable deploy

  • Información del proyecto: La parte superior de la pantalla muestra el nombre del proyecto y la organización y el entorno de Harmony donde existe el proyecto.

  • Etiqueta: Ingresa una etiqueta para etiquetar el evento de despliegue. La etiqueta aparece como una etiqueta en el evento de despliegue y se registra en los detalles del despliegue accesibles desde el historial del proyecto. Este campo puede ser obligatorio dependiendo de la configuración de despliegue a nivel de proyecto.

  • Comentario: Ingresa un comentario para describir el evento de despliegue. El comentario se registra en los detalles del despliegue accesibles desde el historial del proyecto. Este campo puede ser obligatorio dependiendo de la configuración de despliegue a nivel de proyecto.

  • Seleccionar Flujos de Trabajo y Operaciones: Selecciona los flujos de trabajo u operaciones a desplegar. La operación y sus dependencias se seleccionan por defecto. Debes seleccionar al menos un elemento para habilitar el botón Desplegar.

    Cuando seleccionas un flujo de trabajo u operación, cualquier flujo de trabajo u operación dependiente también se selecciona y no se puede desmarcar.

    Para colapsar o expandir flujos de trabajo y operaciones, utiliza las flechas que se muestran a la izquierda del nombre del flujo de trabajo u operación.

    Los flujos de trabajo u operaciones inválidos aparecen en texto rojo e itálico. Debes seleccionar solo elementos válidos para habilitar el botón Desplegar.

  • Desplegar: Haz clic para desplegar los flujos de trabajo u operaciones seleccionados.

Ejecutar una operación

Después de desplegar una operación y sus dependencias, puedes ejecutar esas operaciones. Puedes ejecutar una operación utilizando dependencias ya desplegadas, o puedes hacer que las dependencias se desplieguen automáticamente en el momento de la ejecución. Cuando ejecutas una operación, cualquier operación descendente (enlazada) también se ejecuta.

Puedes ejecutar operaciones manualmente en tiempo de diseño, utilizando un script (ya sea en Studio o Design Studio), desde una línea de comandos en un agente, utilizando un disparador de API, utilizando un oyente, o utilizando un horario. Después de ejecutar operaciones, puedes validar el comportamiento adecuado revisando los registros de operaciones.

Para obtener información sobre el uso de un horario frente a un enfoque impulsado por eventos, consulta Procesamiento por lotes y basado en eventos.

Ejecutar manualmente

La ejecución manual de una operación se utiliza comúnmente durante el desarrollo del proyecto para probar operaciones selectas o todo el proyecto. Puedes ejecutar operaciones manualmente en Studio como se describe a continuación, o desde la página de Proyectos de la Consola de Administración para operaciones que ya has desplegado.

Puedes ejecutar la mayoría de las operaciones manualmente, con las siguientes excepciones:

  • Operaciones desencadenadas a través del API Manager de Harmony. Estas operaciones utilizan una actividad de solicitud API o API SOAP que proporciona datos de origen a la operación.
  • Operaciones desencadenadas por un oyente. Estas operaciones utilizan una actividad de escucha que recibe un evento que activa la ejecución de la operación.

Tienes dos opciones para la ejecución manual de operaciones:

  • Ejecutar: Si ya has desplegado una operación y sus dependencias, esta opción ejecuta inmediatamente la operación y cualquier operación posterior utilizando las dependencias desplegadas existentes. Las operaciones ejecutadas no incluyen ningún cambio de diseño realizado después del último despliegue. Para ejecutar la operación con los últimos cambios de diseño, utiliza Desplegar y Ejecutar.
  • Desplegar y Ejecutar: Esta opción despliega inmediatamente la operación y todas sus dependencias (o informa errores de validación que impiden el despliegue), luego ejecuta la operación y cualquier operación posterior utilizando las nuevas dependencias desplegadas.

Las operaciones que ejecutas manualmente por cualquiera de los métodos muestran el estado de la operación en tiempo real en el lienzo de diseño, como se describe en Estado de la operación a continuación.

Ejecutar

Puedes acceder a la opción Ejecutar desde las siguientes ubicaciones:

Cuando seleccionas Ejecutar, si ya has desplegado una operación y sus dependencias, la operación y cualquier operación posterior vinculada con acciones de operación también se inician según las condiciones configuradas.

Si aún no has desplegado una operación o sus dependencias, un mensaje indica que la operación no se pudo ejecutar:

Texto del diálogo

No se pudo ejecutar la operación
La operación específica no ha sido desplegada o ha sido eliminada.

Haz clic en Continuar para volver a la pantalla anterior. Para desplegar la operación y sus dependencias, así como ejecutar la operación, utiliza la opción Desplegar y Ejecutar.

Si has desplegado una operación o sus dependencias pero has realizado cambios en el diseñador de proyectos de Studio desde el último despliegue, un aviso indica que hay cambios no desplegados:

Texto del diálogo

La operación tiene cambios no desplegados
Esta operación o sus componentes dependientes tienen cambios no desplegados. Haz clic en Continuar para ejecutar la última versión desplegada de esta operación.

Haz clic en Continuar para reconocer que hay cambios no desplegados que no se desplegarán, y para ejecutar la última versión desplegada de la operación y sus dependencias sin los cambios más recientes realizados en el diseñador de proyectos de Studio.

Si no deseas ejecutar la última versión desplegada, haz clic en Cancelar para volver a la pantalla anterior. Para desplegar la versión más reciente de la operación y sus dependencias, así como ejecutar la operación, utiliza la opción Desplegar y Ejecutar.

Desplegar y ejecutar

Puedes acceder a la opción Desplegar y Ejecutar desde las siguientes ubicaciones:

Cuando seleccionas Desplegar y Ejecutar, la operación y sus dependencias se despliegan de inmediato. El despliegue debe tener éxito para que la operación se ejecute, como se describió anteriormente en esta página bajo Desplegar.

Si el despliegue tiene éxito, la operación y cualquier operación descendente (hija) encadenada con acciones de operación también se inician según las condiciones configuradas.

Estado de la operación

Si una operación ha sido enviada con éxito a la cola de operaciones, el estado de la operación en tiempo real se informa en la parte inferior izquierda de una operación:

estado de la operación

El estado de la operación se muestra para las primeras 6 operaciones que se ejecutan dentro de una cadena de operaciones. Puedes ver el estado de cualquier operación restante en los registros de operaciones.

El estado informado corresponde con los estados descritos en la página de Registros de operaciones bajo Estados de operación. Haz clic en el estado de la operación para ver información detallada del registro. La pantalla de registro de operaciones se abre automáticamente en una pestaña separada para que puedas continuar trabajando mientras las operaciones se están ejecutando (ver Registros de operaciones).

Después de que ejecutes manualmente la operación, el estado de la operación se muestra en un proyecto abierto durante 24 horas y no se ve afectado por despliegues adicionales o por ejecutar la operación de otra manera. Solo al volver a ejecutar manualmente la operación se actualizará el estado de la operación para las operaciones y sus operaciones hijas. El estado de la operación se borra cuando cierras el proyecto.

Para las operaciones que están en estado Enviado, Recibido, Pendiente o Ejecutándose, se muestra un botón de Cancelar junto al estado. Al hacer clic en Cancelar, se envía una solicitud al agente para detener la operación y se muestra un estado de Cancelación Solicitada junto al estado de operación en tiempo real:

cancel operation

Nota

Las operaciones que tienen un estado de Cancel Requested pueden seguir ejecutándose.

Pasa el cursor sobre el estado de ejecución para ver la última vez que se actualizó el estado (reportado en la hora local del navegador).

El color del ícono a la izquierda del estado reportado indica la categoría del estado de operación correspondiente al que se muestra en los registros de operación. Cuando las operaciones están en vista colapsada, solo se muestran los íconos de color que indican la categoría del estado de operación.

Use a script

Para ejecutar una operación desde un script, llama a la función RunOperation en un script, como se describe en la documentación de funciones.

Para llamar a otra operación en el mismo proyecto, arrástrala al script. La función completa se crea automáticamente:

RunOperation("<TAG>operation:Operation 2</TAG>");

Para llamar a una operación en otro proyecto, obtén el GUID de la operación ejecutando un script simple en esa operación (usando pruebas de script) que utiliza la ruta de referencia de la operación para mostrar el GUID de la operación:

<trans>"<TAG>operation:Example Operation</TAG>";</trans>

Después de tener el GUID de una operación, puedes eliminar el script. El resultado de las pruebas de script es similar a op.52c3eaa8-bc45-491f-b77f-cfeff994cf31.

Luego puedes usarlo con la función RunOperation en la forma op.<guid> donde <guid> es el GUID de la operación del otro proyecto:

RunOperation("op.52c3eaa8-bc45-491f-b77f-cfeff994cf31");

Para llamar a una operación de Design Studio desde Studio, pasa el parámetro operationId a la función en la forma op.<guid> donde <guid> es el GUID de la operación de Design Studio. Puedes obtener esto desde dentro de Design Studio como se muestra en Llamar a una operación desde una línea de comandos:

RunOperation("op.52c3eaa8-bc45-491f-b77f-cfeff994cf31");

Para llamar a una operación de Studio desde Design Studio, necesitas los nombres del proyecto y de la operación. Después de implementar las operaciones de Studio, los proyectos de Design Studio pueden llamarlas por nombre de proyecto y de operación. Consulta la función RunOperationFromProject de Design Studio:

RunOperationFromProject("<TAG>Projects/MyCloudStudioProject/Operations/MyCloudStudioOperation</TAG>");

Usa una línea de comandos desde un agente

También puedes llamar a operaciones desde una línea de comandos en un agente en el entorno donde implementaste el proyecto. Para más detalles, consulta Llamar a una operación desde una línea de comandos.

Usa un disparador de API

Para llamar a la operación desde una aplicación externa, utiliza API Manager para configurar una API personalizada y asignar la operación para que se active en la solicitud. Para más información, consulta la documentación de API Manager.

Las operaciones llamadas desde APIs muestran un ícono de API :

operación api

Cuando pasas el cursor sobre este ícono, aparece una descripción general del servicio API:

descripción general del servicio de operación

Desde esta descripción general, puedes hacer clic en Copiar URL del servicio para agregar la URL del servicio de la API a tu portapapeles.

Usa un oyente

Los oyentes de eventos permiten que las operaciones se ejecuten automáticamente cuando son activadas por eventos específicos. Puedes controlar si una operación responde a estos disparadores habilitando o deshabilitando su capacidad de escucha de eventos.

Cuando implementas una operación que contiene una actividad de oyente, la escucha de eventos está deshabilitada por defecto y se muestra un ícono de oyente deshabilitado en la operación.

Para habilitar la escucha de eventos para la operación, haz clic en el ícono de oyente deshabilitado y utiliza el interruptor:

visión general del horario de operaciones

Las operaciones activadas por eventos muestran un ícono de oyente activo:

oyente de operación

Para más información, consulta Ver o habilitar / deshabilitar oyentes en la página de Proyectos de la Consola de Administración.

Usar un horario

Para ejecutar la operación automáticamente en un horario, primero debes configurar un horario y luego aplicarlo a una operación. Puedes crear y aplicar horarios directamente en Studio como se describe a continuación. También puedes crear y aplicar horarios desde la página de Proyectos en la Consola de Administración.

Nota

Después de aplicar un horario a una operación, puedes deshabilitarlo o volver a habilitarlo desde la página de Proyectos en la Consola de Administración.

Agregas horarios desde la pestaña Horarios de la configuración de la operación. Puedes acceder a la opción Configuración desde las siguientes ubicaciones:

Para información detallada sobre la configuración, consulta Horarios de operación.

Las operaciones con horarios habilitados muestran un icono de configuración de operación programada:

operación con horario

Cuando pasas el cursor sobre este icono, aparece un resumen del horario:

resumen del horario de operación

Desde este resumen, puedes hacer clic en Editar horario para modificar la configuración o en Eliminar horario para quitar el horario de la operación.

Requisitos de implementación

Puedes configurar los requisitos de implementación para cada proyecto durante la creación y configuración del proyecto.

Si la configuración de implementación a nivel de proyecto requiere una etiqueta o comentario, aparece un diálogo cuando inicias una implementación o implementas y ejecutas para que puedas ingresar la información requerida. La pantalla de implementación configurable también proporciona estos campos.

Texto del diálogo

Requisitos de Implementación
Tu organización requiere un comentario y una etiqueta al implementar.

  • Etiqueta

  • Comentario

  • Etiqueta: Ingresa una etiqueta para etiquetar el evento de implementación. La etiqueta aparece como una etiqueta en el evento de implementación y se registra en los detalles de la implementación accesibles desde el historial del proyecto.
  • Comentario: Ingresa un comentario para describir el evento de implementación. El comentario se registra en los detalles de la implementación accesibles desde el historial del proyecto.
  • Agregar Comentario y Etiqueta: Haz clic para agregar la etiqueta, el comentario o ambos, y continuar con la implementación de la operación.
  • Cancelar: Haz clic para cerrar el diálogo y regresar a la pantalla anterior sin implementar.

Cancelar una operación ejecutada

Si necesitas detener una operación ejecutada que está en estado Enviada, Recibida, Pendiente o En ejecución, puedes hacerlo desde las siguientes ubicaciones: