Form Entry Object Page
A form entry object page is a variation of the SAP Fiori elements object page that hides the header and the navigation bar, leaving a form for entering one business object. A form entry object page uses the same annotations as a standard object page and can replace the list report as the starting page, often opening in create mode.
Quick facts
- Type
- Variation of the object page floorplan
- Layer
- UI applications
- Driven by
- Same annotations as the object page: UI.Facets, UI.FieldGroup
- Configured in
- Object page target settings in manifest.json; create mode in Component.js
- Documented for
- SAP Fiori elements for OData V4
- Applies to
- SAP S/4HANA (all deployment options), SAP BTP
Layer: UI applicationsWhere it sits ▾
Layer: UI applications
Open the architecture map →When should you use a form entry object page?
A form entry object page fits when the whole task is entering data for one new object and users have nothing to search for first: a request form, a registration, a simple purchase requisition raised from a tile.
Decision criteria:
- No list needed and no context to review before typing: a form entry object page.
- The object needs a status, key facts or related items in view: a standard object page.
- Users search, then create or edit one of many objects: a list report with an object page.
- Only two or three fields: dialog-based creation from a list report is lighter.
Example: an employee at Alder Manufacturing opens a "Create Purchase Requisition" tile, lands directly in an empty form, enters twelve office chairs from Cedar Office Supply and chooses Create. A form entry object page is the right choice when the app is the form.
What are the parts of a form entry object page?
A form entry object page has three regions:
- Page title: identifies what is being created, such as a new purchase requisition.
- Form sections: the sections and field groups defined in UI.Facets, stacked on one page.
- Footer bar: the actions that save or discard the new object, plus access to validation messages.
What is missing is deliberate: no header facets with key facts, no image, no anchor or tab bar between sections. Because the page shows the same content as a standard object page, a section that works on one also works on the other. A form entry object page is an object page reduced to the form and the decision to save it.
How do you configure a form entry object page?
In SAP Fiori elements for OData V4, three settings turn an object page into a form entry page:
- Target settings in manifest.json: the target uses the object page template, with
content.header.visibleandcontent.header.anchorBarVisibleset to false and the header content not editable. - Create mode at start: the app component returns a preferred mode of create from its startup parameters, so the app opens an empty object instead of waiting for a selection.
- One draft at a time (optional): the app-level setting
singleDraftForCreatemakes the app reopen the user's unsaved draft instead of creating another one.
The annotations do not change: UI.Facets, UI.FieldGroup and UI.Identification define the form exactly as for a standard object page. SAP documents the pattern for SAP Fiori elements for OData V4 only. It is a property of the app, not of the system, so it works the same in SAP S/4HANA and on SAP BTP wherever a SAPUI5 release that supports these settings runs; check the SAPUI5 SDK for your version. Configuring a form entry object page is therefore a page-setting decision, not a modeling task.
What are common form entry object page mistakes?
- Forgetting the start mode. Without the create preference, the app does not open in creation mode, and users have no obvious way to begin.
- Collecting drafts. Every abandoned start can leave a draft;
singleDraftForCreatereopens the existing draft instead. - Long forms without navigation. With the anchor bar hidden, a ten-section form becomes a long scroll; split the object or use a standard object page with tabs.
- Editing existing objects in a form entry page. Without a header, users lose the status and key facts they need when changing data.
When the app opens in display mode or empty instead of create mode, check the startup parameters in Component.js, then that the first target is the object page template, then the draft settings of the service. Most form entry object page problems are start-up configuration problems, not annotation problems.
Form entry object page vs. object page: what is the difference?
| Form entry object page | Object page | |
|---|---|---|
| Purpose | Enter one new object | Display, edit and create one object |
| Header | Hidden: no key facts, no header facets | Title, status and key facts |
| Navigation bar | Hidden | Anchors or tabs between sections |
| Typical entry | A tile that opens the app in create mode | A row in a list report or a link from another app |
Both share annotations and template; the form entry object page removes everything that is not needed to create the object.
FAQ
What is a form entry object page in SAP Fiori elements?
A form entry object page is an object page configured without header and navigation bar, so only the form sections and the footer actions remain. It is used when an app only needs to capture data for one new object, without a list report in front of it.
Can a form entry object page open directly in create mode?
Yes. In SAP Fiori elements for OData V4, the app component can return a preferred mode of create from its startup parameters. The form entry object page then opens with a new, empty object, ready for input, as soon as the user launches the app.
Does a form entry object page need special annotations?
No. A form entry object page supports the same content and reads the same annotations as a standard object page, such as UI.Facets and UI.FieldGroup. Only the page settings in manifest.json differ: header and navigation bar are switched off.
What happens to unsaved drafts in a form entry app?
With a draft-enabled service, each new entry starts as a draft. If the app-level setting singleDraftForCreate is on, the form entry object page checks for an unsaved new draft and reopens it in edit mode instead of creating another one.
Sources
- SAPUI5 SDK: Form Entry Object Page (SAP Fiori elements for OData V4)
- SAPUI5 SDK: Object Page (SAP Fiori elements for OData V4)
- SAPUI5 SDK: Draft Handling (OData V4)
- Applies to
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP S/4HANA Cloud Public Edition · SAP BTP
- Last reviewed