Partager via


Didacticiel : Utiliser l’API web du portail

Notes

À compter du 12 octobre 2022, le portail Power Apps devient Power Pages. Plus d’informations : Microsoft Power Pages est maintenant généralement disponible (blog)
Nous allons bientôt migrer et fusionner la documentation des portails Power Apps avec la documentation de Power Pages.

Dans ce didacticiel, vous allez configurer une page Web et un modèle Web personnalisé qui utiliseront l’API Web pour lire, écrire, mettre à jour et supprimer des enregistrements de la table des contacts.

Notes

Vous pouvez modifier les noms de colonnes ou utiliser une table différente, tout en suivant les étapes de cet exemple.

Étape 1. Créer des paramètres de site

Avant d’utiliser l’API web des portails, vous devez activer les paramètres de site obligatoires avec l’application Gestion du portail. Les paramètres du site dépendent de la table que vous souhaitez utiliser au moment de l’interaction avec l’API Web.

  1. Accéder à  Power Apps.

  2. Dans le volet gauche, sélectionnez Applications.

  3. Sélectionnez l’application Gestion du portail .

    Lancez l’application Gestion de portail.

  4. Dans le volet gauche de l’application Gestion du portail , sélectionnez Paramètres du site.

    Ouvrez les paramètres du site dans l’application Gestion du portail.

  5. Cliquez sur Nouveau.

  6. Dans la zone Nom , entrez Webapi/contact/enabled.

  7. Dans la liste Site web , sélectionnez votre enregistrement de site web.

  8. Dans la zone Valeur , entrez true.

    Activer la table de contacts pour le paramètre de site WebAPI.

  9. Cliquez sur  Enregistrer et fermer.

  10. Cliquez sur Nouveau.

  11. Dans la zone Nom , entrez Webapi/contact/fields.

  12. Dans la liste Site web , sélectionnez votre enregistrement de site web.

  13. Dans la zone Valeur , entrez
    prénom,nom,nom complet,adressemail1,téléphone1

    Activer le paramètre de site des champs de la table de contacts de l’API Web.

  14. Cliquez sur  Enregistrer et fermer.

  15. Cliquez sur Nouveau.

  16. Dans la zone Nom , entrez Webapi/error/innererror.

    Activer le paramètre de site d’erreur interne de l’API Web.

  17. Dans la liste Site web , sélectionnez votre enregistrement de site web.

  18. Dans la zone Valeur , entrez true.

  19. Cliquez sur  Enregistrer et fermer.

  20. Vérifiez les paramètres du site pour l’ API web.

Étape 2. Configurer les autorisations

Vous devrez configurer des autorisations permettant aux utilisateurs d’utiliser la fonctionnalité API web. Dans cet exemple, vous allez activer la table Contacts pour les autorisations de table, créez un rôle Web à l’aide de l’API Web, ajoutez les autorisations de table pour la table Contacts à ce rôle Web, puis ajoutez le rôle Web aux utilisateurs afin de leur permettre d’utiliser l’API Web.

  1. Dans le volet gauche de l’application Gestion du portail , sélectionnez Autorisations de table.

  2. Cliquez sur Nouveau.

  3. Dans la zone Nom , entrez Autorisation de la table des contacts.

  4. Dans la liste Nom de la table , sélectionnez Contact (contact).

  5. Dans la liste Site web , sélectionnez votre enregistrement de site web.

  6. Dans la liste Type d’accès , sélectionnez Global.

  7. Sélectionnez les privilèges Lire, Écrire, Créer et Supprimer.

  8. Cliquez sur  Enregistrer et fermer.

    Autorisations de table de contact.

Créer un rôle web

Vous pouvez utiliser un rôle web existant sur votre site web ou créer un rôle web.

  1. Dans le volet de gauche, sélectionnez Rôles Web .

  2. Cliquez sur Nouveau.

  3. Dans la zone Nom , entrez Utilisateur de l’API web (ou tout nom qui reflète le mieux le rôle de l’utilisateur accédant à cette fonctionnalité).

  4. Dans la liste Site web , sélectionnez votre enregistrement de site web.

    Ajouter le rôle Web de l’utilisateur de l’API Web.

  5. Cliquez sur Enregistrer.

Ajouter des autorisations de table associée

  1. Avec le rôle web, nouveau ou existant, sélectionnez Association > Autorisations de table.

    Ajouter des autorisations de table associées au rôle web.

  2. Sélectionnez Ajouter une autorisation de table existante.

  3. Sélectionnez Autorisation de la table des contacts, créé plus tôt.

    Sélectionner l’autorisation de la table de contacts.

  4. Sélectionnez Ajouter.

  5. Cliquez sur  Enregistrer et fermer.

    Vue Autorisations de table.

