SAP Fiori Elements et floorplans

Worklist

La worklist est un floorplan SAP Fiori elements qui permet de traiter une collection connue d'éléments de travail dans un tableau sans barre de filtres complète, souvent répartis en onglets de statut avec le nombre d'éléments. La worklist vise à terminer ou à déléguer des éléments ; dans SAP Fiori elements for OData V4, c'est un list report configuré sans barre de filtres.

L'essentiel

Type
Floorplan SAP Fiori elements (modèle de page)
Couche
Applications d'interface
Techniquement
List report simplifié ; template propre en OData V2, paramètre hideFilterBar en OData V4
Piloté par
UI.LineItem, UI.SelectionVariant ou UI.SelectionPresentationVariant pour les onglets
Association type
Object page pour le détail de chaque élément
Qui l'utilise
Développeurs SAP Fiori, designers UX, gestionnaires et acheteurs qui traitent des files de travail
S'applique à
SAP S/4HANA (toutes les options de déploiement), SAP BTP
Couche : Applications d'interfaceOù se situe-t-il ? ▾
Où se situe-t-il ?: L3 · Applications d'interfaceCouche : Applications d'interface.L1L2L3L4L5L6BTP

Couche : Applications d'interface

Ouvrir la carte d'architecture →
Worklist layoutTitre de l'en-tête · Onglets par statut avec compteurs · Champ de recherche · TableauHeader titlePending (4)In process (1)Approved (4)Rejected (1)Search…
Mise en page Worklist: Titre de l'en-tête · Onglets par statut avec compteurs · Champ de recherche · Tableau

Quand utiliser une worklist ?

La worklist convient lorsque l'ensemble des éléments est déjà défini par la tâche et que le rôle de l'utilisateur consiste à le traiter : demandes d'achat en attente d'un acheteur, documents auxquels il manque un champ, livraisons à confirmer. Le traitement consiste généralement à ouvrir un élément, à l'examiner, puis à le terminer ou à le transmettre.

Le critère de décision est l'endroit où se situe l'effort de sélection :

  • Si les utilisateurs doivent combiner plusieurs critères avant que la liste ait du sens, utilisez un list report.
  • Si la liste est prédéfinie et que les utilisateurs agissent surtout sur elle, utilisez une worklist.
  • Si les éléments sont des tâches de workflow acheminées vers l'utilisateur par un moteur de workflow, My Inbox fournit déjà la boîte de réception, avec les décisions, le transfert et la suppléance.

Exemple : l'équipe achats d'Alder Manufacturing ouvre une worklist de demandes d'achat, triées en onglets par statut, et traite une à une les demandes ouvertes de Cedar Office Supply et de Bright Freight. La worklist est le bon choix lorsque le traitement, et non la recherche, constitue la première étape de la tâche.

Quels sont les éléments d'une worklist ?

Une page worklist comporte quatre zones, de haut en bas :

  1. Titre de l'en-tête : le nom de la file de travail, sans l'en-tête chargé de variantes d'un list report.
  2. Onglets par statut : des vues facultatives, définies par les développeurs, qui répartissent les éléments en groupes tels que ouverts, en cours et terminés. Chaque onglet peut afficher le nombre d'éléments qu'il contient.
  3. Champ de recherche : une recherche en texte libre dans la barre d'outils du tableau, qui remplace la barre de filtres.
  4. Tableau : les éléments eux-mêmes, avec des actions dans la barre d'outils ou sur chaque ligne et une navigation vers une object page pour le détail.

Dans SAP Fiori elements for OData V2, la worklist utilise par défaut un responsive table, affiche le nombre de lignes dans le titre du tableau et masque la gestion des variantes, sauf si le développeur l'active. La worklist V2 ne propose pas non plus d'export vers un tableur. La worklist renonce à la barre de filtres au profit d'une page plus épurée qui met en avant les éléments et leurs actions.

Comment configurer une worklist en OData V2 et V4 ?

La configuration diffère entre les deux variantes de SAP Fiori elements :

AspectOData V2OData V4
TemplateWorklist Page, choisi dans le SAP Fiori application generatorTemplate list report avec le paramètre de manifest hideFilterBar
RechercheChamp de recherche dans la barre d'outils du tableauChamp de recherche dans la barre d'outils du tableau
Chargement initialNon documenté séparément ; les options du list report s'appliquentLe contenu se charge toujours, quelle que soit la valeur d'initialLoad
Gestion des variantesMasquée par défaut ; variantManagementHidden et smartVariantManagement l'activentNon documentée séparément ; vérifiez les paramètres de variantes du list report

Les onglets de statut sont des vues multiples. Les développeurs les définissent avec des annotations UI.SelectionVariant ou UI.SelectionPresentationVariant et les déclarent dans manifest.json. En V4, le multiple table mode affiche une icon tab bar, et l'option showCounts, désactivée par défaut, ajoute le nombre d'éléments à chaque onglet. Les colonnes du tableau proviennent d'UI.LineItem, et chaque onglet peut pointer vers son propre line item via une presentation variant. Configurer une worklist revient donc pour l'essentiel à configurer un list report sans barre de filtres.

Peut-on étendre une worklist ?

