Get a query from a report
NBi is able to extract queries and stored procedures from SSRS reports (more precisely from report’s datasets) and use them in your tests. Other features related to queries’ execution are fully applicable to queries extracted from reports: you can definitively make usage of query’s parameters or query’s template-variables or query’s timeout.
The following section describe the syntax 1.0
To extract the queries or stored procedures from a report, you’ve two options: connect to a ReportingServer database through sql or parse a rdl file on a disk. In both cases, you need to specify the xml element report in place of the typical xml element query.
Before trying to define this attribute, you must understand that a report may contain more than one dataset. In consequence, it’s always needed to specify from which dataset you want to extract the query or stored procedure. This can be achieved by using the xml attribute named dataset in the xml element report.
NBi supports to extract queries from shared datasets. Independently of the way the dataset is created in the report (embedded or shared), NBi will retrieve the corresponding query or stored procedure. It’s not needed to adapt the test syntax, it’s transparent.
From ReportingServer database
To extract from a ReportingServer database, you must specify the source as the connection-string to connect to this ReportingServer database.
Don’t be confused with the attribute connectionString defining the database on which you will apply your query. This connection-string is optional and can be replaced by a default value or a reference specified in the settings.
Finally, you must define the report’s name by the means of the attributes path and name. The path is referencing the folder and sub-folder of the report and name it’s display name on the portal. Note that the leading and final slashes (“/”) on the path are mandatory.
From a rdl file on a disk
The difference with the ReportingServer database is expressed on the attribute source which must be unspecified. The path will be expressed from the test-suite file and will have a final back-slash (“").
From SSRS Web Service
Not supported for the moment, will be introduced with a future release.
Defaults and references
Since version 1.9, you can define in the defaults and references values for the attributes source and path. For defaults, these values will be used if no other value is provided in a test and for references, they will be used if the value provided in the test is equivalent to the name of the reference with an @.
The following code extracts the query from a report named Store*Contacts, in directory /AdventureWorks 2012/ hosted on a ReportingServer database. The query is available in the dataset named StoreContacts and NBi applies a value of 300 to the parameter named StoreID when executing the query on a database with a connectionString referenced in the default settings applying to a system-under-test.