Ajouter des contacts au rôle web

  1. Dans le volet de gauche, sélectionnez Contacts.

  2. Sélectionnez le contact que vous voulez utiliser dans cet exemple pour l’API web.

    Notes

    Ce contact est le compte d’utilisateur utilisé dans cet exemple pour tester l’API web. Assurez-vous de sélectionner le bon contact dans votre portail.

  3. Sélectionnez Association > Rôles web.

    Sélectionnez Sélection des rôles Web associés.

  4. Sélectionnez Ajouter un rôle web existant.

  5. Sélectionnez le rôle Utilisateur de l’API web , créé plus tôt.

  6. Sélectionnez Ajouter.

    Vue associée Rôle Web.

  7. Cliquez sur  Enregistrer et fermer.

Étape 3. Créer une page web

Maintenant que vous avez activé l’API web et configuré les autorisations utilisateur, créez une page Web avec un exemple de code pour afficher, modifier, créer et supprimer des enregistrements.

  1. Dans le volet gauche de l’application Gestion du portail , sélectionnez Pages Web.

  2. Cliquez sur Nouveau.

  3. Dans la zone Nom, entrez webapi.

  4. Dans la liste Site web, sélectionnez votre enregistrement de site web.

  5. Pour Page Parent, sélectionnez Accueil.

  6. Pour URL partielle, entrez webapi.

  7. Pour Modèle de page, sélectionnez Accueil.

  8. Pour État de publication, sélectionnez Publié.

  9. Cliquez sur Enregistrer.

    Page web.

  10. Sélectionnez Association > Pages Web.

    Pages Web associées

  11. Depuis Vue associée de la page Web, sélectionnez webapi.

    Vue associée Page web.

  12. Défilez vers le bas jusqu’à la section Contenu, puis accédez à Copier (HTML) (concepteur HTML).

    Copier le contenu HTML

  13. Sélectionnez l’onglet HTML.

    Sélectionner l’onglet HTML

  14. Copiez l’exemple d’extrait de code suivant et collez-le dans le concepteur HTML.

        <!-- Sample code for Web API demonstration -->
    <style>
        #processingMsg {
            width: 150px;
            text-align: center;
            padding: 6px 10px;
            z-index: 9999;
            top: 0;
            left: 40%;
            position: fixed;
            -webkit-border-radius: 0 0 2px 2px;
            border-radius: 0 0 2px 2px;
            -webkit-box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
            box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
            display: none;
        }
    
        table td[data-attribute] .glyphicon-pencil {
            margin-left: 5px;
            opacity: 0;
        }
    
        table td[data-attribute]:hover .glyphicon-pencil {
            opacity: 0.7;
        }
    </style>
    
    <script>
      $(function() {
        //Web API ajax wrapper
        (function(webapi, $) {
          function safeAjax(ajaxOptions) {
            var deferredAjax = $.Deferred();
            shell.getTokenDeferred().done(function(token) {
              // Add headers for ajax
              if (!ajaxOptions.headers) {
                $.extend(ajaxOptions, {
                  headers: {
                    "__RequestVerificationToken": token
                  }
                });
              } else {
                ajaxOptions.headers["__RequestVerificationToken"] = token;
              }
              $.ajax(ajaxOptions)
                .done(function(data, textStatus, jqXHR) {
                  validateLoginSession(data, textStatus, jqXHR, deferredAjax.resolve);
                }).fail(deferredAjax.reject); //ajax
            }).fail(function() {
              deferredAjax.rejectWith(this, arguments); // On token failure pass the token ajax and args
            });
            return deferredAjax.promise();
          }
          webapi.safeAjax = safeAjax;
        })(window.webapi = window.webapi || {}, jQuery)
        // Notification component
        var notificationMsg = (function() {
          var $processingMsgEl = $('#processingMsg'),
            _msg = 'Processing...',
            _stack = 0,
            _endTimeout;
          return {
            show: function(msg) {
              $processingMsgEl.text(msg || _msg);
              if (_stack === 0) {
                clearTimeout(_endTimeout);
                $processingMsgEl.show();
              }
              _stack++;
            },
            hide: function() {
              _stack--;
              if (_stack <= 0) {
                _stack = 0;
                clearTimeout(_endTimeout);
                _endTimeout = setTimeout(function() {
                  $processingMsgEl.hide();
                }, 500);
              }
            }
          }
        })();
        // Inline editable table component
        var webAPIExampleTable = (function() {
          var trTpl = '<% _.forEach(data, function(data){ %>' +
            '<tr data-id="<%=data.id%>" data-name="<%=data.fullname%>">' +
            '<% _.forEach(columns, function(col){ %>' +
            '<td data-attribute="<%=col.name%>" data-label="<%=col.label%>" data-value="<%=data[col.name]%>">' +
            '<%-data[col.name]%><i class="glyphicon glyphicon-pencil"></i>' +
            '</td>' +
            '<% }) %>' +
            '<td>' +
            '<button class="btn btn-default delete" type="submit"><i class="glyphicon glyphicon-trash" aria-hidden="true"></i></button>' +
            '</td>' +
            '</tr>' +
            '<% }) %>';
          var tableTpl = '<table class="table table-hover">' +
            '<thead>' +
            '<tr>' +
            '<% _.forEach(columns, function(col){ %>' +
            '<th><%=col.label%></th>' +
            '<% }) %>' +
            '<th>' +
            '<button class="btn btn-default add" type="submit">' +
            '<i class="glyphicon glyphicon-plus" aria-hidden="true"></i> Add Sample Record' +
            '</button>' +
            '</th>' +
            '</tr>' +
            '</thead>' +
            '<tbody>' + trTpl + '</tbody>' +
            '</table>';
          function getDataObject(rowEl) {
            var $rowEl = $(rowEl),
              attrObj = {
                id: $rowEl.attr('data-id'),
                name: $rowEl.attr('data-name')
              };
            $rowEl.find('td').each(function(i, el) {
              var $el = $(el),
                key = $el.attr('data-attribute');
              if (key) {
                attrObj[key] = $el.attr('data-value');
              }
            })
            return attrObj;
          }
          function bindRowEvents(tr, config) {
            var $row = $(tr),
              $deleteButton = $row.find('button.delete'),
              dataObj = getDataObject($row);
            $.each(config.columns, function(i, col) {
              var $el = $row.find('td[data-attribute="' + col.name + '"]');
              $el.on('click', $.proxy(col.handler, $el, col, dataObj));
            });
            //User can delete record using this button
            $deleteButton.on('click', $.proxy(config.deleteHandler, $row, dataObj));
          }
          function bindTableEvents($table, config) {
            $table.find('tbody tr').each(function(i, tr) {
              bindRowEvents(tr, config);
            });
            $table.find('thead button.add').on('click', $.proxy(config.addHandler, $table));
          }
          return function(config) {
            var me = this,
              columns = config.columns,
              addHandler = config.addHandler,
              deleteHandler = config.deleteHandler,
              $table;
            me.render = function(el) {
              $table = $(el).html(_.template(tableTpl)({
                columns: columns,
                data: me.data
              })).find('table');
              bindTableEvents($table, {
                columns: columns,
                addHandler: addHandler,
                deleteHandler: deleteHandler
              });
            }
            me.addRecord = function(record) {
              $table.find('tbody tr:first').before(_.template(trTpl)({
                columns: columns,
                data: [record]
              }));
              bindRowEvents($table.find('tbody tr:first'), config);
            }
            me.updateRecord = function(attributeName, newValue, record) {
              $table.find('tr[data-id="' + record.id + '"] td[data-attribute="' + attributeName + '"]').text(newValue);
            }
            me.removeRecord = function(record) {
              $table.find('tr[data-id="' + record.id + '"]').fadeTo("slow", 0.7, function() {
                $(this).remove();
              });
            }
          };
        })();
        //Applicaton ajax wrapper 
        function appAjax(processingMsg, ajaxOptions) {
          notificationMsg.show(processingMsg);
          return webapi.safeAjax(ajaxOptions)
            .fail(function(response) {
              if (response.responseJSON) {
                alert("Error: " + response.responseJSON.error.message)
              } else {
                alert("Error: Web API is not available... ")
              }
            }).always(notificationMsg.hide);
        }
        function loadRecords() {
          return appAjax('Loading...', {
            type: "GET",
            url: "/_api/contacts?$select=fullname,firstname,lastname,emailaddress1,telephone1",
            contentType: "application/json"
          });
        }
        function addSampleRecord() {
          //Sample data to create a record - change as appropriate
          var recordObj = {
            firstname: "Willie",
            lastname: "Huff" + _.random(100, 999),
            emailaddress1: "Willie.Huff@contoso.com",
            telephone1: "555-123-4567"
          };
          appAjax('Adding...', {
            type: "POST",
            url: "/_api/contacts",
            contentType: "application/json",
            data: JSON.stringify(recordObj),
            success: function(res, status, xhr) {
              recordObj.id = xhr.getResponseHeader("entityid");
              recordObj.fullname = recordObj.firstname + " " + recordObj.lastname;
              table.addRecord(recordObj);
            }
          });
          return false;
        }
        function deleteRecord(recordObj) {
          var response = confirm("Are you sure, you want to delete \"" + recordObj.name + "\" ?");
          if (response == true) {
            appAjax('Deleting...', {
              type: "DELETE",
              url: "/_api/contacts(" + recordObj.id + ")",
              contentType: "application/json",
              success: function(res) {
                table.removeRecord(recordObj);
              }
            });
          }
          return false;
        }
        function updateRecordAttribute(col, recordObj) {
          var attributeName = col.name,
            value = recordObj[attributeName],
            newValue = prompt("Please enter \"" + col.label + "\"", value);
          if (newValue != null && newValue !== value) {
            appAjax('Updating...', {
              type: "PUT",
              url: "/_api/contacts(" + recordObj.id + ")/" + attributeName,
              contentType: "application/json",
              data: JSON.stringify({
                "value": newValue
              }),
              success: function(res) {
                table.updateRecord(attributeName, newValue, recordObj);
              }
            });
          }
          return false;
        }
        var table = new webAPIExampleTable({
          columns: [{
            name: 'firstname',
            label: 'First Name',
            handler: updateRecordAttribute
          }, {
            name: 'lastname',
            label: 'Last Name',
            handler: updateRecordAttribute
          }, {
            name: 'emailaddress1',
            label: 'Email',
            handler: updateRecordAttribute
          }, {
            name: 'telephone1',
            label: 'Telephone',
            handler: updateRecordAttribute
          }],
          data: [],
          addHandler: addSampleRecord,
          deleteHandler: deleteRecord
        });
        loadRecords().done(function(data) {
          table.data = _.map(data.value, function(record){
            record.id = record.contactid;
            return record;
          });
          table.render($('#dataTable'));
        });
      });
    </script>
    <div id="processingMsg" class="alert alert-warning" role="alert"></div>
    <div id="dataTable"></div>
    

    Coller le code.

  15. Cliquez sur Enregistrer et fermer.

