Objetos y métodos de cuadrícula editables (referencia del lado del cliente)
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Puede configurar los controladores de eventos para suscribirse a eventos desencadenados por cuadrículas editables cuando se seleccionan, cambian o guardan datos en una cuadrícula editable. Las cuadrículas editables admiten la mayoría de los métodos del lado del cliente compatibles con cuadrículas no editables. Más información: Use cuadrículas editables en Dynamics 365
Nota
La cuadrícula editable se introdujo en Actualización de diciembre de 2016 para Dynamics 365 (online y local).
En este tema
Eventos de cuadrícula editables
Métodos de cuadrícula editable
Eventos de cuadrícula editables
La cuadrícula editable admite los siguientes eventos que puede usar para registrar y ejecutar los scripts del lado del cliente. Puede registrarse para estos eventos con la pestaña Eventos de la página Microsoft Dynamics 365 que se usa para habilitar cuadrículas editable para una entidad o una cuadrícula de solo lectura:
OnRecordSelect
OnChange
OnSave
Importante
Use el método getFormContext del contexto de ejecución para crear controladores de eventos comunes que pueden trabajar en una cuadrícula editable GridCell o campo de formulario en función de dónde ejecuta el controlador de eventos.Más información:getFormContext
OnRecordSelect
El evento OnRecordSelect se produce cuando una sola fila (registro) se selecciona en la cuadrícula editable. Este evento no se producirá si un usuario selecciona celdas diferentes en la misma fila o seleccione varias filas.
OnChange
El evento OnChange se produce cuando un valor se modifica en una celda en la cuadrícula editable y la celda pierde el enfoque. Este evento también puede producirse cuando un valor de atributo se actualiza mediante el método setValue.
OnSave
El evento OnSave aparece antes de enviar la información actualizada al servidor, y cuando se produce algo de lo siguiente:
Hay un cambio en la selección de registro.
El usuario explícitamente desencadena una operación de guardar con el botón de guardar de la cuadrícula editable.
El usuario aplica una operación de ordenación, filtro, grupo, paginación, o navegación desde la cuadrícula editable mientras hay cambios pendientes.
Algunos puntos importantes a tener en cuenta para el evento OnSave:
Si un usuario edita varias columnas del mismo registro en secuencia, el evento OnSave se desencadenará solo una vez para garantizar rendimiento óptimo y compatibilidad de comportamiento de formularios.
La cuadrícula editable y el formulario primario tienen botones Guardar independientes. Al hacer clic en el botón Guardar en uno no guardará cambios en el otro.
La cuadrícula editables no guarda cambios pendientes cuando las operaciones de navegación se realizan fuera de su contexto. Si el control tiene datos sin guardar, pueden perderse. Por lo tanto, el evento OnSave puede no desencadenarse. Por ejemplo, esto podría ocurrir al navegar a otro registro utilizando un campo de búsqueda de formulario o a través de la cinta de opciones.
Si presiona el botón Actualizar en la cuadrícula editable se descartará cualquier cambio pendiente, y el evento OnSave no se desencadenará.
El control de cuadrícula editable no implementa un temporizador de autoguardado.
La cuadrícula editable suprime reglas de detección de duplicados.
Métodos de cuadrícula editable
La cuadrícula editable admite algunos métodos nuevos y la mayoría de los existentes compatibles con las cuadrículas de solo lectura:
GridControl
Cuadrícula
GridRow
GridRowData
GridEntity
GridAttribute
GridCell
GridControl
Si conoce el nombre del control de cuadrícula editable, puede tener acceso a él mediante el siguiente código. Por ejemplo, para tener acceso a la subcuadrícula CONTACTOS en el formulario de cuenta predeterminado:
var contactsGrid = Xrm.Page.getControl("Contacts");
Sugerencia
Para identificar los nombres de los controles de cuadrícula en el formulario sin abrir el editor de formularios, consulte la información de Uso de herramientas del desarrollador del explorador.
La cuadrícula editable admite los métodos de control de solo lectura de cuadrícula siguientes: getEntityName y getGrid.
Cuadrícula
La cuadrícula editable admite los siguientes métodos para la Grid devuelta por el método GridControl.getGrid: getRows, getSelectedRows y getTotalRecordCount.
GridRow
La cuadrícula editable admite el método getData para la GridRow devuelta por los métodos Grid.getRows y Grid.getSelectedRows.
GridRow también admite la colección data que proporciona formas de trabajar con una fila de cuadrícula editable. Vea Colecciones (referencia del lado del cliente) para obtener información sobre los métodos disponibles para obtener acceso a los datos de una colección.
GridRowData
La cuadrícula editable admite el método getEntity para los GridRowData devueltos por el método GridRow.getData.
GridRowData también proporciona métodos para recuperar información específica de un registro que se muestra en una fila de cuadrícula editable, incluida una colección de todos los atributos incluidos en la fila. Los datos del atributo se limitan a las columnas presentadas por la cuadrícula editable. Vea Colecciones (referencia del lado del cliente) para obtener información sobre los métodos disponibles para obtener acceso a los datos de una colección.
GridEntity
La cuadrícula editable admite los siguientes métodos para la GridEntity devuelta por el método GridRowData..getEntity:
Aparte de usar el método GridRowData.getEntity, puede recuperar GridEntity accediendo directamente al objeto GridRowData.entity.
GridEntity también admite la colección attributes que proporciona métodos para trabajar con una colección de atributos de una entidad en la cuadrícula editable. Cada atributo (GridAttribute) representa los datos en la celda de una cuadrícula editable, y contiene una referencia a todas las celdas asociadas al atributo. Vea Colecciones (referencia del lado del cliente) para obtener información sobre los métodos disponibles para obtener acceso a los datos de una colección.
GridAttribute
El GridAttribute admite los siguientes métodos para los atributos de una fila de cuadrícula seleccionada: getName, getRequiredLevel, setRequiredLevel, getValue, y setValue.
Use el método Grid.getSelectedRows para recuperar la fila seleccionado en una cuadrícula editable.
GridAttribute también admite la colección controls para atributos de una fila de cuadrícula seleccionada, que proporciona métodos para trabajar con una colección de celdas asociadas al atributo. Cada celda (GridCell) de una fila de cuadrícula seleccionada es análoga a un control en un formulario que está ligado a un atributo en una cuadrícula editable. Vea Colecciones (referencia del lado del cliente) para obtener información sobre los métodos disponibles para obtener acceso a los datos de una colección.
Sugerencia
Por motivos de rendimiento, una fila (registro) en una cuadrícula editable no es editable hasta que se seleccione el registro. Los usuarios deben seleccionar un solo registro en una cuadrícula para editarla. Una vez que un registro se selecciona en una cuadrícula editable, Dynamics 365 evalúa internamente un grupo de elementos incluidos el acceso del usuario al registro, si el registro está activo, y las validaciones de campo para asegurarse de que la seguridad y la validez de datos se mantienen cuando se editan los datos. Considere usar el evento OnRecordSelect con el método del getFormContext para obtener acceso a los registros de la cuadrícula que se encuentren en estado editable.
GridCell
Además de setNotification y clearNotification, la GridCell admite los siguientes métodos para los controles:
Nota
Las cuadrículas editables no pueden mostrar más de una notificación a la vez.
getDisabled
Devuelve si la celda está deshabilitada (solo lectura).
gridCellObj.getDisabled()
- Valor de retorno
Tipo: Booleano. True si la celda está deshabilitada; False de lo contrario.
setDisabled
Establece si la celda está deshabilitada.
gridCellObj.setDisabled(bool)
Argumentos
Tipo: Booleano. True si la celda debe deshabilitarse; False de lo contrario.Comentarios
Habilitar a una celda de sólo lectura para editar puede producir un error cuando se guarda el registro. Si el campo es considerado de sólo lectura por el servidor, un error puede producirse si se modifica el valor. Eso puede ocurrir en los escenarios donde el usuario no tiene privilegios de escritura en el registro, el registro está deshabilitado, o el usuario no tiene los privilegios de seguridad de nivel de campo necesarios.
getLabel
Devuelve la etiqueta de la columna que contiene la celda.
gridCellObj.getLabel()
- Valor de retorno
Tipo: Cadena. La etiqueta de la columna.
Ver también
Objetos y métodos de cuadrícula (solo lectura) (referencia del lado del cliente)
Use cuadrículas editables en Dynamics 365
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright