Partager via

Appeler une fonction à partir d’une application, d’un flux, d’un code ou d’une autre fonction (version préliminaire)

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

Vous pouvez appeler des fonctions dans Dataverse à partir d’une application canevas, d’une page personnalisée dans une application pilotée par modèle, d’un flux, d’un code ou d’une autre fonction.

Important

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle, afin que les clients puissent y accéder de façon anticipée et apporter leurs commentaires.

Appeler une fonction à partir d’une application canevas ou d’une page personnalisée

  1. À partir de la zone Fonctions dans Power Apps (make.powerapps.com), sélectionnez la fonction que vous souhaitez appeler à partir d’une application canevas ou d’une page personnalisée.
  2. Sélectionnez Copier le extrait de code sur la barre de commandes.
  3. Collez et enregistrez la formule copiée dans un éditeur de texte, un bloc-notes ou un endroit auquel vous pouvez facilement vous référer.
  4. Dans Power Apps Studio :
    1. Créez ou modifiez une application canevas ou une page personnalisée dans Power Apps Studio.
    2. Dans le volet de navigation de gauche, sous l’onglet Sources de données, sélectionnez Ajouter des données, recherchez l’option Environnement dans le connecteur Dataverse et sélectionnez-la.
    3. Insérez les composants suivants sur le canevas :
      • Ajoutez des contrôles d’entrée qui correspondent au type de données de chaque paramètre, tel que la saisie numérique.
      • Ajoutez un bouton pour appeler la fonction.
      • Ajoutez un contrôle de sortie qui correspond au type de données de votre paramètre, tel que la saisie numérique.
  5. Sélectionnez le bouton que vous avez créé et, dans la propriété OnSelect, entrez votre fonction, par exemple Environment.new_calculatesum.
  6. Mappez chaque paramètre d’entrée Value pour référencer les contrôles de saisie correspondants :
    • Si votre fonction est Environment.new_CalculateSum({ X: Value, Y: Value });, elle peut être réécrite comme suit : Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Pour définir la sortie « result » de votre fonction, mettez à jour votre formule sur « Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))’.
  7. Sélectionnez le contrôle de sortie et définissez la propriété ’Value’ avec la formule ’result.z’.

Affichez un aperçu de votre application, entrez les valeurs d’entrée 1 et 2, puis sélectionnez le bouton. Le résultat doit s’afficher dans le champ de sortie.

Appeler des fonctions à partir d’un flux de cloud Power Automate

  1. Dans un flux de cloud, ajoutez une nouvelle action à partir du connecteur Microsoft Dataverse.
  2. Sélectionnez l’action appelée Exécuter une action non liée
  3. Sélectionnez votre fonction. La fonction a un nom unique avec un préfixe.
  4. Fournissez des valeurs pour tous les paramètres d’entrée (le cas échéant).

Appeler des fonctions à partir de l’API web Dataverse

Suivez les étapes pour les sections de l’action non liée dans l’article Appel d’API personnalisées à partir de l’API web (en fonction de la portée appropriée du plug-in).

Appeler des fonctions existantes à partir de nouvelles fonctions

Pour appeler une fonction existante dans une nouvelle fonction, utilisez la syntaxe : Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Étant donné que la sortie est toujours un enregistrement, utilisez la notation par points pour accéder aux paramètres de sortie. Par exemple, si la fonction « ExistingFunction » a deux paramètres de sortie définis comme out1 et out2, vous pouvez y accéder de l’une des deux manières suivantes :

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Limitations des fonctions dans Dataverse

  • L’objet de langage d’environnement doit être rajouté pour accéder aux nouvelles fonctions dans les applications canevas existantes. Pour les fonctions créées après avoir ajouté la source de données de la table d’environnement à une application canevas existante, vous devez supprimer et rajouter l’objet de langage d’environnement Power Fx. Vous voyez alors la liste mise à jour des fonctions en tant qu’actions.
  • Support imbriqué. Les fonctions ne peuvent appeler que des actions Microsoft publiées par Microsoft à partir d’expressions Power Fx.
  • Certains scénarios Collect nécessitent Patch. Dans certains scénarios, Collect() ne fonctionne pas. La solution de contournement consiste à utiliser Patch(), comme indiqué dans l’exemple de remplissage de la colonne de référence ici.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Déboguer et obtenir de l’aide pour vos fonctions

Si vous rencontrez des problèmes lors de la création ou de l’exécution de votre fonction, utilisez la fonction trace() pour le débogage ou consultez Limitations des fonctions dans Dataverse pour connaître les problèmes courants qui peuvent se produire.

Débogage à l’aide de la fonction trace()

  1. Pour déboguer à l’aide de la fonction de suivi, assurez-vous d’activer le suivi de l’activité du plug-in et du flux de travail personnalisé.
  2. Accédez à Power Apps (make.powerapps.com), sélectionnez l’icône d’engrenage Paramètres dans le coin supérieur droit, puis sélectionnez Paramètres avancés.
  3. Sélectionnez Paramètres > Audit > Paramètres d’audit globaux.
  4. Dans l’onglet Personnalisation, assurez-vous que l’option Activer la journalisation dans le journal de suivi du plug-in est activée pour Tout.

Une fois que vous avez activé le suivi, vous pouvez commencer à utiliser les fonctions trace() pour déboguer les formules Power Fx. Pour en savoir plus sur l’utilisation de la fonction trace() dans une expression Power Fx : Fonction de suivi - Power Platform.

Contacter l’aide + le support

Pour les problèmes liés aux fonctions non couvertes dans les conseils sur les plug-ins low-code Microsoft Dataverse et les problèmes connus, tels que les erreurs non documentées reçues, utilisez l’expérience Aide + Support et incluez les informations suivantes :

  • Type de problème – API web Dataverse et SDK.
  • Sous-type de problème.

Exemples de fonctions

Créer et utiliser des fonctions dans Microsoft Dataverse

  • Last updated on