Editar cuadrícula

El control Editar cuadrícula te permite enumerar, editar, paginar o buscar registros tabulares.

Demos

Editar cuadrícula: trabajar con entidades

Introducción

Esta aplicación muestra cómo trabajar con entidades utilizando el control Editar cuadrícula .

Aplicación de demostración: pruébela usted mismo

Descargar la aplicación de demostración de GitHub

Vista previa de la aplicación de demostración en la nube

Aplicación de demostración: instrucciones de uso

1. Descarga el archivo zip con la aplicación de demostración. Contiene:

   • Schema.json: el esquema para las entidades que utiliza la aplicación

   • EditGridEntity_DemoApp.uiapp: el archivo UiPath^® Apps

2. En UiPath^® Data Service, importa el archivo Schema.json. Asegúrate de importar tanto las entidades (país y empleados) como los conjuntos de opciones (género y habilidades).
3. Rellene sus entidades y conjuntos de opciones con datos.
4. En UiPath^® Apps, crea una nueva aplicación e importa la aplicación descargada.
5. Es posible que observe algunos errores. Para solucionarlos, sustituye la entidad Empleados a la que se hace referencia por la que has importado recientemente en el paso 2.
6. Previsualiza la aplicación e interactúa con los datos en Editar cuadrícula.

General

• Fuente de datos: la fuente de los datos que deseas editar dentro de la cuadrícula. Debes hacer referencia a un objeto de tipo AppsDataSource, como una entidad de Data Service o un proceso de Orchestrator.

  Una vez que obtienes la fuente de datos, la cuadrícula detecta automáticamente las columnas de datos. Al hacer clic en el icono Más de cada columna se accede a las siguientes propiedades:

  • Nombre: el nombre para mostrar del encabezado de la columna.

  • Fuente: el campo de la entidad a la que se hace referencia.

  • Vista modo de edición: determina cómo interactuar con la columna:

    Opción de vista del modo de edición	Descripción
    Cuadro de texto	Las celdas de la columna se comportan como un control de cuadro de texto.
    Selector de fechas	Las celdas de la columna se comportan como un control Datepicker.
    Casilla de verificación	Las celdas de la columna se comportan como un control Checkbox.
    Lista desplegable	Las celdas de la columna se comportan como un control desplegable.
    Selección múltiple	Las celdas de la columna se comportan como un control de selección múltiple.

  • Oculto: si es verdadero, oculta la columna en tiempo de ejecución.

  • Editable: si es falso, marca el contenido de la columna como de solo lectura.

• Añadir nueva columna: añade nuevas columnas a tus datos haciendo clic en el icono más "+".

• Oculto: si es verdadero, oculta el control en tiempo de ejecución.

• Editable: si es falso, marca el control como de solo lectura.

• Añadir filas: si es verdadero, permite a los usuarios de la aplicación añadir nuevas filas en tiempo de ejecución. Si es falso, los usuarios no pueden añadir nuevas filas.

• Eliminar filas: si es verdadero, permite a los usuarios de la aplicación eliminar filas. Si es falso, los usuarios no pueden eliminar filas.

• Búsqueda: si es verdadero, expone una capacidad de búsqueda integrada.

Nota:

The Date Picker in the Edit Grid does not support editing column types which contain time values. Configure the column in your Data Service entity using the Exclude time option to avoid errors in your data.

If you need to include a column corresponding specifically to time, set the Edit mode view option of the column to the Textbox type.

Events

• Fila seleccionada: configura lo que sucede cuando se selecciona una fila.

• Fila añadida: configura lo que ocurre cuando se añade una fila.

• Fila modificada: configura lo que sucede cuando se modifica una fila.

• Fila eliminada: configura lo que sucede cuando se elimina una fila.

Nota:

Para acceder a los errores de actualización, adición o edición de operaciones, utiliza la siguiente sintaxis:

<PageName>.<ControlName>.<RuleName>.Error.Message

Por ejemplo, MainPage.EmployeeDetailsGrid.UpdateEntityRecord.Error.Message.

Nota:

Para utilizar un argumento de entrada/salida para manipular Editar cuadrícula, utiliza la siguiente sintaxis:

Processes.ALLDATATYPES.out_datatable

Por ejemplo:

• Para añadir una fila, utiliza Processes.ALLDATATYPES.out_datatable.AddRow(MainPage.EditGrid.NewItem).
• Para eliminar una fila, utiliza Processes.ALLDATATYPES.out_datatable.DeleteRowAt(MainPage.EditGrid.RowIndex).
• Para actualizar una fila, utiliza Processes.ALLDATATYPES.out_datatable.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem).

Estilo

• Alineación de control: por defecto, hereda la alineación principal. Se puede establecer una alineación diferente a la principal. Para volver a la alineación principal, anula la selección de las opciones anuladas.

  Nota: la alineación depende del diseño seleccionado para el elemento principal (Vertical vs Horizontal).

• Color de fondo: el color de fondo del encabezado la cuadrícula y el cuerpo de la cuadrícula.

• Borde: establece el borde del control. Se pueden configurar el grosor, el color y el radio del borde.

• Fuente: los atributos de la fuente tanto para el encabezado de la columna como para el texto del cuerpo de la columna, como la familia de la fuente, el tamaño, el color o el estilo (negrita, cursiva y subrayado). Por defecto, el control hereda la familia de fuentes del contenedor principal inmediato, que se indica con la palabra clave "heredada".

• Margen: el margen del control. De forma predeterminada, se establece un margen de 4px. Se combinan las propiedades de los márgenes superiores/inferiores e izquierdos/derechos. Estas propiedades se pueden separar utilizando el botón Enlace situado a la derecha de la sección Margen.

• Tamaño: el ancho y la altura del control. El tamaño está establecido como auto de forma predeterminada. Para establecer valores mínimos o máximos, haz clic en el icono de tres puntos (...). Si el tamaño del control es menor que las opciones, se muestra una barra de desplazamiento.

Propiedades VB

Propiedad VB	Tipo de datos	Descripción
SelectedItem	Apps.Controls.TabularInitClass	Hace referencia al elemento actualmente seleccionado en el control.
DataSource	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	Hace referencia al origen de datos para los valores dentro del control Tabla.
NewItem	Apps.Controls.TabularInitClass	Hace referencia al elemento creado por la opción Añadir fila . El evento Fila añadida hace referencia a esta propiedad.
Editable	Booleano	Determina si Editar cuadrícula es editable.
AddRows	Booleano	Determina si se pueden añadir filas a Editar cuadrícula.
DeleteRows	Booleano	Determina si las filas se pueden eliminar de Editar cuadrícula.
RowIndex	Entero	Hace referencia al índice de la fila para las operaciones de actualización y eliminación. Debe utilizarse para la integración de procesos en los que todo el conjunto de datos está en memoria.
Search	Booleano	Habilita o deshabilita la función de búsqueda. Si es verdadero, la búsqueda está habilitada.
Value	Apps.Controls.TabularInitClass	El valor actualmente seleccionado del control.
Hidden	Booleano	Si es verdadero, oculta el control en tiempo de ejecución.
Disabled	Booleano	Si es verdadero, deshabilita el control en tiempo de ejecución.

Cómo convertir datos complejos a AppsDataSource

Para convertir una tabla de datos o un tipo de datos complejo a un AppsDataSource: guarda la tabla de datos en una variable y utiliza el método .ToListSource que convierte los datos de la tabla de datos en AppsDataSource.

1. Guarda los datos en una variable de tipo DataTable. Por ejemplo, nombra la variable "dt".
2. En el campo Fuente de datos de los controles de la tabla, utiliza la siguiente expresión:

   dt.ToListSource()

Generalmente, los objetos complejos se pueden convertir a AppsDataSource utilizando la sintaxis:

Processes.ALLDATATYPES.out_datatable.ToListSource()

Uso de TablaDeDatos en los controles Editar cuadrícula

Asegúrate de tener un objeto TablaDeDatos en tu aplicación.

