Botones de operación

Un botón de operación ejecuta una operación registrada por el servidor — una API personalizada, una acción personalizada, uno de los mensajes propios de Dataverse o código propio — y solo se muestra a los usuarios para los que está registrado. El botón pregunta una vez al servidor qué operaciones puede ejecutar el usuario iniciado sesión, y comprueba cada registro que enviaría con lo que el usuario podría hacerle, para no ofrecer lo que el servidor rechazaría. El servidor sigue juzgando cada solicitud cuando se envía.

Registro de una operación

Registra una operación en el servidor Program.cs: AddOperationAccess para una operación Dataverse, AddOperationHandler para tu propio código. Dentro AddPortalRolede , WithOperationAccess y WithOperationHandler concede una a los titulares del rol. Un registro indica quién puede ejecutar la operación, los parámetros que puede llevar una solicitud, los registros a los que deben apuntar y las salidas que regresan.

• ForEveryone(), ForSignedInUsers(), ForContactsMatching(fetchXml) y ForWebRoles(...) indican quién puede ejecutarlo; el registro de un rol es para los titulares del puesto. Bajo la seguridad nativa de Dataverse, los contactos tienen roles web en lugar de portales, y una API personalizada solo se ofrece a los usuarios cuyos roles de seguridad otorgan su privilegio de ejecución.
• Una petición de tu propio código se juzga exactamente como la de una operación de Dataverse: el manejador solo ve las solicitudes que han pasado, con los parámetros que el servidor establece completados, y el llamador solo ve las salidas que devuelve el registro.
• Tu propio código no puede compartir la transacción de Dataverse, así que se envía una solicitud por sí sola: un lote que lo lleve junto con cualquier otra cosa es rechazado.
• La seguridad describe todo lo que puede decir un registro.

OperationButton

Pon un OperationButton lugar donde debe estar la operación, nombrando la operación y el parámetro en el que va su registro.

• Está oculto para los usuarios que no pueden ejecutar la operación, y mientras la respuesta está en camino; se configura WhenNotAllowed (whenNotAllowed) para desactivarla en su lugar. La respuesta se pide una vez y se guarda mientras la aplicación está abierta; una solicitud que el servidor rechaza la solicita de nuevo.
• El registro entra RecordParameteren : Record, cualquier registro por referencia, o bien el registro del RecordContext botón se queda en el botón una vez guardado. El usuario debe poder actuar en consecuencia según lo requiera el registro: el registro de un formulario indica lo que el usuario puede hacer con él, y se lee un registro nombrado por referencia para él.
• En un formulario, una operación Dataverse sobre el registro del formulario se envía en la partida guardada propia del formulario, tras sus cambios, así que ambos se guardan o ninguno, y el registro se lee de nuevo. Tu propio código se ejecuta después de que se guardan los cambios del formulario.
• Parameters se envían con cada petición, y GetParametersAsync (getParameters) recoge más cuando se pulsa el botón, por ejemplo, desde un diálogo, por ejemplo; al no devolver nada cancela el clic. ConfirmationMessage pregunta antes de que se ejecute la operación y OnCompleted devuelve sus salidas.
• Establece su texto con Label o su contenido, y su icono, descripción emergente y apariencia como en cualquier otro botón.

OperaciónGridButton

En la barra de herramientas de una cuadrícula, OperationGridButton ejecuta la operación una vez por cada fila seleccionada, enviando la fila en RecordParameter, y luego actualiza la cuadrícula. Está habilitada mientras cada fila seleccionada es una sobre la que el usuario puede actuar, que cada fila dice por sí misma. Las peticiones de una operación de Dataverse se envían en una sola transacción, así que todas se ejecutan o ninguna; tu propio código se ejecuta en una fila a la vez y se detiene en la primera que falla.

Preguntar qué puede ejecutar el usuario

Los botones preguntan GET /api/permissions/operations, lo que responde solo para el usuario iniciado sesión: cada operación que pueda ejecutar, o solo las que nombras, con lo que puede llevar una solicitud para cada una y los registros a los que debe apuntar. Tu propia interfaz puede preguntar lo mismo a través IOperationAccessCache de Blazor o IPowerPortalsProService.GetOperationAccessForCurrentUserAsync useOperationAccess ppp.retrieveOperationAccessAsync en React.