Worklist
Una worklist es un floorplan de SAP Fiori elements para procesar una colección conocida de elementos de trabajo en una tabla sin una barra de filtros completa, a menudo dividida en pestañas de estado con recuentos de elementos. Una worklist se centra en completar o delegar elementos, y en SAP Fiori elements para OData V4 es un list report configurado sin barra de filtros.
Datos clave
- Tipo
- Floorplan de SAP Fiori elements (plantilla de página)
- Capa
- Aplicaciones de UI
- Técnicamente
- List report simplificado; plantilla propia en OData V2, ajuste hideFilterBar en OData V4
- Basada en
- UI.LineItem, UI.SelectionVariant o UI.SelectionPresentationVariant para las pestañas
- Combinación típica
- Object page para los detalles de cada elemento
- Quién trabaja con ello
- Desarrolladores SAP Fiori, diseñadores UX, administrativos y compradores que procesan colas de trabajo
- Se aplica a
- SAP S/4HANA (todas las opciones de implementación), SAP BTP
Capa: Aplicaciones de UIDónde se ubica ▾
Capa: Aplicaciones de UI
Abrir el mapa de arquitectura →¿Cuándo conviene usar una worklist?
Una worklist encaja cuando el conjunto de elementos ya está definido por la tarea y el trabajo del usuario consiste en recorrerlo: solicitudes de pedido que esperan a un comprador, documentos a los que les falta un campo, entregas pendientes de confirmar. Procesar suele significar abrir un elemento, revisarlo y, después, completarlo o pasarlo a otra persona.
El criterio de decisión es dónde recae el esfuerzo de selección:
- Si los usuarios deben combinar varios criterios antes de que la lista tenga sentido, use un list report.
- Si la lista está predefinida y los usuarios actúan principalmente sobre ella, use una worklist.
- Si los elementos son tareas de workflow que un motor de workflow asigna al usuario, My Inbox ya proporciona la bandeja de entrada, con decisiones, reenvío y sustitución.
Ejemplo: el equipo de compras de Alder Manufacturing abre una worklist de solicitudes de pedido, ordenadas en pestañas por estado, y procesa una a una las solicitudes abiertas de Cedar Office Supply y Bright Freight. Una worklist es la opción adecuada cuando el primer paso de la tarea es procesar, no buscar.
¿Qué partes tiene una worklist?
Una página worklist tiene cuatro regiones, de arriba abajo:
- Título de cabecera: el nombre de la cola de trabajo, sin la cabecera cargada de variantes de un list report.
- Pestañas por estado: vistas opcionales, definidas por los desarrolladores, que dividen los elementos en grupos como abiertos, en proceso y completados. Cada pestaña puede mostrar el número de elementos que contiene.
- Campo de búsqueda: una búsqueda de texto libre en la barra de herramientas de la tabla, que sustituye a la barra de filtros.
- Tabla: los propios elementos, con acciones en la barra de herramientas o en cada fila y navegación a una object page para ver los detalles.
En SAP Fiori elements para OData V2, la worklist usa por defecto una responsive table, muestra el número de filas en el título de la tabla y oculta la gestión de variantes salvo que el desarrollador la habilite. La worklist de V2 tampoco ofrece exportación a hoja de cálculo. Una worklist renuncia a la barra de filtros a cambio de una página más plana que da prioridad a los elementos y sus acciones.
¿Cómo se configura una worklist en OData V2 y V4?
La configuración difiere entre las dos variantes de SAP Fiori elements:
| Aspecto | OData V2 | OData V4 |
|---|---|---|
| Plantilla | Worklist Page, elegida en el SAP Fiori application generator | Plantilla de list report con el ajuste de manifest hideFilterBar |
| Búsqueda | Campo de búsqueda en la barra de herramientas de la tabla | Campo de búsqueda en la barra de herramientas de la tabla |
| Carga inicial | No se documenta por separado; se aplican las opciones del list report | El contenido siempre se carga, indique lo que indique initialLoad |
| Gestión de variantes | Oculta por defecto; variantManagementHidden y smartVariantManagement la habilitan | No se documenta por separado; consulte los ajustes de variantes del list report |
Las pestañas de estado son vistas múltiples. Los desarrolladores las definen con anotaciones UI.SelectionVariant o UI.SelectionPresentationVariant y las enumeran en manifest.json. En V4, el modo de tablas múltiples representa una icon tab bar, y la opción showCounts, desactivada por defecto, añade el número de elementos a cada pestaña. Las columnas de la tabla proceden de UI.LineItem, y cada pestaña puede apuntar a su propio line item mediante una presentation variant. Por tanto, configurar una worklist es sobre todo configurar un list report sin la barra de filtros.
¿Se puede extender una worklist?
Sí. SAP documenta la worklist como un list report simplificado, por lo que se aplican las opciones del list report:
- Su propia aplicación: los puntos de extensión añaden columnas, acciones y vistas personalizadas; en OData V4, los building blocks y las custom pages del flexible programming model cubren carencias mayores. También se pueden añadir vistas personalizadas como pestañas adicionales mediante una controller extension.
- Una aplicación entregada por SAP: los adaptation projects creados con SAP Fiori tools, o la adaptación key user, modifican la aplicación sin modificar el código de SAP.
En SAP S/4HANA Cloud Public Edition, compruebe cuáles de estas vías admite SAP para la aplicación en cuestión.
Un límite práctico: cuando los usuarios piden varios campos de filtro, el requisito se ha convertido en un list report, y volver a habilitar la barra de filtros es más honesto que construir filtros personalizados alrededor de una worklist. Extender una worklist funciona bien para acciones y columnas, y peor para la búsqueda.
¿Cuáles son los errores de diseño más comunes en una worklist?
- Usar una worklist para búsquedas abiertas. Sin barra de filtros, los usuarios se desplazan y buscan en lugar de seleccionar; un list report encaja mejor.
- Apuntarla a un entity set enorme. Una barra de filtros oculta implica que el contenido se carga al inicio, por lo que las selection variants de las pestañas ya deben acotar los datos.
- Pestañas que se solapan. Si un elemento puede aparecer en dos pestañas de estado, los recuentos dejan de cuadrar y los usuarios desconfían de la cola.
- Esperar recuentos en tiempo real. En OData V4, actualizar el recuento de una pestaña mediante un side effect global solo funciona para una vista que el usuario ya ha abierto, así que planifique cómo se actualizan los recuentos después de las acciones.
- Reconstruir My Inbox. Modelar las aprobaciones de workflow como una worklist personalizada duplica el reenvío, la sustitución y la gestión de tareas que My Inbox ya proporciona.
Cuando los recuentos parezcan incorrectos, compruebe en este orden: la selection variant de cada pestaña, los solapamientos entre pestañas y si la pestaña se actualizó después de la última acción. La mayoría de los problemas de una worklist son problemas de diseño de la selección, no defectos del framework.
¿En qué se diferencian una worklist, un list report y My Inbox?
| Worklist | List report | My Inbox | |
|---|---|---|---|
| Qué es | Floorplan de SAP Fiori elements | Floorplan de SAP Fiori elements | Aplicación SAP Fiori (F0862) para tareas de workflow |
| Tarea principal | Procesar un conjunto conocido de elementos | Encontrar objetos en un conjunto grande y actuar sobre ellos | Decidir sobre tareas asignadas por un workflow |
| De dónde proceden los elementos | Un entity set OData, acotado por pestañas | Un entity set OData, acotado por la barra de filtros | Motores de workflow, a través del servicio Task Gateway |
| Filtrado | Campo de búsqueda y pestañas de estado | Barra de filtros completa con variantes | Filtros de tareas, ordenación y agrupación |
| En SAP Fiori elements para OData V4 | List report sin barra de filtros | Floorplan propio | No es un floorplan de SAP Fiori elements |
Una worklist y un list report son dos configuraciones de la misma tecnología, mientras que My Inbox es una aplicación dedicada a las tareas de workflow.
Preguntas frecuentes
¿Sigue disponible la worklist en SAP Fiori elements para OData V4?
Sí. En SAP Fiori elements para OData V4, la worklist es una configuración especializada del list report y no una plantilla independiente. Los desarrolladores definen hideFilterBar en manifest.json y la página muestra entonces un campo de búsqueda en la barra de herramientas de la tabla y siempre carga su contenido.
¿Qué diferencia hay entre una worklist y My Inbox?
Una worklist es un floorplan que cualquier aplicación puede usar para listar business objects que procesar, como solicitudes de pedido. My Inbox es una aplicación SAP Fiori concreta que muestra tareas de workflow de SAP Business Workflow y de otros proveedores de tareas, con opciones de decisión, reenvío y sustitución.
¿Puede una worklist mostrar recuentos de elementos en sus pestañas?
Sí. Las pestañas de estado de una worklist son vistas múltiples definidas con selection variants. En SAP Fiori elements para OData V4, la opción showCounts del modo de tablas múltiples muestra el número de elementos en cada pestaña; está desactivada por defecto.
¿Pueden los usuarios filtrar una worklist?
Solo de forma limitada. Una worklist ofrece un campo de búsqueda, ordenación y pestañas definidas por los desarrolladores, pero no una barra de filtros. Cuando los usuarios necesitan con regularidad varios criterios de filtro para encontrar sus elementos, un list report es el floorplan de SAP Fiori elements más adecuado.
¿Una worklist abre una object page?
Normalmente, sí. Al elegir una fila en una worklist se navega a la object page de ese elemento, donde el usuario revisa los detalles y completa el trabajo. Las acciones sencillas también pueden ejecutarse directamente desde la tabla de la worklist sin abrir el elemento.
Fuentes
- SAPUI5 SDK: Worklist Page (SAP Fiori elements for OData V4)
- SAPUI5 SDK: Worklist Page (SAP Fiori elements for OData V2)
- SAPUI5 SDK: Configuring Filter Bars, including hiding the filter bar (OData V4)
- SAPUI5 SDK: Defining Multiple Views in a List Report Page Table, Multiple Table Mode (OData V4)
- SAPUI5 SDK: Standard Floorplans (SAP Fiori elements for OData V4)
- Se aplica a
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP S/4HANA Cloud Public Edition · SAP BTP
- Última revisión