Report Definition XML Elements
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
The report definition for a report contains RDL elements that define the data and appearance of the report.
A report definition (.rdl) file can contain additional elements that are not used by the report server. For example, Report Designer places an element in the report definition that is only used by Report Designer.
In This Section
Element | Parent | Description |
---|---|---|
DataSet |
Indicates whether the data is accent-sensitive. |
|
Actions |
Defines a hyperlink, bookmark link, or drillthrough action. |
|
DataPoint, Image |
Defines a list of actions associated with a ReportItem. |
|
ActionInfo |
Defines an ordered list of actions associated with a ReportItem. |
|
ReportParameter |
Indicates whether the value for the parameter can be an empty string. |
|
CustomReportItem |
Contains the report item to render in cases where the custom report item is not supported by the server or the renderer. |
|
Report |
Specifies the name of the person who created the report. |
|
Report |
Specifies the rate, in seconds, at which a report rendered in HTML refreshes. |
|
Style |
Describes the background color of the item. |
|
Style |
Specifies the end color of the background gradient. |
|
Style |
Specifies the type of background gradient. |
|
Style |
Provides information about the background image. |
|
BackgroundImage |
Indicates how the background image fills the available space. |
|
Report |
Contains the visual elements of the report. |
|
ReportItem |
Provides a bookmark that users can jump to using a link defined as a bookmark action. |
|
Action, Drillthrough |
Contains the ID of a bookmark to jump to within the report. |
|
Style |
Defines the default border properties for a report item. |
|
Style |
Defines the border properties for the bottom border of a report item. |
|
Page |
Describes the width of the bottom margin of the report. |
|
PageBreak |
Defines where the page should break. |
|
Style |
Specifies the calendar to use to format dates. |
|
Textbox |
Indicates whether the size of the text box can increase vertically according to its content. |
|
Textbox |
Indicates whether the size of the text box can decrease according to its content. |
|
Title |
Contains the text of the chart or axis title. |
|
DataSet |
Indicates whether the data is case-sensitive. |
|
TablixCornerCell, TablixHeader, TablixCell |
Defines the report item contained in a body, header, or corner cell of a Tablix element. |
|
ReportItems |
Defines a chart region to be included in the report. |
|
Classes |
Contains information about a class to instantiate during report initialization. The class instance can be used in expressions in the report. |
|
Report |
Contains classes to instantiate during report initialization. |
|
Class |
Contains the name of the class to instantiate. |
|
Report |
Contains definitions for custom functions to be used in the report. |
|
CodeModules |
Contains the name of the assembly to load. |
|
Report |
Contains the names of assemblies to load for use in expressions. |
|
DataSet |
Describes the locale that the report server uses to sort data. |
|
Border, BottomBorder, LeftBorder, RightBorder, Style, TopBorder |
Describes the foreground color of the item. |
|
CellContents |
Specifies the number of columns that the cell spans. |
|
Page |
Defines the default number of columns in the report. |
|
Page |
Defines the spacing between columns. |
|
Query |
Specifies the query that the report server executes to retrieve data for the report. |
|
Query |
Indicates the type of query that is contained in the CommandText element. |
|
DataSource |
Provides information about the data source. |
|
ConnectionProperties |
Contains the connection string for the data source. |
|
Report |
Indicates whether the space between report items in a rectangle or the report body should not be preserved as report items expand. |
|
CustomReportItem |
Represents the data to display in a custom report item. |
|
Axis, ChartMember, DataMember, DataPoint, Report, ReportItem, TablixMember |
Allows report design tools to pass information to custom report renderers and custom report items. |
|
CustomProperties |
Represents a custom property used in a report, report item, or group. |
|
ReportItems |
Defines a custom report item to be drawn in the report. |
|
DataRow |
Defines the set of data values to pass to a custom report item for a specific combination of leaf-node groupings. |
|
CustomData |
Defines the hierarchy of column groups for the data. |
|
ChartMember, DataPoint, Group, Report, ReportItem, TablixCell, TablixMember |
Contains the name of the data element or attribute for a report item or the name of the top-level element for a report rendered using a data rendering extension like the XML rendering extension. |
|
ChartMember, DataPoint, Group, ReportItem, TablixCell, TablixMember |
Indicates whether the item appears in output rendered by the XML rendering extension. |
|
Report,Textbox |
Indicates whether a text box within the report should be rendered as an element or as an attribute when the report is rendered using the XML rendering extension. |
|
Field |
Provides a name of a field in a query. |
|
DataPoint |
Defines the data labels to display for data values. |
|
DataMembers |
Defines a member of a custom data hierarchy. |
|
DataColumnHierarchy, DataMember, DataRowHierarchy |
Defines a list of members of a custom data hierarchy. |
|
DataPoints |
Defines a single data point for a chart. |
|
ConnectionProperties |
Specifies the data processing extension to use for the data source. |
|
(none) |
Defines a virtual report element of a report that is used to define a property inheritance relationship with Tablix and Chart elements but does not itself appear in an RDL report. |
|
DataRows |
Defines the columns of data within each row to pass to a custom report item. |
|
CustomData |
Defines the hierarchy of row groups for the data. |
|
CustomData |
Defines the rows of data to pass to a custom report item. |
|
Report |
Contains the namespace to use in a report rendered using a data rendering extension like the XML rendering extension. |
|
DataSets |
Contains information about a set of data to display as a part of the report. |
|
DataSetReference |
Indicates which dataset to use for the dataset reference. |
|
CustomData, DataRegion, DataSetReference |
Indicates which dataset to use for the data region. |
|
DefaultValue, ValidValues |
Defines a dataset that contains a query that returns a set of valid values or default values for a report parameter. |
|
DefaultValue, ValidValues |
Contains information about the sets of data to display as a part of the report. |
|
DataSources |
Describes a data source in the report. |
|
Query |
Contains the name of the data source for the query. |
|
DataSource |
Contains the path to a shared data source. |
|
Report |
Describes the data sources for the report. |
|
Report |
Contains the location and file name of a transformation to apply to a report that is rendered using a data rendering extension. |
|
ReportParameter |
Specifies the data type of a parameter. |
|
DataCell, DataValues |
Defines a single value for a DataPoint in a Chart or a data value to pass to a custom report item. |
|
ReportParameter |
Specifies the default value to use for the parameter. |
|
Report |
Indicates that Variables throughout the report are not required to be pre-evaluated at the beginning of report processing and may be evaluated for on-demand based on usage. |
|
Report |
Contains a description for the report. |
|
SortExpression |
Indicates whether the items are sorted in ascending or descending order. |
|
Style |
Specifies the direction of text. |
|
Group |
Identifies an instance of the group within the document map. |
|
ReportItem |
Identifies an instance of a report item within the document map. |
|
Action |
Contains a reference to a report to be opened through a drillthrough action. |
|
EmbeddedImages |
Contains an image that is embedded within the report. |
|
Report |
Contains the images that are embedded within the report. |
|
Fields |
Describes a field in the dataset. |
|
DataSet |
Contains the fields in the dataset. |
|
Filters |
Contains a list of filters that restrict rows of data in a dataset or data region, or restrict group instances in a grouping. |
|
Filter |
Contains an expression that is evaluated for each row of data or group and compared to a filter value. |
|
CustomData, DataRegion, DataSet, Group |
Contains a collection of filter lists to apply to a dataset, data region, or grouping. |
|
FilterValues |
Contains a value to compare against a filter expression. |
|
Filter |
Contains a collection of values to compare to the filter expression. |
|
Tablix |
Indicates the column headers should be displayed on the page even when the user scrolls part of the Tablix off the page. |
|
TablixMember |
Indicates the entire member should be displayed on the page even when the user scrolls part of the Tablix off the page. |
|
Tablix |
Indicates the row headers should be displayed on the page even when the user scrolls part of the Tablix off the page. |
|
Style |
Contains the name of the font for the item. |
|
Style |
Indicates the point size of the font for the item. |
|
Style |
Indicates the style of the font for the item. |
|
Style |
Indicates whether or not the font for the item is bold. |
|
Style |
Contains the Microsoft .NET Framework formatting string for the item. |
|
ChartMember, DataMember, TablixMember |
Defines the expressions by which to group the data. |
|
GroupExpressions, ReGroupExpressions |
Defines an individual expression by which to group the data. |
|
Group |
Contains an ordered list of expressions by which to group the data. |
|
Tablix |
Indicates the number of instances of the outermost column group to appear outside the row headers. |
|
Body, PageSection, ReportItem, TablixRow |
Indicates the height of the item. |
|
ReportParameter, Visibility |
Indicates whether the item should initially be visible on the report. |
|
Textbox |
Indicates whether an item is displayed when its current value is the same as its value in the previous row. |
|
TablixMember |
Indicates whether this static member should be hidden if the Tablix contains no rows of data. |
|
Action |
Contains the URL of the target object. |
|
ReportItems |
Contains an image to be displayed in the report. |
|
EmbeddedImage |
Contains encoded image data. |
|
ToggleImage |
Specifies the initial state of a visibility toggle image. |
|
Class |
Contains the name of the variable to which the class is assigned. |
|
ConnectionProperties |
Indicates whether the data source uses integrated security to connect. |
|
Page |
Specifies the default height of a report that is rendered in the HTML or GDI rendering extensions. |
|
Page |
Specifies the default width of a report that is rendered in the HTML or GDI rendering extensions. |
|
DataSet |
Indicates whether subtotal rows returned from a data provider that supports server subtotals should be interpreted as detail rows instead. |
|
DataSet |
Indicates whether the data is kanatype-sensitive. |
|
DataRegion, Rectangle, Subreport, TablixMember, Textbox |
Indicates whether all sections of the data region are kept together on one page. |
|
TablixMember |
Specifies that during rendering, this static member stays on the same page with the closest target peer dynamic member as indicated by the value. |
|
ParameterValue |
Contains the label to display to the user for the parameter. |
|
DataSetReference |
Contains the name of the field that displays a list of friendly names to display to the user for valid values for a parameter. |
|
Report |
Indicates the primary language of the text in the report. |
|
Style |
Indicates the primary language of the text. |
|
Legend |
Determines the arrangement of labels within the legend. |
|
Tablix |
Indicates the overall direction of the Tablix layout. |
|
ReportItem |
Indicates the distance of the item from the left edge of the containing item. |
|
Style |
Defines the border properties for the left border of a report item. |
|
Page |
Specifies the width of the left margin of the Page. |
|
ReportItems |
Defines a line to be drawn in the report. |
|
Style |
Describes the height of a line of text. |
|
Rectangle |
Contains the name of a child report item that is the target location for the document map label. |
|
DataPoint |
Defines a marker for displayed chart data values. |
|
Subreport |
Indicates whether transactions in the subreport are merged with transactions in the parent report when both reports use the same data sources. |
|
BackgroundImage, EmbeddedImage, Image |
Identifies the Multipurpose Internet Mail Extensions (MIME) type of the image. |
|
ReportParameter |
Indicates that the report parameter can take a set of values. |
|
CustomProperty, DataSet, DataSource, DataValue, EmbeddedImage, Field, Group, Parameter, QueryParameter, ReportItem, ReportParameter, Variable |
Defines a unique CLS-compliant identifier for this RDL element. |
|
CustomProperty |
Contains the name for a custom property. |
|
NoRowsMessage Element (RDL) |
DataRegion, Subreport |
Specifies the text to display when no rows are returned by the datasets in a subreport or data region. |
ReportParameter |
Indicates whether the value for the parameter can be null. |
|
Style |
Specifies the language to use to format numbers. |
|
Style |
Specifies the language variant to use to format numbers. |
|
Parameter |
Indicates that the parameter is ignored when a user opens a report using a drillthrough link on another report. |
|
Rectangle, Subreport, Tablix |
Indicates that the borders should not appear at locations where the item spans multiple pages. |
|
Filter |
Specifies an operator to use to compare the values in the FilterExpression and FilterValues elements. |
|
Style |
Designates the amount of padding between the bottom edge of the report item and its contents. |
|
Style |
Designates the amount of padding between the left edge of the report item and its contents. |
|
Style |
Designates the amount of padding between the right edge of the report item and its contents. |
|
Style |
Designates the amount of padding between the top edge of ave the report item and its contents. |
|
Report |
Contains page layout information for the report. |
|
DataRegion, Group, Rectangle |
Indicates that the rendering extension should insert a page break at the end of the item. |
|
Page |
Contains a footer that is rendered at the bottom of each page of the report. |
|
Page |
Contains a header that is rendered at the top of each page of the report. |
|
Page |
Specifies the default height of a report that is rendered in a physical page-oriented rendering extension. |
|
Page |
Defines the layout of report items to appear at the top or bottom of every page of the report. |
|
Page |
Specifies the default width of a report that is rendered in a physical page-oriented rendering extension. |
|
Parameters |
Contains a parameter to pass to a report or control. |
|
ParameterValues |
Provides an individual hard-coded parameter for the list contained withing the ParameterValues element. |
|
ValidValues |
Provides a list of hard-coded values to display to the user so that they can choose a value for this parameter. |
|
Drillthrough, Subreport |
Contains a list of parameters to pass to a subreport or drillthrough report. |
|
Group |
Identifies the parent group in a recursive hierarchy. |
|
DataLabel |
Indicates the position of the data label. |
|
Legend |
Indicates the position of the legend. |
|
Title |
Indicates the position of the title. |
|
PageSection |
Indicates whether the page header is rendered on the first page of the report. |
|
PageSection |
Indicates whether the page header is rendered on the last page of the report. |
|
ConnectionProperties |
Contains the text that the user interface displays when prompting the user for database credentials. |
|
ReportParameter |
Designates the text to display when the user interface prompts the user for parameter values. |
|
DataSet |
Contains information about the query contained within the dataset. |
|
QueryParameters |
Contains information about an individual parameter that is passed to the data source as part of a query. |
|
Query |
Lists the parameters to pass to the data source as part of the query. |
|
ReportItems |
Defines a rectangle to be drawn in the report. A rectangle can be a graphical element or a container for report items. |
|
Tablix |
Indicates the column headers that should be repeated on each page on which a portion of the Tablix appears. |
|
TablixMember |
Indicates whether to repeat this static member on every page that has at least one complete instance of the dynamic member referred to by KeepWithGroup or a descendant of that member.. |
|
Tablix |
Indicates the row headers that should be repeated on each page on which a portion of the Tablix appears. |
|
ReportItem |
Provides the name of the data region with which to repeat the report item if the data region spans multiple pages. |
|
(none) |
Contains properties, data, and layout information for the report. The Report element is the top-level element of Report Definition Language (RDL). |
|
Report |
Defines a virtual report element of a report that is used to define a property inheritance relationship with other report elements but does not itself appear in an RDL report. |
|
ReportItems |
Defines a virtual report item in a report. A report item can be a line, rectangle, text box, image, subreport, data region, or custom report item. |
|
Body, PageSection, Rectangle |
Contains the report items that define the contents of a report region. |
|
Drillthrough, Subreport |
Contains name of the target report. |
|
ReportParameters |
Describes an individual parameter in the report. |
|
Report |
Contains an ordered list of parameters in the report. |
|
Style |
Describes the color of the right border of the item. |
|
Report |
Specifies the width of the right margin of the report. |
|
CellContents |
Specifies the number of rows that the cell spans. |
|
Marker |
Indicates the size of the marker. |
|
Image |
Determines the appearance of the image if the image does not fit within the height and width of the Image element. |
|
SortBy |
Contains the expression by which to sort the data. |
|
ChartMember, DataMember, TablixMember |
Defines an ordered list of expressions to use during a sort. |
|
UserSort |
Contains the name of the scope (data region or group) in which to evaluate a sort expression. |
|
UserSort |
Indicates the name of the data region, group, or data set for a sort. |
|
BackgroundImage, Image |
Indicates the source of the image specified in the Value element. |
|
Action, ActionInfo, Body, Border, BottomBorder, CustomReportItem, DataLabel, DataPoint, Image, LeftBorder, Legend, Line, List, Page, PageSection, PlotArea, Rectangle, ReportElement, RightBorder, Subreport, Tablix, Textbox, Title, TopBorder |
Contains information about the style of an item. |
|
Border, BottomBorder, LeftBorder, RightBorder, TopBorder |
Defines an expression that specifies the style of a border. |
|
ReportItems |
Contains information about a report to be included within the report. |
|
ReportItems |
Defines a Tablix data region. A Tablix data region is a flexible layout grid that can support nested and adjacent repeating and static rows and columns for both column groups and row groups. |
|
Tablix |
Defines the layout and structure of the section of the Tablix data region that contains the data elements. |
|
TablixRows |
Defines the contents of each cell in the body section of a Tablix data region. |
|
TablixRows |
Defines the ordered list of cells in a row of the body section of a Tablix data region. |
|
TablixColumns |
Defines a column in the body section of a Tablix data region. |
|
Tablix |
Defines the hierarchy for a set of members for the columns in a Tablix data region. |
|
TablixBody |
Defines the set of columns in the body section of a Tablix data region. |
|
Tablix |
Defines the layout and structure of the corner section of a Tablix data region. |
|
TablixCornerRow |
Defines the contents of each corner cell in a Tablix data region. |
|
TablixCornerRows |
Defines the list of cells in a row of the corner section of a Tablix data region. |
|
TablixCorner |
Defines the list of rows in the corner section of a Tablix data region. |
|
TablixMember |
Defines the layout and contents of each tablix member in a tablix column hierarchy or tablix row hierarchy in a Tablix data region. |
|
TablixMembers |
Defines a tablix member in an ordered list of members for a tablix row hierarchy or tablix column hierarchy in a Tablix data region. A tablix member can contain a nested tablix members list. |
|
TablixColumnHierarchy, TablixRowHierarchy |
Defines an ordered list of members in the row hierarchy or column hierarchy in a Tablix data region. |
|
TablixRows |
Defines the list of tablix cells and the height of the row in the tablix body section of a Tablix data region. |
|
Tablix |
Defines the hierarchy for a set of members for the rows in a Tablix data region. |
|
TablixBody |
Defines the set of rows in the body section of a Tablix data region. |
|
Style |
Describes the horizontal alignment of the text of the item. |
|
ReportItems |
Defines a text box to be drawn in the report. |
|
Style |
Describes special text formatting for the item. |
|
Query |
Specifies the number of seconds the query runs before timing out. |
|
Textbox |
Indicates that a toggle image is displayed as a part of the text box. |
|
Visibility |
Specifies the text box that users click to show or hide the current item. |
|
ReportItem |
Contains a text label for the item. |
|
ReportItem |
Indicates the distance of the item from the top of the containing item. |
|
Style |
Defines the border properties for the top border of a report item. |
|
Page |
Specifies the width of the top margin of the report. |
|
DataSource |
Indicates whether the datasets that use this data source run in a single transaction. |
|
CustomReportItem |
Specifies the type of custom report item for use by report design tools or the report server. |
|
Style |
Indicates the level of bi-directional embedding. |
|
ReportParameter |
Indicates whether a report parameter is used in queries within the report |
|
Textbox |
Indicates that an end-user sort control should be displayed as a part of this text box in the UI. |
|
ReportParameter |
Provides a list of possible values with which to populate a parameter list that is displayed to users. |
|
CustomProperty |
Contains the value for a custom property. |
|
DataLabel |
Contains the expression for the value labels. |
|
DataValue |
Contains the value of the data point. |
|
Field |
Contains an expression that evaluates to the value of the field. |
|
Image, BackgroundImage |
Identifies the source of the image. |
|
Parameter |
Contains the value for an individual parameter that is passed to a subreport or drillthrough report. |
|
ParameterValue |
Contains a possible value for the parameter. |
|
QueryParameter |
Contains the value to pass to the data source. |
|
Textbox |
Contains the value of the text box. The value can be a field name, a constant, or another expression. |
|
Values |
Contains an individual value or expression to be used as a default for a parameter. |
|
DataPoint |
Defines the name of the value axis on which to plot the data point. |
|
DataSetReference |
Contains the name of the field that contains the valid values or the default value of the parameter. |
|
DefaultValue |
Contains the hard-coded default values for a multivalued parameter. |
|
Variables |
Defines a named expression to be evaluated within the group or report. |
|
Group, Report |
Defines a set of named expressions to be evaluated within the group or report. |
|
Style |
Describes the vertical alignment of the text of the item. |
|
ReportItem, TablixMember |
Indicates whether the item is displayed in the rendered report. |
|
Style |
Indicates the width of the item. |
|
DataSet |
Indicates whether the data is width-sensitive. |
|
Style |
Indicates whether the text is written horizontally or vertically. |
|
ReportItem |
Indicates the drawing order of the item within the containing item. |
See Also
Reference
Report Definition Language XML Schema
Concepts
Report Definition XML Diagram
Report Definition Language Data Types
Other Resources
Report Definition Language Reference
Development (Reporting Services)