SAP Fiori Elements & Floorplans

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 ▾
Where it sits: L3 · UI applicationsLayer: UI applications.L1L2L3L4L5L6BTP

Layer: UI applications

Open the architecture map →
Form Entry Object Page layoutPage title "New Purchase Requisition" · Form sections · Footer bar (Create / Cancel)New Purchase RequisitionBasic dataSupplier and amountJustificationCreateCancel
Form Entry Object Page layout: Page title "New Purchase Requisition" · Form sections · Footer bar (Create / Cancel)

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:

  1. Page title: identifies what is being created, such as a new purchase requisition.
  2. Form sections: the sections and field groups defined in UI.Facets, stacked on one page.
  3. 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:

  1. Target settings in manifest.json: the target uses the object page template, with content.header.visible and content.header.anchorBarVisible set to false and the header content not editable.
  2. 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.
  3. One draft at a time (optional): the app-level setting singleDraftForCreate makes 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?

  1. Forgetting the start mode. Without the create preference, the app does not open in creation mode, and users have no obvious way to begin.
  2. Collecting drafts. Every abandoned start can leave a draft; singleDraftForCreate reopens the existing draft instead.
  3. 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.
  4. 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 pageObject page
PurposeEnter one new objectDisplay, edit and create one object
HeaderHidden: no key facts, no header facetsTitle, status and key facts
Navigation barHiddenAnchors or tabs between sections
Typical entryA tile that opens the app in create modeA 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

Applies to
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP S/4HANA Cloud Public Edition · SAP BTP
Last reviewed

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP and other SAP products and services mentioned are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. This guide is independent and is not affiliated with, sponsored or endorsed by SAP SE.