Dynamic FORM

Since ITP/MDK Repository 3.2.0 and ITP version 3.2.5 forms can be created with a WYSIWYG Form Editor. These forms are retrieved from the ITP/MDK Repository database at the moment the model is run. That is why these forms are called dynamic forms as opposed to normal forms that are created with the statement FORM.

Note

ITP Models using this feature can be created with ITP/Workstation, but to run a model containing this feature, you will need ITP/Server or ITP/OnLine Server.

To insert a form that has been created with the Form Editor in the model document the FORM statement needs to be used.

Insert a dynamic FORM

Add the following lines to the model document to insert a dynamic form:

FORM
NAME "folder\name of the form"

NAME contains the name of the form as it is known in the ITP/MDK Repository project. This is sufficient if the form is located in the root folder of the special ITP/MDK Repository Forms folder. If the form is located in a (sub) folder of the special Forms folder this (sub)folder needs to be passed too.

It's possible to explicitly pass a project to insert the form. This ensures that the form is always retrieved from this project.

FORM
NAME "Project.folder\name of the form"

The name of the special Forms folder does not need to be passed!

Refer to Retrieving dynamic building blocks for an overview on how forms and other dynamic building blocks are retrieved from the ITP/MDK Repository.

It is also possible to pass a variable instead of a fixed name to the statement FORM:

FORM
VAR variable

Dynamic forms can be configured to automatically insert any selected Text Blocks. If the user selects multiple Text Blocks, these are separated by paragraph breaks. This behavior can be influenced by the pragma functions AutoInsertSeparator and AutoInsertTerminators. Refer to pragma for more information.

Note

The ITP/MDK Repository computes the dependencies of the different objects in a project. The dependency of a model on a form can only be computed if a form has been inserted with the statement NAME.

FIELDSETs and dynamic Forms

The ITP/MDK Repository contains Field Sets which are used in Text Blocks and Forms. Every time a model uses a Text Block or Form that refers to a Field Set it must declare a variable FIELDSET with the same name. The contents of this FIELDSET variable are used wherever fields from the Field Set are used. Refer to Inserting a Text Block for more information on using Text Blocks in ITP Model documents.