Skip to main content

Mettre à jour les macros manquantes

Historiquement, lorsque vous importez ou ouvrez un workflow avec une macro existante, si cette macro était absente du workflow (en raison d'un changement de nom, d'un déplacement, d'un package incorrect, etc.), la macro présentait une icône en forme de point d'interrogation ( UnknownTool_71x71.png) sur le canevas du workflow.

Vous avez ensuite dû passer par un processus pénible qui consiste à rajouter manuellement la macro et reconfigurer le workflow pour que les choses fonctionnent correctement.

Maintenant, vous pouvez identifier les emplacements de macro corrects avant l'ouverture du workflow et éviter complètement l'erreur de la macro manquante !

Mettre à jour les macros manquantes dans les workflows

Lorsque vous tentez d'ouvrir un workflow (fichier YXMD, YXMC ou YXWZ) avec une macro manquante, une fenêtre contextuelle Mettre à jour les macros manquantes apparaît dans Designer pour vous avertir du problème.

update-missing-macros-1.png

La fenêtre Mettre à jour les macros manquantes indique que le workflow référence au moins une macro manquante ou inaccessible. Le message fournit des détails sur ces macros. Notez que la fenêtre répertorie un maximum de 3 macros manquantes (bien qu'il en manque peut-être davantage).

Vous avez 2 options :

  • Mettre à jour : sélectionnez l'option Mettre à jour pour mettre à jour les chemins de fichiers des macros manquantes. Cela ouvre le workflow d'origine où vous pouvez apporter des modifications. Cependant, Designer n'enregistre pas automatiquement le workflow. Une fois les mises à jour effectuées, vous pouvez utiliser Fichier > Enregistrer sous ou le raccourci clavier Ctrl+S (Enregistrer) pour enregistrer une nouvelle version du workflow ou remplacer le workflow d'origine si nécessaire. Notez que vous devez accéder aux fichiers de macros manquantes et pouvoir naviguer jusqu'à leurs emplacements. Si vous avez reçu le workflow de quelqu'un qui n'a pas inclus les macros, vous devrez probablement le contacter et lui demander de vous fournir les fichiers. Si vous choisissez de ne pas mettre à jour les chemins de fichiers ici, le workflow s'ouvrira avec les icônes d'outils manquants.

  • Fermer (ne pas mettre à jour) : sélectionnez l'option Fermer. Cela ouvre le workflow d'origine sans les macros mises à jour. Les macros auront l'icône d'outil manquant ( UnknownTool_71x71.png) et, si vous souhaitez corriger ces macros manquantes ultérieurement, vous devrez ajouter les macros et les reconfigurer manuellement.

Mettre à jour la macro

Pour mettre à jour les macros, procédez comme suit :

  1. Dans la fenêtre Mettre à jour les macros manquantes, sélectionnez l'option Mettre à jour .

  2. Une fenêtre Mettre à jour les macros manquantes s'ouvre, similaire à l'expérience Dépendances du workflow. Ici, vous pouvez modifier le chemin de fichier de chaque macro manquante et mettre à jour son emplacement. Notez que vous ne pouvez pas modifier les dépendances non macro via cette fenêtre.

    update-missing-macros-2.png
  3. Sélectionnez l'icône de crayon de modification associée à une macro manquante. Cette opération ouvre l'explorateur de fichiers dans lequel vous pouvez naviguer jusqu'à l'emplacement correct de la macro. Sélectionnez la macro pour que Designer mette à jour le chemin de la macro et passe la couleur du chemin en vert.

  4. Effectuez cette opération pour les macros supplémentaires et sélectionnez OK lorsque vous avez terminé. Vous pouvez également sélectionner Annuler à ce stade, ce qui ouvre le workflow d'origine avec des chemins de fichiers rompus (icônes de point d'interrogation d'outil manquant).

  5. Si vous avez mis à jour les chemins de macros et sélectionné OK à l'étape précédente, votre workflow s'ouvre avec les macros mises à jour et aucune icône d'outil manquant.

Si la macro est la même et que le nombre de connexions d'entrée et de sortie des nouveaux chemins de macros correspond au nombre indiqué dans le workflow, Designer tente d'établir les connexions automatiquement. Cependant, dans certains cas (par exemple, si vous connectez une macro différente avec le même nombre d'entrées et de sorties), Designer n'est pas en mesure d'établir les connexions. Si c'est le cas, vous devez les vérifier et les configurer manuellement. 

Important

Lorsque vous utilisez la fonctionnalité Mettre à jour les macros manquantes, Designer met à jour le workflow d'origine, mais le workflow n'est pas automatiquement enregistré. Vous pouvez utiliser Fichier > Enregistrer sous ou le raccourci clavier Ctrl+S (Enregistrer) pour enregistrer une nouvelle version du workflow ou remplacer le workflow d'origine si nécessaire. Si vous fermez le workflow sans enregistrer, vos mises à jour seront perdues.

Fermer (ne pas mettre à jour)

Si vous souhaitez ouvrir le workflow sans mettre à jour les macros, procédez comme suit :

  1. Lorsque vous tentez d'ouvrir un workflow avec des macros manquantes, la fenêtre Mettre à jour les macros manquantes s'affiche.

  2. Pour ouvrir le workflow sans mettre à jour les emplacements des macros, sélectionnez l'option Fermer .

  3. Votre workflow s'ouvre et les macros manquantes affichent l'icône d'outil manquant ( UnknownTool_71x71.png). Si vous souhaitez mettre à jour les macros manquantes, vous devez ajouter les macros et les reconfigurer manuellement.

Mettre à jour les macros manquantes dans les packages de workflows

Si vous essayez d'importer un package de workflow Alteryx (YXZP) avec une macro manquante, le processus est très similaire à celui décrit ci-dessus. Vous devez d'abord passer par le processus d'importation, dont la sélection d'un répertoire de destination.

  1. Lors de l'importation, si Designer détecte des macros manquantes, un message contextuel s'affiche pour vous donner l'information suivante :

    Une erreur est survenue lors du chargement d'une macro : macro « \Example-Macro.yxmc » introuvable

    import-workflow-package.png
  2. Sélectionnez OK pour continuer et suivez les invites pour terminer le processus d'importation.

À ce stade, la fenêtre Mettre à jour les macros manquantes s'ouvre et vous pouvez suivre le processus ci-dessus pour corriger les chemins d'accès aux fichiers de macros.

Mettre à jour les macros manquantes dans les macros imbriquées

Vous pouvez également mettre à jour les macros manquantes lorsque la macro manquante est imbriquée. Lorsque vous ouvrez un workflow avec une macro imbriquée manquante, le canevas et la fenêtre Résultats affichent l'erreur suivante :

Macro « \Example-Macro.yxmc » introuvable

Pour résoudre ce problème, sur le canevas du workflow, faites un clic droit sur l'icône de l'outil contenant l'erreur. Ensuite, sélectionnez Ouvrir la macro… dans le menu. Cette action déclenche immédiatement la fenêtre Mettre à jour les macros manquantes, qui vous permet de suivre le processus ci-dessus .