Oui. SAP documente la worklist comme un list report simplifié ; les options du list report s'appliquent donc :

  • Votre propre application : les points d'extension ajoutent des colonnes, des actions et des vues personnalisées ; en OData V4, les building blocks et les custom pages du flexible programming model couvrent les besoins plus importants. Des vues personnalisées peuvent aussi être ajoutées comme onglets supplémentaires au moyen d'une controller extension.
  • Une application livrée par SAP : les adaptation projects créés avec SAP Fiori tools, ou l'adaptation key user, modifient l'application sans modifier le code de SAP.

Dans SAP S/4HANA Cloud Public Edition, vérifiez lesquelles de ces voies SAP prend en charge pour l'application concernée.

Une limite pratique : dès que les utilisateurs demandent plusieurs champs de filtre, le besoin est devenu un list report, et réactiver la barre de filtres est plus honnête que de construire des filtres personnalisés autour d'une worklist. Étendre une worklist fonctionne bien pour les actions et les colonnes, moins bien pour la recherche.

Quelles sont les erreurs de conception courantes sur une worklist ?

  1. Utiliser une worklist pour une recherche ouverte. Sans barre de filtres, les utilisateurs font défiler et recherchent au lieu de sélectionner ; un list report convient mieux.
  2. La faire pointer vers un entity set volumineux. Une barre de filtres masquée signifie que le contenu se charge au démarrage ; les variantes de sélection des onglets doivent donc déjà restreindre les données.
  3. Des onglets qui se chevauchent. Si un élément peut apparaître dans deux onglets de statut, les compteurs ne s'additionnent plus et les utilisateurs perdent confiance dans la file.
  4. Attendre des compteurs en temps réel. En OData V4, l'actualisation du compteur d'un onglet via un side effect global ne fonctionne que pour une vue que l'utilisateur a déjà ouverte ; prévoyez donc comment les compteurs se mettent à jour après les actions.
  5. Reconstruire My Inbox. Modéliser des approbations de workflow sous forme de worklist spécifique duplique le transfert, la suppléance et la gestion des tâches que My Inbox fournit déjà.

Lorsque les compteurs semblent faux, vérifiez dans l'ordre : la variante de sélection derrière chaque onglet, les chevauchements entre onglets, et si l'onglet a été actualisé après la dernière action. La plupart des problèmes de worklist sont des problèmes de conception de la sélection, pas des défauts du framework.

Worklist, list report ou My Inbox : quelle différence ?

WorklistList reportMy Inbox
DéfinitionFloorplan SAP Fiori elementsFloorplan SAP Fiori elementsApplication SAP Fiori (F0862) pour les tâches de workflow
Tâche principaleTraiter un ensemble connu d'élémentsTrouver des objets dans un grand ensemble et agir dessusDécider sur des tâches acheminées par un workflow
Origine des élémentsUn entity set OData, restreint par des ongletsUn entity set OData, restreint par la barre de filtresMoteurs de workflow, via le service Task Gateway
FiltrageChamp de recherche et onglets de statutBarre de filtres complète avec variantesFiltres de tâches, tri et regroupement
Dans SAP Fiori elements for OData V4List report sans barre de filtresFloorplan à part entièrePas un floorplan SAP Fiori elements

La worklist et le list report sont deux configurations de la même technologie, tandis que My Inbox est une application dédiée aux tâches de workflow.

Questions fréquentes

La worklist est-elle toujours disponible dans SAP Fiori elements for OData V4 ?

Oui. Dans SAP Fiori elements for OData V4, la worklist est une configuration spécialisée du list report plutôt qu'un template distinct. Les développeurs définissent hideFilterBar dans manifest.json, et la page affiche alors un champ de recherche dans la barre d'outils du tableau et charge toujours son contenu.

Quelle est la différence entre une worklist et My Inbox ?

La worklist est un floorplan que toute application peut utiliser pour lister des business objects à traiter, comme des demandes d'achat. My Inbox est une application SAP Fiori précise qui affiche les tâches de workflow de SAP Business Workflow et d'autres fournisseurs de tâches, avec options de décision, transfert et suppléance.

Une worklist peut-elle afficher le nombre d'éléments sur ses onglets ?

Oui. Les onglets de statut d'une worklist sont des vues multiples définies avec des variantes de sélection. Dans SAP Fiori elements for OData V4, l'option showCounts du multiple table mode affiche le nombre d'éléments sur chaque onglet ; elle est désactivée par défaut.

Les utilisateurs peuvent-ils filtrer une worklist ?

De façon limitée seulement. La worklist propose un champ de recherche, le tri et des onglets définis par les développeurs, mais pas de barre de filtres. Lorsque les utilisateurs ont régulièrement besoin de plusieurs critères de filtre pour trouver leurs éléments, le list report est le floorplan SAP Fiori elements le plus adapté.

Une worklist ouvre-t-elle une object page ?

Généralement, oui. Le choix d'une ligne dans une worklist mène à l'object page de l'élément, où l'utilisateur examine le détail et termine le travail. Des actions simples peuvent aussi s'exécuter directement depuis le tableau de la worklist sans ouvrir l'élément.

Sources

S'applique à
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP S/4HANA Cloud Public Edition · SAP BTP
Dernière relecture

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP et les autres produits et services SAP mentionnés sont des marques commerciales ou des marques déposées de SAP SE (ou d'une société affiliée à SAP) en Allemagne et dans d'autres pays. Ce guide est indépendant ; il n'est ni affilié à SAP SE, ni sponsorisé, ni approuvé par SAP SE.