Ir al contenido

Ejecutar un flujo de trabajo

Puede iniciar una ejecución completa de un flujo de trabajo haciendo clic en el icono de ejecución de la jerarquía Flujos de trabajo o seleccionando Run All en el menú Acciones de un flujo de trabajo específico.

También puede hacer clic en el botón Toggle Start/Stop en la parte superior de la tabla de flujos de trabajo. Este botón de alternancia detiene un flujo de trabajo en ejecución o inicia un flujo de trabajo.

Si hace clic en Ejecutar en un flujo de trabajo que ya se está ejecutando, PlaidCloud se lo indica en lugar de iniciar una segunda ejecución.

Cada ejecución lleva un modo de contabilización en ERP. Para elegir uno en PlaidCloud, use Ejecutar con modo de contabilización en el menú contextual de un flujo de trabajo, o el botón de modo de ejecución del lienzo del flujo de trabajo; Iniciar flujo de trabajo o Ejecutar flujo de trabajo a secas solicitan el modo Live, sujeto aun así al límite del proyecto que se describe más adelante. También puede elegir el modo al iniciar una ejecución mediante la API de ejecución o el asistente.

Modo Qué sucede
Live Los pasos de contabilización contabilizan exactamente como siempre. Es el modo predeterminado.
Simulate Cada paso de contabilización en ERP genera y valida exactamente lo que contabilizaría, pero no confirma nada y nunca se comunica con el ERP. Los asientos que se contabilizarían se registran para que pueda revisarlos antes de ejecutar en modo Live: los de un paso Contabilizar documentos, en el Registro de asientos como Se contabilizaría (consulte Contabilizar documentos en sistemas ERP), y los del propio paso de contabilización de un sistema, en el historial de contabilización en ERP, marcados como simulados.
Off Los pasos de contabilización se omiten por completo.

Un proyecto también tiene su propio límite de modo de contabilización, que cualquier miembro con acceso de escritura a un proyecto desbloqueado establece mediante la API del proyecto o el asistente. El límite solo hace que una ejecución sea más segura, nunca más permisiva: el modo efectivo de una ejecución es el más restrictivo entre el modo que usted eligió y el límite del proyecto, de modo que un proyecto limitado a Simulate sigue simulado aunque inicie la ejecución en modo Live.

Un evento programado conserva su propio modo de contabilización, por lo que una programación establecida en Simulate se ejecuta simulada cada vez que se activa.

El modo se propaga a todo lo que toca la ejecución. Un subflujo de trabajo, una macro y un paso Run Model, Conditional Run Model o Loop Model heredan el modo de la ejecución principal, igual que una ejecución que reanude después de una detención: una ejecución simulada no puede contabilizar de verdad en ningún punto de su interior.

Una ejecución de flujo de trabajo contabiliza en un ERP como el proyecto, no como la persona que la inició. Antes de que una ejecución pueda contabilizar, el proyecto necesita una autorización para cada conexión y entorno de ERP que usen sus pasos de contabilización. Sin ella, el paso falla con el mensaje “This project isn’t authorized to post to connection …”, que indica la conexión y el entorno. Los pasos Call SAP Financial Document Attachment, Call SAP Master Data Table RFC y Call SAP RFC no la necesitan.

Para autorizar un proyecto, abra su página de inicio y seleccione Autorizaciones de escritura en ERP en Contabilización en ERP. Cada fila es una conexión en un entorno. Marque Autorizado para permitir que el proyecto contabilice allí, o desmárquelo para impedirlo. Autorizado por y Autorizado el muestran quién autorizó por última vez y cuándo.

  • El botón se muestra a los Arquitectos del proyecto y a los administradores del espacio de trabajo, pero solo un Arquitecto puede cambiar una autorización, y solo mientras el proyecto esté desbloqueado. Un administrador del espacio de trabajo que no sea Arquitecto puede agregarse primero como Arquitecto.
  • Al seleccionar una fila para autorizar o desautorizar, la lista no se vuelve a cargar: la posición de desplazamiento y el orden de columnas que haya elegido se mantienen. La ventana se puede cambiar de tamaño, y la nota sobre los proyectos públicos se ajusta para mostrarse completa.
  • Para autorizar una conexión, también necesita acceso de escritura a ella: es de su propiedad, o se comparte con usted por nombre o mediante uno de sus grupos de seguridad. Una conexión establecida en Todos los miembros del espacio de trabajo no cuenta.
  • Un proyecto establecido en Todos los miembros del espacio de trabajo se autoriza como cualquier otro. Todos los miembros son Arquitectos de él, por lo que cualquier miembro con acceso de escritura a una conexión puede autorizar el proyecto para ella. Una vez autorizado, cualquier miembro puede contabilizar en esa conexión desde los flujos de trabajo del proyecto, y la ventana lo indica sobre la cuadrícula.
  • Una copia nueva privada para usted, creada con datos de tablas o miembros de dimensión, conserva las autorizaciones del origen que usted mismo podría conceder, y llega en modo Simulate si el origen estaba en Live; consulte Autorizaciones de escritura en ERP en la copia. Cualquier otra copia, o un proyecto creado a partir de un archivo de proyecto, empieza sin autorizaciones. Autorícelo antes de que contabilice.

Mientras se ejecuta un flujo de trabajo, cada paso muestra un icono de estado que indica en qué punto se encuentra, junto con el tiempo que lleva en ejecución. Pase el cursor sobre el icono para ver el mensaje correspondiente.

Estado Qué significa
Waiting El paso está en cola y aún no ha comenzado.
Running El paso está trabajando y su duración aumenta mientras tanto.
Completed El paso terminó correctamente.
Warning El paso terminó, pero señaló algo que vale la pena leer en el registro del flujo de trabajo.
Error El paso falló. Consulte Gestión de errores de pasos.
Skipped Se omitió el paso: está deshabilitado o no se cumplieron sus condiciones de ejecución. Consulte Omitir pasos en un flujo de trabajo.
Continued El paso falló, pero está configurado para continuar en caso de error, así que el flujo de trabajo siguió adelante. Consulte Continuar en caso de error.
Stopped La ejecución se detuvo antes de que el paso pudiera terminar.
Abandoned La ejecución del paso se interrumpió, por lo que nunca terminará. Reanude la ejecución o vuelva a ejecutar el flujo de trabajo.

Una vista de flujo de trabajo abierta se actualiza sola a medida que avanza una ejecución, de modo que los estados que ve se mantienen al día sin recargar la página.

Un paso se marca como abandonado cuando lo que lo estaba ejecutando desapareció a mitad de la ejecución, con mayor frecuencia porque alguien presionó Detener o porque el mantenimiento de la plataforma interrumpió la ejecución. La duración del paso deja de aumentar y la información sobre herramientas del estado explica lo que sucedió.

Un paso abandonado no se completó y no produjo ningún resultado. No es un paso lento, ni un problema con sus datos o su configuración.

Para retomar el trabajo, Reanude la ejecución, con lo que el paso abandonado se ejecuta de nuevo, o vuelva a ejecutar todo el flujo de trabajo. Ambas opciones son seguras.

Si se pierde el servidor que ejecuta un paso a mitad de la ejecución, PlaidCloud vuelve a ejecutar el paso automáticamente cuando es seguro repetirlo: un paso que reemplaza su resultado termina con el mismo resultado que una sola ejecución limpia, por lo que no tiene nada que comprobar. El registro del paso muestra una advertencia donde comienza el segundo intento: “Restarted: the server running this step stopped before it finished (e.g. out of memory or a restart); running it again from the start.”

Un paso que no se puede repetir de forma segura no se vuelve a ejecutar. Falla una sola vez con un mensaje de interrumpido, porque ejecutarlo por segunda vez podría duplicar lo que el primer intento ya escribió. Los pasos que escriben resultados con {date} o {date_iso} en el nombre o la ruta se consideran no seguros de repetir, ya que una nueva ejecución podría caer en una fecha distinta. Para recuperarse, revise en el destino del paso lo que escribió el primer intento, límpielo si es necesario y luego vuelva a ejecutar el paso o Reanude la ejecución.

Mientras un paso espera a un trabajador, su mensaje de estado dice “Waiting for a worker… N min. No import worker has picked this step up yet.” (el tipo de trabajador corresponde al paso, como importación o exportación). El mensaje desaparece cuando comienza el trabajo.

Si el trabajo de un paso no puede iniciarse nunca, el paso falla con el motivo en lugar de esperar indefinidamente:

Causa Falla después de aproximadamente
Ningún trabajador recoge el trabajo de un paso de importación o de dimensión 40 minutos
El pod del paso se queda atascado en Pending 20 minutos
No se puede descargar la imagen del paso 5 minutos
No se crea ningún pod para el paso 20 minutos
Ningún ejecutor recoge una sincronización de conector (Singer) 30 minutos

El mensaje de la sincronización del conector nombra la sincronización. Si un trabajador inició el trabajo y luego desapareció, el paso también falla, con un mensaje que indica que el trabajador se detuvo. Los mensajes de importación y de dimensión dicen “Use Run from here to retry.”

