Bedienungstasten

Eine Operationstaste führt eine Operation aus, die der Server registriert hat – eine benutzerdefinierte API, eine benutzerdefinierte Aktion, eine eigene Nachricht von Dataverse oder eigenen Code – und zeigt sie nur den Nutzern, für die sie registriert ist. Die Schaltfläche fragt den Server einmal, welche Operationen der angemeldete Nutzer ausführen kann, und prüft jeden Datensatz, den er senden würde, mit dem, was der Benutzer mit ihm tun könnte, sodass er nicht das anbietet, was der Server ablehnen würde. Der Server bewertet trotzdem jede Anfrage, wenn sie gesendet wird.

Registrierung einer Operation

Registrieren Sie eine Operation im ServerAddOperationAccess: Program.csfür eine Dataverse-Operation, AddOperationHandler für Ihren eigenen Code. Innerhalb AddPortalRoleund WithOperationAccess WithOperationHandler gewähren Sie den Inhabern der Rolle eine Operation. Eine Registrierung gibt an, wer die Operation ausführen darf, welche Parameter eine Anfrage enthalten darf, auf welche Datensätze sie verweisen müssen und welche Ausgaben zurückkommen.

• ForEveryone(), ForSignedInUsers(), ForContactsMatching(fetchXml) und ForWebRoles(...) sagen, wer sie ausführen darf; die Registrierung einer Rolle ist für die Inhaber der Rolle. Unter Dataverse-nativer Sicherheit halten Kontakte Webrollen statt Portalrollen, und eine benutzerdefinierte API wird nur Nutzern angeboten, deren Sicherheitsrollen das Ausführungsrecht gewähren.
• Eine Anfrage nach eigenem Code wird genau so bewertet wie eine Dataverse-Operation: Der Handler sieht nur Anfragen, die gesendet wurden, wobei die vom Server gesetzten Parameter ausgefüllt sind, und der Aufrufer sieht nur die Ausgaben, die die Registrierung zurückgibt.
• Dein eigener Code kann die Transaktion von Dataverse nicht teilen, daher wird eine Anfrage dafür von selbst gesendet: Eine Charge, die sie zusammen mit anderen Transaktionen enthält, wird abgelehnt.
• Sicherheit beschreibt alles, was eine Registrierung sagen kann.

OperationButton

Setze ein OperationButton Punkt, wo die Operation hingehört, benenne die Operation und den Parameter, in den ihr Datensatz eingefügt wird.

• Sie ist vor Nutzern verborgen, die die Operation möglicherweise nicht ausführen, und während die Antwort unterwegs ist; setzen WhenNotAllowed Sie stattdessen (whenNotAllowed), um sie zu deaktivieren. Die Antwort wird einmal gefragt und gespeichert, solange die App geöffnet ist; eine Anfrage, die der Server ablehnt, fordert sie erneut an.
• Der Datensatz geht in RecordParameter: Record, beliebigen Datensatz durch Referenz, oder der Eintrag des RecordContext Buttons befindet sich, sobald er gespeichert ist. Der Benutzer muss entsprechend der Registrierung darauf reagieren können: Der Datensatz eines Formulars gibt an, was der Benutzer damit machen darf, und ein nach Referenz benannter Datensatz wird dafür gelesen.
• Auf einem Formular wird eine Dataverse-Operation auf dem Datensatz des Formulars im eigenen Speicherstand des Formulars nach den Änderungen gesendet, sodass beide gespeichert werden oder keines von beidem, und der Datensatz wird zurückgelesen. Ihr eigener Code läuft, nachdem die Änderungen des Formulars gespeichert wurden.
• Parameters werden mit jeder Anfrage gesendet, und GetParametersAsync (getParameters) sammelt mehr, wenn der Button angeklickt wird, aus einem Dialog, zum Beispiel; wenn nichts zurückgegeben wird, wird der Klick abgebrochen. ConfirmationMessage fragt, bevor die Operation ausgeführt wird, und OnCompleted gibt die Ausgaben zurück.
• Setze den Text mit Label oder seinem Inhalt sowie Symbol, Tooltip und Aussehen wie auf jedem anderen Button.

OperationGridButton

In der Werkzeugleiste OperationGridButton eines Gitters wird die Operation einmal für jede ausgewählte Zeile ausgeführt, die Zeile in RecordParametergesendet, und dann das Raster aktualisiert. Sie ist aktiviert, während jede ausgewählte Zeile eine ist, auf die der Benutzer reagieren kann, was jede Zeile von sich selbst sagt. Die Anfragen einer Dataverse-Operation werden in einer Transaktion gesendet, also laufen sie alle oder keine; dein eigener Code läuft jeweils eine Zeile und stoppt bei der ersten, die fehlschlägt.

Zu fragen, was der Nutzer ausführen könnte

Die Schaltflächen fragen GET /api/permissions/operations, was nur für den angemeldeten Benutzer beantwortet wird: jede Operation, die er ausführen kann, oder nur die, die du nennst, mit dem, was eine Anfrage für jede Person enthalten darf und auf welche Datensätze sie verweisen muss. Deine eigene Benutzeroberfläche kann das Gleiche über IOperationAccessCache oder IPowerPortalsProService.GetOperationAccessForCurrentUserAsync auf Blazor und useOperationAccess /oder ppp.retrieveOperationAccessAsync auf React fragen.