Each form element is saved to the database by a unique, technical key. Generally an element is saved in the container by its name. This may however not always be desirable, since it could for example lead to doubling.
| Therefore form elements contain the additional option to insert a separate Field Name in Container. | You can find the field Field Name in Container in the Edit Sidebar of a form element. Here you can enter a key different from the element's name by which the values will be saved in the container. If a Field Name in Container is defined, you always need to use the Field Name in Container instead of the element's name to enable access to the corresponding data.
Inserting a Field Name in Container is especially useful if the element's name is very long, contains special characters or spaces. Using a shorter Field Name in Container makes it much easier to reference the value, for example in Worker coding. The content of the Field Name in Container is a JSON dot notation, therefore hierarchic in its structure. This means: Using dots in the Field Name in Container creates substructures. Example: Creating a section with substructures
Field Name in Container | Possible Content |
---|
Invoice | Creates a section Invoice in the container which can contain complex data or primitive data types. | Invoice.Number | Creates the substructure Number which itself can contain complex data or primitive data types. | Invoice.Date
| Creates the substructure Date which itself can contain complex data or primitive data types.
|
Note |
---|
The Field Name in Container is a technical identifier often used for additional coding. Therefore the Field Name in Container should not contain any spaces, special cases or umlauts. Make sure that an element's key is always unique. If multiple fields are named alike or were assigned the same Field Name in Container, errors will occur during app execution. |
Example: One element - various names | - The form element Input Field was assigned the Name Order Value.
- Translations have also been saved:
- Gesamt for German language.
- Total Purchase Price for English language.
- In the form itself the English translation Total Purchase Price is displayed, as the current designer uses the BPaaS Editor in English.
- The saved Field Name in Container is price. Now the value of this Input Field is saved in the container under the name price.
|
|