Flujos de trabajo guiados en Jitterbit App Builder
Introducción
Un flujo de trabajo guiado lleva a un administrador a través de una tarea de mantenimiento paso a paso, por ejemplo seleccionando los paquetes u objetos involucrados, enviando notificaciones e instalando un paquete o bloqueando un recurso. App Builder realiza un seguimiento del progreso de un flujo de trabajo guiado, por lo que se puede pausar y reanudar en cualquier momento, incluso por un administrador diferente.
App Builder proporciona dos flujos de trabajo guiados de forma predeterminada, descritos en esta página: Instalar Paquetes, que te guía a través de instalar un paquete de lanzamiento, e Mantenimiento, que te guía a través de bloquear una aplicación o fuente de datos para que se pueda actualizar de forma segura. Estos flujos de trabajo guiados nativos estandarizan tareas de mantenimiento que de otro modo requerirían varios pasos manuales propensos a errores. También puedes crear tus propios flujos de trabajo guiados personalizados para que coincidan con el proceso de tu organización.
Los flujos de trabajo guiados están disponibles en la pestaña Workflow de la página Mantenimiento, accesible desde el IDE. Esta página ha estado disponible desde App Builder 4.43 como versión beta, y disponible de forma general desde App Builder 4.65.
Para una referencia completa de cada campo y panel en la página Mantenimiento, consulta Mantenimiento.
Ejecutar el flujo de trabajo guiado Instalar Paquetes
El flujo de trabajo guiado Instalar Paquetes te guía a través de la instalación de un paquete de lanzamiento, con la opción de notificar a los usuarios afectados antes y después de la instalación. Para ejecutarlo, sigue estos pasos:
-
Selecciona IDE > Mantenimiento.
-
En el panel Iniciar Flujo de Trabajo, haz clic en Iniciar Ahora para Instalar Paquetes.
-
Seleccionar Paquetes (acción Seleccionar/Cargar Paquetes): Selecciona un paquete de lanzamiento ya disponible en el entorno o carga uno.
-
Seleccionar Objetos Afectados (acción Seleccionar Objetos): Revisa las aplicaciones y fuentes de datos que App Builder completó desde el manifiesto del paquete, agregando más si es necesario. Estos objetos se convierten en los destinatarios predeterminados para los pasos de notificación a continuación.
-
Preinstalación | Enviar Notificación(es) (acción Notificaciones): (Opcional) Envía una notificación advirtiendo a los usuarios afectados que la instalación está a punto de comenzar.
-
Instalar Paquetes (acción Instalar Paquetes): Revisa el manifiesto del paquete, los detalles de lanzamiento y las notas de lanzamiento, luego haz clic en Instalar.
-
Postinstalación | Enviar Notificación(es) (acción Notificaciones): (Opcional) Envía una notificación informando a los usuarios afectados que la instalación se ha completado.
Consejo
Puedes navegar fuera y reanudar este flujo de trabajo guiado en cualquier momento desde el panel Flujos de Trabajo en Curso. La instalación en sí también se ejecuta en segundo plano, por lo que la aplicación afectada permanece disponible mientras se instala un paquete.
Para obtener detalles sobre cada campo disponible en cada paso, consulta Pasos.
Ejecutar el flujo de trabajo guiado Mantenimiento
El flujo de trabajo guiado Mantenimiento te guía a través del bloqueo de una aplicación o fuente de datos, de modo que los usuarios no incluidos en la lista blanca se redirijan a una página de mantenimiento, y desbloquearla una vez que se complete el mantenimiento. Para ejecutarlo, sigue estos pasos:
-
Selecciona IDE > Mantenimiento.
-
En el panel Iniciar Flujo de Trabajo, haz clic en Iniciar Ahora para Mantenimiento.
-
Seleccionar Objetos Afectados (acción Seleccionar Objetos): Selecciona las aplicaciones y fuentes de datos a bloquear. Estos objetos se convierten en los destinatarios predeterminados para los pasos de notificación a continuación.
-
Prebloqueo | Enviar Notificación(es) (acción Notificaciones): (Opcional) Envía una notificación. Este paso incluye la notificación Aplicación(es) Inactiva(s), que puedes enviar tal como está o personalizar antes de enviar. Es la única notificación que App Builder incluye preconfigurada.
-
Bloquear/Desbloquear Objetos Afectados (acción Bloquear y Desbloquear): Haz clic en Alternar Bloqueos para bloquear los objetos seleccionados. Consulta Otorgar acceso a una aplicación o fuente de datos bloqueada para saber quién puede acceder a un recurso bloqueado y quién se redirige a una página de mantenimiento.
-
Post-Unlock | Send Notification(s) (Acción Notificaciones): (Opcional) Envía una notificación para informar a los usuarios afectados que se ha restaurado el acceso.
Al hacer clic en Finish, se desbloquean todos los objetos que aún estén bloqueados al final del flujo de trabajo guiado.
Para obtener detalles sobre todos los campos disponibles en cada paso, consulta Steps.
Flujos de trabajo guiados personalizados
Crear un flujo de trabajo guiado
Para crear tu propio flujo de trabajo guiado:
- Selecciona IDE > Maintenance.
- En el panel Start Workflow, haz clic en Configure.
- En el panel Workflows, haz clic en + Workflow e ingresa un nombre.
- En el panel Steps, haz clic en + Step para cada paso que necesite el flujo de trabajo guiado, y establece su Name y Action. Para obtener una descripción de todas las acciones disponibles y sus campos, consulta Steps.
Editar, copiar o eliminar un flujo de trabajo guiado
Para editar, copiar o eliminar un flujo de trabajo guiado:
- Selecciona IDE > Maintenance.
- En el panel Start Workflow, haz clic en Configure.
-
En el panel Workflows, localiza el flujo de trabajo guiado que buscas y selecciona su fila. Luego:
- Para eliminar el flujo de trabajo guiado, haz clic en el icono de papelera, luego haz clic en Proceed cuando se te pida confirmación.
- Para editar el flujo de trabajo guiado, utiliza el panel Steps para modificar sus pasos, o cámbia su nombre en el campo Name del panel Workflows.
- Para copiar el flujo de trabajo guiado, haz clic en More > Copy, luego haz clic en Proceed cuando se te pida confirmación.
Nota
Los flujos de trabajo guiados proporcionados por App Builder, Install Packages y Maintenance, no se pueden editar ni eliminar, pero sí se pueden copiar.
Enviar una notificación bajo demanda durante un flujo de trabajo guiado
A partir de la versión 4.44 de App Builder, puedes enviar una notificación inmediata (bajo demanda) en cualquier paso de un flujo de trabajo guiado. Para hacerlo, sigue estos pasos:
-
Selecciona More > Notifications.
-
En el diálogo Notification, ingresa los detalles de la notificación.
-
(Opcional) Abre el menú Dismiss After Step, luego selecciona después de cuál paso se debe descartar la notificación.
-
Haz clic en el botón Send.
Consejo
En un paso Notifications, la misma acción también está disponible directamente como un botón On-Demand Notification.
Descartar notificaciones
A partir de la versión 4.44 de App Builder, puedes descartar cualquier notificación enviada por flujos de trabajo guiados, ya sean predefinidos o bajo demanda. Para hacerlo, sigue estos pasos:
-
Selecciona IDE > Maintenance.
-
Selecciona la pestaña Notifications.
-
Haz clic en el botón Dismiss para una notificación. Si la notificación proviene de un flujo de trabajo guiado, sus columnas Workflow Name y Label identifican cuál flujo de trabajo guiado y paso la enviaron.
Otorgar acceso a una aplicación o fuente de datos bloqueada
El bloqueo impide que los usuarios accedan a recursos seleccionados, mientras permite que grupos de usuarios seleccionados continúen trabajando, por ejemplo para terminar las pruebas antes de que se lance una versión. De forma predeterminada, el flujo de trabajo guiado Maintenance bloquea recursos mediante su paso Lock & Unlock, pero cualquier flujo de trabajo guiado personalizado también puede incluir esta acción. El bloqueo implica dos tipos de acceso independientes.
Otorgar acceso al recurso bloqueado en sí
De forma predeterminada, los grupos de seguridad Administrators y Developers aún pueden acceder a una aplicación o fuente de datos bloqueada. Para permitir que otro grupo tenga acceso, sigue estos pasos:
- Selecciona IDE > User Management.
- Selecciona la pestaña Groups.
- En el panel Groups, haz clic en el icono Open record para un grupo.
- En el diálogo Group, selecciona More > Edge Case.
- Activa el interruptor Application and Data Source Lock, luego haz clic en Save.
Otorgar acceso a la página de mantenimiento
Cualquier usuario que no esté en un grupo al que se le haya otorgado el acceso anterior se redirige a una página de mantenimiento cuando intenta acceder a un recurso bloqueado. Para que un usuario se redirija en lugar de recibir un error de Acceso denegado, su grupo necesita acceso a la aplicación Vinyl - Maintenance, con el rol Everyone otorgado en la fuente de datos Vinyl (Sealed). Para otorgar esto a un grupo, incluido el grupo Anonymous Users (para visitantes no autenticados), sigue estos pasos:
- Selecciona IDE > User Management.
- Selecciona la pestaña Groups.
- Selecciona el grupo y luego haz clic en Manage Privileges.
- Haz clic en + Privilege y luego agrega la aplicación Vinyl - Maintenance.
- Otorga al grupo el rol Everyone en la fuente de datos Vinyl (Sealed).
Este requisito es específico de la página de mantenimiento predeterminada; consulta Configurar una página de mantenimiento personalizada para conocer los requisitos de acceso separados de una personalizada.
Configurar una página de mantenimiento personalizada
De forma predeterminada, los usuarios bloqueados se redirigen a la página de mantenimiento integrada de App Builder. Para redirigir a los usuarios de una aplicación específica a una página personalizada en su lugar, sigue estos pasos:
-
Diseña la página que deseas usar en cualquier aplicación que no sea la que se está bloqueando (una página dentro de la aplicación bloqueada no es accesible una vez que esa aplicación se bloquea).
-
Marca la página como Public: con la página abierta, haz clic en Edge Case y luego activa el interruptor Public.
-
Selecciona IDE > Maintenance y luego selecciona la pestaña Settings.
-
En el panel Maintenance Pages, busca la fila de la aplicación y luego establece su campo Page en la página que diseñaste.
Los usuarios objetivo necesitan al menos acceso de Read a la página personalizada. Si un usuario no tiene acceso a ella, se redirige a la página de mantenimiento predeterminada en su lugar; si tampoco tiene acceso a esa página, recibe un error de Acceso denegado.