Defining the Data that Feeds the Report DataSet
The Report DataSet
Structure includes a root Report DataSet
Collection 
to which you can add as many items as needed:
• Report DataSet
Properties 
• Report DataSet
Collections
How to add items to the Report DataSet Definition
To add an item to the Report DataSet Definition, you add it from a Report DataSet Collection of the Definition.
E.g: from the Application Report DataSet Collection, add the "Application Code" MetaAttribute
The item is added to the structure under its parent Report DataSet Collection.
E.g.: the "Application Code" Report DataSet Property is added to the Report DataSet structure under the "Application" Report DataSet Collection.
How to proceed: the big picture
To define the data that feeds the Report DataSet you can add:
• Report DataSet Collections:
• directly from a Report DataSet Collection of the structure
• Report DataSet Properties:
• value-type Properties
• parameter-type Properties
• computed-type Properties
• collection count-type Properties
Adding a Report DataSet Collection
From the Report DataSet structure, you can add a Report DataSet Collection to a Report DataSet Collection (the root one or another one).
To add a Report DataSet Collection to the Report DataSet structure:
1. Access the Report DataSet Definition properties.
2. Display its Definition page.
The left pane displays the Report DataSet structure.
3. Hover the cursor over the
Report DataSet Collection,
click
and select
Report DataSet Collection:
4. In the Collection Provider section:
in the Collection is populated by drop-down list, select how to populate the Report DataSet Collection:
• MetaAssociationEnd and in the Target MetaClass select the MetaClass corresponding to the Collection you want to add and in the Populating MetaAssociationEnd drop-down list, select the MetaAssociationEnd.
The list includes available MetaAssociationEnds only, i.e. the MetaAssociationEnds of the parent Report DataSet Collection.
or
• Collection parameter and in the Populating Collection Parameter field, select the Collection parameter.
A Collection parameter is available if in the Report DataSet Definition
Characteristics tab, you added a
Collection Parameter,
see
Adding Collection parameters.
or
• Query and connect or create a query. In the Target MetaClass/Populating query drop-down lists select a MetaClass and its related query or click Connect Query to connect the query (else click New query to create a query).
The list includes only the queries related to the parent Report DataSet Collection.
If you created a Property parameter in the Report DataSet Definition
Characteristics tab (
see
Adding Property parameters ), you can use it in the query.
5. Click OK.
Adding a value-type Property to the Report DataSet structure
You can feed the Report DataSet with value-type properties, based on:
• a MetaAttribute
• a TaggedValue
From the Report DataSet structure, you can add a Property to a Report DataSet Collection of the structure.
To add a value-type Property to the Report DataSet structure:
1. Access the Report DataSet Definition properties.
2. Select Definition.
The left pane displays the Report DataSet structure.
3. Hover the cursor over the
Report DataSet Collection,
click
and select
Report DataSet Property:
• In the Property type field, select "Value".
• In the TaggedValue/MetaAtribute field, select the TaggedValue/MetaAttribute.
4. Click OK.
Adding a parameter-type Property to the Report DataSet structure
You can feed the Report DataSet with parameter-type Properties.
From the Report DataSet structure, you can add the Property to a Report DataSet Collection of the structure.
To add a parameter-type Property to the Report DataSet structure:
1. Access the Report DataSet Definition properties.
2. Select Definition.
The left pane displays the Report DataSet structure.
3. Hover the cursor over the
Report DataSet Collection,
click
and select
Report DataSet Property:
• In the Property type field, select "Parameter".
• In the MetaParameter field, select the MetaParameter.
A MetaParameter is available if in the Report DataSet Definition
Characteristics tab, you added a
Property Parameter,
see
Adding Property parameters.
4. Click OK.
Adding a computed-type Property to the Report DataSet structure
You can feed the Report DataSet with a computed-type Property. The Property is computed locally for the dataset. For this purpose you create a
computed Report DataSet Property from the
Report DataSet Collection using a macro.
To add a computed-type Property to the Report DataSet structure:
1. Access the Report DataSet Definition properties.
2. Select Definition.
The Report DataSet structure displays.
3. Right-click the Report DataSet Collection and select New> Report DataSet Property:
• In the Property type field, select "Computed".
• Define the MetaAttribute characteristics (Type, Length, Format)
• In the Implementation field, click the right oriented arrow and select Create Macro.
4. Click OK.
Adding a collection count-type Property to the Report DataSet structure
You can feed the Report DataSet with a collection count-type Property.
The Property is collected locally for the dataset, with the count of the collection retrieved from a query or a MetaAssociationEnd. As collected, the Property cannot be drag and drop. For this purpose you create a
collection count Report DataSet Property from the
Report DataSet Collection using a query or a MetaAssociationEnd.
To add a collection count-type Property to the Report DataSet structure:
1. Access the Report DataSet Definition properties.
2. Select Definition.
The Report DataSet structure displays.
3. Right-click the Report DataSet Collection and select New> Report DataSet Property.
4. In the Property type field, select "Collection count".
5. From the Counted Query (or Counted MetaAssociationEnd) field connect the query (or the MetaAssociationEnd).
