Fonctions définies par l’utilisateur DAX (préversion)

Note

Les fonctions définies par l’utilisateur DAX sont actuellement en préversion.

Les fonctions définies par l’utilisateur (DAX) DAX (Data Analysis Expressions) vous permettent de empaqueter une logique DAX réutilisable et paramétrée dans vos modèles, ce qui facilite l’écriture, la maintenance et le partage de votre code DAX. Au lieu de répéter des formules pour des mesures, des colonnes calculées et des visuels, les UDF (fonctions définies par l’utilisateur) apportent une flexibilité de style de programmation à vos modèles sémantiques. Cela vous permet de définir une fois des fonctions et de les utiliser partout où le langage DAX est pris en charge. Pour en savoir plus, consultez les fonctions définies par l’utilisateur DAX.

Pourquoi utiliser des fonctions définies par l’utilisateur ?

• Réutilisabilité et cohérence : définissez un calcul une fois et réutilisez-le partout.
• Facilité de maintenance : Mettez à jour la logique à un emplacement unique pour corriger ou faire évoluer les règles.
• Création plus sûre : les indicateurs de type facultatifs et les helpers de vérification de type prennent en charge le code prévisible et résistant aux erreurs.
• Objets de modèle de première classe : les UDFs (fonctions définies par l’utilisateur) vivent dans le modèle et peuvent être consultées dans l'explorateur de modèles.

Get started

Pour essayer les fonctions définies par l’utilisateur dans Desktop :

1. Accédez aux options de fichier > et aux paramètres>.
2. Sélectionnez Fonctionnalités d’aperçu et vérifiez les fonctions définies par l’utilisateur DAX.
3. Sélectionnez OK et redémarrez Power BI Desktop.

Définir une fonction

Vous pouvez définir une fonction définie par l’utilisateur dans Power BI Desktop à l’aide de la vue de requête DAX (DQV) ou de la vue TMDL.

Syntaxe générale

La syntaxe générale d’une fonction UDF est la suivante :

/// Optional description above the function
FUNCTION <FunctionName> = ( <ParameterName>: <ParameterType>, ... ) => <FunctionBody>

Exemple : Fonction fiscale simple

Voici un exemple simple dans DQV qui ajoute une taxe au montant donné. Vous pouvez également évaluer les fonctions définies par l'utilisateur (UDF) dans DQV.

DEFINE
    /// AddTax takes in amount and returns amount including tax
    FUNCTION AddTax = (
            amount : NUMERIC
        ) =>
        amount * 1.1

EVALUATE
{ AddTax ( 10 ) }
// Returns 11

Une fois qu’une fonction UDF est définie, vous pouvez mettre à jour le modèle ou utiliser l’objectif de code pour ajouter la fonction à votre modèle.

- [Fonctions définies par l’utilisateur DAX](/dax/best-practices/dax-user-defined-functions)