Partilhar via


Evento Grid OnRecordSelect (referência da API do cliente)

O OnRecordSelect evento ocorre quando uma única linha (registro) é selecionada em uma grade editável. Esse evento não ocorre se um usuário selecionar células diferentes na mesma linha ou selecionar várias linhas.

Exemplo: substituir o comportamento de abertura padrão em grades controladas por modelo

Quando quiser personalizar a maneira como um registro de tabela é aberto a partir do controle de grade do Power Apps, você pode controlar como isso é aberto com uma função JavaScript associada ao evento grid OnRecordSelect .

O exemplo a seguir garante que o registro seja aberto usando o formulário especificado pelo pageInputformId valor usando o método Xrm.Navigation.navigateTo . Neste exemplo, o formulário e a grade devem pertencer à mesma entidade.

Etapa 1: Criar um recurso da Web

Crie, salve e publique um recurso da Web JavaScript (JS) que contenha o seguinte código:

var Example = window.Example || {};
(function () {
this.OnSelect = function (executionContext) {
   var pageInput = {
      pageType: "entityrecord",
      entityName: executionContext.getEventSource().getEntityName(),
      entityId: executionContext.getEventSource().getId(),
      formId: "420786E3-D342-4A9A-914B-AA331FF2D25E"    
   };
   Xrm.Navigation.navigateTo(pageInput);
}
}).call(Example);

Para obter mais informações: Criar ou editar recursos da Web de aplicativos controlados por modelo

Etapa 2: Habilitar o controle de grade do Power Apps

Siga estas etapas para habilitar o controle de grade do Power Apps como a grade principal (exibição de tabela) ou dentro de uma subgrade de formulário orientada por modelo:

Etapa 3: Registrar o comportamento personalizado no evento OnRecordSelect

Quando você habilita o controle de grade do Power Apps, uma guia Eventos é exibida. Selecione a guia Eventos :

  1. Na seção Bibliotecas de formulários , adicione a Biblioteca de formulários a partir do recurso da Web criado.
  2. Na seção Manipuladores de Eventos , selecione o evento OnRecordSelect e selecione Adicionar e um pop-up será exibido.
  3. No pop-up, selecione a biblioteca de formulários que acabou de adicionar e o nome Example.OnSelectda função . Este é o nome da função JavaScript criada no recurso da Web. Certifique-se de marcar a opção Passar contexto de execução como primeiro parâmetro.

Mais informações: Controlo Grelha do Power Apps

Eventos (referência da API do cliente)
Eventos em formulários e grelhas em aplicações condicionadas por modelo