Skip to main content

Beaker with bubbling liquid Outil Formule

Exemple d'outil unique

L'outil Formule comporte un exemple d'outil unique. Accédez à la page Exemples de workflows pour savoir comment accéder à cet exemple et à de nombreux autres exemples directement dans Alteryx Designer.

Utilisez l'outil Formule pour créer de nouvelles colonnes, mettre à jour des colonnes et utiliser une ou plusieurs expressions pour effectuer divers calculs et opérations. Accédez à la page Fonctions pour consulter la liste des fonctions à utiliser pour créer une expression.

Vous pouvez utiliser l'outil Formule pour ...

  • Appliquer des instructions conditionnelles

  • Convertir des chiffres et des chaînes

  • Mettre en forme des dates

  • Extraire des chemins de fichier

  • Appliquer des algorithmes financiers ou des calculs mathématiques

  • Rechercher des valeurs minimales et maximales.

  • Analyser des données géographiques.

  • Nettoyer des données chaîne.

  • Soumettre des données à des tests de validation

Configuration de l'outil

Dans la fenêtre Configuration , vous pouvez créer plusieurs expressions. Alteryx attribue un numéro d'ID d'expression à chaque expression individuelle dans l'ordre dans lequel elle apparaît dans la fenêtre Configuration (pas nécessairement dans l'ordre dans lequel elle a été créée). Par exemple, l'expression 1 a un ID de 1, la deuxième a un ID de 2, et ainsi de suite.

Note

Notez que si vous réorganisez vos expressions, les ID ne sont pas réorganisés conjointement. Par exemple, si vous avez 3 expressions et que vous déplacez l'expression 3 vers le haut, elle aura un ID de 1, alors qu'elle avait un ID de 3 précédemment.

Ces ID peuvent vous aider à documenter et à dépanner vos expressions puisque l'ID d'expression est référencé dans le message d'erreur.

formula-tool-id.png

Construire des expressions

Pour construire votre expression, spécifiez d'abord une colonne de sortie. La colonne de sortie contient les résultats de votre expression. Vous pouvez écraser une colonne existante ou créer une nouvelle colonne. Sélectionnez la liste déroulante Colonne de sortie et choisissez une colonne existante ou sélectionnez Ajouter une colonne et donnez un nom à votre nouvelle colonne.

Pour ajouter une nouvelle colonne de données ...

  1. Sélectionnez + Ajouter une colonne et entrez le nouveau nom de colonne.

    • Type de données  : sélectionnez un type de données , si nécessaire.

      Note

      Pour les valeurs FixedDecimal, il existe une conversion implicite en Double dans l'outil Formule.

    • Taille  : sélectionnez cette option pour modifier la taille ou la largeur des données pour les types de données décimale fixe, chaîne, date-heure, heure ou objet spatial.

  2. Sélectionnez l'éditeur d'expression pour créer votre expression. Une fois le workflow exécuté, la zone Aperçu des données affiche la première ligne de données de la colonne spécifiée avec l'expression appliquée.

