Seguimiento del progreso (con temas)
El widget de seguimiento del progreso permite dividir diseños complejos en múltiples vistas. El widget se puede utilizar para simplificar un proceso complejo dividiendo el flujo de trabajo en pasos lineales. Cada paso del seguimiento de progreso puede mostrar un mashup contenido que muestre widgets independientes. El widget de mashup contenido se puede utilizar para mostrar un mashup específico para el número de paso actual. El paso actual se realza y los usuarios pueden navegar entre los pasos, lo que facilita la comprensión del progreso de un formulario o un proceso.
Formato de los datos
Se debe crear una infotable con definiciones de campo que representen la estructura de los datos de los pasos. En la infotable se debe incluir una definición de campo para el número de paso, el rótulo y el mashup asociado. En la siguiente tabla se muestra el formato de los datos de la infotable:
|
Número de paso
|
Rótulo de paso
|
Nombre del mashup de paso
|
Interactivo en pasos
|
Estado de paso
|
|
|---|---|---|---|---|---|
|
Definición de campo
|
StepNumber: {name: 'StepNumber', baseType: 'NUMBER'}
|
StepLabel: {name: 'StepLabel', baseType: 'STRING'}
|
StepMashupName: {name: 'StepMashupName', baseType: MASHUPNAME'}
|
StepInteracive: {name: 'StepInteracive', baseType: 'BOOLEAN'}
|
StepState: {name: 'StepState', baseType: 'STRING'}
|
|
Uso
|
Permite definir el número del paso.
|
Permite definir el rótulo del paso.
|
Permite definir el nombre del mashup asociado al paso.
|
Permite definir el estado de interacción para el paso.
|
Permite definir el estado del paso. Opciones: Complete, Inactive, Current, Error
|
|
Tipo base
|
NUMBER
|
STRING
|
NUMBER
|
BOOLEAN
|
STRING
|
|
Ejemplo de fila
|
StepNumber: 1
|
StepLabel: 'Step 1'
|
StepMashupName: 'Mashup1'
|
StepInteractive: true
|
StepLabel: 'current'
|
En la siguiente imagen se muestra un ejemplo de los datos devueltos de una infotable con cuatro definiciones de campo para el eje Y:
Adición de un widget de seguimiento del progreso a un mashup
1. Añada el Seguimiento del progreso a un contenedor vacío en el esquema.
2. Añada el mashup contenido a un segundo contenedor.
3. En el panel Datos, enlace la propiedad All Data de la infotable devuelta a la propiedad Data del widget.
4. En el panel Propiedades, configure las siguientes propiedades:
◦ StepNumberField: permite seleccionar la columna de infotable para el número de paso.
◦ StepLabelField: permite seleccionar la columna de infotable para el rótulo del paso.
◦ StepMashupNameField: permite seleccionar la columna de infotable para el nombre del mashup. Asegúrese de que los nombres de mashup existan.
◦ StepInteractiveField: permite seleccionar la columna de infotable que se utiliza para especificar si un paso es interactivo.
◦ StepStateField: permite seleccionar la columna de infotable que se utiliza para especificar el paso actual.
5. Opcionalmente, defina la propiedad de widget IsInteractive en True para permitir que los usuarios naveguen por los pasos pulsando en un rótulo de paso.
6. Enlace la propiedad de widget CurrentStepMashup a la propiedad Name del widget de mashup contenido.
7. Pulse en Guardar y, a continuación, en Ver mashup.
En tiempo de ejecución, se muestra el mashup asociado al paso actual.
Activación de los pasos interactivos
Por defecto, el soporte para la interacción del usuario con los pasos está desactivado en tiempo de ejecución. Para añadir soporte para navegar entre pasos, se deben utilizar eventos de widgets o servicios en el mashup. Por ejemplo, se pueden añadir botones que permitan a los usuarios desplazarse al paso siguiente o anterior.
La propiedad IsInteractive se puede activar para permitir que los usuarios naveguen entre los pasos en tiempo de ejecución pulsando en un rótulo de paso. Esto también permite a los usuarios navegar entre los pasos en orden aleatorio. En la siguiente imagen se muestra un seguimiento de progreso interactivo.
Propiedades de los widgets
Nombre de la propiedad | Descripción | Tipo base | Valor por defecto | Enlace | Localización |
|---|---|---|---|---|---|
CurrentStepMashup | Se recupera el nombre del mashup para el paso actual. | STRING | N/D | S | N |
CurrentStepNumber | Permite definir o recuperar el número del paso actual en tiempo de ejecución. | NUMBER | N/D | S | N |
Data | El origen de datos de la infotable que se utiliza para definir los pasos que se deben mostrar en el widget. | INFOTABLE | S | N | |
DisableAutoStepCompletion | Permite desactivar la finalización automática de los pasos al navegar entre los pasos del rastreador de progreso. Cuando se activa, el estado del paso siempre se define mediante datos de infotable que se especifican mediante la propiedad StepStateField. | BOOLEAN | Falso | N | N |
ErrorStateIcon | Permite especificar el icono que se mostrará cuando no se puedan cargar los datos del seguimiento de progreso. | MEDIALINK | error | S | N |
ErrorStateText | Permite especificar el texto que se mostrará cuando no se pueden cargar los datos del seguimiento de progreso. | STRING | [[ProgressTracker.unableToLoadData]] | S | S |
IsInteractive | Permite especificar si los pasos pueden ser interactivos. | BOOLEAN | Falso | S | N |
MinStepSpacing | Permite definir la longitud mínima de la línea horizontal que separa los pasos en el seguimiento de progreso. | NUMBER | 90 | N | N |
NoBindingIcon | Permite especificar el icono que se mostrará cuando el seguimiento de progreso no esté enlazado a ningún origen de datos. | MEDIALINK | bind | N | N |
NoBindingText | Permite especificar el texto que se mostrará cuando el seguimiento de progreso no esté enlazado a ningún origen de datos. | STRING | [[ProgressTracker.noDataToDisplay]] | N | S |
NoDataIcon | Permite especificar el icono que se mostrará cuando los datos del seguimiento de progreso no contengan ningún paso. | MEDIALINK | not visible | S | N |
NoDataText | Permite especificar el texto que se debe mostrar cuando los datos del seguimiento del progreso no contienen ningún paso. | STRING | [[ProgressTracker.noStepData]] | S | S |
SelectedData | Una infotable que representa los datos del paso seleccionado. | INFOTABLE | S | N | |
StepClicked | Un evento enlazable que se activa cuando se pulsa en un paso. | Evento | S | N | |
StepInteractiveField | Permite especificar el campo de infotable que define si un paso es interactivo. | Campo de infotable | N | N | |
StepLabelField | Permite especificar el campo de infotable que contiene los rótulos de los pasos. | Campo de infotable | N | N | |
StepMashupNameField | Permite especificar el campo de infotable que define el mashup que se debe mostrar para cada paso. | Campo de infotable | N | N | |
StepNumberField | Permite especificar el campo de infotable que contiene los números de paso. | Campo de infotable | N | N | |
StepSize | Permite definir el tamaño de los iconos de los pasos. Opciones: Pequeño, Medio, Grande | STRING | Medio | S | N |
StepStateField | Permite especificar el campo infotable que define el estado del paso. | Campo de infotable | N | N | |
TabSequence | Permite definir la secuencia en la que se realza un widget cuando el usuario pulsa el tabulador. | NUMBER | 0 | No | N |
Height | Permite definir la altura del widget cuando se añade a un contenedor con un tamaño fijo. | NUMBER | 90 | N | N |
Width | Permite definir el ancho del widget cuando se añade a un contenedor con un tamaño fijo. | NUMBER | 600 | N | N |