Macros

Une macro est un workflow ou un groupe d'outils combiné dans un outil unique qui peut être inséré dans un autre workflow. Créez une macro pour enregistrer et automatiser un processus analytique que vous exécutez régulièrement. Utilisez la macro créée dans un workflow sans avoir à recréer à chaque fois le processus analytique.

Enregistrez une macro sous forme de fichier .yxmc pour l'utiliser dans Designer ou partagez-la avec d'autres utilisateurs via la Galerie de la communauté Alteryx ou le Server de votre entreprise.

Types de macros

Macro standard : cette macro permet d'inclure dans un package un processus d'un workflow en tant qu'outil afin de l'insérer dans un workflow.
Macro batch : cette macro s'exécute à plusieurs reprises dans un workflow, créant un résultat après chaque exécution. La macro s'exécute une fois pour chaque enregistrement ou groupe d'enregistrements de données sélectionné. La macro exige un outil Paramètre de contrôle en tant qu’entrée.
Macro itérative : cette macro s'exécute dans le workflow autant de fois que défini dans la configuration ou de façon continue jusqu'à ce qu'une condition soit satisfaite.
Macro Optimiseur d'emplacement : cette macro est une macro itérative qui peut être utilisée dans l'analyse du réseau pour identifier un ou plusieurs emplacements optimaux.

Construire une macro

Une macro consiste en un workflow et une interface utilisateur créée à l’aide d’outils Interface. Pour plus d'informations, rendez-vous sur Outils Interface et Fenêtre Concepteur d'interface . Vous pouvez également créer une interface utilisateur personnalisée à l'aide de l' outil Bibliothèque GUI - HTML .

Pour construire une macro...

Si vous utilisez un workflow existant, sélectionnez la partie du workflow que vous voulez enregistrer en tant que macro, puis copiez-la et collez-la dans un nouvel onglet de workflow.

Créez un nouveau workflow ou ouvrez un workflow existant.
Ajouter une entrée de macro :
- Si le workflow ne contient pas d'entrée, ajoutez un outil Entrée de macro.
- Si le workflow contient un outil d'entrée (comme un outil Entrée de données ou Saisie de texte), cliquez avec le bouton droit de la souris sur l'outil, puis sélectionnez Convertir en Entrée de macro .
Configurez l' outil Entrée de macro .
Ajoutez et configurez un outil Sortie de macro .

Par défaut, le type de workflow devient Macro standard quand un outil Entrée de macro est ajouté dans un workflow. Le type de macro est renseigné par défaut par Macro batch lorsque vous ajoutez un outil Paramètre de contrôle au workflow. Pour créer une macro itérative, réglez le type de macro sur Itérative.

Pour définir le type de macro :

Sélectionnez le canevas, puis cliquez sur l'onglet Workflow dans la fenêtre Configuration du workflow.
Dans le champ Type , près de Macro , sélectionnez un type de macro.

Convertir en macro

En plus de créer une macro à partir de zéro, vous avez la possibilité de convertir un workflow existant en macro, dans sa totalité ou en partie. Avant de convertir une macro, vérifiez les exigences et limitations suivantes :

