Studio Report Template Controls

Applies to: Kyvos Reporting

When a report template (.irt file) is applied during report creation in Kyvos Reporting Studio, specific elements are inherited into the report layout (.irl file). Templates include both dynamic controls and static controls, each with distinct behavior and usage.

Types of Controls in Report Templates

Control Type	Description

Control Type	Description
Dynamic Controls	These controls transfer formatting and layout properties to the actual report controls in the `.irl` file. The behavior depends on the control type and the section it belongs to.
Static Controls	These controls are directly copied from the template to the report layout without modification. They typically include labels, graphics, and decorative elements.

Kyvos Reporting Studio also applies certain report-level properties from the template to the report layout, such as:

Report Properties: PrintWidth, DocumentName, ScriptLanguage
Watermark Properties: Watermark, WatermarkAlignment, WatermarkPrintOnPages
Page Settings: LeftMargin, RightMargin, TopMargin, MirrorMargins, PaperSize, PaperHeight, PaperWidth, Orientation, Collate, Duplex, Gutter, PaperBin

All dynamic control names must begin with the prefix IRT_ and are reserved within the template context.

Dynamic Controls

Dynamic controls are used to define standardized formatting and placement for fields, labels, page elements, and summaries. When a report layout is generated using a template, these controls influence the corresponding report elements.

Available Dynamic Controls

Section	Control Name	Purpose

Section	Control Name	Purpose
Report Header	`IRT_ReportHeader_Title`	Sets formatting and vertical position of the report title.
Page Header	`IRT_PageHeader_Label`	Sets formatting and placement for labels in the page header.
Page Header / Footer	`IRT_PageNo`	Sets formatting and position for page numbers. Can be reused in both header and footer.
Group Header (X = 1 to 5)	`IRT_GroupHeaderX_TextBox`	Sets formatting for textboxes in group headers.
Detail Section	`IRT_Detail_TextBox`	Applies formatting for text fields in the detail section.
	`IRT_Detail_Date`	Applies formatting for date fields in the detail section.
	`IRT_Detail_Number`	Applies formatting for numeric fields in the detail section.
Group Footer (X = 1 to 5)	`IRT_GroupFooterX_Summary`	Sets formatting for summary fields in group footers.
Report Footer	`IRT_ReportFooter_Label`	Sets formatting for footer labels.

Examples

Page number in page footer: Place IRT_PageNo in the page footer section.
Group header and footer structure:
- IRT_GroupHeader2_TextBox in Group Header 2
- IRT_GroupHeader1_TextBox in Group Header 1
- IRT_GroupFooter1_Summary in Group Footer 1
Detail section customization:
- Use IRT_Detail_TextBox, IRT_Detail_Date, or IRT_Detail_Number for consistent field formatting.

Static Controls

Static controls are copied exactly as defined in the template (.irt) and placed onto the report layout (.irl). These are typically used for non-data-driven visual or textual elements.

Common Examples

Control Name	Description

Control Name	Description
`IRT_Ln`	Line below the report title in the Report Header
`IRT_logo`	Company logo image placed in Report Header
`IRT_cpright`	Copyright or disclaimer message in Report Footer
`IRT_co_addrs`	Company address text control
`IRT_Bx`	Box placed around a checkbox in Detail section
`IRT_Ovl`	Oval or box shape used in OCR forms