Créer et exécuter avec Weave

Description

Vous pouvez commencer la plupart des tâches dans PlaidCloud en disant à Weave ce que vous voulez, en une phrase. Weave répond par une carte qui indique exactement ce qu’il va créer ou modifier, et rien ne se passe tant que vous ne l’avez pas approuvée. Tout ce qui est décrit sur cette page se passe dans le dock Weave, et chaque carte suit les mêmes règles :

Vous approuvez une carte dans le navigateur, avec Approve 1 change (ou Approve 6 changes), vous laissez les choses en l’état avec Pas maintenant, ou vous redemandez avec Change….
Chaque exécution lancée par Weave a la comptabilisation ERP désactivée.
Weave n’exécute, ne modifie ni ne planifie une étape qui écrit en dehors de PlaidCloud. Il vous renvoie au formulaire de l’étape ou au workflow.
Weave ne peut faire que ce que votre rôle autorise. Si votre rôle ne permet pas une action, Weave l’indique et ne modifie rien.

Consultez Approuver une modification pour savoir comment se lit une carte et comment l’annuler.

Dites à Weave ce que vous voulez

Les boîtes de dialogue qui créent un projet, un workflow, une étape, une importation ou une dimension s’ouvrent sur Tell Weave what you want : une zone pour une phrase, avec quelques suggestions de départ sous forme de liens en dessous.

Boîte de dialogue	La zone demande	Suggestions de départ
Nouveau projet	Describe the project, avec un exemple	Partir d’un modèle, Importer des fichiers depuis Documents, Copier un projet
Nouveau workflow	What should this workflow do?	Importer un fichier dans une table, Copier des étapes d’un autre workflow, Rapprocher deux tables
Nouvelle étape	What should this step do?	Importer un fichier, Rechercher, Filtre
Importation	Which file should become a table?	Importer un fichier dans une table
Nouvelle dimension	What should this dimension hold?	Créer à partir de la colonne d’une table

Saisissez la phrase et appuyez sur Entrée. Le dock s’ouvre avec votre phrase envoyée. Appuyez sur Maj+Entrée pour aller à la ligne. Dans Nouveau projet, Demander à Weave devient le bouton principal dès que la zone contient du texte.

Cliquez sur Fill in the form instead pour le formulaire habituel, et sur Tell Weave instead pour revenir à la zone. PlaidCloud mémorise ce que vous avez utilisé en dernier pour chaque type d’objet.

Le menu New step du canevas de workflow commence par Describe the step…, qui ouvre la même zone pour une étape placée après celle sur laquelle vous vous trouvez.

La zone apparaît lorsque le chat Weave est activé et que votre rôle peut créer cet objet. Sinon, la boîte de dialogue affiche le formulaire.

Listes et pages vides

Une liste vide part aussi de Weave :

Projets, Workflows, Tables, Dimensions et les étapes d’un workflow affichent la zone de phrase.
Éditeurs de données, UDF, Connexions et Tableaux de bord affichent un bouton Demander à Weave.
Un canevas de workflow vide indique This workflow is empty. Tell Weave what it should do, or add a step., avec la zone, une suggestion de départ Importer un fichier et Ajouter une étape.
Un projet sans workflow affiche une carte Start with Weave sur sa Vue d’ensemble.

Les boutons habituels de la liste, comme le chargement de données d’exemple, restent disponibles en dessous.

Décrire un workflow et le regarder se construire

Décrivez ce qu’un workflow doit faire, par exemple Importe freight.csv, recherche la région de chaque transporteur et totalise le fret par transporteur. Weave répond par une seule carte de plan, intitulée par exemple Build 3 steps in a new workflow “Freight by Carrier”, then run it. Chaque ligne du plan indique ce que fait une étape, en termes simples :

Import freight.csv into a new table Freight (Carrier, Amount, Month).
Look up Region in Carriers by Carrier.
Total Amount by Carrier into Freight by Carrier.
Run Freight by Carrier. ERP posting is off for this run.

Un plan peut importer des fichiers, extraire, rechercher, joindre, unir et totaliser, et les étapes suivantes peuvent lire les tables créées par les étapes précédentes. L’exécution du workflow est la dernière ligne du plan.

Lorsque vous approuvez, le dock affiche Création du workflow, Création de l’étape 2 sur 3 et En cours d’exécution. Sur le canevas, chaque étape apparaît au moment de sa création avec un contour Built by Weave, qui s’estompe à la fin de la construction, et un bandeau au-dessus du workflow indique Weave is building this workflow. Cliquez sur Arrêter dans le bandeau pour arrêter. Weave indique alors ce qu’il avait construit, par exemple Stopped part-way: built Import Freight and Lookup Region.

Weave construit dans des workflows avancés. Si on lui demande de construire dans un workflow standard, il propose de construire un nouveau workflow à la place.
Un nouveau workflow ne peut pas prendre le nom d’un workflow existant.
Weave importe des fichiers CSV, Excel, Parquet et DB2. Une ligne que Weave ne peut pas construire est listée sous Not added: avec la raison, par exemple un fichier absent ou sans ligne d’en-tête.

