Escribir scripts para subcuadrículas
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Puede establecer controladores de eventos para ejecutar los scripts cuando los datos se cargan en subcuadrículas. Esto proporciona métodos para cambiar la vista seleccionada y obtener referencias a los datos visualizados en la cuadrícula.
Importante
Esta característica se introdujo en la actualización 1 de CRM Online 2015 y CRM 2016 (local).
En este tema
Evento OnLoad de subcuadrícula
Modelo de objetos de subcuadrícula
Evento OnLoad de subcuadrícula
Las subcuadrículas se cargan asincrónicamente desde el formulario de modo que no pueda obtener acceso fiable a los datos en la subcuadrícula en el evento OnLoad del formulario. Pero puede establecer un controlador de eventos para el evento OnLoad de la subcuadrícula. Este evento se producirá cada vez que los datos de la cuadrícula se actualicen, incluido cuando los usuarios ordenan las columnas de la cuadrícula.
No hay interfaz de usuario para agregar nuevos controladores de eventos para este evento, por lo que si desea hacerlo, deberá usar código en otro evento, normalmente el evento OnLoad de formulario para usar el método GridControl. método deaddOnLoad. Para quitar controladores de evento para este evento, use el método GridControl. método deremoveOnLoad.
Modelo de objetos de subcuadrícula
El diagrama siguiente muestra los objetos a los que puede obtener acceso desde una subcuadrícula de un formulario.
.jpeg "Objetos de control de cuadrícula")
El control de subcuadrícula se conoce como GridControl en este contexto. Como control de Xrm.Page.ui, la subcuadrícula tiene todos los métodos disponibles para todos los controles además del método refresh.
El GridControl es el mismo objeto pasado a una barra de comandos o acciones de la cinta de opciones o reglas utilizando el <CrmParameter> (RibbonDiffXml) cuando está disponible cuando se selecciona el parámetro SelectedControl.
Cambiar vistas con el ViewSelector
Cuando una subcuadrícula se configura para mostrar un selector de vistas puede obtener o establecer la vista actual. Use el método GridControl.getViewSelector para acceder al seleccionador de vistas y luego los métodos ViewSelector.getCurrentViewgetCurrentView y ViewSelector.setCurrentView para obtener o para establecer la vista actual con un objeto de búsqueda.
Obtener datos de la cuadrícula
Use el método GridControl. métodogetGrid para obtener acceso a la cuadrícula. Use el método Grid.getRows o el método Grid.getSelectedRows para obtener una colección de objetos GridRow. A continuación puede acceder a una referencia a cada registro de la fila encadenando los métodos GridRow.getData, GridRowData.getEntity y GridEntity.getEntityReference methods.
Ver también
Objetos y métodos de cuadrícula (solo lectura) (referencia del lado del cliente)
Colecciones (referencia del lado del cliente)
Escriba código para formularios de Microsoft Dynamics 365
Amplíe Microsoft Dynamics 365 en el cliente
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright