操作ボタン

操作ボタンはサーバーが登録した操作を実行します。カスタムAPI、カスタムアクション、Dataverseのメッセージ、またはあなたのコードのいずれかで、登録されたユーザーにのみ表示されます。ボタンはサーバーにサインインしたユーザーが実行可能な操作を一度だけ尋ね、送信するレコードをユーザーが行う可能性のある操作と照合するため、サーバーが拒否するようなものを提供しません。サーバーは送信時にすべてのリクエストを判断します。

操作の登録

サーバーの Program.csに操作を登録します:Dataverse操作の場合は AddOperationAccess 、 AddOperationHandler は自分のコードです。 AddPortalRole内で、 WithOperationAccess と WithOperationHandler は役割の保持者に1つずつ付与します。登録は、誰が操作を実行できるか、リクエストが持つパラメータ、指すべきレコード、そして返ってくる出力を規定します。

• ForEveryone()、 ForSignedInUsers()、 ForContactsMatching(fetchXml) 、 ForWebRoles(...) が誰が実行できるかを決めています。ロールの登録はその役割の保有者のためのものです。Dataverseネイティブセキュリティの下では、連絡先はポータルロールではなくウェブロールを保持し、実行権限を持つセキュリティロールを持つユーザーのみがカスタムAPIを提供します。
• 自分のコードへのリクエストはDataverse操作と同じように判断されます。ハンドラーはサーバーが設定したパラメータを埋めた合格リクエストのみを認識し、呼び出し者は登録が返す出力のみを見る。
• 自分のコードはDataverseのトランザクションを共有できないため、リクエストは自動的に送られます。他のものと一緒に処理するバッチは拒否されます。
• セキュリティ は登録書が伝えるすべての内容を説明しています。

オペレーションボタン

操作が属する場所には OperationButton を入れ、演算名とその記録に入るパラメータを付けます。

• この処理を実行しないユーザーには隠されており、回答が届く間に; WhenNotAllowed (whenNotAllowed)を設定して代わりに無効にします。回答は一度だけ求められ、アプリが開いている間に保持されます。サーバーが拒否したリクエストは再度求められます。
• レコードは RecordParameterに入ります: Record、参照による任意の記録、または保存された後はボタンが入っている RecordContext の記録です。ユーザーは登録の要求に応じてその記録に対応できなければなりません。フォームのレコードにはユーザーが何をできるかが記され、参照名付きのレコードが読み取られます。
• フォームの場合、そのフォームのレコードに対するDataverse操作は、変更後にフォーム自身のセーブに送信されるため、両方が保存されるかどちらでも保存されず、レコードが読み戻されます。フォームの変更が保存された後、あなたのコードが実行されます。
• Parameters はすべてのリクエストに送信され、 GetParametersAsync (getParameters)はボタンをクリックすると、例えばダイアログからさらに多くを集めます。何も返さないとクリックはキャンセルされます。 ConfirmationMessage は操作を実行する前に尋ね、 OnCompleted は出力を返します。
• テキストの Label 内容やアイコン、ツールチップ、見た目を他のボタンと同じように設定してください。

オペレーショングリッドボタン

グリッドのツールバーでは、 OperationGridButton 選択された各行に対して一度だけ操作を実行し、その行を RecordParameterに送信し、その後グリッドを更新します。選択されたすべての行がユーザーが行動可能な行であり、各行がそれ自体を示している間に有効化されます。Dataverse操作のリクエストは1つのトランザクションで送信されるため、すべて実行するか、実行しないかのどちらかです。自分のコードは一度に1行ずつ動作し、失敗した最初の行で停止します。

ユーザーが何を実行できるかを尋ねること

ボタンは GET /api/permissions/operationsを尋ね、サインインユーザーだけが答えます:実行するすべての操作、またはあなたが名前を挙げた操作のみ、それぞれのリクエストが何を運ぶか、指し示すべきレコードを含みます。あなたのUIはBlazorの IOperationAccessCache や IPowerPortalsProService.GetOperationAccessForCurrentUserAsync 、Reactの useOperationAccess や ppp.retrieveOperationAccessAsync で同じ質問を行えます。