A text items is used for displaying text in a content item or on a page.

Text items are small indivisible blocks of formatted text. They are indivisible in the sense that only a whole text item is reusable, not a part of the text item. You can use a text item on pages and in documents. A text item can consist of multiple pieces of text and fields, each of which can have a condition and a presentation style.

Create a new text item

To create a text item:

  1. On the Home tab, in the document group, click the New text item icon.
  2. Or activate the Text item’s list view and use keyboard shortcut CTRL + N.
  3. Fill out the required fields. It is possible to set the text for each language set in the Global elements. To add text for different language than the default one, select the language just above the text area editor and click the new item button. A tab will be added to the text area for the selected language.
  4. Click Save or Save and close.

Editing text

To add or edit text in a text item:

  1. Select the language tab in which you want to add text.
  2. Type your text in the text field. The lines you edit will be marked by a yellow block at the left of the text area.

the first language tab displayed in the text item editor is that of the specification language. You can change the specification language in your user profile. For more information, see user profile

Adding conditions

You can add a condition to a part of your text, in order to display or hide this part under certain conditions.

Always consider reusability of your text item when you decide to add a condition to your text item. An alternative is to divide your text over several text items and use a content item to add your conditions. For more information on using content items, see Reusable items.

To add a condition to a text item:

  1. Select the text to which you want to apply the condition.
  2. Select the add condition button  just above the text area.
  3. Enter your condition in the expression editor that appears.
  4. Click OK to save your expression.

As a result, the conditional text is highlighted and a condition icon is placed in front of the highlighted text.

To edit the condition:

  1. Click the condition button just in front of the conditional text.
  2. Click Edit condition
  3. Change the condition in the expression editor.
  4. Click OK to save your changes.

To remove the condition:

  1. Click the condition icon just in front of the conditional text.
  2. Click remove condition.

Using fields (expressions) in your text

In Blueriq Studio text items, you can refer to information from your domain model. You can do this by inserting fields in your text. A field can contain an expression or a reference to an attribute. On generating your document, these fields are substituted by their actual values.

To add an attribute or expression field to your text:

  1. Select the Field button  just above the text area. Type a character after a field before adding the next field.
  2. Create an Expression using the expression editor.
  3. Click OK to insert the expression

Adding presentation styles

You can add a presentation style to a piece of text.

To add a presentation style to a text item:

  1. Select the text to which you want to apply the presentation style.
  2. Open the list of presentation styles with the button  just above the text area.
  3. Select the presentation style, or choose Remove presentation style at the bottom of the list.

When exporting a project containing a text item, the markup will be removed. Enters for example are markup, and won't be saved. When the project is imported in the runtime, the text items do not contain these markups anymore.

If you wish to use markups, it is suggested to use the corresponding presentation styles (i.e. NewLine)

Copy or paste text

Due to partial trust, it is not possible to copy text into a text item, or copy the text from a text item and pasting it in a different application. To avoid having to copy text by hand, you can use the copy or paste text functionality. In the pop-up window it is possible to exchange text with different applications.

  1. You can use 'Insert at cursor' to add text to your text item on the position of the cursor. If a presentation style or condition is applied to the location of the cursor, the new text will also have that presentation style or condition. 
  2. You can use 'Get Text' to retrieve the current text of the text item to this pop-up window, so that you can copy-paste the text to another application. Conditions and presentation styles are ignored.