Los objetos TablaDeDatos pueden definirse como argumentos de entrada, salida o entrada/salida de un proceso. Para utilizar estos objetos TablaDeDatos, debes hacer referencia al proceso en el que se utilizan como argumentos.

Nota:

TablaDeDatos solo admite primitivas en una columna. Los argumentos de tipo complejo en una columna no funcionan en TablaDeDatos.

Digamos que tienes un proceso llamado "Proceso_A", que tiene los objetos TablaDeDatos como argumentos:

Argumentos de entrada	in_dt1
Argumentos de salida	out_dt1
Argumentos de entrada/salida	inout_dt

Editar cuadrícula

1. Ve a la pestaña General de tu control Editar cuadrícula .

2. En el campo Origen de datos del control, abre el editor de expresiones y escribe la siguiente expresión:

   Processes.<process_name>.<datatable_output_argument>.ToListSource

   Por ejemplo:

   Processes.Process_A.out_dt1.ToListSource

3. Para realizar operaciones en las filas de la TablaDeDatos, como añadir, editar o eliminar:

   1. Asegúrate de que las propiedades Editable, Añadir filas y Eliminar filas están establecidas en verdadero.

      

   2. Cambia a la pestaña Eventos del control Editar cuadrícula y configura las reglas correspondientes:

      1. Para añadir filas, haz clic en Crear regla para Fila añadida y, a continuación, utiliza la regla Establecer valor :

         Elementos para configurar	Processes.<process_name>.<datatable_output_parameter> Por ejemplo: Processes.Process_A.out_dt1
         Valor	Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem) Por ejemplo: Processes.Process_A.out_dt1.AddRow(MainPage.EditGrid.NewItem)

      2. Para eliminar filas, haz clic en Crear regla para Fila eliminada y, a continuación, utiliza la regla Establecer valor :

         Elementos para configurar	Processes.<process_name>.<datatable_output_parameter> Por ejemplo: Processes.Process_A.out_dt1
         Valor	Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex) Por ejemplo: Processes.Process_A.out_dt1.DeleteRowAt(MainPage.EditGrid.RowIndex)

      3. Para modificar filas, haz clic en Crear regla para Fila modificada y, a continuación, utiliza la regla Establecer valor :

         Elementos para configurar	Processes.<process_name>.<datatable_output_parameter> Por ejemplo: Processes.Process_A.out_dt1
         Valor	Processes.<process_name>.<datatable_output_parameter>.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem) Por ejemplo: Processes.Process_A.out_dt1.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem)

Cómo utilizar entidades con controles de Editar cuadrícula

El siguiente ejemplo muestra cómo vincular una entidad a un control Editar cuadrícula y realizar las operaciones CRUD utilizando las reglas específicas del control y de la entidad.

La entidad utilizada se llama "Empleado'' y tiene los siguientes campos:

• Nombre

• Edad

• Fecha de nacimiento

• Género

• Equipo

• Fecha de incorporación

• IsFullTime

• Aptitudes

Mostrar registros de entidades

1. Crea una nueva aplicación VB y añade la entidad Empleado a la aplicación.
2. Añade el control Editar cuadrícula a la aplicación.
3. En el campo Fuente de datos del control Editar cuadrícula, utiliza el Creador de consultas y selecciona la entidad Empleado. Las columnas del control se rellenan automáticamente con los campos de la entidad.
4. Para cada columna, asegúrate de que el menú desplegable de la vista Modo de edición está establecido en el tipo de datos correcto, como se indica a continuación:

   Opción	Descripción
   Fecha de nacimiento	Selector de fechas
   Edad	Cuadro de texto
   Nombre	Cuadro de texto
   Género	Lista desplegable
   Equipo	Lista desplegable
   Fecha de incorporación	Selector de fechas
   IsFullTime	Casilla de verificación
   Aptitudes	Selección múltiple

   Género y Equipo son conjuntos de opciones de entidad. Al seleccionar el menú desplegable en la vista Modo de edición para estas columnas, se muestran dos nuevas propiedades: Fuente de la lista y Columna.
