Skip to content

Latest commit

 

History

History
119 lines (60 loc) · 5.08 KB

form-section-4102b3d.md

File metadata and controls

119 lines (60 loc) · 5.08 KB

Form Section

Form sections are based on the annotation UI.FieldGroup and can be added, moved, changed, and deleted.

Adding Form Section

To add a Form section, perform the following steps:

  1. Click the Object/Form Entry Page to open the Page Editor.

  2. Navigate to the section node in the outline and click the ➕ (Add) icon.

    As a result, a dropdown menu displaying currently supported section types appears.

  3. Select Add Form Section from the dropdown list.

    A pop-up window Add Form Section appears with a field to provide a label for the section to be added.

  4. Enter a title to the Label field and click Add.

    Note:

    See Internationalization (i18n) for translation if there is none.

    A new section tab appears in the application preview of the form and Object Page. Now you can add fields to the newly created form section. For more information, see Adding Filter Fields.

In the annotation file, you can see the following changes applied:

  • A new UI.FieldGroup with the empty Data property is added.

  • A UI.ReferenceFacet record is added to the UI.Facet annotation with the following properties:

    • Target, as annotation path pointing to the created UI.FieldGroup.
    • Label, as a string value containing user-entered text.
    • ID, as a string value auto-generated based on the label.

  • If the UI.Facet annotation isn’t yet available, it’s applied to the entity associated with the Object Page.

  • If the UI.Facet annotation exists on the underlying layer, the annotation on this layer will be overridden in the local file.

  • In the case of CAP CDS, a using statement is added to the overridden file.

Moving Form Section

The user can change the order of the sections in the application header. By using the drag-and-drop functionality, drag the required section to a different position within the Header Sections node:

  • When dropped, the records in the UI.Facets collection are reordered.
  • When SAP Fiori application is rendered, sections are displayed based on the records sequence in the UI.HeaderFacets annotation.

Move multiple sections

To move the multiple sections to another position, perform the following steps:

  1. Use the [Ctrl] + [Click] combination to select more than one section.
  2. Drag the selected section to the desired position with your pointer.

Deleting Form Section

To delete the section in the application, perform the following steps:

  1. Navigate to the section node in the outline.
  2. Click the 🗑️ (Delete) icon to open the Delete Confirmation popup window.
  3. Click Delete to confirm the action.

Note:

This action deletes respective UI.ReferenceFacet record from UI.Facets.

Note:

To remove unreferenced UI.FieldGroup annotation, run the cleanup procedure that deletes the unreferenced annotation.

Maintaining Form Section Properties

Label

To change the section label, perform the following steps:

  1. Select the required section and navigate to the properties pane area.

  2. Enter a new name in the Label text box. This field defines the text to be displayed at a section label.

    As a result, the section is renamed both in the Page Editor and in the application preview.

See Label Maintenance for more information.

Note:

See Internationalization (i18n) for translation if not yet there.

Display on Demand

The Display On Demand switch is displayed in the Property Panel for the Form Section and Identification Section section if they are used as a sub section in a Group Section. Activate it to hide the Form Section or Identification Section under the Show More by default. Click Show More to make it visible. Deactive it to always display the section.

Note:

By default, this property is deactivated. Once the user activates it, an embedded annotation UI.PartOfPreview is added to the respective UI.ReferenceFacet record with boolean value false. The embedded annotation will be removed, if the property is switched off again. The embedded annotation is also removed, if the section is moved and not contained in a Group Section after the move.

Hidden

For more information, see Hidden.