Row element properties

Open the Properties view in Document Studio and select a Row element. The Properties view displays these available properties for rows.


General properties

In the All properties tab, these properties are located at the top-level, in the Metadata, and in the Formatting > Common sections.

Type Value Description
Tag String Tag name for the element. This property cannot be edited.
Name String The name of the element.
Description String A summary or note about this element.
Assignment String The variables that are assigned to the element.
Condition String A script that can apply variables or attributes as conditions on the element.
Style name String Name of the style that is applied to the element.


Data properties

The Data tab is only visible in the Properties view when there is a query added to the element. In the All properties tab, these properties are located at the top-level and in the Data sections.

Type Value Description
Data Source String The data source schema name. You cannot edit this property. Example: Generic XML 1
Context String If the query is on an element nested within another element, the context of the parent element is listed for this property. You cannot edit this property. Example: $7 is the context for the parent element.
Query String The name of the query as specified in the data source schema.
Sort String The Rational® Publishing Engine or native sort applied to the element.
Limit String Default value: 0

Enter a number to generate only a certain number of data values in your output.

Filter String The Rational Publishing Engine or native filter applied to the element.
Recursive Level Number Default value: 0

Instead of adding a query and each of its child queries in your template to extract a set of data, you can use the Recursive Level and Recursive Segments. Use these properties together to specify only the parent query in your template and extract data from that query and all of its child queries.

The Recursive Level is the number of times the recursive segments in the query are repeated. Example: In the query Module/Object/Link/Linked Object, if you entered 2 for the recursive segment value and 3 for the recursive level value, Link/Linked Object would repeated 3 times. The resulting query is Module/Object/Link/Linked Object/Link/Linked Object/Link/Linked Object.

Recursive Segments Number Default value: 1

Instead of adding a query and each of its child queries in your template to extract a set of data, you can use the Recursive Level and Recursive Segments. Use these properties together to specify only the parent query in your template and extract data from that query and all of its child queries.

The number of segments in the query that are to be repeated. Example: In the query Module/Object/Link/Linked Object, if you entered 2 for the recursive segment value, Link/Linked Object are the segments that are repeated.


Specific properties

In the All properties tab, these properties are located in the Formatting > specific section.

Type Value Description
Row break across page true, false When set to true, a row that does not fit on a page is pushed to the second page. When not set or set to false, a row that does not fit on a page is split horizontally onto two pages.
Row repeat at page beginning true, false Default value: true

When set to true, the row can be used as a header row if the table carries onto multiple pages.

When set to false, the row does not repeat on multiple pages. If rows span more than one page, the content might be truncated.

Once per table true, false When set to true, duplicate rows are removed from consecutive tables that display as merged tables in the generated output.
Attention: If the row element is inside of a container element, do not set once per table to true.
Remove if empty true, false This property only applies to rows or cells that are generated by queries. Header rows do not impact the behavior of this property.

When set to true, if there is not any data to generate and populate the row with, then the row does not display in the output. A row also does not display when the property is set to true and there are generated rows that do not have any cells in them. If there are generated rows with empty cells in them, the row still displays despite the property setting.

When set to false, if there is not any data to populate the row with, the empty row still displays in the output.


Font properties

In the All properties tab, these properties are located in the Formatting > FontFormatting > Line, Formatting > Character, and Formatting > Effects sections.

Type Value Description
Font String, Cambria, Courier New, Georgia, Helvetica, Lucida, Tahoma, Times New Roman, Verdana Select one of the common fonts available in the dropdown menu or type the name of another font on your computer to use.
Size 1 to 1638 The point size of the text in the element. You can select a value from the dropdown menu or type a value between the supported sizes.

Example:

Font size example

Color 000000 to FFFFFF Default value: 000000

The hexadecimal color of the text in the element.

Example:

Font color example

Note: The value transparent is only supported for XSL-FO output.
Bold true, false Default value: false

true applies bold styling.

Example:

Bold example

Italic true, false Default value: false

true applies italic styling.

Example:

Italic example

Underline true, false, single, words, double, dotted, thick, dash, dash long, dot dash, dot dot dash, wavy, dotted heavy, dash heavy, dash long heavy, dot dash heavy, dot dot dash heavy, wavy heavy, wavy double Default value: false

true creates a horizontal line beneath the text.

Example:

Underline example

Overline true, false Default value: false

true creates a horizontal line over the text.

Example:

Overline example

Strikethrough true, false, double Default value: false

true creates a horizontal line through the center of the text.

Example:

Strikethrough example

Shadow true, false Default value: false

true creates a shadow on the text.

Example:

Shadow example

Outline true, false Default value: false

true creates an outline around the text.

Example:

Outline example

Emboss true, false Default value: false

true creates an emboss around the text.

Example:

Emboss example

Engrave true, false Default value: false

true creates an engrave around the text.

Example:

Engrave example

Small caps true, false Default value: false

true changes lowercase letters into capital letters.

Example:

Small caps example

All caps true, false Default value: false

true changes all letters into capital letters.

Example:

All caps example

Hidden true, false Default value: false

true removes the text from the output.

Underline color 000000 to FFFFFF Default value: 000000

The hexadecimal color of the line underneath the text in the element.


Size properties

In the All properties tab, these properties are located in the Formatting > size section.

Type Value Description
Specify height true, false Set to true to apply the Row height property to the row. Set to false to have the value entered for the Row height ignored.
Row height 0 to 1500 The number of pixels vertically the row is.
Row height specifier at least, exactly A qualifier for how tall the row is. This allows the row height to adjust for cells with larger amounts of content.

Feedback