Exécuter ou planifier un workflow

Demandez à Weave d’exécuter un workflow, ou une partie de celui-ci : Exécute Month-End Close à partir d’Allocate by Driver. La carte est intitulée d’après ce qui va s’exécuter, par exemple Run “Month-End Close” from the step “Allocate by Driver”, et liste :

Exécutions — le nombre d’étapes exécutées.
Écriture — les tables que l’exécution écrit.
Écriture ERP — ERP posting is off for this run., lorsque des étapes de l’exécution comptabilisent dans un ERP.
Défaire — A run can’t be undone: it replaces what these tables hold.

Dans un workflow standard, les étapes s’exécutent dans l’ordre ; une exécution d’étapes non adjacentes couvre donc tout ce qui se trouve entre elles, et la carte l’indique.

Après l’exécution, Weave indique comment elle s’est déroulée, par exemple succeeded in 4 min, avec les lignes de chaque table et si elles se situent dans leur plage habituelle. Si le workflow est déjà en cours d’exécution, rien ne démarre, et Weave vous invite à approuver de nouveau une fois qu’il est terminé.

Demandez à Weave de planifier un workflow, par exemple Exécute Month-End Close chaque jour ouvré à 06:00, ou de modifier, activer, désactiver ou supprimer l’une de ses planifications. La carte de planification affiche Quand, les trois prochaines heures d’exécution sous Suivant, et Activée. Une modification d’une planification existante l’affiche avant et après. Après votre approbation, Weave vous indique quand a lieu la prochaine exécution.

Exécuter un workflow nécessite un rôle qui peut modifier les workflows. Modifier les planifications nécessite aussi un rôle qui peut modifier l’automatisation du projet.
Weave n’active ni ne modifie une planification qui comptabilise dans un ERP. Il indique This schedule posts to the ERP. Turn it on in Schedules.
Weave n’exécute ni ne planifie un workflow qui envoie des données en dehors de PlaidCloud. Exécutez-le depuis le workflow.

Modifier ou ajouter une étape

Demandez à Weave de modifier une étape, par exemple Modifie Allocate by Driver pour qu’elle répartisse selon l’effectif. La carte est intitulée Change “Allocate by Driver”, affiche chaque paramètre avant et après, et se termine par Then: re-run Allocate by Driver with ERP posting off and check it succeeds. Après votre approbation, Weave enregistre la modification, ré-exécute l’étape et vous indique le résultat. Le bouton Défaire de la carte rétablit les paramètres.

Demandez à Weave d’ajouter une étape, par exemple Ajoute une étape après Load Freight qui ne conserve que les lignes de 2026. La carte est intitulée Add a step “Freight 2026” after “Load Freight”, et une table créée par l’étape est marquée (new table). Dans un workflow avancé, l’étape est placée à droite de celle qu’elle suit.

Weave ne modifie pas, au moyen d’une carte :

une étape qui comptabilise dans un ERP ou écrit en dehors de PlaidCloud ;
les étapes SQL, comme Extract: SQL et Importation : SQL, les étapes de fonction définie par l’utilisateur et les étapes qui exécutent des scripts ou du Python ;
tout ce qui vide, supprime ou efface une table ou une dimension.

Il indique lesquelles et vous renvoie au formulaire de l’étape. Une étape qui exécute d’autres workflows, ou qui figure dans plusieurs workflows, n’est pas ré-exécutée après la modification. Weave vous invite à la ré-exécuter depuis son workflow.

Déposer un fichier sur Weave

Faites glisser un fichier sur la Vue d’ensemble d’un projet, ou sur le canevas d’un workflow avancé. La page indique Drop a file or an Alteryx workflow here, téléverse le fichier dans Documents et ouvre le dock avec une carte pour celui-ci :

Vous déposez	Weave propose
Un fichier de données : CSV, TSV, TXT, Excel ou Parquet	Une nouvelle table, sur la Vue d’ensemble, ou une étape d’importation nommée d’après le fichier, placée là où vous l’avez déposé sur le canevas.
Un script SQL (`.sql`)	Des étapes qui font ce que fait le script. Consultez Transformer un script SQL en étapes.
Un workflow Alteryx (`.yxmd` ou `.yxwz`)	Un nouveau projet contenant le workflow converti. Consultez Importer des workflows Alteryx.
Un fichier `.zip`	Le transfert des workflows Alteryx qu’il contient dans un nouveau projet.

Weave traite un fichier à la fois. Si vous en déposez plusieurs, il utilise le premier et l’indique. Pour importer un dossier, compressez-le et déposez le fichier zip, ou téléversez-le dans Documents et nommez-le dans le dock. Un fichier que Weave ne reconnaît pas reste dans Documents, et Weave vous indique où.

Vous pouvez aussi nommer un fichier qui se trouve déjà dans Documents : Convertis Revenue Prep.yxmd depuis Documents.

Transformer un script SQL en étapes

