Usar aplicaciones de Alteryx convertidas

PlaidCloud convierte las preguntas de las aplicaciones analíticas de Alteryx en variables de flujo de trabajo controladas. Los usuarios pueden establecer esas variables antes de una ejecución y PlaidCloud aplica los valores a fórmulas, filtros, rutas de archivo, condiciones, parámetros de macros y ajustes de pasos posteriores.

La interfaz App Runner

Al convertir una aplicación analítica de Alteryx (.yxwz), su interfaz también se materializa como un “App Runner” de Panel publicado: un formulario de entrada funcional que recoge los mismos valores que las preguntas de Alteryx y ejecuta con ellos el flujo de trabajo convertido. Esta interfaz se obtiene automáticamente como parte de la conversión; una aplicación sin widgets de entrada se omite.

Las preguntas de la aplicación se convierten en controles de App Runner: texto, numérico, fecha, casilla de verificación, botón de opción, lista desplegable, cuadro de lista, árbol, examinar archivo y examinar carpeta. Cada control escribe en la variable de flujo de trabajo que lee el paso convertido, de modo que una ejecución desde App Runner aplica la misma lógica que establecer las variables a mano. Un control que no se vincula a una variable de flujo de trabajo real se muestra con una nota visible en lugar de recoger silenciosamente un valor que no va a ninguna parte: revíselo y apúntelo a la variable prevista.

El formulario se organiza según la agrupación del propio autor de la aplicación (las pestañas y los cuadros con etiqueta con los que el autor construyó la aplicación) y el texto explicativo del autor (herramientas Label de Alteryx) se muestra en el formulario junto a las preguntas que describe. Una pregunta que la aplicación fijó en tiempo de diseño, como un Detour sin ninguna pregunta de interfaz que lo controle, no se muestra como pregunta.

El formulario se abre con los valores guardados en las variables del flujo de trabajo (los valores predeterminados del autor, salvo que alguien haya guardado otros), y una pregunta sin valor guardado aparece en blanco. Si un valor guardado ya no coincide con ninguna de las opciones de una pregunta, se ignora en lugar de mostrarse como una selección obsoleta. Una pregunta numérica aplica el mínimo, el máximo y el paso que estableció el autor, de modo que una pregunta limitada a un rango pequeño no puede responderse fuera de él.

Cuando el flujo de trabajo convertido se ramifica, App Runner muestra la rama como una opción con etiqueta, de modo que el camino que sigue una ejecución se elige en tiempo de ejecución, igual que lo elegía la aplicación de Alteryx.

Preguntas de archivo y carpeta

Cada pregunta de archivo o carpeta tiene un botón Examinar que abre un explorador de documentos, de modo que usted elige la ruta en lugar de escribirla de memoria.

Examinar ofrece las cuentas de documentos a las que tiene acceso, con la cuenta propia de la aplicación como predeterminada, y le permite cambiar entre ellas.
Se abre en la carpeta que nombra la respuesta actual de la pregunta; si la pregunta aún no tiene respuesta, se abre en la raíz de la cuenta.
Una ruta de navegación en la parte superior permite retroceder. Al elegir una carpeta de la lista, se abre; al elegir un archivo, se selecciona.
Seleccionar muestra la ruta que rellenará antes de que pulse el botón. Sin nada resaltado, Seleccionar toma la carpeta que está viendo; así se elige el nivel superior de una cuenta.
Si no se puede listar una carpeta, la lista lo indica y da el motivo, y Seleccionar no rellenará una ruta que usted no haya visto. Un listado que no recibe respuesta en 20 segundos indica que la cuenta no respondió.

Ejecutar la aplicación

Rellene el formulario y pulse Ejecutar.

Sus respuestas acompañan a la ejecución y valen solo para esa ejecución. Nunca se guardan en el flujo de trabajo, de modo que las respuestas de una persona nunca llegan a la ejecución de otra, y ejecutar la aplicación no requiere derecho a modificar el flujo de trabajo, lo cual importa en un proyecto que restringe filas, donde solo sus Arquitectos pueden modificarlo. Para cambiar los valores con los que se abre el formulario, guárdelos en el flujo de trabajo, como se indica más abajo.

Las respuestas se comprueban antes de que comience la ejecución. Las preguntas de opciones que nunca se respondieron detienen la ejecución antes de que empiece y se nombran, en lugar de descubrirse a mitad de una ejecución que puede durar buena parte de una hora.

Mientras hay una ejecución en curso, el formulario muestra una barra de progreso, N of M steps contados frente al total de pasos del flujo de trabajo, el tiempo transcurrido y el paso o pasos que se están ejecutando ahora. Pausar y Detener aparecen junto a Ejecutar solo mientras hay una ejecución en curso; Pausar se convierte en Reanudar mientras la ejecución está en pausa.

Un paso que falla se nombra en el formulario en cuanto falla y, cuando la ejecución termina, el formulario cita lo que dijo cada paso fallido. No tiene que abrir el flujo de trabajo para averiguar por qué se detuvo. Los pasos que no pudieron ejecutarse porque falló un paso anterior se muestran por separado como no ejecutados en lugar de como fallos, y aun así cuentan para la barra de progreso, de modo que esta llega al final.