5. Para obtener las opciones de un conjunto de opciones:
   1. En el campo Fuente de la lista, utiliza la siguiente sintaxis

      GetChoiceSet("Choiceset Name")

      Por ejemplo, para las columnas Género y Equipo, el campo Fuente de la lista debe tener:

      • Género: GetChoiceSet("Gender")
      • Equipo: GetChoiceSet("Team")
   2. En el campo Columna, escribe "Name".
      

   Aptitudes es un conjunto de opciones de entidad que permite una selección múltiple. Al seleccionar Elección múltiple en la vista Modo de edición para estas columnas, se muestran dos nuevas propiedades: Fuente de la lista y Columna.

6. Configura la columna Aptitudes como lo hiciste para Género y Equipo.
7. Ve a la pestaña Evento del control Editar cuadrícula.
8. Para el evento Fila añadida, crea la siguiente regla:
   1. Añade la regla Crear registro de entidad.
   2. En la sección ¿En qué entidad se debe crear el registro?, selecciona la entidad Empleado.
   3. En el campo Valores a establecer, actualiza lo siguiente:
      • Propiedad nombre: MainPage.EditGrid.NewItem.Name
      • Propiedad fecha de incorporación: MainPage.EditGrid.NewItem.Dateofjoining
      • Propiedad edad: MainPage.EditGrid.NewItem.Age
      • Propiedad género: MainPage.EditGrid.NewItem.Gender
      • Propiedad equipo: MainPage.EditGrid.NewItem.Team
      • Propiedad IsFullTime: MainPage.EditGrid.NewItem.Isfulltime
      • Propiedad aptitudes: MainPage.EditGrid.NewItem.Skills
9. Para el evento Fila modificada, crea la siguiente regla:
   1. Añade la regla Actualizar registro de entidad.
   2. En la sección ¿Qué registro de la entidad debe actualizarse?, selecciona la entidad Empleado.
   3. En el ID de registro de Entidad, escribe la siguiente expresión:

      MainPage.EditGrid.SelectedItem.Id

   4. En el campo Valores a establecer, actualiza lo siguiente:
      • Propiedad nombre: MainPage.EditGrid.SelectedItem.Name
      • Propiedad fecha de incorporación: MainPage.EditGrid.SelectedItem.Dateofjoining
      • Propiedad edad: MainPage.EditGrid.SelectedItem.Age
      • Propiedad género: MainPage.EditGrid.SelectedItem.Gender
      • Propiedad equipo: MainPage.EditGrid.SelectedItem.Team
      • Propiedad IsFullTime: MainPage.EditGrid.SelectedItem.Isfulltime
      • Propiedad aptitudes: MainPage.EditGrid.SelectedItem.Skills
10. Para el evento Fila eliminada, crea la siguiente regla:
    1. Añade la regla Eliminar registro de entidad.
    2. En la sección ¿Qué registro se debe eliminar?, selecciona la entidad Empleado.
    3. En el ID de registro de Entidad, escribe la siguiente expresión:

       MainPage.EditGrid.SelectedItem.Id

11. Previsualiza tu aplicación e interactúa con las distintas funciones Editar cuadrícula, como la paginación, la búsqueda, la adición de nuevas filas, la actualización de las filas o la eliminación de estas.

Cómo utilizar relaciones en los controles de Editar cuadrícula

Para utilizar campos de entidad de tipo Relación en un control de Editar cuadrícula:

1. En el campo de vista Modo de edición, establece los campos de relación como un menú desplegable.
2. En la siguiente propiedad Fuente de la lista, utiliza la siguiente expresión:

   Fetch(of <entity_name>)(Nothing, Nothing, Nothing, Nothing, New ExpansionFieldOption(){addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

3. En la siguiente propiedad Columna, escribe "Name".
4. En las reglas relacionadas con la entidad, como Crear, Actualizar o Eliminar registros de entidad, pasa el ID del campo de relación de la siguiente manera:

   MainPage.EditGrid.SelectedItem.<entity_name>.Id