Mise en œuvre du composant API web

Le composant API web est conçu pour effectuer des actions de création, de récupération, de mise à jour et de suppression. Le composant affiche quatre boutons, pouvant être activés pour appeler différentes actions de l’API Web. Le résultat de l’appel d’API web est injecté dans un élément div HTML en bas du composant de code.

Disponible pour

Applications pilotées par modèle

Code

Vous pouvez télécharger l’exemple de composant complet ici.

Par défaut, dans l’exemple, le composant est configuré pour effectuer des actions de création, de récupération, de mise à jour sur l’entité Account et définit les champs de nom et de revenu dans les exemples de l’API Web.

Pour modifier la configuration par défaut sur n’importe quelle entité ou champ, mettez à jour les valeurs de configuration suivantes, comme indiqué

 private static _entityName:string = "account";  
 private static _requiredAttributeName: string = "name";  
 private static _requiredAttributeValue: string = "Web API code component (Sample)";  
 private static _currencyAttributeName: string = "revenue";  

La méthode createRecord affiche trois boutons, qui vous permettent de créer un enregistrement de compte avec le champ de revenu défini sur différentes valeurs (100, 200, 300).

Lorsque vous sélectionnez l’un des boutons de création, le gestionnaire d’événements du onClick bouton vérifie la valeur du bouton cliqué et utilise l’action d’API web pour créer un enregistrement de compte avec le champ revenue défini sur la valeur du bouton. Le champ nom de l'enregistrement de compte est défini à Web API code component (Sample) avec une extension aléatoire int ajoutée à la fin de la chaîne. La méthode de rappel de l’appel de l’API Web injecte le résultat de l’appel de l’API Web (réussite ou échec) dans le div de résultat du contrôle personnalisé.

La méthode deleteRecord affiche un bouton qui ouvre une boîte de dialogue lorsqu’il est activé. La boîte de dialogue de recherche vous permet de sélectionner l’enregistrement de compte à supprimer. Une fois qu'un enregistrement de compte est sélectionné dans la boîte de dialogue de recherche, il est transmis au deleteRecord pour supprimer l'enregistrement de la base de données. La méthode de rappel de l’appel de l’API Web injecte le résultat de l’appel de l’API Web (réussite ou échec) dans le div de résultat du contrôle personnalisé.

La méthode FetchXML retrieveMultiple affiche un bouton dans le composant de code. onClick de ce bouton, FetchXML est généré et transmis à la fonction retrieveMultiple pour calculer la valeur moyenne du champ de revenu pour tous les enregistrements de comptes. La méthode de rappel de l’appel de l’API Web injecte le résultat de l’appel de l’API Web (réussite ou échec) dans le div de résultat du contrôle personnalisé.

La méthode retrieveMultiple OData affiche un bouton dans le composant de code. onClick de ce bouton, la chaîne OData est générée et transmise à la fonctionnalité retrieveMultiple pour récupérer tous les enregistrements de comptes avec un champ de nom semblable à « API Web du composant de code (exemple) », qui est true pour tous les enregistrements de comptes créés par cet exemple de composant de code.

Lors de la récupération réussie des enregistrements, le composant de code a une logique pour compter le nombre d’enregistrements de comptes avec le champ de revenu défini sur 100, 200 ou 300, et affiche ce nombre dans un div de conteneur de statut OData sur le composant de code. La méthode de rappel de l’appel de l’API Web injecte le résultat de l’appel de l’API Web (réussite ou échec) dans le div de résultat du contrôle personnalisé.

Articles connexes

Télécharger des exemples de composants
Comment utiliser les exemples de composants
Référence d’API Power Apps component framework
Référence du schéma de manifeste Power Apps component framework