Forms, Sections and FieldGroups

If you’re not satisfied with the default PPP customizing and want to add or remove Forms, Sections and FieldGroups as well as their corresponding fields from the Basic Field Configuration, you can customize it using BRF+. For this, please follow these steps:

Step 1: Assigning Fields to a FieldGroup

Open your BRF+ Application and navigate to the expression table “Field Group Control” (Technical Name: FIELDGROUP_CONTROL).

  • Field Group ID: Enter any ID for your Field Group. This ID is later used to assign Field Groups to Sections.

  • Field ID: Enter the Field ID of the Field you want to have inside the Field Group. This Field ID has to exist in the “Basic Field Config” (Technical Name: BASIC_FIELDCONFIGURATION) expression table.

  • Field Label Text ID: Enter any Text ID (Used in “Translatable Texts”, Technical Name: TEXTS). The Text of the Text ID will be used as the Label for the Field Group.

  • Mandatory: Marks the field as mandatory. If set to true, validations are called, which check if the field is filled before saving in the PPP UI.

  • Read Only: Marks the field as read only. If set to true, the field can not be changed inside this FieldGroup.

An example of a “FieldGroup” customizing:

Step 2: Assigning FieldGroups to a Section

Open your BRF+ Application and navigate to the expression table “Section Control” (Technical Name: SECTION_CONTROL).

  • Section ID: Enter any ID for your Section. This ID is later used to assign Sections to Forms.

  • Field Group ID: Enter the FieldGroup ID of the FieldGroup you want to have inside the Field Group. This FieldGroup ID has to exist in the “Field Group Control” (Technical Name: FIELDGROUP_CONTROL) expression table.

  • Field Grp. Head. ID: Enter any Text ID (Used in “Translatable Texts”, Technical Name: TEXTS). The Text of the Text ID will be used as the Header of the Section.

An example of a “Section” customizing:

Step 3: Assigning Sections to a Form

Open your BRF+ application and navigate to one of the following expression tables, depending on which entity the form belongs to.

Entity TypeExpression TableTechnical Name
ItemForm Control ItemFORM_CONTROL_ITEM
Decision PointForm Control DPFORM_CONTROL_DECISION_POINT
ProjectForm Control ProjectFORM_CONTROL_PROJECT
PhaseForm Control PhaseFORM_CONTROL_PHASE
TaskForm Control TaskFORM_CONTROL_TASK
ChecklistForm Control ChecklistFORM_CONTROL_CHECKLIST
Checklist ItemForm Control Checklist ItemFORM_CONTROL_CHECKLIST_ITEM
RoleForm Control RoleFORM_CONTROL_ROLE

Each of these expression tables has its own unique input columns according to fields of that entity. The output remains the same for all of the FormControl Expression tables:

  • Section ID: Enter any ID for your Section. This Section ID has to exist in the “Section Control” (Technical Name: SECTION_CONTROL) expression table.

  • Section Headline Text ID: Enter any Text ID (Used in “Translatable Texts”, Technical Name: TEXTS). The Text of the Text ID will be used as the Header of the Form.

An example of a “Form Control Task” customizing:

Example: Adding New Elements

 
If you are creating a new Field, New Field Group, and New Section, you should add corresponding fields in all 5 tables:
 

Step 1: Basic Field Configuration

  • Creates a new Field (Basic Field Configuration).

    • Table: BASIC_FIELD_CONFIGURATION
    • Add a new entry for the field, including Field ID, Origin, Origin Fieldname, Display Type, and Field Text ID.

Step 2: Fieldgroup Control

  • Creates a new Field Group and locates the new field within it.

    • Table: FIELDGROUP_CONTROL
    • Add a new entry for the Field Group ID, Field ID, and Field Label Text ID.

Step 3: Section Control

  • Creates a new section and locates the new Field Group.

    • Table: SECTION_CONTROL
    •  Add a new entry for the Section ID, Field Group ID, and Field Group Headline.

Step 4: Form Control

  • One of the forms locates the new section.

    • Table: FORM_CONTROL_PROJECT
    • Add a new entry for the Section ID and Section Headline.

Step 5: Translatable Texts

  • Lists all new elements to be displayed well in PPP (Text).

    • Table: TEXTS
    • Add new entries for the Text ID, Language, and Text

After the metadata update you can see all your new elements in PPP. 

See Also

Keywords

brf+, add, form, section, fieldgroup, fields