Portal (Container)

See also: Row layout, Embed forms (Sub-forms)

In the context of data entry forms, an additional layout element "Portal" is available (if the portal module is licensed). This is only a line layout container, but it allows you to use portal components directly in a data entry form, with all the associated degrees of freedom*.
This avoids the circumstance of having to embed an external portal just to be able to use form-specific 'tricks'.

* The degrees of freedom mentioned above include the free allocation of data fields and the editing of service configurations in the 'Entries and service' properties section.

A portal container has the same setting options as a line layout container. Details are therefore described in the chapter Row layout.

Use case example

In a portal section of a shipment form, a customized profile call is compiled with the help of Variablen elements.

images/download/attachments/44943488/image2020-2-18_8-45-18-version-1-modificationdate-1582011919382-api-v2.png

As shown above, a portal container is inserted at any position of the shipment form.

images/download/attachments/44943488/image2020-2-18_8-47-23-version-1-modificationdate-1582012044568-api-v2.png

When selecting the portal container, all portal-related element sections (red frame on the left) are now available. These can then be inserted directly into the portal container.

images/download/attachments/44943488/image2020-2-18_8-50-45-version-1-modificationdate-1582012246252-api-v2.png

In the Portal style, the data fields can now also be assigned freely.
►NOTE◄ To prevent conversion errors when saving (since these data fields are usually unknown in the context of business objects), the data field of the portal container should be set to Skip (button to the right of the field).

To complete the use case example, the variables could now be filled with the Set value action. The Validate element and call profile behavior (linked to the portal container) could then be used to call a profile that receives an object with the variable data fields as input data.