Déposez un fichier .sql, ou collez le script dans le dock. Weave le lit et propose des étapes standard qui effectuent le même travail, sur une carte de plan telle que Build 6 steps from 4 statements in a new workflow “Revenue Prep”, then run it. Déposées sur un canevas, les étapes sont ajoutées à ce workflow.

La carte nomme le dialecte SQL selon lequel le script a été lu : Databricks, Spark, Snowflake, BigQuery, T-SQL, Oracle, PostgreSQL, MySQL ou StarRocks. Si Weave a deviné le dialecte et que le script est écrit pour une autre base de données, précisez laquelle et redemandez.

Chaque ligne indique ce que fait une étape, par exemple Total Amount by Region into Revenue by Region. Tout ce qui ne peut pas devenir une étape est listé sous Not added: avec l’instruction et la raison, par exemple une instruction qui modifie la base de données elle-même, ou une table qui ne se trouve pas encore dans le projet. Une instruction est soit convertie entièrement, soit non ajoutée : Weave ne construit jamais une partie d’instruction.

Weave lit les scripts jusqu’à 1 Mo. Divisez un script plus long en plusieurs fichiers.
Les instructions INSERT, UPDATE, DELETE et MERGE deviennent des étapes qui écrivent de nouvelles tables ou en mettent une à jour. Weave ne vide pas de tables ; un DELETE sans WHERE n’est donc pas ajouté.
Une table créée par le script est utilisée par les instructions qui la suivent. Toute autre table lue par le script doit déjà se trouver dans le projet.
Comme pour tout plan, Weave construit dans des workflows avancés, et l’exécution finale a la comptabilisation ERP désactivée.

Importer des workflows Alteryx

Un seul workflow

Déposez un workflow Alteryx (.yxmd ou .yxwz) sur la Vue d’ensemble d’un projet, ou nommez-en un dans Documents. La carte Convert “Revenue Prep” into a new project affiche :

Nom du projet — Revenue Prep (from Alteryx). La carte crée un nouveau projet avec le workflow converti et ses tables, et copie les fichiers d’entrée qu’il lit dans le dossier situé à côté. Rien ne change dans vos projets existants.
Estimation — le nombre approximatif d’outils du workflow, et combien sont convertis, nécessitent une vérification ou n’ont pas d’équivalent PlaidCloud.
Enregistré dans — le dossier Documents dans lequel vont les fichiers du projet.

Lorsque vous approuvez, Weave convertit le workflow et vous indique ce qu’il a créé, avec Ouvrir le projet et Ouvrir le workflow. Les fichiers d’entrée qu’il n’a pas trouvés sont listés, afin que vous puissiez les ajouter au dossier plus tard. Défaire place le nouveau projet dans la corbeille.

Un workflow de plus de 25 Mo, ou dont l’estimation prend trop de temps, est converti dans le convertisseur Alteryx à la place.

Un dossier entier

Nommez un dossier de workflows Alteryx dans Documents, par exemple Transfère le dossier Alteryx Finance Close, ou déposez-en un fichier .zip sur la Vue d’ensemble d’un projet. Placez aussi dans le dossier les fichiers que vos workflows Alteryx ont écrits, et Weave compare avec eux les résultats des workflows convertis.

La carte Move 12 Alteryx workflows into a new project affiche le nom du projet, une estimation de la conversion des workflows, les fichiers de sortie avec lesquels elle comparera, et les étapes qu’elle exclut du contrôle parce qu’elles écrivent en dehors de PlaidCloud. Chaque exécution a la comptabilisation ERP désactivée, et les étapes qui écrivent des fichiers de sortie ne s’exécutent pas pendant le contrôle : ce sont les tables qu’elles écrivent qui sont comparées à la place.

Un dossier volumineux peut prendre plusieurs heures. Vous pouvez fermer PlaidCloud pendant le traitement. La progression de la tâche dans le dock passe par la décompression, la conversion, l’importation des fichiers de sortie, l’exécution et la comparaison, puis la rédaction du rapport. Elle se termine par une phrase telle que Finance Close (from Alteryx) is ready: 9 of 12 workflows match the outputs you supplied, 2 differ, 1 didn’t run. 3 need a decision on the move-in report. avec Ouvrir le rapport.

Le Rapport de migration liste d’abord les workflows qui nécessitent une décision, puis chaque workflow avec ce qui a été reconnu et converti, ce qui est à vérifier, s’il a été Exécuté et si ses résultats Correspondent aux fichiers que vous avez fournis. Chaque ligne comporte :

Comparer — ouvre la comparaison des résultats de ce workflow avec votre fichier.
Revérifier — propose de ré-exécuter et de comparer ce workflow.
Ouvrir — ouvre le workflow.
Affecter — choisit qui décide pour la ligne. Cette personne est avertie dans PlaidCloud. Vous ne pouvez affecter une ligne qu’à un membre du projet qui peut ouvrir ce workflow.

Un workflow nécessite une décision lorsqu’il n’a pas été converti, comporte des outils sans équivalent PlaidCloud, ne s’est pas exécuté, diffère de votre fichier ou n’a pas pu être comparé.