Help Center > Foundation Help

Se aplica a:

  • Winshuttle Foundation

Tabla de repetición

Una tabla de repetición contiene otros controles en un formato de tabla. Los usuarios pueden insertar varias filas al rellenar el formulario.

Por ejemplo, si tiene un formulario de solicitud de compra, es posible que solo deba mostrar una única fila de la tabla (descripción del elemento, cantidad, precio, subtotal) en el formulario, pero, probablemente, deseará que sus usuarios puedan añadir filas adicionales al rellenar el formulario.

Nota: Puede «anidar» tablas de repetición arrastrando un elemento de tabla de repetición a una existente y especificando el número de columnas de la tabla anidada y el número de columnas de la tabla anidada que se extenderán (es decir, el tamaño o la anchura de la tabla anidada en la tabla principal).

Confirme lo siguiente al trabajar con grupos o tablas de repetición

Confirme lo siguiente al trabajar con elementos de repetición de cualquier tipo (es decir, Grupos de repetición y/o Tablas de repetición) en un servicio web (o cualquier otro sitio):

  • Un campo dentro de una carpeta de contenido de repetición en el árbol del formulario de datos también está dentro de un contenedor de repetición en el formulario.
  • Todos los campos de no repetición del árbol del formulario de datos son de no repetición en el formulario.

Si no se siguen las pautas anteriores, el resultado será un comportamiento no intencionado al trabajar con elementos de repetición al ejecutar un servicio web.

Añadir una tabla de repetición a un formulario

  1. En el lienzo, haga clic en el grupo al que desea añadir una tabla.
  2. En el panel Propiedades, haga clic en la pestaña Elementos.
  3. Haga clic en Elementos de contenedor.
  4. Haga clic en Tabla de repetición.
  5. En el cuadro de diálogo Nueva tabla de repetición, escriba el número de columnas que desee y haga clic en Aceptar.

Consejo para realizar una consulta a un origen de datos de SQL: hay que tener en cuenta las mayúsculas y las minúsculas.

Si realizar una consulta sobre un origen de datos SQL y, luego, desea introducir los resultados en una tabla seleccionable o de repetición, asegúrese de que el texto de su consulta coincide con las mayúsculas y minúsculas de las columnas SQL.

Por ejemplo, si una columna de la base de datos SQL se llama COLUMNA_1, la consulta no funcionará si se busca columna_1.

Propiedades del elemento de tabla de repetición de Composer

Nombre: Id. de la tabla en el formulario.

Solo lectura: Establece el grupo en solo lectura (true) o en no solo lectura (false).

Extensión de columna: Número de columnas que abarcará el grupo.

Mostrar encabezado: Se establece en true para mostrar el encabezado de la columna.

Nueva ubicación del elemento: Ubicación de «(+) Añadir nuevo elemento»

Habilitar búsqueda: Habilitar o deshabilitar una casilla de búsqueda para buscar o filtrar información de una tabla.

  • Verdadero: Habilita un cuadro de búsqueda para que el usuario del formulario introduzca criterios de búsqueda o de filtro.
  • Falso: Oculta el cuadro de búsqueda.

Habilitar ordenación

  • Verdadero: Muestra las flechas de ordenación de los campos de una tabla para permitir que los usuarios ordenen los datos rápidamente.
  • Falso: Oculta las flechas de ordenación.

Habilitar operaciones de Excel: Cuando se establece en True, muestra las operaciones de Excel disponibles para el usuario del formulario (Exportar y Cargar en Excel), de manera que los datos se puedan cargar en un archivo de Excel en el PC local del usuario del formulario.

  • Exportar envía el contenido de una tabla o un grupo de repetición a un archivo de Excel.
  • Cargar carga los datos en un archivo Excel.

Opciones de carga de Excel: Muestra las siguientes opciones de carga disponibles (como selectores de botones de radio) para el usuario del formulario en tiempo de ejecución:

  • Sustituir: Sustituirá el contenido de la tabla o el grupo.
  • Actualizar: Actualizará cada fila o campo al mismo tiempo que conservará las filas adicionales que ya estén en la tabla o en el grupo.
  • Anexar: Conservará todas las filas existentes y añadirá el nuevo contenido al final de la tabla o el grupo.

Aplicar el recuento de filas en la carga de Excel: (verdadero/falso): Si se establece en Verdadero, esta opción marca que el archivo actualizado contiene el mismo número de filas que la tabla de repetición. Si hay una incompatibilidad, se rechazará la carga de Excel. Se puede usar para restringir que se puedan añadir o eliminar nuevas filas de la tabla de repetición al cargarse en Excel.

Habilitar resultados de validación: Muestra el vínculo Validación al usuario. Si hace clic en Validación, se mostrará el número de errores de validación encontrados en el grupo o en la tabla de repetición. Normalmente se usa con la propiedad Paginar contenido (consulte más adelante) para buscar errores de validación en grandes tablas.

Recuento de filas predeterminado: Número de filas vacías creadas al cargar el formulario.

Recuento de filas: Permite especificar el número de filas antes de paginar el contenido.

Paginar contenido: Si se establece en Verdadero, el contenido de la tabla se mostrará en una única página. Si se establece en Falso, el contenido se paginará según la configuración Recuento de filas.

Campo Número de fila: Seleccione un campo que se usará como el número de fila de la tabla.

Icono Opciones de fila: (izquierda o derecha) Dónde se colocará el icono de Opciones de fila en una fila de una tabla seleccionable (consulte a continuación).