Créez une expression en procédant de l’une des manières suivantes :

  • Entrez le texte directement dans l'éditeur d'expression.

  • Appuyez sur Ctrl + espace pour afficher une liste de toutes les fonctions.

  • Entrez un mot ou une expression pour afficher la liste des fonctions correspondantes.

  • Entrez le symbole [ (crochet gauche) pour afficher la liste des variables que vous pouvez utiliser dans l’expression. Les variables comprennent...

    • Colonnes : données d'une connexion entrante ou d'une colonne créée dans une expression précédente.

    • Connexions à partir de questions  : valeurs provenant d'un outil d'interface connecté à l'ancrage question (Q) d'un outil avec un éditeur d'expression, lorsque l'outil est utilisé dans une application ou une macro. Utilisez l’ancrage question (Q) lorsque vous voulez utiliser les valeurs des questions comme variables dans l’expression. Accédez à la page Outils Interface pour plus d'informations.

    • Constantes : variables globales pour un workflow qui permettent de modifier une valeur dans un emplacement unique et appliquent cette modification au reste du workflow. Accédez à la page Constantes pour plus d'informations.

  • Sélectionnez l'icône Fonctions (« fx ») pour rechercher et parcourir les catégories de fonctions. Accédez à la page Fonctions  pour plus d'informations.

  • Sélectionnez l'icône Colonnes et constantes (« x ») pour rechercher et parcourir les colonnes et constantes entrantes ou nouvellement créées.

    • Colonnes existantes  : données d'une connexion entrante ou d'une colonne créée dans une expression précédente.

    • Connexions à partir de questions  : valeurs provenant d'un outil d'interface connecté à l'ancrage question (Q) d'un outil avec un éditeur d'expression, lorsque l'outil est utilisé dans une application ou une macro. Utilisez l’ancrage question (Q) lorsque vous voulez utiliser les valeurs des questions comme variables dans l’expression. Accédez à la page Outils Interface pour plus d'informations.

    • Constantes : variables globales pour un workflow qui permettent de modifier une valeur dans un emplacement unique et appliquent cette modification au reste du workflow. Accédez à la page Constantes pour plus d'informations.

  • Sélectionnez l'icône Expressions récentes et enregistrées (dossier) pour rechercher et parcourir les expressions récentes et enregistrées.

  • Avec une expression dans l'éditeur d'expression, sélectionnez l'icône Enregistrer l'expression (disque), entrez un nom et sélectionnez Enregistrer . Une fois l’expression construite, elle peut être enregistrée en vue de son utilisation ultérieure.

Ajouter une autre expression

Il peut s'avérer utile d'ajouter plusieurs expressions dans un outil Formule unique lorsque vous modifiez des données dans des colonnes liées ou que vous exécutez des opérations similaires. Lorsque vous modifiez des données non liées ou que vous exécutez des fonctions non liées, l'utilisation de plusieurs outils Formule facilite la résolution des problèmes liés au workflow. Pour ajouter une expression, sélectionnez l'icône « + » .

Thumbnail

Réorganiser des expressions

L’ordre dans lequel les expressions sont appliquées affecte les résultats lorsque plusieurs expressions modifient les mêmes données. Pour réorganiser une expression, sélectionnez et maintenez l'icône de réorganisation (à gauche de l'éditeur d'expression) et faites glisser l'expression vers le haut ou vers le bas.

Notez que lorsque vous réorganisez des expressions, leurs ID sont réaffectés. Alteryx attribue un numéro d'ID d'expression à chaque expression individuelle dans l'ordre dans lequel elle apparaît dans la fenêtre Configuration.

Thumbnail

Développer et réduire des expressions

Lorsque vous travaillez sur vos expressions, la fenêtre Configuration de l'outil Formule peut être un peu saturée, surtout si vous avez beaucoup d'expressions individuelles.

Vous pouvez utiliser les icônes Développer et Réduire pour afficher et masquer des expressions individuelles ou pour afficher et masquer toutes les expressions simultanément.

  • Pour développer et réduire une seule expression, sélectionnez l'icône « > » associée à un ID d'expression spécifique.

  • Pour développer et réduire toutes les expressions, sélectionnez l'icône « > » en haut de l'éditeur d'expressions.

expand-collapse-expressions.png

Veuillez noter que chaque fois que vous accédez à la fenêtre Configuration de l'outil Formule, la première expression est développée et toutes les expressions suivantes sont réduites.

Ancrage d'entrée supplémentaire

Dans la mesure où cet outil inclut un éditeur d'expressions, un ancrage d'entrée supplémentaire s'affiche lorsque l'outil est utilisé dans une application ou un workflow macro. Utilisez les outils Interface pour la connexion à un ancrage Question.

Disable Individual Expressions

While you work with the Formula tool, you have the option to enable and disable individual expressions. This gives you flexibility when you build, test, troubleshoot, and execute your workflows.

  • By default, expressions in the Formula tool are always enabled.

  • When you disable an expression, the Formula tool configuration information remains unchanged (for example, name and data type selection).

  • When disabled, an expression doesn't execute at runtime, and an Info message displays in the Results window messages tab to indicate that an expression is disabled.

  • You can continue to edit any disabled expressions.

To disable an individual Formula expression...

  1. In the Formula tool, locate the expression that you want to disable.

  2. Use the Disable and Enable Expression toggle (next to the Delete Expression trash can) to disable the expression. Switch the toggle to the left (disabled) position. Note that an enabled expression displays a white left-panel color, while a disabled expression displays a gray left-panel color.

    disable-expression.gif

  3. To enable the expression, switch the toggle to the right (enabled) position.

Be Careful

If Expression 1 creates a new column and is disabled, and Expression 2 references that new column, then Expression 2 will error with a missing field (column) error.

Dans cette section​: