Ejecución de flujos de trabajo e historiales de revisión
Acerca de Workflows Run & Revision Histories
Después de configurar sus workflows, probablemente desee verificar su estado y evaluar las modificaciones que se han realizado en ellos. Las secciones Historial de ejecución e Historial de revisiones de Flujos de trabajo le permiten ver las ejecuciones pasadas de sus flujos de trabajo, los detalles de esas ejecuciones y las modificaciones que se han realizado en cualquier flujo de trabajo. Esta sección es especialmente útil para evaluar por qué un flujo de trabajo puede haber fallado. La generación de informes contendrá información sobre por qué ha fallado el flujo de trabajo o si se ha realizado un cambio, lo que ayudará a identificar y solucionar el problema.
Puede ver el Historial de ejecución y el Historial de revisiones para un flujo de trabajo específico haciendo clic en el flujo de trabajo y, a continuación, yendo a la sección en la que está interesado.
También puede ver el Historial de ejecución para todos los flujos de trabajo dentro de un proyecto yendo directamente a Historial de ejecución desde la pestaña de flujo de trabajo del proyecto.
Historial de ejecución
La página Historial de ejecución le permite ver información adicional sobre los flujos de trabajo que ha iniciado. Esta página puede ayudarle a supervisar sus flujos de trabajo, diagnosticar problemas y obtener un resumen de qué flujos de trabajo se han completado correctamente y cuáles han fallado.
Cuando se ejecute su flujo de trabajo, se añadirá una nueva entrada a la página de historial de ejecución. Esta página contiene una tabla que muestra la siguiente información sobre sus ejecuciones de flujo de trabajo:
- Iniciado el: La fecha y hora en que comenzó a ejecutarse el flujo de trabajo.
- Nombre de flujo de trabajo: El nombre del flujo de trabajo.
Consejo Q: Si ve los estados de un flujo de trabajo llamado “Flujo de trabajo eliminado”, es probable que haya eliminado el flujo de trabajo adjunto. Tenga cuidado al hacer esto: los registros aún están ahí, pero el flujo de trabajo en sí es irrecuperable.Consejo Q: Esta columna se excluye si se accede al historial de ejecución para un flujo de trabajo específico.
- Propietario: El nombre de usuario del usuario que creó el flujo de trabajo.
- Estado: El estado del flujo de trabajo. Consulte los estados del flujo de trabajo para obtener más información.
Puede ver información más detallada sobre cada ejecución de workflow. Haga clic en una ejecución de workflow para ampliarla y ver información sobre cada componente del workflow.
Haga clic en una tarea para abrir un panel lateral con más información sobre esa tarea:
- Estado: El estado de la tarea. Consulte los estados del flujo de trabajo para obtener más información.
- ID de ejecución del flujo de trabajo: cada vez que se ejecuta un flujo de trabajo, a cada aspecto del flujo de trabajo se le asigna un ID de ejecución único. Puede utilizar este ID para filtrar sus flujos de trabajo o proporcionarlo al soporte técnico de Qualtrics si necesita ayuda para solucionar el motivo del fallo de un flujo de trabajo.
- Programado para: La fecha y la hora en que se programó la ejecución del flujo de trabajo. Esto solo aparecerá para flujos de trabajo programados.
- Hora de inicio: La fecha y la hora en que se ha iniciado la ejecución del workflow.
- Hora de fin: La fecha y la hora en que el flujo de trabajo terminó de ejecutarse.
- Duración: tiempo total que tardó en ejecutarse el flujo de trabajo.
- Archivos: si la tarea procesó cualquier archivo, puede descargarlos en esta sección. Consulte Descarga de archivos de datos para obtener más información.
Consejo Q: Si la tarea seleccionada no procesa archivos, este campo se ocultará.
Además de la información anterior, puede hacer clic en Ver JSON para ver el payload JSON de la tarea.
El payload JSON puede ser útil para solucionar problemas con sus flujos de trabajo, especialmente los flujos de trabajo ETL. La pestaña Entrada muestra la información y los datos recibidos por la tarea, mientras que la pestaña Salida muestra el resultado de la tarea.
Buscando historial de ejecución
El historial de ejecución incluye filtros preconfigurados que le permiten encontrar fácilmente el flujo de trabajo en el que está interesado. También puede utilizar la barra de búsqueda para buscar valores de salida de tareas.
- Utilice el menú desplegable Propiedad y uso compartido para filtrar por workflows de su propiedad, workflows que se han compartido con usted o todos los workflows a los que tiene acceso.
Consejo Q: este filtro se excluye si se visualiza el historial de ejecución en un proyecto de encuesta.
- Utilice el menú desplegable Nombre de flujo de trabajo para filtrar por nombre de flujo de trabajo.
Consejo Q: Este filtro se excluye si se visualiza el historial de ejecución de un flujo de trabajo específico.
- Utilice el menú desplegable Iniciado por para filtrar por lo que inicia el workflow, ya sea una programación o un evento de workflow específico.
- Utilice el menú desplegable Tareas incluidas para filtrar por las tareas que resultan del workflow.
- Utilice la barra de búsqueda de datos de salida de tarea para buscar valores de salida de tarea dentro del workflow. Cuando introduce una palabra clave o un valor específico en la barra de búsqueda, la lista de ejecuciones de flujo de trabajo solo mostrará las ejecuciones que contengan esa palabra clave o valor.
Consejo Q: Este filtro solo está disponible si selecciona una tarea específica del menú desplegable Tareas incluidas.Atención: Este filtro no está disponible actualmente para todos los tipos de tarea.
- Utilice el menú desplegable Estado de tareas para filtrar por el estado de la tarea de flujo de trabajo.
- Utilice los campos Fechas de inicio y de fin de workflow para filtrar por cuándo se ha iniciado el workflow. Haga clic en el icono del calendario para ver un calendario y seleccionar una fecha.
- Utilice el menú desplegable Iniciado por (ID) para filtrar por el ID de desencadenador de un workflow específico. Consulte la sección Búsqueda de un ID de desencadenador a continuación para obtener más información sobre cómo recuperar el ID de desencadenador.
Estados de flujo de trabajo
Las tareas de workflow pueden tener una variedad de estados para permitirle conocer el progreso del workflow:
- En cola: La tarea está programada para ejecutarse a continuación.
- En curso: La tarea se está ejecutando actualmente.
Ejemplo: tiene dos tareas que se ejecutan secuencialmente en un workflow. Antes de la ejecución, la primera tarea se fijará en “En cola”. Mientras se esté ejecutando, el estado de la primera tarea será “En curso”, mientras que la segunda tarea no se visualizará. Al finalizar la primera tarea, la segunda tarea aparecerá como “En cola”.
- Correcto: La tarea se ha ejecutado. En el caso de una tarea de correo electrónico, esto significa que ha salido del servidor de Qualtrics.
- Error: la tarea no se ha desencadenado. Esto suele deberse a un error en la configuración de la tarea. Por ejemplo, si introduce un correo electrónico no válido en la tarea de correo electrónico.
Consejo Q: los flujos de trabajo que no son ETL tienen un tiempo de espera de 60 segundos. Esto significa que el workflow fallará si se tarda más de 60 segundos en ejecutarse.Consejo Q: Puede volver a intentar un flujo de trabajo si 1 o más tareas de ese flujo de trabajo han fallado. Consulte la sección de reintento de workflows para obtener más información.
- Reintento automático: una o más tareas del flujo de trabajo han fallado y se están reintentando. Consulte Workflow y errores de tarea para obtener más información.
- Inicio retrasado: el flujo de trabajo no se ha ejecutado porque se han aplicado opciones de inicio retrasadas. Hay 1 o más instancias en las que se habría iniciado el flujo de trabajo, que ahora se retienen en una cola hasta que finaliza el intervalo de tiempo.
Historial de revisión
El historialde revisiones le permite ver los cambios que se han realizado en cualquier flujo de trabajo al que tenga acceso. Esto significa que puede ver cuándo se ha desactivado/activado exactamente un workflow, cuándo se han realizado modificaciones de condiciones y quién ha editado su workflow.
El historial de revisiones está disponible tanto para flujos de trabajo específicos como para todos los flujos de trabajo de un proyecto. A continuación, verá una captura de pantalla del historial de revisiones de una sola encuesta que muestra todas las modificaciones del flujo de trabajo en orden.
El historial de revisiones contiene la siguiente información sobre sus workflows:
- Nombre del flujo de trabajo: el nombre del flujo de trabajo que se ha editado. Solo aparece si está consultando el historial de revisiones de todo un proyecto.
- Nombre de usuario: El nombre de usuario del usuario que realizó la edición.
- Qué ha cambiado: Una descripción de la edición realizada en el flujo de trabajo.
- Fecha de la última revisión: Fecha y hora en que se editó el flujo de trabajo.
- Ver detalles: Ver el payload JSON para su workflow antes y después de la modificación.
Búsqueda de historial de revisiones
El historial de ejecución incluye filtros preconfigurados que le permiten encontrar fácilmente cambios específicos en su flujo de trabajo.
- Utilice el menú desplegable Nombre de usuario para filtrar por el usuario que ha realizado la modificación.
- Utilice el menú desplegable Qué ha cambiado para filtrar por el tipo de edición que se ha realizado en el workflow.
- Utilice los filtros Última fecha (rango) revisada para seleccionar un rango de fechas cuando se realizó la edición. Haga clic en el icono del calendario para ver un calendario y seleccionar una fecha.
Reejecución de workflows
Desde la página de historial de ejecución, puede volver a ejecutar los flujos de trabajo para completarlos de nuevo. Seleccione los flujos de trabajo que desea volver a ejecutar y haga clic en Volver a ejecutar flujos de trabajo.
Si elige volver a ejecutar un flujo de trabajo fallido, se le preguntará si desea comenzar desde la primera tarea fallida o si desea comenzar desde el principio del flujo de trabajo.
Los flujos de trabajo no se pueden ejecutar en los siguientes escenarios:
- La configuración del flujo de trabajo y los errores de tarea no permiten volver a intentar los flujos de trabajo o no permiten que los flujos de trabajo se reintenten fuera de un período de tiempo determinado.
- El flujo de trabajo seleccionado para volver a ejecutar está actualmente en curso, en cola o ya se está volviendo a ejecutar.
- El flujo de trabajo se encontraba en un inicio retrasado cuando se ejecutó originalmente.
- La reejecución de los flujos de trabajo seleccionados superará el límite máximo de flujos de trabajo que se pueden ejecutar.
Reintentar workflows
Si una tarea de un flujo de trabajo falla y desea reintentar todo el flujo de trabajo, haga clic en Reintentar. Tenga en cuenta que el botón Reintentar solo aparecerá si falla una tarea. Al hacer clic en el botón Reintentar se volverá a ejecutar todo el flujo de trabajo.
Al volver a intentar un workflow se volverá a ejecutar la tarea con la misma configuración que su ejecución inicial. Debe reintentar un flujo de trabajo cuando:
- Se ha agotado el tiempo de espera de una tarea debido a un error interno de Qualtrics.
- Una tarea falla debido a un problema que se origina con un sistema de terceros.
Ejemplo: Deseo importar empleados de SuccessFactors, pero no he configurado mi cuenta de SuccessFactors con los permisos correctos. Cuando se ejecuta el flujo de trabajo en Qualtrics, se produce un error porque mi cuenta de SuccessFactors no tiene permiso para ver los datos del empleado. Sin embargo, si actualizo mis permisos de SuccessFactors, puedo reintentar la tarea en Qualtrics y la tarea tendrá éxito.
Si se vuelven a intentar las tareas que han fallado debido a errores de configuración, el reintento volverá a fallar. En su lugar, debería iniciar una nueva ejecución de workflow después de corregir los errores de configuración.
Buscar un ID de desencadenador
Cada vez que se ejecuta un flujo de trabajo, a cada componente de tarea de ese flujo de trabajo se le asigna un ID de desencadenador único. Puede utilizar este ID para buscar una ejecución específica del flujo de trabajo o proporcionársela al soporte técnico de Qualtrics si necesita ayuda para solucionar el motivo del error del flujo de trabajo.
- Vaya a la sección Historial de ejecución del flujo de trabajo en el que está interesado.
- Haga clic en la tarea específica y ejecute para la que desea encontrar el ID de desencadenador.
- Haga clic en Ver JSON.
- Realice una búsqueda de texto para “uniqueId”. En Mac, esto es CMD + F y en PC es CTRL + F. Debería aparecer una casilla en su navegador web que le permita buscar.
- Copie el valor para su ID unívoco (también conocido como ID de desencadenador).
El ID de desencadenador se puede utilizar para buscar ejecuciones de flujo de trabajo específicas en sus informes.
Descarga de archivos de datos
Determinadas tareas de workflow le permiten descargar un archivo de los datos que han procesado. Esto es útil para solucionar problemas y comprender qué datos está transfiriendo entre Qualtrics y otros sistemas de terceros.
Para descargar su archivo de datos, haga clic en el botón de descarga en la sección Archivos cuando visualice una tarea específica. Esto descargará sus datos como un archivo CSV en su ordenador, que puede abrir utilizando cualquier software de edición de hojas de cálculo.
Puede descargar archivos de datos para algunas tareas ETL, como:
- Extraer datos de la tarea de archivos SFTP
- Cargar datos en tarea SFTP
- Extraer datos de la tarea de Google Drive
- Extraer respuestas de una tarea de encuesta
- Añadir contactos y transacciones a la tarea XMD