Versions Compared

Key

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

...

To merge text via the content tree:

  1. Select adjacent text content nodes in the tree.
  2. Select merge text 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.

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.

To merge text via the text editor:

  1. Open a text in your document or content item.
    • Select Merge with previous from the document tab, in the outline tools group. Or use the keyboard shortcut ALT+PAGE UP.
    • Select Merge with next from the document tab, in the outline tools group. Or use the keyboard shortcut 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 previous paragraphs.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.

Image Added

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

Click on the condition icon in the tree or in the pre-viewer. The condition editor will pop up in which the condition can be edited.

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.

Apply a content style or presentation style to a content node

A content item can have a content style and a presentation style. These can be added to a content item in the context item tree, using a resource-centric menu or buttons on the Document Ribbon.

...

Set a repeat condition on a content node

Click on the condition icon in the tree or in the pre-viewer. The condition editor will pop up in which the condition can be edited.

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.

Image Added

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.

Set image width and height

The image width and height are set using the width and height text boxes on the Document Ribbon. The width and height have to 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. The scaling of the picture depends on the document renderer.

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.

Image Added

Documents

A document is started by creating a Blueriq Studio Document element, or by using the RTF Import wizard. The contents of a document is stored in a tree of content items. Content items are the nodes in the tree that represents representing the document. This means that content items can contain other content items. In addition, each content item can contain text or images.

A document is shown in two ways: as a tree of content items at the left hand side, and as text on the right hand side. Although this seems to be a preview pane, the view has no styling and in that sense doesn't look like the final result after rendering.

The two display forms are linked: when a node is selected in the tree on the left, the text is also selected at the right. In addition, the text of the child nodes “inside” of the content item is also selected.

The formatting of the text in a document is done by setting content styles and presentation styles to the content items. A content style determines the type of the content item, for example Paragraph, List, or Table. The presentation style determines the sub styling, for example RightAligned, TextEmphasis, or ListBullet (for a list).

Presentation styles can also be applied to parts pieces of the text of inside the content item.

Editing a document

A document is edited by manipulating the content items of the document is composed of.

Tree view

The actions for editing the structure of the document have to be performed in the tree view. Actions can be chosen from the context menu (right mouse button), or by using the keyboard (see the list of keyboard shortcuts). The icon that represents the content item looks different depending on what is set on the content item:

Image Added: generic icon for a content item;

Image Added: a content item with a condition;

Image Added: a content item with a repetition;

Image Added: a content item on which a content style is set;

Image Added: a content item on which a presentation style is set;

Image Added: a content item on which a content and a presentation style is set;

Image Added: a content item on which a condition, a content style and a presentation style is set.

Edit a content item

The properties of a content item can be edited in the editor as shown below. Once a property of the content item is changed, the icon representing the content item in the tree view will change accordingly.

Repetition on a content item

A repetition can be set on a content item. This allows the content item, which might contain a sub tree, to be shown multiple times. The repetition is over the instances of one entity. The expression for the repetition is any expression that can evaluate to a set of instances. This could be:

  • The name of an entity (Car);
  • A relation path, starting with a singleton and ending with a relation name (Car FROM Person.owns_car);
  • One of the two expressions above, with a restriction added (Car WHERE Car.price < 10000).

Reusable items

Content items can be made reusable. Reusable means that the content item can be used in multiple documents, or more than once in the same document. The text part of a content item can be made reusable as well, this is called a text item. Text items can be used in multiple documents, and more than once in the same document. (Reusable) content items and text items are autonomous items, and can also be created and maintained separate from a document.

...