Text item

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.

Adding conditions

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

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.
   
   

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.