Form Entry Object Page

Une form entry object page convient lorsque toute la tâche consiste à saisir les données d'un nouvel objet et que les utilisateurs n'ont rien à rechercher au préalable : un formulaire de demande, une inscription, une demande d'achat simple lancée depuis une tile.

Critères de décision :

• Aucune liste nécessaire et aucun contexte à examiner avant la saisie : une form entry object page.
• L'objet doit garder visibles un statut, des informations clés ou des éléments liés : une object page standard.
• Les utilisateurs recherchent, puis créent ou modifient un objet parmi beaucoup d'autres : un list report avec une object page.
• Seulement deux ou trois champs : la création via une boîte de dialogue depuis un list report est plus légère.

Exemple : un employé d'Alder Manufacturing ouvre une tile « Create Purchase Requisition », arrive directement dans un formulaire vide, saisit douze chaises de bureau de Cedar Office Supply et choisit Create. Une form entry object page est le bon choix lorsque l'application est le formulaire.

Une form entry object page comporte trois zones :

1. Titre de la page : identifie ce qui est créé, par exemple une nouvelle demande d'achat.
2. Sections de formulaire : les sections et groupes de champs définis dans UI.Facets, empilés sur une seule page.
3. Barre de pied de page : les actions qui sauvegardent ou rejettent le nouvel objet, ainsi que l'accès aux messages de validation.

Ce qui manque est délibéré : pas de header facets avec des informations clés, pas d'image, pas de barre d'ancres ni de barre d'onglets entre les sections. Comme la page affiche le même contenu qu'une object page standard, une section qui fonctionne sur l'une fonctionne aussi sur l'autre. Une form entry object page est une object page réduite au formulaire et à la décision de le sauvegarder.

Dans SAP Fiori elements pour OData V4, trois paramètres transforment une object page en page de saisie de formulaire :

1. Paramètres de la cible dans manifest.json : la cible utilise le modèle object page, avec content.header.visible et content.header.anchorBarVisible définis à false et le contenu de l'en-tête non modifiable.
2. Mode création au démarrage : le composant de l'application renvoie un mode préféré de création à partir de ses paramètres de démarrage, si bien que l'application ouvre un objet vide au lieu d'attendre une sélection.
3. Un seul draft à la fois (optionnel) : le paramètre de niveau application singleDraftForCreate fait rouvrir à l'application le draft non sauvegardé de l'utilisateur au lieu d'en créer un autre.

Les annotations ne changent pas : UI.Facets, UI.FieldGroup et UI.Identification définissent le formulaire exactement comme pour une object page standard. SAP ne documente ce modèle que pour SAP Fiori elements pour OData V4. Il s'agit d'une propriété de l'application, et non du système : il fonctionne donc de la même façon dans SAP S/4HANA et sur SAP BTP, partout où s'exécute une release SAPUI5 qui prend en charge ces paramètres ; vérifiez le SDK SAPUI5 pour votre version. Configurer une form entry object page relève donc d'un choix de paramétrage de page, et non d'une tâche de modélisation.

1. Oublier le mode de démarrage. Sans la préférence de création, l'application ne s'ouvre pas en mode création, et les utilisateurs n'ont aucun moyen évident de commencer.
2. Accumuler les drafts. Chaque démarrage abandonné peut laisser un draft ; singleDraftForCreate rouvre plutôt le draft existant.
3. Formulaires longs sans navigation. Avec la barre d'ancres masquée, un formulaire de dix sections devient un long défilement ; scindez l'objet ou utilisez une object page standard avec des onglets.
4. Modifier des objets existants dans une form entry page. Sans en-tête, les utilisateurs perdent le statut et les informations clés dont ils ont besoin pour modifier les données.

Lorsque l'application s'ouvre en mode affichage, ou vide, au lieu du mode création, vérifiez les paramètres de démarrage dans Component.js, puis que la première cible utilise le modèle object page, puis les paramètres de draft du service. La plupart des problèmes de form entry object page sont des problèmes de configuration du démarrage, et non des problèmes d'annotation.