insert_text_block_extended

The keyword insert_text_block was used in earlier versions of ITP to declare a field set. This keyword is deprecated since ITP/MDK Repository 3.2.0 and ITP version 3.2.5. Use the statement TEXTBLOCK instead.

The function insert_text_block_extended is an extension to the insert_text_block function. The function is used if;

• Text Blocks need to be inserted in the same result document using different styles,
• a Text Block needs to be inserted in a table cell.

The function has three parameters all type TEXT. The result of the function is type TEXT, the text of the predefined Text Block.

1. The first parameter contains the label of the Text Block that needs to be inserted.
2. The second parameter contains the prefix of the styles set that needs to be used to layout the Text Block. If this parameter is left empty, ITP will search for a styles set with the ITP prefix. Refer to the topic TEXTBLOCK for more information on laying out the Text Blocks.
3. The third parameter contains the paragraph sign that is assigned to the Text Block. The model developer needs to pass a paragraph sign that is declared within a table cell to insert a Text Block in a table cell. Using the wrong paragraph sign to insert a Text Block in a table cell can result in a corrupted Microsoft Word document. This paragraph can be left empty if the Text Block is not inserted in a table cell. Refer to the Text Block Help for more information on inserting Text Block in a table cell.

If the Text Block set the Text Block belongs to has an associated field set, the model developer is responsible for assigning values to all fields from this field set using a variable type FIELDSET . This needs also to be done if the Text Block that is inserted into the result document does not use any of these fields.

Example

@(insert_text_block_extended("Clauses"; "TST"; ""))

The Text Block with label "Clauses" is inserted in the result document. The styles set that is used has the prefix "TST".

Example

TEXT par := "
"
@(insert_text_block_extended("Clauses"; ""; par))

The Text Block with label "Clauses" is inserted in the result document. The function needs to be called within a table cell because the paragraph sign that is passed in the third parameter is declared within a table cell.

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.