Boutons d’opération

Un bouton d’opération exécute une opération enregistrée par le serveur — une API personnalisée, une action personnalisée, un message propre à Dataverse, ou un code à vous — et ne l’affiche qu’aux utilisateurs pour lesquels il est enregistré. Le bouton demande une fois au serveur quelles opérations l’utilisateur connecté peut exécuter, et vérifie chaque enregistrement qu’il enverrait par rapport à ce que l’utilisateur pourrait lui faire, afin de ne pas offrir ce que le serveur refuserait. Le serveur juge toujours chaque requête lors de son envoi.

Enregistrement d’une opération

Enregistrer une opération dans le Program.csserveur : AddOperationAccess pour une opération Dataverse, AddOperationHandler pour votre propre code. Dans AddPortalRole, WithOperationAccess et WithOperationHandler en accorder une aux titulaires du rôle. Un enregistrement indique qui peut exécuter l’opération, les paramètres qu’une requête peut porter, les enregistrements auxquels elle doit pointer et les sorties qui reviennent.

• ForEveryone(), ForSignedInUsers(), ForContactsMatching(fetchXml) et ForWebRoles(...) indiquer qui peut l’exécuter ; l’enregistrement d’un rôle est destiné aux titulaires du rôle. Sous la sécurité native Dataverse, les contacts détiennent des rôles web plutôt que des rôles de portail, et une API personnalisée n’est proposée qu’aux utilisateurs dont les rôles de sécurité accordent son privilège d’exécution.
• Une requête pour votre propre code est jugée exactement comme l’est une opération Dataverse : le gestionnaire ne voit que les requêtes passées, avec les paramètres définis par le serveur remplis, et l’appelant ne voit que les sorties retournées par l’enregistrement.
• Votre propre code ne peut pas partager la transaction Dataverse, donc une demande est envoyée de son propre côté : un lot qui le transporte avec tout autre est refusé.
• La sécurité décrit tout ce qu’une immatriculation peut dire.

OpérationBouton

Mettez un OperationButton point où l’opération appartient, en nommant l’opération et le paramètre dans lequel son enregistrement est inclus.

• Elle est cachée aux utilisateurs qui ne peuvent pas exécuter l’opération, et pendant que la réponse est en cours ; on règle WhenNotAllowed (whenNotAllowed) pour la désactiver à la place. La réponse est demandée une fois et conservée tant que l’application est ouverte ; une demande refusée par le serveur la demande à nouveau.
• L’enregistrement est inclus RecordParameter: Record, n’importe quel enregistrement par référence, ou alors l’enregistrement du RecordContext bouton s’y installe, une fois qu’il est sauvegardé. L’utilisateur doit pouvoir agir dessus comme l’enregistrement l’exige : l’enregistrement d’un formulaire indique ce que l’utilisateur peut lui faire, et un enregistrement nommé par référence est lu pour celui-ci.
• Sur un formulaire, une opération Dataverse sur l’enregistrement du formulaire est envoyée dans la sauvegarde propre du formulaire, après ses modifications, donc les deux sont sauvegardés ou aucun, et l’enregistrement est relu. Votre propre code s’exécute après la sauvegarde des modifications du formulaire.
• Parameters sont envoyés avec chaque requête, et GetParametersAsync (getParameters) en recueille davantage lorsque le bouton est cliqué, par exemple depuis une boîte de dialogue, ; ne rien retourner annule le clic. ConfirmationMessage demande avant que l’opération ne s’exécute, et OnCompleted rend ses sorties.
• Réglez son texte avec Label ou son contenu, ainsi que son icône, infobulle et apparence comme sur n’importe quel autre bouton.

OpérationGridButton

Dans la barre d’outils d’une grille, OperationGridButton l’opération est exécutée une fois pour chaque ligne sélectionnée, envoyant la ligne dans RecordParameter, puis rafraîchissant la grille. Elle est activée alors que chaque ligne sélectionnée est une sur laquelle l’utilisateur peut agir, ce que chaque ligne indique elle-même. Les requêtes d’une opération Dataverse sont envoyées en une seule transaction, donc elles s’exécutent toutes ou aucune ne s’exécute ; votre propre code s’exécute sur une ligne à la fois et s’arrête à la première qui échoue.

Demander ce que l’utilisateur peut exécuter

Les boutons demandent GET /api/permissions/operations, ce qui répond uniquement pour l’utilisateur connecté : chaque opération qu’il peut exécuter, ou seulement celles que vous nommez, avec ce qu’une demande peut contenir et les enregistrements auxquels elle doit pointer. Votre propre interface utilisateur peut poser la même question via IOperationAccessCache ou IPowerPortalsProService.GetOperationAccessForCurrentUserAsync sur Blazor, ou useOperationAccess ppp.retrieveOperationAccessAsync sur React.