Compartilhar 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 ocorrerá se um usuário selecionar células diferentes na mesma linha ou selecionar várias linhas.

Exemplo: substituir o comportamento aberto padrão em grades controladas por modelos

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

O exemplo a seguir garante que o registro seja aberto usando o formulário especificado pelo valor usando o pageInputformId 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 Web JavaScript (JS) que contém 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);

Mais informações: Criar ou editar recursos web de aplicativo baseados em 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 um subgrid de formulário controlado 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 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 ser adicionada e o nome Example.OnSelectda função. Esse é o nome da função JavaScript criada no recurso da Web. Verifique o contexto de execução de passagem da opção como primeiro parâmetro.

Mais informações: Controle de grade do Power Apps

Eventos (referência à API do cliente)
Eventos em formulários e grades em aplicativos baseados em modelos