Una ejecución nunca permanece En ejecución después de que el trabajo que la respalda haya desaparecido. Si se pierde el servidor que ejecuta el flujo de trabajo, la ejecución termina como fallida. Una ejecución puede durar como máximo 12 horas: si sigue en ejecución en ese momento, falla con “Run failed: still running at the 12-hour limit. Re-run the workflow.”

Mientras un flujo de trabajo se está ejecutando, puede Pausarlo, de modo que los pasos en curso terminen y los nuevos esperen, o Detenerlo, lo que cancela los pasos que estaban en cola y cualquier trabajo de importación o exportación que siga en ejecución, junto con la consulta del almacén de datos que estaba leyendo una exportación. Los pasos de importación y de dimensión que seguían en cola se cancelan limpiamente, para que no retengan las importaciones y cargas de dimensiones posteriores del espacio de trabajo. Detener también detiene las sincronizaciones de conector (Singer) en cola o en ejecución del flujo de trabajo, para que una sincronización no siga ejecutándose después de que el flujo de trabajo se haya detenido.

Una macro puede estar ejecutándose en varios lugares a la vez, llamada por otros flujos de trabajo o por un paso Macro: ejecución simultánea. Detener la macro detiene todas sus copias en ejecución. Detener una sola copia detiene solo esa copia y lo que esta inició, y deja en ejecución el flujo de trabajo que la llamó, al igual que un paso Macro Concurrent que abandona una copia que dejó de responder. Una macro que solo se está ejecutando dentro de otros flujos de trabajo aparece como En ejecución en la lista de flujos de trabajo, con Detener disponible, y al abrirla se muestra el estado, la hora de inicio y la hora de fin de cada paso según su última ejecución.

Reanudar retoma una ejecución pausada, detenida o fallida desde donde se quedó, en lugar de empezar de nuevo. Está disponible siempre que la última ejecución de un flujo de trabajo haya terminado en estado pausado, detenido o de error.

Lo que significa “desde donde se quedó” depende de cómo se ejecuta el flujo de trabajo:

Ejecución Al reanudar
Serie Se reinicia en el paso que se estaba ejecutando cuando terminó la ejecución y continúa desde allí. Si ese paso está dentro de un grupo, Reanudar retoma todo el grupo de nivel superior que lo contiene: los pasos del grupo que ya terminaron correctamente se dejan como están, los demás se ejecutan y la ejecución continúa después del grupo.
Paralela Vuelve a ejecutar cada paso que no había terminado correctamente y deja intactos los pasos completados.
Avanzada (grafo) Vuelve a ejecutar el nodo que falló y todo lo que sigue esperándolo, y deja intactos los nodos completados.

Los pasos que llaman a otro flujo de trabajo (Run Model, Conditional Run Model y Loop Model) reanudan el flujo de trabajo al que llaman en lugar de reiniciarlo, sin importar cuántos niveles de anidamiento tenga. Un paso de bucle reanuda la iteración que se interrumpió y omite las iteraciones que ya se completaron.

Cuando usted reanuda un flujo de trabajo que se ejecutó como hijo anidado de otro (uno invocado por un paso Run Model de un flujo principal), PlaidCloud ofrece Reanudar desde el inicio de la cadena. Reanudar el hijo por sí solo no puede continuar la orquestación del principal, así que esta opción reanuda el flujo principal de nivel superior (la raíz de la cadena) y continúa toda la cadena desde donde se detuvo. Reanudar un flujo de trabajo de nivel superior no cambia. El inicio de la cadena se resuelve dentro del mismo proyecto: una cadena que cruza a otro proyecto se reanuda desde el inicio de la parte que está dentro del proyecto.

Reanudar siempre continúa la ejecución original. Vuelve a ejecutar cada paso de esa ejecución que no terminó correctamente (un paso que falló o fue abandonado se vuelve a ejecutar, no se trata como completado), y volver a ejecutar un paso individual por separado mientras tanto no cambia lo que Reanudar retomará a continuación. Esto también se aplica a un flujo de trabajo hijo: si volvió a ejecutar uno de sus pasos por separado, reanudar el flujo principal sigue ejecutando todo lo que le quedaba al hijo, no solo ese paso.

Una ejecución reanudada se registra como una ejecución nueva en el historial de ejecuciones del flujo de trabajo, que contiene solo los pasos que volvió a ejecutar. La ejecución original conserva su propia entrada en el historial. Cuando una ejecución llama al mismo flujo de trabajo hijo más de una vez, cada llamada tiene su propia entrada en el historial de ejecuciones del hijo. Las iteraciones de un paso de bucle cuentan como una sola llamada.