Compartir a través de

Evento OnRecordSelect de cuadrícula (referencia de la API de cliente)

  • Artículo

El evento OnRecordSelect se produce cuando una sola fila (registro) se selecciona en una cuadrícula editable. Este evento no se produce si un usuario selecciona celdas diferentes en la misma fila o seleccione varias filas.

Ejemplo: Anular el comportamiento predeterminado para abrir en cuadrículas controladas por modelos

Cuando desee personalizar la forma en que se abre un registro de tabla desde el control de red de Power Apps, puede controlar cómo se abre esto con una función de JavaScript asociada con el evento OnRecordSelect de la cuadrícula.

El siguiente ejemplo asegura que el registro se abre utilizando el formulario especificado por el valor pageInputformId usando el método Xrm.Navigation.navigateTo. En este ejemplo, el formulario y la cuadrícula deben pertenecer a la misma entidad.

Paso 1: Crear un recurso web

Cree, guarde y publique un recurso web de JavaScript (JS) que contenga el siguiente 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);

Más información: Crear o editar recursos web de aplicación basada en modelos

Paso 2: habilitar el control de cuadrícula de Power Apps

Siga estos pasos para habilitar el control de cuadrícula de Power Apps como la cuadrícula principal (vista de tabla) o dentro de una subcuadrícula de formulario basada en modelos:

Paso 3: registre el comportamiento personalizado en el evento OnRecordSelect

Cuando habilita el control de cuadrícula de Power Apps, aparece una pestaña Eventos. Seleccione la pestaña Eventos:

  1. Bajo la sección Bibliotecas de formularios, agregue la biblioteca de formularios del recurso web creado.
  2. Bajo la sección Controladores de eventos, seleccione el evento OnRecordSelect y seleccione Agregar, y aparece una ventana emergente.
  3. En la ventana emergente, seleccione la biblioteca de formularios que acaba de agregar y el nombre de la función Example.OnSelect. Este es el nombre de la función JavaScript creada en el recurso web. Asegúrese de activar la opción Pasar el contexto de ejecución como primer parámetro.

Más información: Control de cuadrícula de Power Apps

Eventos (referencia de la API de cliente)
Eventos en formularios y cuadrículas en aplicaciones basadas en modelos