Aller au contenu

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, aux filtres, aux chemins de fichiers, aux conditions, aux paramètres de macro et aux paramètres des étapes en aval.

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 ces valeurs. Vous obtenez cette interface automatiquement lors 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, sélection de fichier et sélection de dossier. Chaque contrôle écrit dans la variable de workflow que lit 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 variable de workflow réelle s’affiche avec une remarque visible, plutôt que de collecter silencieusement une valeur qui ne mène nulle part : vérifiez-le et pointez-le vers la variable voulue.

Le formulaire reprend le regroupement de l’auteur de l’application, c’est-à-dire les onglets et les zones étiquetées avec lesquels il a construit l’application, et le texte explicatif de l’auteur (les outils Label d’Alteryx) est affiché sur le formulaire à côté des questions qu’il décrit. Une question que l’application a figée à la conception, comme un Detour sans question d’interface qui le pilote, n’est pas affichée du tout 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 tant que personne n’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 plutôt qu’affichée comme une sélection obsolète. 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é : le chemin suivi par une exécution est donc choisi au moment de l’exécution, comme l’application Alteryx le faisait.

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, par défaut le compte propre de 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. Si 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 renseigne pas un chemin que vous n’avez pas vu. Une liste qui ne reçoit aucune réponse en 20 secondes indique que le compte n’a pas répondu.

Renseignez le formulaire et appuyez sur Exécuter.

Vos réponses accompagnent l’exécution et ne valent que pour celle-ci. 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 exécuter l’application ne nécessite aucun droit de modification du 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 indiqué ci-dessous.

Les réponses sont vérifiées avant le démarrage de l’exécution. Les questions à choix auxquelles personne n’a répondu interrompent l’exécution avant son démarrage et sont nommées, plutôt que d’être découvertes en cours d’exécution, qui peut durer près d’une heure.

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

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 elle s’est arrêtée. Les étapes qui n’ont pas pu s’exécuter parce qu’une étape précédente a échoué sont présentées séparément comme non exécutées plutôt que comme des échecs, et elles comptent quand même 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 pendant que cette exécution est encore en cours affiche l’exécution en cours, avec Pause et Arrêter, au lieu d’un formulaire inactif.

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

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

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 actuels et reconstruite à la prochaine mise à jour de PlaidCloud, puis de nouveau chaque fois que vous utilisez Régénérer ou modifiez l’application sur l’écran Applications. Les paramètres de l’application et son workflow ne sont pas modifiés.

  • Où se trouvent les fichiers. Sur la connexion PlaidCloud Git gérée, une application App Runner est un dossier portant le nom de l’application dans le dépôt apps de votre espace de travail, à côté de vos autres applications Panel. Une application qui avait son propre dépôt est déplacée automatiquement dans son dossier, et l’ancien dépôt est archivé (conservé en lecture seule, jamais supprimé). Un push vers apps ne reconstruit une application que si son propre dossier, ou le fichier requirements.txt à la racine du dépôt, a changé.
  • 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 app.py, widget_map.py et requirements.txt actuels par-dessus vos modifications. L’historique Git de l’application conserve les versions précédentes.

PlaidCloud convertit les contrôles courants des applications Alteryx 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, les boutons radio, les listes déroulantes, les zones de liste et les arborescences deviennent des variables à choix contrôlé.
  • Les contrôles de sélection de fichier deviennent des variables de fichier Document.
  • Les contrôles de sélection 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.

Avant d’exécuter le workflow d’une application convertie :

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

Pour les exécutions planifiées, enregistrez les valeurs de variables à utiliser à chaque exécution de la planification.

Les conditions et les contrôles d’erreur des applications Alteryx sont convertis en conditions d’étape PlaidCloud. Une condition peut :

  • Autoriser le workflow à 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 conserver la validation au niveau de l’application tout en exécutant le workflow dans PlaidCloud.

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’importation.
  • Les étapes d’entrée dynamiques peuvent utiliser des variables pour résoudre le chemin Document final à l’exécution.

Cela rend les applications converties portables d’un utilisateur à l’autre et d’une exécution planifiée à l’autre.

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 paramètres d’entrée et de contrôle de la macro.

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.

Pour chaque application convertie, vérifiez que :

  • Chaque question attendue apparaît sous forme de variable de workflow.
  • Les valeurs par défaut correspondent à celles de l’application d’origine lorsqu’elles é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, les avertissements ou le comportement d’arrêt attendus.
  • La parité des sorties est validée pour les valeurs de variables sélectionnées.