Versions Compared

Old Version 8

changes.mady.by.user Frank van der Vaart

Saved on

compared with

New Version 9

changes.mady.by.user Frank van der Vaart

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

Edit text in the item

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.
Tip
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


Add or edit a condition in the text

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

Note
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.


Add or edit a presentation style in the text

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.


Using fields 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

 

Content items

You can think of content items as a kind of sub-document. A content item contains both structure and content, just like a document. But, you cannot ‘generate’ a content item as you can a document. Content items can only be used as part of other content items or documents. In fact, reuse of content and structure is the sole purpose of a content item.

Both parts of the content item are visible in the content item editor:

  1. In the form of a tree, that shows the structure of the content items in a document.
  2. In a preview, the preview shows the content items in a document in a linear textual form.

Whenever a content node is selected in the tree, its content is highlighted in the document preview and vice versa.

The structure of a content item consists of:

  • content nodes of type text,
  • other content items or
  • content nodes of type image.

A content node can have the following properties:

  • Pre-condition, specifies under what conditions the content of the node should be displayed.
  • Repetition, specifies for which instances to display the content of the node, e.g. repeat a paragraph for all products in your application.
  • Content style, defines the layout of the content in the node, e.g. a chapter is always preceded by a page break.
  • Presentation style, defines the formatting of the content in a node, e.g. the font face, colour, etc.

Create a new content item

There are two ways to create a new content item, creating it from scratch or turn a content node into a content item. A content item is in fact a reusable content node.

To create a new content item:

  1. On the Document tab, in the document group, click the New content item icon.
  2. Or open the content item’s list view and use keyboard shortcut CTRL + N.
  3. Enter the content item’s name.
  4. Click Save or Save and close.

To turn a content node into a content item:

  1. Open a document or Content item.
  2. Select the node that you want to turn in to a Content item from the tree-view.
  3. Select Make reusable – as Content item from the shortcut menu.
  4. Click Save or Save and close.

The new content item will not be saved until you save the entire document or content item that contains this new content item.

Move a content node

  1. Select the node you want to move.
  2. On the documents tab, in the outline tools group, click one of the move icons. You can also use one of the keyboard shortcuts CTRL+I (up), CTRL+K (down), CTRL+J (left) or CTRL+L (right).
  3. Or select one of the Move options from the shortcut menu. Repeat this until the node is in the desired position.

If you are not allowed to move a node to a specific location, that specific move option will be read-only in the menu and ribbon.

Merge text from several content nodes

To merge text via the content tree:

  1. Select a text content node in the tree that you want to merge with the previous or with the next text content node on the same level.
  2. Select Merge with next or Merge with previous from the shortcut menu or the document tab, in the outline tools group. Or use the keyboard shortcuts ALT+PAGE UP or ALT+PAGE DOWN.

You are not allowed to merge reusable text or content items, since this would affect multiple documents or content items. In these cases the merge option will be disabled.

When you merge, be aware that properties of the top content node are preserved, while properties of the other node are lost. Any conditions and styles within the text are preserved. ‘Soft’ line breaks are inserted between the merged paragraphs.

Content node properties

You can view and edit several properties of a content node by opening the properties box, either by clicking on the small expand arrow at the top-left corner of the preview pane or by selecting Open properties on the documents tab, in the outline tools group.

Another way to adjust the properties of a content node is by opening the text editor in the text view (by double-clicking on a node in the tree view or on a text in the text view), and click on the icons right below the name of the node. 

 The icons represent from left to right: Content style, Presentation style, Condition and Repeat condition.

Apply a content style or presentation style to a content node

A content node can have a content style (e.g. Header, Table, TableRow, TableCell, AddressBlock) and/or a presentation style (e.g. TextEmphasis, Center, RightAligned). You can use pre-defined styles from a library, or add custom styles (that must be recognized by the renderer).

Set a condition on a content node

You can enter an expression in the Condition box. When the (boolean) expression evaluates to true, the content node will be displayed. The colour of the border around the condition icon indicates if the condition expression is a valid expression.

Set a repeat condition on a content node

You can also enter an expression in the Repeat Condition box. You can specify any expression that evaluates to a set of instances (e.g. ALL Customer, Policy.HasApplicants, COLLECT Customer FROM ALL Customer WHERE <condition>). 

For each instance in the set that results from the repeat expression, the content node (and all of its content) is repeated. With each repetition an instance from the set is activated.

Set image width and height

Image nodes have additional properties Width and Height. The width and/or height can be specified using a floating point number, using a period as decimal indicator. The unit is centimetres, and does not have to be specified. Neither width nor height is required. If only one of the two is specified, the picture will be proportionally resized. The scaling of the picture depends on the document renderer.

Insert a text item node or an image node

A (reusable) text item can be inserted as a child of a content item by dragging the text item onto the content item. A text item cannot be inserted as a child of an image.

An image can be inserted as a child of a content item by dragging the image onto the content item. When an image is dragged onto an image that is a child of a content item, the current image will be replaced.

Another way to insert new items is to select a node in the tree where you want to add something, then go to the Insert item part of the shortcut menu, select the type of item (content, text or image) and the item itself, and select one of three insertion possibilities: before, after or as a child of the selected node.

 

RTF Import wizard

You can create a Document from scratch in Blueriq, but you can also be off to a running start by importing an existing RTF document. Companies often already have detailed templates of the documents that are involved in their business processes. In that case, the easiest way to a new Document is to import an RTF-file into Blueriq Studio. During the import process, you can map the various styles that the import wizard detects in the source document onto pre-defined content styles and presentation styles in Blueriq.

Tip

You can save a lot of studio editing time by 'cleaning' the source RTF document before import: make sure all paragraphs, headings, ... that look the same, actually have the same style. In Word, you can use the Format Painter to copy and paste styles.

 

Import

<to do: describe the import process: From the import button to mapping styles to finish...>.