Botões de Operação

Um botão de operação executa uma operação registrada pelo servidor — uma API personalizada, uma ação personalizada, uma mensagem própria do Dataverse ou código seu — e aparece apenas para os usuários para os quais está registrado. O botão pergunta ao servidor uma vez quais operações o usuário logado pode executar, e verifica cada registro que enviaria em relação ao que o usuário pode fazer com ele, para não oferecer o que o servidor recusaria. O servidor ainda julga cada solicitação quando ela é enviada.

Registrando uma operação

Registre uma operação no servidor Program.cs: AddOperationAccess para uma operação do Dataverse, AddOperationHandler para seu próprio código. Dentro AddPortalRolede , WithOperationAccess e WithOperationHandler conceda uma aos detentores do papel. Um registro indica quem pode executar a operação, os parâmetros que uma solicitação pode carregar, os registros para os quais devem apontar e as saídas que retornam.

• ForEveryone(), ForSignedInUsers(), ForContactsMatching(fetchXml) e ForWebRoles(...) digam quem pode executá-la; o registro de uma função é para os detentores da função. Sob a segurança nativa do Dataverse, os contatos possuem papéis web em vez de portais, e uma API personalizada é oferecida apenas a usuários cujos papéis de segurança concedem seu privilégio de execução.
• Uma solicitação pelo seu próprio código é julgada exatamente como a de uma operação do Dataverse: o manipulador vê apenas as requisições que foram passadas, com os parâmetros definidos pelo servidor preenchidos, e o chamador vê apenas as saídas retornadas pelo registro.
• Seu próprio código não pode compartilhar a transação do Dataverse, então um pedido é enviado por conta própria: um lote que carrega com qualquer outra coisa é recusado.
• Segurança descreve tudo o que um registro pode dizer.

OperationButton

Coloque onde OperationButton a operação pertence, nomeando a operação e o parâmetro em que seu registro vai entrar.

• Ela é oculta dos usuários que podem não executar a operação e, enquanto a resposta está a caminho; configure WhenNotAllowed (whenNotAllowed) para desativá-la em vez disso. A resposta é pedida uma vez e mantida enquanto o aplicativo está aberto; uma solicitação que o servidor recusa pede novamente.
• O registro entra RecordParameterem : Record, qualquer registro por referência, ou então o registro do RecordContext botão fica lá, uma vez salvo. O usuário deve poder agir conforme o registro exige: o registro de um formulário diz o que o usuário pode fazer com ele, e um registro nomeado por referência é lido para ele.
• Em um formulário, uma operação do Dataverse no registro do formulário é enviada no save próprio do formulário, após as alterações, então ambos são salvos ou nenhum, e o registro é lido novamente. Seu próprio código roda após as alterações do formulário serem salvas.
• Parameters são enviadas com cada requisição, e GetParametersAsync (getParameters) acumula mais quando o botão é clicado, por exemplo; não devolver nada cancela o clique. ConfirmationMessage pergunta antes da operação rodar e OnCompleted devolve suas saídas.
• Defina seu texto com Label ou seu conteúdo, e seu ícone, dica de ferramenta e aparência como em qualquer outro botão.

OperationGridButton

Na barra de ferramentas de uma grade, OperationGridButton executa a operação uma vez para cada linha selecionada, enviando a linha em RecordParameter, e então atualiza a grade. Ela é ativada enquanto cada linha selecionada é uma que o usuário pode agir, que cada linha diz por si só. As requisições de uma operação do Dataverse são enviadas em uma única transação, então todas são executadas ou nenhuma roda; seu próprio código roda em uma linha de cada vez e para na primeira que falha.

Perguntando o que o usuário pode rodar

Os botões perguntam GET /api/permissions/operations, o que responde apenas para o usuário logado: cada operação que ele pode executar, ou apenas aquelas que você nomeia, com o que uma solicitação para cada uma pode conter e os registros para os quais deve apontar. Sua própria interface pode pedir o mesmo através IOperationAccessCache ou IPowerPortalsProService.GetOperationAccessForCurrentUserAsync no Blazor, e useOperationAccess /ou ppp.retrieveOperationAccessAsync no React.