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 de 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

• 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.

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

  Nota:

  El selector de fecha en Editar cuadrícula no admite la edición de tipos de columna que contienen valores de tiempo. Configura la columna en tu entidad de Data Service utilizando la opción Excluir tiempo para evitar errores en tus datos.

  Si necesitas incluir una columna de tiempo, establece la opción de vista Modo de edición de la columna en el tipo Cuadro de texto .

Events

• Fila seleccionada : configura lo que sucede cuando se selecciona una fila.
• Fila añadida : configura lo que sucede 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.

Estilo

• Alineación de control : de forma predeterminada, 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 u Horizontal).

• Color de fondo : el color de fondo para el encabezado y el cuerpo de la cuadrícula.
• Borde : el borde del control. Se puede configurar el grosor del borde, el color y el radio .
• Fuente : los atributos de fuente tanto para el encabezado de la columna como para el texto del cuerpo de la columna , como la familia de fuentes, el tamaño, el color o el estilo (negrita, cursiva y subrayado). De forma predeterminada, 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 superior/inferior e izquierdo/derecho . Estas propiedades pueden separarse utilizando el botón Enlace situado a la derecha de la sección Margen .
• Tamaño : la anchura y la altura del control. De forma predeterminada, el tamaño está establecido en auto. 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úrese 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 de nombre : MainPage.EditGrid.NewItem.Name
      • Propiedad Fecha de unión : MainPage.EditGrid.NewItem.Dateofjoining
      • Propiedad de edad : MainPage.EditGrid.NewItem.Age
      • Propiedad de género : MainPage.EditGrid.NewItem.Gender
      • Propiedad del equipo : MainPage.EditGrid.NewItem.Team
      • Propiedad IsFullTime : MainPage.EditGrid.NewItem.Isfulltime
      • Propiedad de habilidades : 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 de nombre : MainPage.EditGrid.SelectedItem.Name
      • Propiedad Fecha de unión : MainPage.EditGrid.SelectedItem.Dateofjoining
      • Propiedad de edad : MainPage.EditGrid.SelectedItem.Age
      • Propiedad de género : MainPage.EditGrid.SelectedItem.Gender
      • Propiedad del equipo : MainPage.EditGrid.SelectedItem.Team
      • Propiedad IsFullTime : MainPage.EditGrid.SelectedItem.Isfulltime
      • Propiedad de habilidades : 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 propiedad Columna posterior, 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