Étape 4. Effacer le cache des portails

Vous avez créé un exemple de page webapi pour tester la fonctionnalité de l’API Web. Avant de commencer, assurez-vous que le cache des portails Power Apps a bien été effacé afin que les modifications de l’application Gestion du portail soient reflétées sur votre portail.

IMPORTANT : L’effacement du cache côté serveur du portail entraîne une dégradation temporaire des performances du portail pendant le rechargement des données à partir de Microsoft Dataverse.

Pour effacer le cache :

  1. Connectez-vous à votre portail en tant que membre du rôle Web Administrateurs.

  2. Modifiez l’URL en ajoutant /_‑services/about à la fin. Par exemple, si l’URL du portail est  https://contoso.powerappsportals.com, remplacez-la par  https://contoso.powerappsportals.com/_services/about.

    Effacer le cache.

    REMARQUE : vous devez être membre du rôle Web Administrateurs pour effacer le cache. Si vous affichez un écran vide, vérifiez les attributions de rôle Web.

  3. Sélectionnez Effacer le cache.

Plus d’informations :  Effacer le cache côté serveur d’un portail

Étape 5. Utilisez l’API Web pour lire, afficher, modifier, créer et supprimer

L’exemple de page Web avec l’URL webapi créé précédemment est maintenant prêt à être testé.

Pour tester la fonctionnalité de l’API Web :

  1. connectez-vous à votre portail avec le compte d’utilisateur auquel le rôle Utilisateur de l’API web précédemment créé est affecté.

  2. Accédez à la page Web webapi créée précédemment. Par exemple, https://contoso.powerappsportals.com/webapi La WebAPI récupérera les enregistrements de Microsoft Dataverse.

    Exemple de page web webapi.

  3. Sélectionnez Ajouter un exemple d’enregistrement pour ajouter l’exemple d’enregistrement à partir du script.

  4. Sélectionnez un champ. Dans cet exemple, nous avons sélectionné Email pour modifier l’adresse e-mail d’un contact.

    Modifier l’e-mail

  5. Sélectionnez Supprimer le bouton pour supprimer un enregistrement.

Maintenant que vous avez créé une page Web avec un exemple pour lire, modifier, créer et supprimer des enregistrements, vous pouvez personnaliser les formulaires et la mise en page.

Étape suivante

Composer des demandes HTTP et traiter les erreurs

Voir aussi

Vue d’ensemble des portails Web API
Opérations d’écriture, de mise à jour et de suppression à l’aide de l’API Web
Les portails lisent les opérations à l’aide de l’API Web
Configurer les autorisations de colonne

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).