Vous devez d'abord exécuter le workflow et parcourir partout où les données sont disponibles.
Vous devez enregistrer le workflow avant de convertir en macro.
Les outils sélectionnés doivent se trouver dans un chemin continu et être connectés les uns aux autres (hormis les commentaires, navigateurs et conteneurs d'outils qui ne sont pas concernés).
Les outils sélectionnés ne doivent pas contenir d'erreurs.
Les outils sélectionnés ne doivent pas contenir d'outils BDD.
Les outils sélectionnés ne doivent pas être connectés à des outils Action.
Les outils sélectionnés ne doivent pas contenir un outil Python.
Les outils sélectionnés ne doivent pas inclure de données contenant des types de données spatiales, BLOB ou Rapport.

Pour convertir en macro...

Sélectionnez au moins un outil dans un workflow. Cliquez sur le canevas du workflow et faites-le glisser pour sélectionner plusieurs outils.
Cliquez avec le bouton droit de la souris sur l'un des outils sélectionnés pour ouvrir le menu des outils.
Sélectionnez Convertir en macro dans la liste déroulante pour ouvrir la fenêtre Créer une macro .
Dans la fenêtre Créer une macro…
- Entrez un nom de fichier pour la macro.
- Choisissez un emplacement où enregistrer la macro.
- Choisissez une icône pour la macro.
Sélectionnez Ok pour convertir votre workflow en macro, dans sa totalité ou en partie. Sélectionnez Annuler pour abandonner le processus.
Le fichier de macro nouvellement créé s'ouvre dans un nouvel onglet de Designer et le workflow d'origine indique que les outils sélectionnés ont été convertis en macro.

Enregistrer la macro

Enregistrez une macro en vue de son utilisation et de son partage ultérieurs. Enregistrez les macros sous un nom unique à un emplacement spécifique. Dans Designer, vous pouvez créer un répertoire de macro associé à un emplacement sur votre ordinateur ou votre réseau afin d’y enregistrer facilement des macros et les utiliser dans un workflow.

Pour enregistrer une macro...

Sélectionnez Fichier > Enregistrer sous .
Identifiez le dossier dans lequel enregistrer les macros sur votre ordinateur ou votre réseau.
Entrez le nom unique de la macro, puis sélectionnez Enregistrer .

Pour partager un workflow utilisant des macros personnalisées, exportez le workflow pour vous assurer que toutes ses dépendances, y compris la macro, sont enregistrées avec le workflow. Le workflow doit inclure le chemin relatif de la macro. Consultez les pages Gestion de workflow et Dépendances du workflow pour plus d'informations.

Créer un référentiel de macro

Dans Designer, vous pouvez associer l’emplacement où enregistrer les macros et créez un répertoire de macro afin d’y enregistrer facilement les macros et les utiliser dans un workflow. Tout fichier .yxmc de macro à l’emplacement sélectionné apparaît dans la catégorie de l’outil dans la palette d’outils.

Pour créer un référentiel de macro...

Sélectionnez Options > Paramètres utilisateur > Modifier les paramètres utilisateur > Macros .
Sélectionnez le bouton « + ».
Dans Nom de catégorie , entrez un nom. Le nom par défaut est Macros.
Sélectionnez le bouton « ... » pour accéder à l'emplacement où vous enregistrez les macros sur votre ordinateur ou sur un réseau.

Les sous-dossiers d'un chemin de recherche ne peuvent pas être ajoutés de manière individuelle si leur dossier parent existe déjà dans le référentiel de macros.

Pour définir un emplacement de référentiel par défaut...

Sélectionnez le chemin de recherche du référentiel dans la liste.
Sélectionnez Définir par défaut . Le référentiel par défaut est signalé par un astérisque ( * ).

Utiliser une macro dans un workflow

Pour utiliser une macro enregistrée dans votre répertoire de macro, recherchez la macro dans la palette d’outils ou utilisez l’option Rechercher.

Pour utiliser une macro qui n’apparaît pas dans la palette d’outils, cliquez avec le bouton droit sur le canevas du workflow, puis sélectionnez Insérer > Macro . Toute macro actuellement ouverte dans le canevas peut être sélectionnée dans cette liste ou vous pouvez accéder à l’emplacement d’un autre fichier *.yxmc de macro.

Pour utiliser une version de macro spécifique dans votre workflow, cliquez sur la macro avec le bouton droit de votre souris et sélectionnez la version que vous voulez exécuter. Les versions de macro doivent toutes être stockées dans le même répertoire. Vous pouvez configurer cet emplacement dans Paramètres utilisateur .

Pour distinguer une macro d'un outil dans un workflow, sélectionnez l'option Afficher les indicateurs de macro sur les outils pour afficher l'icône + dans Paramètres utilisateur > Canevas . Rendez-vous sur Paramètres utilisateur pour plus d'informations.

Pour afficher le workflow d'une macro, cliquez avec le bouton droit de la souris sur la macro dans un workflow, puis sélectionnez Ouvrir la macro . Une macro dans un workflow est automatiquement mise à jour lorsque les modifications apportées à cette macro sont enregistrées.

Échantillons de macros

Designer propose des macros qui vous aideront à apprendre leur création et leur utilisation. Pour accéder aux macros...

Dans Fichiers de programme de votre ordinateur, allez dans \Program Files\Alteryx\bin\RuntimeData\Macros.
Dans Designer...
- Accédez à Aide > Exemples de workflows > Utiliser des outils de script et d'automatisation > Créer une macro .
- Certains outils de la palette d’outils sont des macros. Par exemple, les outils Créer des échantillons et Nettoyage des données . Cliquez avec le bouton droit de la souris sur un outil, puis sélectionnez Ouvrir la macro , si cette option est disponible, pour afficher le workflow de macro.
Accédez aux applications publiées dans la Galerie de la communauté Alteryx .

Dans cette section: