Ir al contenido

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 macro y configuraciones de pasos posteriores.

Convertir una aplicación analítica de Alteryx (.yxwz) también materializa su interfaz como una “App Runner” de Panel publicada: un formulario de entrada funcional que recopila los mismos valores que las preguntas de Alteryx y ejecuta con ellos el flujo de trabajo convertido. Usted obtiene esta interfaz 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, exploración de archivos y exploración de carpetas. 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 recopilar en silencio 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 título con los que el autor creó la aplicación), y el texto explicativo del autor (las herramientas Label de Alteryx) se muestra en el formulario junto a las preguntas que describe. Una pregunta que la aplicación fijó en el momento del 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, a menos 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 bifurca, App Runner muestra la rama como una opción con título, de modo que la ruta que sigue una ejecución se elige en el momento de ejecutar, igual que la aplicación de Alteryx la elegía.

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 puede acceder, con la propia cuenta de la aplicación como predeterminada, y le permite cambiar entre ellas.
  • Se abre en la carpeta que indica la respuesta actual de la pregunta; si la pregunta aún no tiene respuesta, se abre en el nivel superior de la cuenta.
  • Una ruta de navegación en la parte superior permite retroceder. Elegir una carpeta de la lista la abre; elegir un archivo lo selecciona.
  • Seleccionar muestra la ruta que completará antes de que usted lo pulse. Si no hay nada resaltado, Seleccionar toma la carpeta que está viendo; así se elige el nivel superior de una cuenta.
  • Si no se puede enumerar una carpeta, la lista lo indica y nombra el motivo, y Seleccionar no completará una ruta que usted no vio. Una lista que no obtiene respuesta en 20 segundos indica que la cuenta no respondió.

Complete el formulario y pulse Ejecutar.

Sus respuestas van con la ejecución y valen solo para esa ejecución. Nunca se guardan en el flujo de trabajo, así 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 adelante.

Las respuestas se comprueban antes de que comience la ejecución. Las preguntas de opción 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 casi una hora.

Mientras una ejecución está en curso, el formulario muestra una barra de progreso, N of M steps contados respecto del total de pasos del flujo de trabajo, el tiempo transcurrido y el paso o los pasos que se están ejecutando. Pausar y Detener aparecen junto a Ejecutar solo mientras una ejecución está 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 y no como errores, y aun así cuentan para la barra de progreso, de modo que esta llega al final.

Una ejecución continúa si usted 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 Abrir flujo de trabajo 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 vista propia del formulario de una ejecución dejó de actualizarse.

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

Una aplicación de App Runner es una aplicación de servidor de Panel cuyos 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 cada vez que usted usa Recompilar o edita la aplicación en la pantalla Aplicaciones. La configuración de la aplicación y su flujo de trabajo no se tocan.

  • Dónde residen los archivos. En la conexión administrada de PlaidCloud Git, una aplicación de App Runner es una carpeta con el nombre de la aplicación dentro del repositorio apps de su espacio de trabajo, junto a sus otras aplicaciones de Panel. Una aplicación que tenía su propio repositorio se traslada automáticamente a su carpeta, y el repositorio anterior se archiva (se conserva en solo lectura y nunca se elimina). Un envío a apps recompila una aplicación solo cuando cambió su propia carpeta o el requirements.txt de la raíz del repositorio.
  • 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.

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 exploración de archivos se convierten en variables de archivo de documentos.
  • Los controles de exploración de carpetas se convierten en variables de carpeta de documentos.

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

Antes de ejecutar el flujo de trabajo de una aplicación convertida:

  1. Abra el flujo de trabajo convertido.
  2. Revise las variables del flujo de trabajo.
  3. Establezca los valores de texto, numéricos, de fecha, de opción, de archivo y de carpeta que sean obligatorios.
  4. Confirme que las rutas de archivos y carpetas de documentos apuntan a la ubicación de la dependencia importada o a otra ruta de documentos aprobada.
  5. Ejecute el flujo de trabajo.

Para las ejecuciones programadas, guarde los valores de variable que deban usarse cada vez que se ejecute la programación.

Las condiciones y las comprobaciones de error de las aplicaciones de Alteryx se convierten en condiciones de paso 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 diferente.

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

Las preguntas de archivo y carpeta usan rutas de documentos:

  • 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 documentos seleccionada durante la importación.
  • Los pasos de entrada dinámica pueden usar variables para resolver la ruta de documentos final en tiempo de ejecución.

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

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 parámetros de entrada y de control de la macro.

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

Para cada aplicación convertida, confirme que:

  • Cada pregunta esperada aparece como una variable de 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 documentos.
  • Las condiciones producen los mensajes, las advertencias o el comportamiento de detención esperados.
  • La paridad de los resultados se cumple para los valores de variable seleccionados.