Una ejecución continúa si cierra la página o pierde la conexión. Si vuelve a abrir la aplicación mientras esa ejecución sigue en curso, se muestra la ejecución en progreso, con Pausar y Detener, en lugar de un formulario inactivo.

Un enlace Open workflow junto a Ejecutar abre el flujo de trabajo subyacente en PlaidCloud en una pestaña nueva, en su lienzo cuando es un flujo de trabajo DAG. Funciona incluso si la propia vista de una ejecución del formulario ha dejado de actualizarse.

Todavía puede ejecutar el flujo de trabajo directamente estableciendo sus variables, como se indica más abajo; App Runner es una vía de acceso adicional, al estilo de una aplicación.

Mantener la aplicación al día

Una aplicación de App Runner es una aplicación de servidor de Panel cuyos archivos app.py, widget_map.py y requirements.txt genera PlaidCloud. Cuando PlaidCloud actualiza App Runner, sus aplicaciones existentes adoptan la nueva versión por sí solas: cada una se actualiza a los archivos actuales y se recompila la próxima vez que se actualiza PlaidCloud, y de nuevo siempre que usted haga clic en Recompilar o edite la aplicación en la pantalla Mis aplicaciones Panel. La configuración de la aplicación y su flujo de trabajo no se tocan.

Una aplicación bloqueada se deja como está. Desbloquéela y haga clic en Recompilar para ponerla al día.
Las ediciones manuales de los archivos generados se reemplazan. Una actualización escribe los app.py, widget_map.py y requirements.txt actuales sobre sus cambios. El historial de Git de la aplicación conserva las versiones anteriores.

Tipos de entrada convertidos

PlaidCloud convierte los controles habituales de las aplicaciones de Alteryx en entradas de flujo de trabajo con tipo:

Los cuadros de texto se convierten en variables de texto.
Los controles numéricos se convierten en variables numéricas.
Los controles de fecha se convierten en variables de fecha ISO.
Las casillas de verificación, los botones de opción, las listas desplegables, los cuadros de lista y los árboles se convierten en variables de opción controlada.
Los controles de examinar archivo se convierten en variables de archivo de Document.
Los controles de examinar carpeta se convierten en variables de carpeta de Document.

El flujo de trabajo convertido usa estas variables en cualquier lugar en que la aplicación de Alteryx usaba el valor de la pregunta original.

Establecer valores antes de una ejecución

Antes de ejecutar un flujo de trabajo de aplicación convertido:

Abra el flujo de trabajo convertido.
Revise las variables del flujo de trabajo.
Establezca los valores obligatorios de texto, numéricos, de fecha, de opción, de archivo y de carpeta.
Confirme que las rutas de archivo y carpeta de Document apuntan a la ubicación de las dependencias importadas o a otra ruta de Document aprobada.
Ejecute el flujo de trabajo.

En las ejecuciones programadas, guarde los valores de las variables que deben usarse cada vez que se ejecute la programación.

Condiciones, advertencias y errores

Las condiciones y comprobaciones de error de las aplicaciones de Alteryx se convierten en condiciones de pasos de PlaidCloud. Una condición puede:

Permitir que el flujo de trabajo continúe.
Emitir un mensaje de advertencia.
Detener el flujo de trabajo con un error claro cuando la regla de la aplicación lo exija.
Dirigir la ejecución por una rama distinta.

Use este comportamiento para conservar la validación a nivel de aplicación mientras ejecuta el flujo de trabajo en PlaidCloud.

Entradas de archivo y carpeta

Las preguntas de archivo y carpeta usan rutas de Document:

Las entradas de archivo seleccionan un archivo de Document.
Las entradas de carpeta seleccionan una carpeta de Document.
Las dependencias de escritorio importadas se almacenan en la ruta de Document seleccionada durante la importación.
Los pasos de entrada dinámica pueden usar variables para resolver la ruta final de Document en tiempo de ejecución.

Esto mantiene las aplicaciones convertidas portables entre usuarios y ejecuciones programadas.

Parámetros de macro

Cuando una aplicación convertida llama a una macro, las variables de la aplicación pueden alimentar los parámetros de la macro. PlaidCloud pasa esos valores al flujo de trabajo de macro generado mediante el tratamiento de entradas de macro y parámetros de control.

Las ejecuciones simultáneas de macros están aisladas, por lo que varias ejecuciones de flujos de trabajo pueden usar la misma macro convertida sin compartir estado intermedio.

Lista de comprobación de validación

En cada aplicación convertida, confirme que:

Cada pregunta esperada aparece como variable del flujo de trabajo.
Los valores predeterminados coinciden con los de la aplicación original donde se configuraron.
Las listas controladas contienen las opciones esperadas.
Las variables de archivo y carpeta apuntan a rutas de Document.
Las condiciones producen los mensajes, advertencias o comportamiento de detención esperados.
La paridad de las salidas se cumple para los valores de variables seleccionados.