Utiliser les applications Alteryx converties

PlaidCloud convertit les questions des applications analytiques Alteryx en variables de workflow contrôlées. Les utilisateurs peuvent définir ces variables avant une exécution, puis PlaidCloud applique les valeurs aux formules, filtres, chemins de fichiers, conditions, paramètres de macro et paramètres des étapes en aval.

L’interface App Runner

La conversion d’une application analytique Alteryx (.yxwz) matérialise aussi son interface sous la forme d’une application Panel « App Runner » publiée : un formulaire de saisie fonctionnel qui collecte les mêmes valeurs que les questions Alteryx et exécute le workflow converti avec celles-ci. Vous obtenez automatiquement cette interface dans le cadre de la conversion ; une application sans widget de saisie est ignorée.

Les questions de l’application deviennent des contrôles App Runner : texte, numérique, date, case à cocher, bouton radio, liste déroulante, zone de liste, arborescence, parcours de fichier et parcours de dossier. Chaque contrôle écrit dans la variable de workflow lue par l’étape convertie ; une exécution depuis App Runner pilote donc la même logique que la définition manuelle des variables. Un contrôle qui n’est lié à aucune véritable variable de workflow est affiché avec une remarque visible, plutôt que de collecter silencieusement une valeur qui ne mène nulle part : examinez-le et orientez-le vers la variable voulue.

Le formulaire est organisé selon le regroupement de l’auteur de l’application, c’est-à-dire les onglets et les zones étiquetées avec lesquels l’auteur a construit l’application, et le texte explicatif de l’auteur (outils Label d’Alteryx) est affiché sur le formulaire à côté des questions qu’il décrit. Une question fixée par l’application lors de la conception, comme un Detour sans question d’interface qui le pilote, n’est pas du tout affichée comme une question.

Le formulaire s’ouvre sur les valeurs enregistrées dans les variables du workflow, c’est-à-dire les valeurs par défaut de l’auteur sauf si quelqu’un en a enregistré d’autres, et une question sans valeur enregistrée est vide. Si une valeur enregistrée ne correspond plus à l’un des choix d’une question, elle est ignorée au lieu d’être affichée comme une sélection périmée. Une question numérique applique le minimum, le maximum et le pas définis par l’auteur ; une question limitée à une petite plage ne peut donc pas recevoir de réponse en dehors de celle-ci.

Lorsque le workflow converti comporte des branches, App Runner affiche la branche sous la forme d’un choix étiqueté, de sorte que le chemin pris par une exécution est choisi au moment de l’exécution, comme l’application Alteryx le choisissait.

Questions de fichier et de dossier

Chaque question de fichier ou de dossier comporte un bouton Parcourir qui ouvre un navigateur de documents, afin que vous choisissiez le chemin au lieu de le saisir de mémoire.

Parcourir propose les comptes de documents auxquels vous avez accès, avec par défaut le compte propre à l’application, et vous permet de passer de l’un à l’autre.
Il s’ouvre sur le dossier que nomme la réponse actuelle de la question ; si la question n’a pas encore de réponse, il s’ouvre à la racine du compte.
Un fil d’Ariane en haut permet de remonter. Choisir un dossier dans la liste l’ouvre ; choisir un fichier le sélectionne.
Sélectionner affiche le chemin qu’il va renseigner avant que vous n’appuyiez dessus. Lorsque rien n’est mis en surbrillance, Sélectionner prend le dossier que vous consultez : c’est ainsi que vous choisissez la racine d’un compte.
Si un dossier ne peut pas être listé, la liste l’indique et en donne la raison, et Sélectionner ne renseignera pas un chemin que vous n’avez pas vu. Un listage qui ne reçoit aucune réponse en 20 secondes indique que le compte n’a pas répondu.

Exécuter l’application

Remplissez le formulaire et appuyez sur Exécuter.

Vos réponses accompagnent l’exécution et ne valent que pour cette exécution. Elles ne sont jamais enregistrées dans le workflow ; les réponses d’une personne n’atteignent donc jamais l’exécution d’une autre, et l’exécution de l’application ne nécessite aucun droit de modifier le workflow, ce qui compte sur un projet qui restreint les lignes, où seuls ses Architectes peuvent le modifier. Pour changer les valeurs sur lesquelles le formulaire s’ouvre, enregistrez-les dans le workflow, comme décrit ci-dessous.

Les réponses sont vérifiées avant le démarrage de l’exécution. Les questions à choix qui n’ont jamais reçu de réponse arrêtent l’exécution avant son démarrage et sont nommées, au lieu d’être découvertes en cours d’une exécution qui peut durer près d’une heure.

Pendant qu’une exécution est en cours, le formulaire affiche une barre de progression, N of M steps comptés par rapport au nombre total d’étapes du workflow, le temps écoulé, ainsi que l’étape ou les étapes en cours d’exécution. Suspendre et Arrêter n’apparaissent à côté d’Exécuter que pendant une exécution ; Suspendre devient Reprendre lorsque l’exécution est suspendue.

