Table element properties

Open the Properties view in Document Studio and select a Table element. The Properties view displays these available properties for tables in IBM Engineering Lifecycle Optimization - Publishing (PUB).




General properties

In the All properties tab, these properties are 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 variable assignments that are done in the element.
Condition String A script that can apply variables or attributes as conditions on the element.
Master page String Name of the master page that is applied to the element.
Force page change true, false Default value: false

When true, a page break is inserted if current master page is similar to previous one.

Target region String Writes the current element in the region that you specify.
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 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 that is 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 PUB or native sort that is applied to the element.
Limit String Default value: 0

Enter a number to limit the number of data values in your output.

Filter String The PUB or native filter that is 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 be 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
Table autofit autofit to window, autofit to contents When set to autofit to window, the table is resized to the width of the page. When set to autofit to contents, the table is resized to text contained within it.
Resize to fit contents true, false When set to true, the column widths are adjusted based on the cell with the largest amount of text contained within it.
Fixed cell width in column true, false When set to true, all of the cells in a column are the same width.
Cell spacing 0 to 190 The number of pixels of white space between cells.
Default cell alignment top left, top right, top center, center right, center left, center, bottom right, bottom left, bottom center Where the lines within a cell begin and end in relation to the page margins.
XHTML cell merge true, false When set to true, tables are rendered in all outputs as XHTML tables are rendered. In version 1.2 and earlier, you might have had to add empty cells to your template when you merged other cells so that the table generated correctly in Microsoft Word and PDF outputs. With XHTML cell merge set to true, you are not required to add these empty cells. When set to false, which is the default setting in version 1.2.0.1 and later, tables are rendered as they were in version 1.2 and earlier.
Remove if empty true, false This property only applies to tables that have 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 a table with, then the table does not display in the output. A table also does not display when the property is set to true and the generated table does not have any rows in it. If there are empty rows in the generated table, the table still displays despite the property setting.

When set to false, if there is not any data to populate the table with, the empty table 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 effect around the text.

Example:
Emboss example
Engrave true, false Default value: false

true creates an engrave effect 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 where all letters are uppercase
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.




Border properties

In the All properties tab, these properties are located in the Formatting > Border sections.

Type Value Description
Margin 0 to 1000 The white space between the sides of the text the border style property is applied to and any other text or element
Example:
All borders margin example
Style none, single, thick, double, hairline, dotted, dash large gap, dot dash, dot dot dash, triple, thin thick small gap, thick thin small gap, thin thick thin small gap, thin thick medium gap, thick thin medium gap, thin thick thin medium gap, thin thick large gap, thick thin large gap, thin thick thin large gap, wave, double wave, dash small gap, dash dot stroker, emboss 3D, engrave 3D, outset, inset, groove, ridge, dashed, hidden The type of border used around the side of the element
Color 000000 to FFFFFF The hexadecimal color of the border on the side of the text in the element
Note: Do not set color to transparent for all borders.
Width 0 to 30 The number of pixels the width of the border of the side of the element is.



Cell border properties

In the All properties tab, these properties are located in the Formatting > cell border > cell border color section.

Type Value Description
Style none, single, thick, double, hairline, dotted, dash large gap, dot dash, dot dot dash, triple, thin thick small gap, thick thin small gap, thin thick thin small gap, thin thick medium gap, thick thin medium gap, thin thick thin medium gap, thin thick large gap, thick thin large gap, thin thick thin large gap, wave, double wave, dash small gap, dash dot stroker, emboss 3D, engrave 3D, outset, inset, groove, ridge, dashed, hidden The type of border used around the side of the element
Color 000000 to FFFFFF The hexadecimal color of the border on the side of the text in the element
Note: Do not set color to transparent for all borders.
Width 0 to 30 The number of pixels the width of the border of the side of the element is.



Color properties

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

Type Value Description
Table background color 000000 to FFFFFF The hexidecimal color of the cell backgrounds.

Positioning and alignment properties

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

Type Value Description
Table alignment left, right, center Where the lines within a cell begin and end in relation to the page margins.
Table indent 0 to 500 The number of pixels of white space between the left page margin and the table.