Box Tags

Boxes are used by central or overview pages and can be included within a tab block or an elements block. A box element is defined by using a box tag with required tags between an open { and close } braces.

Tag

Examples

Status

Notes

box

box percent = 50 {

title "Left Side"

title-justification "left"

element id = "mynos"

}

 

box id = "bgd" style = "simple" {

element id = "gdcount" percent = 30

}

Required

Creates a box around a single element with a blue title bar along the top.

The boxed element can include any element. For example, table, grid, image, row or chart. A percent is used when the box tag is within a vsplit or hsplit.

background-color

background-color "bdfbaf" Optional Sets the background color for the box. Uses a hexadecimal code to identify colors.

bar-chart

bar-chart id = "bar_chart_year" {

dimension "Year"

title "Vehicles Sold by Year"

bar column = "Vehicles Sold" {

link {

page id = "year"

}

}

sort-column = "Year"

}

 

bar-chart id = "lc-sales" {

cplan "/cplans/southern.cplan"

dimension "Posting Month"

title "Cases Sold by Month"

bar column = "Cases Y Y-1" title = "2018"

bar column = "Cases Y" title = "2019"

sort-column "Posting Month"

}

Optional

Defines a bar chart with the specified dimension and summary.

Multiple columns can be specified. By default, the legend displays on the right side of the chart.

TIP: Use the sort-column and first tags together to display a limited number of the highest or lowest values.

element

element {

...

}

 

element id = "br-yearmo" percent = 90

Optional

Defines elements for a tab block. When defined in a definitions block, the elements can be reused by pages within the script.

Boxes are contained within an elements block, include an element from an elements block, or both.

grid

grid id = "gdcar" {

cplan "/cplans/carLK.cplan"

row "Group"

row "Make"

}

Optional

Defines a grid by specifying rows from a cPlan and the strings in those rows.

hbar-chart

hbar-chart id = "bar_chart_year" {

dimension "Year"

bar column = "Vehicles Sold" {

link {

page id = "year"

}

}

sort-column "Year"

}

Optional

Defines an hbar-chart with the specified dimension and data column.

Multiple columns can be specified. By default, the legend displays on the right side of the chart.

An hbar-chart does not support a title tag.

TIP: Use the sort-column and first tags together to display a limited number of the highest or lowest values.

hsplit

vsplit {

hsplit percent = 50 {

element id = "ln-yearmo" percent = 0

element id = "br-yearmo" percent =50

}

hsplit percent = 50 {

element id = "gddimcount" percent = 90

spacer percent = 10

}

}

Optional

Displays contained items horizontally, or left to right.

IMPORTANT: An hsplit tag must first be contained within a vsplit tag. Multiple hsplit tags within a vsplit are aligned top to bottom according to the vsplit tag.

id

id = "br-yearmo" Optional Gives a block or element an identifying name so it can be referenced elsewhere in the script.

image

image id = "preview" percent = 27 {

repository "brands"

path "/divetab/images/group.jpg"

}

Optional

Specifies a graphic to include and gives it an id.

line-chart

line-chart id = "lc_month" {

title "Vehicles Sold by Month"

dimension "Month"

line column = "Vehicles Sold"

sort-column = "Month"

}

Optional

Defines a line chart with the specified dimension and data column.

Multiple columns can be specified. By default, the legend displays on the right side of the chart.

TIP: Use the sort-column and first tags together to display a limited number of the highest or lowest values.

percent

percent = 50

percent = 85

Optional

Identifies the percentage of the display layout allocated for the element.

NOTE: The total percentage must equal 100.

pie-chart

pie-chart id = "Pie-gp" {

title "Units by Salesperson"

title-justification "left"

dimension "Salesperson"

column column = "Cases Y Y-1" {

link {

page id = "rp-Product Category"

}

}

}

Optional

Defines a pie chart for the specified data dimension and data column.

Only one column can be specified. By default, the legend displays on the right side of the chart.

table

table id = "tb-customer" {

dimension "Customer"

text column = "Net Sales" {

width 150

}

text column = "Cases" {

background-color "dda0dd"

text-color "5f9ea0"

}

sort-column "Cases" reverse = true

first 10

}

Optional

Defines a table on the page. The columns expand and contract to fit the area available in the parent element in the page. Columns can use the width tag to specify the width of the column.

TIP: Use the sort-column and first tags together to display a limited number of the highest or lowest values.

title

title "Bar Chart" Optional Indicates a title for the box.
title-justification

title-justification "left"

title-justification "right"

title-justification "center"

Optional Aligns the title of the box to the left, right, or center. By default, the box title is aligned to the center of the title bar.
vsplit

hsplit {

vsplit percent = 50 {

element id = "br-year" percent = 49

line percent = 2

element id = "ln-mo" percent = 49

}

vsplit percent = 50 {

element id = "table-yr" percent = 90

}

}

Optional

Displays contained items vertically, or top to bottom.

IMPORTANT: A vsplit tag must first be contained within an hsplit tag. Multiple vsplit tags within an hsplit are aligned left to right according to the hsplit tag.

See also: