Form Views

You can configure form views. In this configuration, the fields are displayed in a grid. You can change the position of fields, and add or remove fields. In the list of available fields, you can add all fields under a node.

Features

You can choose between the following configurations:

Two panels with 8 columns each, 16 in total
One panel with 16 columns
One panel with 8 columns

Activities

Start the UI Configuration Tool in the BSP Component Workbench. Choose a form view for the following activities and click the Configuration tab. Choose an existing configuration and click Display <-> Change.

You see all the fields that are displayed in the view. Required entry fields have a red asterisk at the end. If the view consists of two panels, they are separated in the middle by a red vertical line.

Save your entries after you have made all your changes.

Adding Fields

Click Show Available Fields to show the field selection with all available fields. In the field selection, click the selector box in front of the field that you want to add to the view. In the left or the right panel, click the row under which you want to add the new field. Above the corresponding panel, click the Add Field icon.

The field is inserted in a new row underneath the row you chose. If you do not choose a row, the field is inserted as the last row in the panel. You can move it to the required row from there.

Note Note

You can also choose nodes with multiple fields in the field selection, even from different pages, and add all the chosen fields at once.

End of the note.

Removing Fields

Select a field or fields, and click Remove Field above the appropriate panel. To select multiple fields, hold down CTRL and click the field. The field or fields are inserted in the list of available fields under the corresponding nodes. The row that the field occupied is not deleted.

Changing the Position of Fields

Use the Up and Down arrow keys above the panel to move selected rows in the column up or down by one row.

Use the Left and Right arrow keys to move selected fields between the left and right panels. If you clicked a row beforehand in the other panel, the field is inserted in the row underneath it. If you did not previously click a row, the field is inserted as the last row in the panel. You can move it to the required row from there.

Adding Blank Rows

In the left or the right panel, click the row under which you want to insert a blank row. Click the icon Insert Row above the panel. The blank row is inserted below the row you clicked. If you did not choose a row, the blank row is inserted as the first row in the panel.

Note Note

You cannot delete empty rows from a panel. You can only move fields to the new rows.

End of the note.

Adding Captions

Captions are text-only fields that serve as headings for groups of fields. Choose whether you want to insert the heading in the left or right panel. Enter the text for the heading in the field underneath. Click Apply. The caption appears in a new row at the very top of the panel. Use the Up and Down arrow keys to move the caption to the required row.

Maintaining Field Properties

Hold down ALT and click a field in a panel. You then see the column with the field properties on the right-hand side. Click Show Technical Details at the top of the page so that the field properties are enhanced with technical information. You have the following options:

Activity	Procedure
View technical field information	Check the information in the fields Technical Field Name, Original Label, Field Type, Length, Type. You cannot change any of these fields. Technical field names are not normally visible to users; they only see the field labels. You can display the technical names if you require support from your hosting provider, or if the support team needs specific field information.
Change the field label	Overwrite the text in the field.
Show or hide the field label	Select or deselect Show Label.
Specify if users can, must, or must not enter data in the field	Select Display Only if the information in a field is only meant to be viewed. Select Mandatory if the user must enter data. Deselect both options if the user may enter data but does not have to. A field cannot be Mandatory and Display Only at the same time.
Position the field label and the corresponding data area in the panel	Change the entries in the row and column fields as required. Example Input field with label Account: Row From: 3 Label Col. From: A Label Col. To: C Field Col. From: D Field Col. To:F The input field and the field label are now in row 3, with the Account label occupying columns A through C, and the data area columns D through F. End of the example. Note You cannot change the size of input fields. End of the note.

To update the column with the changed data, click Apply. Then save your entries.

Changing Grid Types

You can change the configuration of the grid, to flexibly move fields between the columns. You can choose between various grid configurations. You can, as described in the table, move field labels and the associated data areas between the columns.

Note Note

The columns in which you position a field label and its data area cannot be occupied by another field label. Before you move a field label, you must ensure that the columns into which you want to move it are empty.

End of the note.

Creating Separate Configurations

Views on editable overview pages can be used in display and edit mode. In general, both modes have a unique configuration, which means they have the same fields, labels, captions, and so on.

Some views support the creation of separate configurations with different fields, labels, and captions in the display view and edit view of the editable overview page.

If you want to create separate configurations for display mode and edit mode, proceed as follows:

Select the required application component and the required view.
You can use the standard configuration, which is the unique configuration, or copy the default configuration to your role configuration key.
Select Create Separate Config. in the toolbar.
You can now see Display Mode Configuration and Edit Mode Configuration directly below the toolbar.
Select Display Mode Configuration and create a configuration for this mode.
Select Edit Mode Configuration and create a configuration for this mode.
Save your configurations.

Note Note

If a field label is renamed in one of these configurations, this renaming is automatically copied to the other configuration.

End of the note.

Switching Back to Unique Configuration

If you want to return to an editable overview page that looks the same in display mode and edit mode, you can switch back to a unique configuration. In this case, the edit mode is the leading mode, which determines the new unique configuration.

Select the configuration with your role configuration key.
Select Switch to Unique Config. in the toolbar.
Save the new unique configuration.