Une étape qui échoue est nommée sur le formulaire dès son échec, et lorsque l’exécution se termine, le formulaire cite ce qu’a indiqué chaque étape en échec. Vous n’avez pas besoin d’ouvrir le workflow pour savoir pourquoi il s’est arrêté. Les étapes qui n’ont pas pu s’exécuter parce qu’une étape précédente a échoué sont affichées séparément comme non exécutées plutôt que comme des échecs, et elles comptent toujours dans la barre de progression, qui atteint donc la fin.

Une exécution se poursuit si vous fermez la page ou perdez la connexion. Rouvrir l’application alors que cette exécution est toujours en cours affiche l’exécution en cours, avec Suspendre et Arrêter, au lieu d’un formulaire inactif.

Un lien Ouvrir le workflow à côté d’Exécuter ouvre le workflow sous-jacent dans PlaidCloud dans un nouvel onglet, sur son canevas s’il s’agit d’un workflow DAG. Il fonctionne même si la vue propre du formulaire sur une exécution a cessé de se mettre à jour.

Vous pouvez toujours exécuter directement le workflow en définissant ses variables, comme décrit ci-dessous ; App Runner est une voie d’accès supplémentaire, de type application.

Maintenir l’application à jour

Une application App Runner est une application serveur Panel dont PlaidCloud génère les fichiers app.py, widget_map.py et requirements.txt. Lorsque PlaidCloud met à jour App Runner, vos applications existantes adoptent d’elles-mêmes la nouvelle version : chacune est actualisée avec les fichiers courants et reconstruite à la prochaine mise à jour de PlaidCloud, et à nouveau chaque fois que vous cliquez sur Régénérer ou modifiez l’application sur l’écran Mes applications Panel. Les paramètres de l’application et son workflow ne sont pas touchés.

Une application verrouillée est laissée telle quelle. Déverrouillez-la et cliquez sur Régénérer pour la mettre à jour.
Les modifications manuelles des fichiers générés sont remplacées. Une actualisation écrit les fichiers courants app.py, widget_map.py et requirements.txt par-dessus vos modifications. L’historique Git de l’application conserve les versions antérieures.

Types d’entrée convertis

PlaidCloud convertit les contrôles d’application Alteryx courants en entrées de workflow typées :

Les zones de texte deviennent des variables de texte.
Les contrôles numériques deviennent des variables numériques.
Les contrôles de date deviennent des variables de date ISO.
Les cases à cocher, boutons radio, listes déroulantes, zones de liste et arborescences deviennent des variables de choix contrôlé.
Les contrôles de parcours de fichier deviennent des variables de fichier Document.
Les contrôles de parcours de dossier deviennent des variables de dossier Document.

Le workflow converti utilise ces variables partout où l’application Alteryx utilisait la valeur de la question d’origine.

Définir les valeurs avant une exécution

Avant d’exécuter un workflow d’application converti :

Ouvrez le workflow converti.
Examinez les variables de workflow.
Définissez les valeurs requises de texte, numériques, de date, de choix, de fichier et de dossier.
Vérifiez que les chemins de fichier et de dossier Document pointent vers l’emplacement des dépendances importées ou vers un autre chemin Document approuvé.
Exécutez le workflow.

Pour les exécutions planifiées, enregistrez les valeurs de variables à utiliser chaque fois que la planification s’exécute.

Conditions, avertissements et erreurs

Les conditions et vérifications d’erreur des applications Alteryx se convertissent en conditions d’étape PlaidCloud. Une condition peut :

Permettre au workflow de continuer.
Émettre un message d’avertissement.
Arrêter le workflow avec une erreur claire lorsque la règle de l’application l’exige.
Router l’exécution par une autre branche.

Utilisez ce comportement pour préserver la validation au niveau de l’application tout en exécutant le workflow dans PlaidCloud.

Entrées de fichier et de dossier

Les questions de fichier et de dossier utilisent des chemins Document :

Les entrées de fichier sélectionnent un fichier dans Document.
Les entrées de dossier sélectionnent un dossier Document.
Les dépendances de bureau importées sont stockées au chemin Document sélectionné lors de l’import.
Les étapes d’entrée dynamique peuvent utiliser des variables pour résoudre le chemin Document final à l’exécution.

Cela garantit la portabilité des applications converties entre utilisateurs et exécutions planifiées.

Paramètres de macro

Lorsqu’une application convertie appelle une macro, les variables de l’application peuvent alimenter les paramètres de la macro. PlaidCloud transmet ces valeurs au workflow de macro généré via la gestion des entrées de macro et des paramètres de contrôle.

Les exécutions simultanées de macros sont isolées ; plusieurs exécutions de workflow peuvent donc utiliser la même macro convertie sans partager d’état intermédiaire.

Liste de contrôle de validation

Pour chaque application convertie, vérifiez que :

Chaque question attendue apparaît comme variable de workflow.
Les valeurs par défaut correspondent à l’application d’origine lorsque des valeurs par défaut étaient configurées.
Les listes contrôlées contiennent les choix attendus.
Les variables de fichier et de dossier pointent vers des chemins Document.
Les conditions produisent les messages, avertissements ou comportements d’arrêt attendus.
La parité des sorties est validée pour les valeurs de variables sélectionnées.