Créer et utiliser des fonctions dans Microsoft Dataverse (version préliminaire)

[Cette rubrique fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Créez et utilisez des fonctions réutilisables dans Microsoft Dataverse. Les fonctions utilisent Power Fx pour exécuter un ensemble spécifique de commandes dans Dataverse qui s’exécutent côté serveur.

Prérequis

Appartenance au rôle de sécurité de personnalisateur système dans l’environnement Power Platform.

Créer une fonction dans une solution

1. Accédez à Power Apps, puis sélectionnez Solutions dans le volet de navigation de gauche. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.
2. Ouvrez la solution où vous souhaitez créer une fonction.
3. Dans la barre de commandes, sélectionnez Nouveau>Automatisation>Fonction.
4. Saisissez les informations suivantes dans le volet latéral Nouvelle fonction qui apparaît.
   • Fournissez un nom d’affichage et une description pour votre fonction.
   • Sélectionnez Nouveau paramètre d’entrée et/ou Nouveau paramètre de sortie, puis fournissez un nom et un type de données pour le paramètre. Ajoutez plus de paramètres d’entrée et de sortie si nécessaire.
   • Dans la liste Références de table, vous pouvez éventuellement sélectionner des tables. Vous pouvez référencer les tables Dataverse de votre choix à l’aide des fonctions de collecte de données, telles que Filter() et LookUp().
   • Entrez l’expression Power Fx dans la zone Formule.
5. Sélectionnez Enregistrer.
6. Testez la fonction.

Référencez les paramètres d’entrée dans la formule par leurs noms.

Les paramètres de sortie doivent être référencés à l’intérieur d’accolades, par exemple { Out: "Return value" }.

Exemples de fonctions

Cette section fournit quelques exemples de fonctions.

Calculer la somme de deux entiers

1. Entrez un Nom d’affichage, par exemple new_calculateSum, et une Description.

2. Ajoutez deux paramètres d’entrée, x et y (tous deux de type de données entier), et un paramètre de sortie, z (type de données entier).

3. Dans la zone Formule, entrez la formule :
   { z:x+y }

   

4. Testez la fonction.

Ajouter un nouveau titre à la table d’articles

1. Créez deux paramètres d’entrée titre et url (tous deux avec des types de données de chaîne) et une variable de sortie, message (type de données de chaîne).
2. Sélectionnez la table Articles fédérés de la base de connaissances dans le menu déroulant Références de table.
3. Dans la zone Formule, entrez la formule :

Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

Validez si une chaîne d’entrée contient les chaînes de votre choix

1. Créez un paramètre d’entrée DocumentTextInput (avec un type de données de chaîne) et une variable de sortie, nommée résultat (type de données de chaîne).
2. Dans la zone Formule, entrez la formule :

{
    result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput, 

    "Document is compliant.", 
    "Document is missing one or more compliance clauses." 
    ) 
}

Calculer le prix d’un séjour à l’hôtel

1. Créez six paramètres d’entrée : nuits, chambres, taxes, remises, roomservice, ratepernight (tous avec un type de données de chaîne) et une variable de sortie, price (type de données float).
2. Dans la zone Formule, entrez la formule :

{ 
   price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice 

}

Plus d’exemples de fonctions

Pour obtenir d’autres exemples de fonctions, consultez Exemples de fonctions (version préliminaire).

Modifier, tester ou supprimer une fonction

Modifier une fonction

1. Sélectionnez votre fonction dans la zone Fonctions.
2. Dans la barre de commandes, sélectionnez Modifier.
3. Modifiez votre formule, puis enregistrez-la.

Tester une fonction

1. Sélectionnez la fonction dans la zone Fonctions.
2. Sélectionnez Tester dans la barre de commandes.
3. Fournissez des valeurs pour les paramètres d’entrée définis dans la fonction, puis sélectionnez Lire.

Un test réussi renvoie une réponse OData qui inclut des informations telles que l’URI de l’organisation, le nom de la fonction, ainsi que les paramètres et valeurs de sortie.

Supprimer une fonction

1. Sélectionnez Fonctions dans le volet de navigation de gauche, puis sélectionnez votre fonction. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.
2. Sélectionnez Supprimer dans la barre de commandes.

Articles associés

Fonctions dans Microsoft Dataverse (version préliminaire)