Estilos de grupo

  • Ancho del borde: Anchura en píxeles del borde que se muestra alrededor del grupo.
  • Estilo del borde: Discontinuo, punteado, sólido, etc.
  • Color del borde: Color del borde.
  • Anchura de la tabla: Anchura (en píxeles) de la tabla. El valor predeterminado (0) permite cambiar el tamaño de la tabla de forma dinámica con el explorador (diseño flexible).

Opciones avanzadas

Columna clave para combinar

Este desplegable contendrá una lista de todos los campos que figuran en la tabla de repetición o el grupo. Al configurar esta «clave», el formulario realizará una combinación cada vez que se actualicen los datos de la tabla, pero solo se actualizan los campos que el usuario realmente ha cambiado.

El valor de la clave debe ser el nombre de una de las columnas de la tabla. Cada fila debe tener un valor de clave único. El valor de la clave indica qué columna contiene la clave (por ejemplo, my:partnumber).

Tipo de almacén de payload

Esta propiedad almacena el contenido repetido fuera del XML del formulario. Si trabaja en un entorno en el que se ha configurado un almacén de datos externo para descargar parte de sus datos de formulario, los valores de este desplegable permiten especificar qué «almacén» se debe usar. (Debería configurarlo el administrador de Winshuttle Workflow).

Cuando el formulario se carga, el XML del formulario se rellenará con el contenido guardado para que, en el momento de la ejecución, sea idéntico. Al establecer esta propiedad como «predeterminada», permitirá que la propiedad de configuración global de Server «PayloadStoreType» indique qué almacén utilizar al guardar el contenido repetido.

Configuración de PayloadStoreType

1 Almacén de datos adjuntos

Es el almacén predeterminado si no se especifica PayloadStoreType. Las tablas externas se almacenan como adjuntos en el elemento de lista.

2 Almacén de archivos

Las tablas externas se almacenan en un sistema de archivos de red. Utilice el valor de la configuración global «FileSystemPayloadStoreFolder» para proporcionar una ruta UNC al sistema de archivos. También puede añadir _<ListName> para crear una configuración específica para listas (es decir, ‘FileSystemPayloadStoreFolder_MyTestForm’). La cuenta SVAdmin debe tener acceso de lectura/escritura a esta carpeta.

3 Almacén de blobs de base de datos

Las tablas externas son como blobs en una base de datos de SQL. Use el script siguiente para crear las tablas y los índices necesarios:

 SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO CREATE TABLE [dbo].[Payloads]( [PayLoadID] [uniqueidentifier] NOT NULL, [WebGuid] [uniqueidentifier] NOT NULL, [ListGuid] [uniqueidentifier] NOT NULL, [ItemID] [int] NOT NULL, [Binding] [nvarchar](50) NOT NULL, [Payload] [nvarchar](max) NOT NULL, [LastUpdate] [datetime] NOT NULL, CONSTRAINT [PK_Payloads] PRIMARY KEY CLUSTERED ( [PayLoadID] ASC )WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY] ) ON [PRIMARY] GO ALTER TABLE [dbo].[Payloads] ADD CONSTRAINT [DF_Payloads_PayLoadID] DEFAULT (newid()) FOR [PayLoadID] GO ALTER TABLE [dbo].[Payloads] ADD CONSTRAINT [DF_Payloads_LastUpdate] DEFAULT (getdate()) FOR [LastUpdate] GO CREATE NONCLUSTERED INDEX [IX_Payloads] ON [dbo].[Payloads] ( [WebGuid] ASC, [ListGuid] ASC, [ItemID] ASC )WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, SORT_IN_TEMPDB = OFF, IGNORE_DUP_KEY = OFF, DROP_EXISTING = OFF, ONLINE = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY] GO

La tabla se puede añadir a la base de datos de Workflow o a cualquier otra base de datos. En el último caso, puede especificar una cadena de conexión con el valor de la configuración global «SqlConnectionPayloadStore». También puede añadir _<ListName> para crear una configuración específica para listas.

4 Almacén de tablas de base de datos

Las tablas externas se desensamblan y almacenan como registros individuales en una base de datos de SQL. Use el script siguiente para crear las tablas y los índices necesarios:

 SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO CREATE TABLE [dbo].[PayloadTables]( [Id] [uniqueidentifier] NOT NULL, [ParentId] [uniqueidentifier] NOT NULL, [Ordinal] [int] NOT NULL, [Binding] [nvarchar](50) NULL,> [Value] [nvarchar](100) NULL, [PayloadLockID] [int] NULL, CONSTRAINT [PK_PayloadTables] PRIMARY KEY CLUSTERED ( [Id] ASC )WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY] ) ON [PRIMARY] GO CREATE NONCLUSTERED INDEX [IX_PayloadTables] ON [dbo].[PayloadTables] ( [ParentId] ASC, [Ordinal] ASC, [Binding] ASC )WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, SORT_IN_TEMPDB = OFF, IGNORE_DUP_KEY = OFF, DROP_EXISTING = OFF, ONLINE = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY] GO

La tabla se puede añadir a la base de datos de Workflow o a cualquier otra base de datos. En el último caso, puede especificar una cadena de conexión con el valor de la configuración global «SqlConnectionFormXmlDB». También puede añadir _<ListName> para crear una configuración específica para listas (es decir, ‘PayloadStoreType_MyTestForm’).