Appendix B: Web Service Interface Reference

Reporting Services Web Service

Creating a Web Reference

To use a web service, you need to create code that knows how to send data to and retrieve data from that web service. Fortunately, this code is generated for you by Visual Studio through the process of creating a web reference. Once the web reference is in place, you can call the methods of the web service the same way you call the methods of a local .NET assembly.

Two web service interfaces are provided for Reporting Services: the ReportService2005 web service and the ReportExecution2005 web service. The ReportService2005 web service enables you to manage Reporting Services. The ReportExecution2005 web service lets you execute reports.

Here are the steps for creating a web reference:

1. In your Visual Basic .NET or C# project (not a Report project), right-click the project entry in the Solution Explorer and select Add Web Reference from the Context menu. The Add Web Reference dialog box appears.

2. Select the link for Web Services on the Local Machine.

3. When the list of web services on the local machine appears, click the link for ReportService2005 or ReportExecution2005.

4. When the “ReportingService2005” Description or “ReportExecutionService” Description appears in the dialog box, click Add Reference.

When you click the link for Web Services on the Local Machine, a URL beginning with http://localhost is used to locate the web services on the local machine. Because of this, the ReportService2005 web service uses localhost. ReportService2005 as its namespace and the ReportExecution2005 web service uses localhost.ReportExecution2005 as its namespace.

Credentials

Most ReportService2005 and ReportExecution2005 methods require logon credentials to be authenticated prior to their execution. This is accomplished by creating a network credential object and assigning it to the Credentials property of the web service object. In the following code, a logon is accomplished prior to the execution of the ListChildren method. The ListChildren method returns an array with one element for each report item found in the specified folder (the Home folder in this example). The array only contains those items the specified credentials have the right to view.

 Dim rs As localhost.ReportingService2005 Dim LogonCredentials As System.Net.NetworkCredential Dim items As localhost.CatalogItem() rs=New localhost.ReportingService LogonCredentials = New _    System.Net.NetworkCredential ("LogonName", "Password", "Domain") rs.Credentials = LogonCredential rs.PreAuthenticate = True items = rs.ListChildren("/", False)

Of course, if you were to use this sample code, you would need to replace LogonName, Password, and Domain with the appropriate logon name, password, and domain name for a valid domain logon. Also, this code sample assumes you created a web reference to the ReportService2005 web service called ReportingService2005, as described in the previous section.

When the PreAuthenticate property is true, the credentials are sent with the first web service request. When the PreAuthenticate property is false, the credentials are not sent to the server until the server issues an authentication challenge. In other words, when the PreAuthenticate property is false, the credentials are not sent to the server until the server requires a login. Setting the PreAuthenticate property to true can save one roundtrip between the server and the client, but as long as you have the Credentials property initialized to a valid logon, either setting for the PreAuthenticate property (true or false) works.

Code Sample

Unfortunately, space restrictions prevent the inclusion of code samples for each of the ReportService2005 and ReportExecution2005 web service properties, methods, and classes. A sample program incorporating all these items is available for download from the web page for this book. Go to http://www.osborne.com and locate the book’s page using the ISBN 0072262397.

ReportExecution2005 Properties

The ReportExecution2005 class inherits from the HttpWebClientProtocol class, the SoapHttpClientProtocol class, and the WebClientProtocol class. The following public properties are defined in the ReportExecution2005 class itself.

ExecutionHeaderValue

Description: This property holds information about the state of the current Report Server session. This state information is contained in an Execution-Header object. The ExecutionHeader inherits from the SoapHeader object.

ServerInfoHeaderValue

Description: This property holds information about the current version of the Report Server.

ReportExecution2005 Methods

The ReportExecution2005 class inherits from the HttpWebClientProtocol class, the SoapHttpClientProtocol class, and the WebClientProtocol class. The following public methods are defined in the ReportExecution2005 class itself.

GetDocumentMap

Description: This method returns a representation of the document map for the execution. This method returns a DocumentMapNode object.

Parameters: None

GetExecutionInfo

Description: This method returns information about the report execution. This method returns an ExecutionInfo object.

Parameters: None

GetRenderResource

Description: This method gets a resource for the specified rendering extension. This method returns a byte array containing a base-64 encoding of the requested resource.

Parameters:

Name	Type	Description
Format	String	The rendering extension format (for example, PDF or XML).
DeviceInfo	String	A device-specific setting for the specified rendering format.
MimeType	String	The MIME type of the resource. (This parameter must be called ByRef.)

ListRenderingExtensions

Description: This method lists the rendering extension formats available on this Report Server. This method returns an array of Extension objects.

Parameters: None

ListSecureMethods

Description: This method lists the ReportExecution2005 web service methods that require a secure connection. This method returns an array of strings containing the method names.

Parameters: None

LoadDrillthroughTarget

Description: This method creates a report execution from a drillthrough from the current execution to a new report. This method returns an ExecutionInfo object.

Parameters:

Name	Type	Description
DrillthroughID	String	The ID of the item that is the target of the drillthrough.

LoadReport

Description: This method creates a new execution from a report on the Report Server. This method returns an ExecutionInfo object.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report to load.
HistoryID	String	The ID of the history snapshot from which to render the report. (Set this to Nothing if the report should not be rendered from a history snapshot.)

LoadReportDefinition

Description: This method creates a report execution from a report definition supplied by the client. This method returns an ExecutionInfo object.

Parameters:

Name	Type	Description
Definition	Array of Bytes	The Report Definition Language (RDL) defining the new report in base-64 binary.
Warnings	Array of Warning Objects	A list of warnings generated when the report definition was loaded. (This parameter must be called ByRef.)

Logoff

Description: This method logs off the current user making requests of the ReportExecution2005 web service. This method must be called using an HTTPS (SSL) request. This method does not return a value.

Parameters: None

LogonUser

Description: This method logs a user on to the ReportExecution2005 web service. This method does not return a value.

Parameters:

Name	Type	Description
UserName	String	The user name to use for the log on.
Password	String	The password to use for the log on.
Authority	String	The authority to use when authenticating this user. This parameter is optional.

NavigateBookmark

Description: This method navigates to a specified bookmark. This method returns an integer that corresponds to the bookmark ID. This method returns zero if the specified bookmark ID is invalid or is not found.

Parameters:

Name	Type	Description
BookmarkID	String	The ID of the bookmark to navigate to.
UniqueName	String	The unique name of the report item pointed to by the bookmark. (This parameter must be called ByRef.)

NavigateDocumentMap

Description: This method navigates to a specified document map entry. This method returns an integer that corresponds to the document map ID. This method returns zero if the specified document map ID is invalid or is not found.

Parameters:

Name	Type	Description
DocMapID	String	The ID of the document map entry to navigate to.

Render

Description: This method renders the specified report. This method returns a byte array containing the rendered report.

Parameters:

Name	Type	Description
Format	String	The rendering format to be used.
DeviceInfo	String	An XML structure to control the behavior of the renderer.
MimeType	String	The MIME type of the rendered report. (This parameter must be called ByRef.)
Encoding	String	The encoding used for the contents of the report. (This parameter must be called ByRef.)
Warnings	An Array of Warning Objects	An array containing any warnings that resulted from the rendering of the report. (This parameter must be called ByRef.)
StreamIDs	String	A stream identifier used by the RenderStream method. This is used to render an external resource such as an image. (This parameter must be called ByRef.)

RenderStream

Description: This method obtains the contents of an external resource used by a rendered report. This method returns a byte array containing the external resource.

Parameters:

Name	Type	Description
Format	String	The rendering format to be used.
StreamID	String	The ID of the stream for the main report.
Encoding	String	The encoding used for the contents of the report. (This parameter must be called ByRef.)
MimeType	String	The MIME type of the rendered report. (This parameter must be called ByRef.)

ResetExecution

Description: This method resets the current execution. This method returns an ExecutionInfo object.

Parameters: None

SetExecutionCredentials

Description: This method sets the credentials associated with the current execution. This method returns an ExecutionInfo object.

Parameters:

Name	Type	Description
Credentials	Array of DataSourceCredentails Objects	The credentials to set.

SetExecutionParameters

Description: This method sets the parameter property for the current execution. This method returns an ExecutionInfo object.

Parameters:

Name	Type	Description
Parameters	An Array of ReportParameter Objects	An array of information on report parameter properties.
ParameterLanguage	String	The language and culture identifier for the parameter (for example, “en-us”).

Sort

Description: This method applies or removes a sort based on user action. This method returns an integer providing the page number where the item indicated by the ReportItem parameter now falls.

Parameters:

Name	Type	Description
SortItem	String	The ID of the item.
Direction	SortDirectionEnum	The direction of the sort. Valid values are Ascending, Descending, and None.
Clear	Boolean	True if all other sorts on this item should be cleared.
ReportItem	String	The ID of the item on the page being used to position the view. (This parameter must be called ByRef.)
NumPages	Integer	The new total number of pages after the sort.

ToggleItem

Description: This method toggles the show/hide property of a report item. This method returns a Boolean that is true if the item is found.

Parameters:

Name	Type	Description
Toggle ID	String	ID of the report item to toggle.

ReportService2005 Properties

The ReportService2005 class inherits from the HttpWebClientProtocol class, the SoapHttpClientProtocol class, and the WebClientProtocol class. The following public properties are either inherited properties used in the code samples in this book or properties defined in the ReportService2005 class itself.

BatchHeaderValue

Description: This property is used to hold a unique, system-generated batch ID. This batch ID serves to group multiple method calls from the ReportService2005 web service into a single batch. The batch ID is created by calling the CreateBatch method. The batch is committed by calling the ExecuteBatch method. The batch is rolled back by calling the CancelBatch method.

Credentials

Description: This property is used to hold the logon credentials used by the client application to authenticate on the ReportService2005 web service. Most ReportService2005 methods require authentication before they execute.

ItemNamespaceHeaderValue

Description: This property determines how items are retrieved with the GetProperties method. Items can be retrieved by passing an item identifier or the full path of the item.

PreAuthenticate

Description: When the PreAuthenticate property is true, the credentials are sent with the first web service request. When the PreAuthenticate property is false, the credentials are not sent to the server until the server issues an authentication challenge.

ServerInfoHeaderValue

Description: This property holds information about the current version of the Report Server.

ReportService2005 Methods

The ReportService2005 class inherits from the HttpWebClientProtocol class, the SoapHttpClientProtocol class, and the WebClientProtocol class. The following public methods are defined in the ReportService2005 class itself.

CancelBatch

Description: This method cancels the current batch of ReportService2005 method calls. The current batch is specified by the BatchHeader object and must be assigned to the BatchHeader Value property of the ReportingService object. If the batch is cancelled, none of the method calls in the batch are executed.

This method does not return a value.

Parameters: None

CancelJob

Description: This method cancels an executing job. This method returns true if the job was cancelled; otherwise, it returns false.

Parameters:

Name	Type	Description
JobID	String	The ID of the job to cancel.

CreateBatch

Description: This method creates a batch ID that can be used to group ReportService2005 method calls into a batch. If an error occurs in one of the method calls in the batch, all previous operations performed by the batch are rolled back and subsequent operations are not attempted. This is useful when you have one ReportingService method call that depends on the successful completion of a prior ReportingService method call. For instance, you may call the CreateFolder method to create a new folder, and then call the CreateReport method to create a report in your new folder. You do not want to attempt to create the report if the folder cannot be created.

This method returns a batch ID string. This batch ID must be assigned to the batchID property of a BatchHeader object. The BatchHeader object must be assigned to the BatchHeaderValue property of the ReportService2005 object. The methods in the batch are not executed until the ExecuteBatch method is called to commit the batch.

Parameters: None

CreateDataDrivenSubscription

Description: This method creates a data-driven subscription for a report. This method returns a string containing the subscription ID.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report to which to subscribe.
ExtensionSettings	ExtensionSettings Object	An object containing the settings for the delivery extension (for example, e-mail delivery) used by this subscription.
DataRetrievalPlan	DataRetrievalPlan Object	An object containing the information necessary to connect to and retrieve the data used for the datadriven subscription.
Description	String	The description of this subscription.
EventType	String	Either TimedSubscription for a subscription triggered by a schedule or SnapshotUpdated for a subscription triggered by the updating of a snapshot.
MatchData	String	Information used to implement the event type.
Parameters	An Array of ParameterValue OrFieldReference Objects	An array of the values used for the report’s parameters.

CreateDataSource

Description: This method creates a new shared data source. This method does not return a value.

Parameters:

Name	Type	Description
DataSource	String	The name of the data source.
Overwrite	Boolean	True if this data source should overwrite an existing data source; otherwise, false.
Parent	String	The path to the folder where the shared data source is created.
Definition	DataSourceDefinition Object	An object containing the connection information for the shared data source.
Properties	An Array of Property Objects	An array of property settings for the shared data source.

CreateFolder

Description: This method creates a new Reporting Services folder in the specified folder. This method does not return a value.

Parameters:

Name	Type	Description
Folder	String	The name of the new folder.
Parent	String	The path to the folder where the new folder is created.
Properties	An Array of Property Objects	An array of property settings for the folder.

CreateLinkedReport

Description: This method creates a new linked report in the specified folder. This method does not return a value.

Parameters:

Name	Type	Description
Report	String	The name of the new linked report.
Parent	String	The path to the folder where the new linked report is created.
Link	String	The folder path and name of the report to which the new linked report should be linked.
Properties	An Array of Property Objects	An array of property settings for the new linked report.

CreateModel

Description: This method creates a model for use with the Report Builder. This method returns an array of Warning objects.

Parameters:

Name	Type	Description
Model	String	The name of the new model.
Parent	String	The path to the folder where the new model is created.
Definition	An Array of Bytes	The model definition of this model.
Properties	An Array of Property Objects	The properties of this model.

CreateReport

Description: This method creates a new report in the specified folder. This method returns an array of Warning objects.

Parameters:

Name	Type	Description
Report	String	The name of the new report.
Parent	String	The path to the folder where the new report is created.
Overwrite	Boolean	True if an existing report with the same name in the same folder is to be replaced with the new report; otherwise, false.
Definition	An Array of Bytes	The Report Definition Language (RDL) defining the new report in base-64 binary.
Properties	An Array of Property Objects	An array of property settings for the report.

CreateReportHistorySnapshot

Description: This method creates a history snapshot of a specified report. The snapshot is created immediately, not at a scheduled time. This method call fails if report history is not enabled for the specified report.

This method returns a string representing the data and time at which the history snapshot was created.

Parameters:

Name	Type	Description
Report	String	The Reporting Services folder and the name of the report from which the history snapshot is created.
Warnings	An Array of Warning Objects	An array of warning messages generated when creating this report history snapshot. (This parameter must be called ByRef.)

CreateResource

Description: This method creates a new resource entry in the specified folder. This method does not return a value.

Parameters:

Name	Type	Description
Resource	String	The name of the new resource.
Parent	String	The path to the folder where the new resource is created.
Overwrite	Boolean	True if an existing resource with the same name in the same folder is to be replaced with the new resource; otherwise, false.
Contents	An Array of Bytes	The contents of the resource in base-64 binary.
MimeType	String	The MIME type of the resource (260 characters maximum).
Properties	An Array of Property Objects	An array of property settings for the resource.

CreateRole

Description: This method creates a new Reporting Services security role. This method does not return a value.

Parameters:

Name	Type	Description
Name	String	The name of the new role.
Description	String	The description of the new role.
Tasks	An Array of Task Objects	An array of Reporting Services tasks that may be executed by this role.

CreateSchedule

Description: This method creates a new shared schedule. This method returns a string containing the schedule ID.

Parameters:

Name	Type	Description
Name	String	The name of the schedule.
ScheduleDefinition	ScheduleDefinition Object	An object containing the information necessary to define a schedule.

CreateSubscription

Description: This method creates a new subscription for a report. This method returns a string containing the subscription ID.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report to which to subscribe.
ExtensionSettings	ExtensionSettings Object	An object containing the settings for the delivery extension (for example, e-mail delivery) used by this subscription.
Description	String	The description of this subscription.
EventType	String	Either TimedSubscription for a subscription triggered by a schedule or SnapshotUpdated for a subscription triggered by the updating of a snapshot.
MatchData	String	Information used to implement the event type.
Parameters	An Array of ParameterValue Objects	An array of the values used for the report’s parameters.

DeleteItem

Description: This method removes an item from a Reporting Services folder. This can be a report, a resource, a shared data source, or a Reporting Services folder. If a report is deleted, any subscriptions and snapshots associated with that report are also deleted. This method does not return a value.

You cannot use this method to delete the My Reports folder or the Users folders created when the My Reports option is enabled.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the item to be deleted.

DeleteReportHistorySnapshot

Description: This method removes a specified history snapshot. This method does not return a value.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report from which the history snapshot is to be deleted.
HistoryID	String	The ID of the history snapshot to delete.

DeleteRole

Description: This method removes a Reporting Services security role. This also removes all security assignments involving the deleted security role. This method does not return a value.

Parameters:

Name	Type	Description
Name	String	The name of the security role to delete.

DeleteSchedule

Description: This method removes a shared schedule. In addition, any snapshots or subscriptions using this schedule are also deleted. This method does not return a value.

Parameters:

Name	Type	Description
Scheduled	String	The schedule ID of the schedule to delete.

DeleteSubscription

Description: This method removes a subscription from a report and it does not return a value.

Parameters:

Name	Type	Description
SubscriptionID	String	The subscription ID of the subscription to delete.

DisableDataSource

Description: This method disables a shared data source. Any reports and data-driven subscriptions that use this shared data source will not execute. This method does not return a value.

Parameters:

Name	Type	Description
DataSource	String	The folder path and name of the shared data source to be disabled.

EnableDataSource

Description: This method enables a shared data source and it does not return a value.

Parameters:

Name	Type	Description
DataSource	String	The folder path and name of the shared data source to be enabled.

ExecuteBatch

Description: This method executes all method calls associated with the current batch. (See the CreateBatch method.) The method calls in the batch are not executed until the ExecuteBatch method is called. This method does not return a value.

Parameters: None

FindItems

Description: This method finds reports, resources, shared data sources, and folders whose name or description satisfies the search conditions. The contents of the specified folder and all the folders contained within that folder are searched. This method returns an array of CatalogItem objects that satisfy the search conditions.

Parameters:

Name	Type	Description
Folder	String	The folder path and name of the folder that serves as the root of the search.
BooleanOper BooleanOperator	BooleanOperatorEnum	Either AND if all the search conditions must be true; otherwise, OR if only one of the search conditions must be true.
Conditions	An Array of SearchCondition Objects	An array containing the search conditions.

FireEvent

Description: This method triggers a Reporting Services event. You can use the ListEvents method to get an array of valid events and their parameters. This method does not return a value.

Parameters:

Name	Type	Description
EventType	String	The name of the event.
EventData	String	The values for the parameters associated with this event.

FlushCache

Description: This method clears any cached copies of the specified report. This includes cached copies created both by caching and by execution snapshots. It does not clear history snapshots. This method does not return a value.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose cache is to be flushed.

GetCacheOptions

Description: This method checks whether there is a cached copy of the specified report. If a cached copy of the report exists, the expiration time or the scheduled expiration information for the cached copy is returned in the Item parameter. This method returns a Boolean, which is true if caching is enabled for the report; otherwise, it returns false.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose cache options are to be checked.
Item	ExpirationDefinition Object	An object containing the expiration information for the cached copy of the report. (This parameter must be called ByRef.)

GetDataDrivenSubscriptionProperties

Description: This method gets information from the specified data-driven subscription. The data-driven subscription information is returned in several reference parameters. This method returns a string containing the ID of the owner of the specified data-driven subscription.

Parameters:

Name	Type	Description
DataDrivenSubscriptionID	String	The data-driven subscription ID of the data-driven subscription whose information is to be returned.
ExtensionSettings	ExtensionSettings Object	An object containing the extension settings. (This parameter must be called ByRef.)
DataRetrievalPlan	DataRetrievalPlan Object	An object containing the data source and query used to select data for the data-driven subscription. (This parameter must be called ByRef.)
Description	String	The description of the data-driven subscription. (This parameter must be called ByRef.)
Active	ActiveState Object	An object containing the active state of the data-driven subscription. (This parameter must be called ByRef.)
Status	String	The status of the data-driven subscription. (This parameter must be called ByRef.)
EventType	String	The event type associated with the data-driven subscription. (This parameter must be called ByRef.)
MatchData	String	The parameter data for the event type associated with the data-driven subscription. (This parameter must be called ByRef.)
Parameters	An Array of ParameterValueOrFieldReference Objects	An array of parameter information for the report associated with the data-driven subscription. (This parameter must be called ByRef.)

GetDataSourceContents

Description: This method gets the information for the specified shared data source. This method returns a DataSourceDefinition object containing the information for the shared data source.

Parameters:

Name	Type	Description
DataSource	String	The folder path and name of the shared data source whose information is to be returned

GetExecutionOptions

Description: This method gets the execution options for the specified report. This method returns an ExecutionSettingEnum value of either Live, indicating the report is to be executed, or Snapshot, indicating the report is to be rendered from a history snapshot.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose execution option is to be returned.
Item	ScheduleDefinitionOrReference Object	An object containing a schedule definition or a reference to a shared schedule. (This parameter must be called ByRef.)

GetExtensionSettings

Description: This method gets the parameter information for the specified delivery extension. This method returns an array of ExtensionParameter objects containing the parameter information.

Parameters:

Name	Type	Description
Extension	String	The name of the delivery extension.

GetltemDataSourcePrompts

Description: This method gets the prompt strings for all the data sources tied to the specified item. This method returns an array of DataSourcePrompt objects.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the item whose data source prompts are to be returned.

GetItemDataSources

Description: This method gets the data sources tied to the specified item. This method returns an array of DataSource objects.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the item whose data sources are to be returned.

GetItemType

Description: This method gets the type of the specified Reporting Services item. This method returns an ItemTypeEnum value, as shown here:

Value	Description
Unknown	Invalid Item Path or Item of Unknown Type.
Folder	This item is a folder.
Report	This item is a report.
Resource	This item is a resource.
LinkedReport	This item is a linked report.
DataSource	This item is a shared data source.
Model	This item is a report model.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the item whose type is to be returned.

GetModelDefinition

Description: This method gets the definition of the specified model. This method returns an array of bytes.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model whose definition is to be returned.

GetModelItemPermissions

Description: This method gets the permissions associated with the specified model item. This method returns an array of strings.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model that contains the item whose permissions are to be returned.
ModelItemID	String	The ID of the model item whose permissions are to be returned. If omitted, the permissions of the model root are returned.

GetModelItemPolicies

Description: This method gets the Reporting Services security policies associated with the specified model item. This method returns an array of Policy objects.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model that contains the item whose policies are to be returned.
ModelItemID	String	The ID of the model item whose policies are to be returned. If omitted, the policies of the model root are returned.
InheritParent	Boolean	True if the policies are inherited from the parent folder; otherwise, false. (This parameter must be called ByRef.)

GetPermissions

Description: This method gets the tasks that may be executed on the specified Reporting Services item by the logon credentials currently being used to access the ReportService2005 web service. This method returns an array of strings, with each string containing the name of one task the logon credentials have permission to execute.

Parameters:

Name	Type	Description
Item	String	The folder path and the name of the item whose permissions are to be returned.

GetPolicies

Description: This method gets the Reporting Services security policies associated with the specified Reporting Services item and returns an array of Policy objects.

Parameters:

Name	Type	Description
Item	String	The folder path and the name of the item whose policies are to be returned.
InheritParent	Boolean	True if the policies are inherited from the parent folder; otherwise, false. (This parameter must be called ByRef.)

GetProperties

Description: This method gets the values of each specified property of the Reporting Services item and returns an array of Property objects.

Parameters:

Name	Type	Description
Item	String	The folder path and the name of the item whose properties are to be returned.
Properties	An Array of Property Objects	An array of the properties whose values you want returned.

GetRenderResource

Description: This method gets a resource for the specified rendering extension. This method returns a byte array containing a base-64 encoding of the requested resource.

Parameters:

Name	Type	Description
Format	String	The rendering extension format (for example, PDF or XML).
DeviceInfo	String	A device-specific setting for the specified rendering format.
MimeType	String	The MIME type of the resource. (This parameter must be called ByRef.)

GetReportDefinition

Description: This method gets the definition for the specified report and returns a byte array with the report definition as a base-64-encoded RDL structure.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose definition is to be returned.

GetReportHistoryLimit

Description: This method gets the maximum number of history snapshots that may be saved for the specified report. This method returns an integer representing the history snapshot limit.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose snapshot history limit is to be returned.
IsSystem	Boolean	True if the report history snapshot limit comes from the system limit; otherwise, false. (This parameter must be called ByRef.)
SystemLimit	Integer	The system limit for report history snapshots. (This parameter must be called ByRef.)

GetReportHistoryOptions

Description: This method gets the report history snapshot options and properties for the specified report. This method returns a Boolean value that is true if a history snapshot is enabled and, otherwise, is false.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose snapshot history options are to be returned.
KeepExecutionSnapshots	Boolean	True if a history snapshot is enabled; otherwise, false. (This parameter must be called ByRef.)
Item	ScheduleDefinitionOrReference Object	An object that contains information about a schedule definition or a reference to a shared schedule used to create the history snapshot. (This parameter must be called ByRef.)

GetReportLink

Description: This method gets the name of the report to which the specified linked report is tied. This method returns a string containing the folder path and the name of the report.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the linked report whose underlying report is to be returned.

GetReportParameters

Description: This method gets the report parameter properties for the specified report. This method returns an array of ReportParameter objects.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose parameter properties are to be returned.
HistoryID	String	Set this parameter to a history ID to retrieve the parameters for a history snapshot; otherwise, set it to Nothing (Null for C#).
ForRendering	Boolean	Set this parameter to true to return the parameter properties used during the creation of the specified history snapshot; otherwise, set it to false.
Values	An Array of ParameterValue Objects	An array of the values to be validated for the report.
Credentials	An Array of DataSourceCredentials Objects	An array specifying data source credentials to be used when validating parameters.

GetResourceContents

Description: This method gets the contents of a Reporting Services resource and returns a byte array containing the base-64-encoded contents of the resource.

Parameters:

Name	Type	Description
Resource	String	The folder path and name of the resource whose contents are to be returned.
MimeType	String	The MIME type of the resource. (This parameter must be called ByRef.)

GetRoleProperties

Description: This method gets a description of the specified role, along with the tasks this role is able to complete. This method returns an array of Task objects.

Parameters:

Name	Type	Description
Name	String	The name of the role whose description and tasks are to be returned.
Description	String	The description of the role. (This parameter must be called ByRef.)

GetScheduleProperties

Description: This method gets the properties of the specified shared schedule. This method returns a Schedule object.

Parameters:

Name	Type	Description
Scheduled	String	The schedule ID of the schedule to be returned.

GetSubscriptionProperties

Description: This method gets the properties of the specified subscription. This method returns a string containing the ID of the owner of this subscription.

Parameters:

Name	Type	Description
SubscriptionID	String	The subscription ID of the subscription whose properties are to be returned.
ExtensionSettings	An ExtensionSettings Object	An object containing the settings for the delivery extension associated with this subscription. (This parameter must be called ByRef.)
Description	String	The description of the subscription. (This parameter must be called ByRef.)
Active	An ActiveState Object	An object containing the active state of the subscription. (This parameter must be called ByRef.)
Status	String	The status of the subscription. (This parameter must be called ByRef.)
EventType	String	Either TimedSubscription for a subscription triggered by a schedule or SnapshotUpdated for a subscription triggered by the updating of a snapshot. (This parameter must be called ByRef.)
MatchData	String	Information used to implement the event type. (This parameter must be called ByRef.)
Parameters	An Array of ParameterValue Objects	An array of the values used for the report’s parameters. (This parameter must be called ByRef.)

GetSystemPermissions

Description: This method gets the system permissions assigned to the logon credentials currently being used to access the ReportService2005 web service. This method returns an array of strings that contain the system permissions.

Parameters: None

GetSystemPolicies

Description: This method gets the system policy for this Reporting Services installation. This method returns an array of Policy objects.

Parameters: None

GetSystemProperties

Description: This method gets the value of each specified system property. This method returns an array of Property objects.

Parameters:

Name	Type	Description
Properties	An Array of Property Objects	An array of properties and their values.

GetUserModel

Description: This method gets the semantic portion of a model for which the current user has access permission. This method returns an array of bytes.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model whose user model is to be retrieved.
Perspective	String	The ID of the perspective whose user model is to be retrieved.

InheritModelItemParentSecurity

Description: This method sets the mode to inherit its security from its parent. As a result, any policies assigned specifically for this model are deleted. This method does not return a value.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model that contains the item whose policies are to be inherited.
ModelItemID	String	The ID of the model item whose policies are to be inherited.

InheritParentSecurity

Description: This method sets the Reporting Services item to inherit its security from its parent folder. As a result, any role assignments made specifically for this item are deleted. This method does not return a value.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the item whose security is to be inherited.

ListChildren

Description: This method lists all the Reporting Services items that are children of the specified folder. The list includes only those items that the logon credentials currently being used to access the ReportService2005 web service have a right to view. This method returns an array of CatalogItem objects.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the folder whose children are to be listed.
Recursive	Boolean	True if the list should recurse down the folder tree; otherwise, false.

ListDependentItems

Description: This method lists all the Reporting Services items dependent on the specified item. This method returns an array of CatalogItem objects.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the folder whose dependants are to be listed.

ListEvents

Description: This method lists the events supported by this Reporting Services installation and returns an array of Event objects.

Parameters: None

ListExtensions

Description: This method lists the extensions of the specified type defined for this Reporting Services installation. It returns an array of Extension objects.

Parameters:

Name	Type	Description
ExtensionType	ExtensionTypeEnum	Either Delivery for delivery extensions, Render for rendering extensions, Data for data access extensions, or All for all of the above.

ListJobs

Description: This method lists the jobs currently running on this Reporting Services installation and returns an array of Job objects.

Parameters: None

ListModelDrillthroughReports

Description: This method lists the reports tied to a specific entity in a model. It also returns an array of ModelDrillthroughReport objects.

Parameters:

Name	type	Description
Model	String	The folder path and name of the model that contains the item whose drillthrough reports are to be listed.
ModelItemID	String	The ID of the model item whose drillthrough reports are to be listed.

ListModelItemChildren

Description: This method lists all the children of the specified model item. This method returns an array of ModelItem objects.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model that contains the item whose children are to be listed.
ModelItemID	String	The ID of the model item whose children are to be listed. If omitted, the children of the model root of the model are listed.
Recursive	Boolean	True if the list should recurse through the model tree; otherwise, false.

ListModelPerspective

Description: This method lists the perspectives of the specified model and it returns an array of ModelCatalogItem objects.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model whose perspectives are to be listed.

ListReportHistory

Description: This method lists the history snapshots and their properties for the specified report. It also returns an array of ReportHistorySnapshot objects.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose history snapshots are to be listed.

ListRoles

Description: This method lists the roles defined for this Reporting Services installation. This method returns an array of Role objects.

Parameters:

Name	Type	Description
SecurityScope	SecurityScopeEnum	The security scope of the roles to be listed. Valid values are All, Catalog, Model, and System.

ListScheduledReports

Description: This method lists the reports using the specified shared schedule and returns an array of CatalogItem objects.

Parameters:

Name	Type	Description
ScheduleID	String	The schedule ID of the shared schedule whose reports are to be listed.

ListSchedules

Description: This method lists all the shared schedules and returns an array of Schedule objects.

Parameters: None

ListSecureMethods

Description: This method lists all the ReportService2005 web service methods that require a secure connection. This method returns an array of strings containing the method names.

Parameters: None

ListSubscriptions

Description: This method lists the subscriptions a specified user has created for a specified report. It also returns an array of Subscription objects.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose subscriptions are to be listed.
Owner	String	The name of the owner whose subscriptions are to be retrieved.

ListSubscriptionsUsingDataSource

Description: This method lists the subscriptions using the specified shared data source and returns an array of Subscription objects.

Parameters:

Name	Type	Description
DataSource	String	The folder path and name of the shared data source whose subscriptions are to be listed.

ListTasks

Description: This method lists the tasks defined for this Reporting Services installation and returns an array of Task objects.

Parameters:

Name	Type	Description
SecurityScope	SecurityScopeEnum	The security scope of the tasks to be listed. Valid values are All, Catalog, Model, and System.

Logoff

Description: This method logs off the current user making requests of the ReportService2005 web service. It must be called using an https (SSL) request. This method does not return a value.

Parameters: None

LogonUser

Description: This method logs a user on to the Report Server web service. It does not return a value. An authentication cookie is passed back in the header of the https request.

Parameters:

Name	Type	Description
UserName	String	The user name to use for the log on.
Password	String	The password to use for the log on.
Authority	String	The authority to use when authenticating this user. This parameter is optional.

MoveItem

Description: This method moves the specified Reporting Services item to the specified folder path. It does not return a value.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the item to be moved.
Target	String	The folder path to which this item is to be moved.

PauseSchedule

Description: This method pauses the execution of the specified schedule. It does not return a value.

Parameters:

Name	Type	Description
ScheduleID	String	The ID of the schedule to pause.

PrepareQuery

Description: This method determines the fields to be returned by the specified query running against the specified data source. This information can be used by the CreateDataDrivenSubscription and SetDataDrivenSubscriptionProperties methods. This method returns a DataSetDefinition object.

Parameters:

Name	Type	Description
DataSource	DataSource Object	An object containing the data source information.
DataSet	DataSetDefinition Object	An object containing the query to return the fields for the data-driven subscription.
Changed	Boolean	True if the dataset passed in the DataSet parameter is different from the dataset returned in the DataSetDefinition object; otherwise, false. (This parameter must be called ByRef.)

RemoveAllModelItemPolicies

Description: This method deletes all policies associated with the items in the specified model. It does not return a value.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model.

ResumeSchedule

Description: This method resumes a schedule that has been paused. It does not return a value.

Parameters:

Name	Type	Description
ScheduleID	String	The ID of the schedule to resume.

SetCacheOptions

Description: This method sets the caching options for the specified report. It does not return a value.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose caching options are to be set.
CacheReport	Boolean	True if each execution of the report is to be cached; otherwise, false.
Item	ExpirationDefinition Object	An object containing information telling when the cached report is to expire.

SetDataDrivenSubscriptionProperties

Description: This method sets the properties of a data-driven subscription. It does not return a value.

Parameters:

Name	Type	Description
DataDrivenSubscriptionID	String	The ID of the data-driven subscription whose properties are to be set.
ExtensionSettings	ExtensionSettings Object	An object containing the settings for the delivery extension (for example, e-mail delivery) used by this subscription.
DataRetrievalPlan	DataRetrievalPlan Object	An object containing the information necessary to connect to and retrieve the data used for the data-driven subscription.
Description	String	The description of this subscription.
EventType	String	Either TimedSubscription for a subscription triggered by a schedule or SnapshotUpdated for a subscription triggered by the updating of a snapshot.
MatchData	String	Information used to implement the event type.
Parameters	An Array of ParameterValue OrFieldReference Objects	An array of the values used for the report’s parameters.

SetDataSourceContents

Description: This method sets the properties of a shared data source. It does not return a value.

Parameters:

Name	Type	Description
DataSource	String	The name of the data source.
Definition	DataSourceDefinition Object	An object containing the connection information for the shared data source.

SetExecutionOptions

Description: This method sets the execution options (either Live or Snapshot) of the specified report. It does not return a value.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose execution option is to be set.
ExecutionSetting	ExecutionSettingEnum	Either Live if the report is to be executed from the data sources or Snapshot if the report is to come from an execution snapshot.
Item	ScheduleDefinitionOrReference Object	An object containing the information for a schedule or a reference to a shared schedule. This schedule is used to create the execution snapshot and is valid only if the ExecutionSetting is Snapshot.

SetItemDataSources

Description: This method sets the properties for data sources associated with the specified item. It does not return a value.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the item for which the data source properties are to be set.
DataSources	An Array of DataSource Objects	An array of data sources and their properties.

SetModelDefinition

Description: This method sets the model definition of the specified model. This method returns an array of Warning objects containing any warning messages that may result from this operation.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model for which the model definition is to be set.
Definition	An Array of Bytes	A byte array containing the model definition in base-64 binary.

SetModelDrillthroughReports

Description: This method associates a set of drill-through reports with the specified model. It does not return a value.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model.
ModelItemID	String	The ID of the model item.
Reports	Array of ModelDrillthroughReport Objects	The drillthrough reports to set for the model item.

SetModelItemPolicies

Description: This method sets the security policies for the specified model item. It does not return a value.

Parameters:

Name	Type	Description
Model	String	The folder path and name of the model.
ModelItemID	String	The ID of the model item.
Policies	An Array of Policy Objects	An array of security policy information.

SetPolicies

Description: This method sets the security policies for the specified report. It does not return a value.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the Reporting Services item for which the security policies are to be set.
Policies	An Array of Policy Objects	An array of security policy information.

SetProperties

Description: This method sets the properties of the specified Reporting Services item. This method does not return a value.

Parameters:

Name	Type	Description
Item	String	The folder path and name of the Reporting Services item for which the properties are to be set.
Properties	An Array of Property Objects	An array of properties and their values.

SetReportDefinition

Description: This method sets the report definition of the specified report. It returns an array of Warning objects containing any warning messages that may result from this operation.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report for which the report definition is to be set.
Definition	An Array of Bytes	A byte array containing the Report Definition Language (RDL) in base-64 binary.

SetReportHistoryLimit

Description: This method sets the limit for the number of history snapshots that may be saved for the specified report. It does not return a value.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report for which the history snapshot limit is to be set.
UseSystem	Boolean	True if the system default history snapshot limit is to be used with this report; otherwise, false.
HistoryLimit	Integer	The limit for the number of history snapshots saved for this report.

SetReportHistoryOptions

Description: This method sets the options specifying when a history snapshot is created for the specified report. This method does not return a value.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report for which the history snapshot options are to be set.
EnableManualSnapshotCreation	Boolean	True if snapshots can be created using the CreateReportHistorySnapshot method; otherwise, false.
KeepExecutionSnapshots	Boolean	True if execution snapshots are saved as history snapshots; otherwise, false.
Item	ScheduleDefinitionOrReference Object	An object containing the information for a schedule or a reference to a shared schedule. This schedule is used to create the history snapshot.

SetReportLink

Description: This method sets the report to which the specified linked report should be linked. It does not return any value.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the linked report.
Link	String	The folder path and name of the report to which this should be linked.

SetReportParameters

Description: This method sets the parameter property for the specified report. It does not return a value.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose parameter property should be set.
Parameters	An Array of ReportParameter Objects	An array of information on report parameter properties.

SetResourceContents

Description: This method sets the contents of a Reporting Services resource. It does not return a value.

Parameters:

Name	Type	Description
Resource	String	The folder path and name of the resource whose contents are to be set.
Contents	An Array of Bytes	The contents of the resource in base-64 binary.
MimeType	String	The MIME type of the resource. This is optional and is returned through an out parameter.

SetRoleProperties

Description: This method sets the properties of a security role. This method does not return a value.

Parameters:

Name	Type	Description
Name	String	The folder path and name of the security role whose properties are to be set.
Description	String	The description of the security role.
Tasks	An Array of Task Objects	An array of Reporting Services tasks that may be executed by this role.

SetScheduleProperties

Description: This method sets the properties of a shared schedule. It does not return a value.

Parameters:

Name	Type	Description
Name	String	The name of the shared schedule.
Scheduled	String	The ID of the shared schedule whose properties are to be set.
ScheduleDefinition	ScheduleDefinition Object	An object containing the information necessary to define a schedule.

SetSubscriptionProperties

Description: This method sets the properties of a subscription. It does not return a value.

Parameters:

Name	Type	Description
SubscriptionID	String	The ID of the subscription whose properties are to be set.
ExtensionSettings	ExtensionSettings Object	An object containing the settings for the delivery extension (for example, e-mail delivery) used by this subscription.
Description	String	The description of this subscription.
EventType	String	Either TimedSubscription for a subscription triggered by a schedule or SnapshotUpdated for a subscription triggered by the updating of a snapshot.
MatchData	String	Information used to implement the event type.
Parameters	An Array of ParameterValue e Objects	An array of the values used for the report’s parameters.

SetSystemPolicies

Description: This method sets the system policies for this Reporting Services installation. It does not return a value.

Parameters:

Name name	Type	Description
Policies	An Array of Policy Objects	An array of the values used to set the system policies.

SetSystemProperties

Description: This method sets the specified system properties. It does not return a value.

Parameters:

Name	Type	Description
Properties	An Array of Property Objects	An array of properties and their values.

UpdateReportExecutionSnapshot

Description: This method updates the report execution snapshot for the specified report. It does not return a value.

Parameters:

Name	Type	Description
Report	String	The folder path and name of the report whose execution snapshot is to be updated.

ValidateExtensionSettings

Description: This method validates the settings for a Reporting Services extension and returns an array of ExtensionParameter objects.

Parameters:

Name	Type	Description
Extension	String	The name of the extension.
ParameterValues	An Array of ParameterValueOrFieldReference Objects	An array of parameter values to be validated.

ReportService2005 and ReportExecution2005 Web Service Classes

The Namespace for Reporting Services Web Service Classes

The namespace for Reporting Services web service classes is the same as the namespace used for web services themselves. If the ReportService2005 web service has a namespace of then the namespace for each web service class associated with the ReportService2005 web service would be

 localhost.ReportService

 localhost.{ClassName}

where {ClassName} is the name of one of the classes. The description for each class will tell you whether it is a class of the ReportService2005 web service or the ReportExecution2005 web service.

The “Specified” Properties

Many of the properties for these classes have a corresponding property of the same name, with “Specified” on the end. These properties are used to let any code using the class know if a value was specified for this property or if it was left with no value specified. In most cases, these “specified” properties are added to correspond to class properties with data types of Boolean, date, and others that cannot easily represent an empty state.

For example, the DataSourceDefinition class has a property named Enabled. When this property is set to true, the data source is enabled. When this property is set to false, the data source is disabled. If you do not specify a value for this property, it defaults to false and the data source is disabled. To prevent this from happening, a property called EnabledSpecified of type Boolean has been added to the Data-SourceDefinition class. This additional property lets the code using this class know whether the value for the Enabled property should be used because it was specified by the user or if it should be ignored because it was not specified.

As the developer, you must make sure these “specified” properties are set properly. Any time you provide a value for a property with a corresponding “specified” prop-erty, you need to set that “specified” property to true. If you do not take care of this in your code, these property values will be ignored by the methods using these classes.

In some cases, “specified” properties were added for read-only class properties. This seems to make no sense because you cannot specify a value for a read-only property. Nevertheless, there they are. In these cases, the “specified” properties can be safely ignored.

ActiveState

Description: An object of the ActiveState class type is returned by the GetSubscriptionProperties method to provide information on various error conditions that may be present in a specified subscription. In addition to the properties listed here, this class includes a “specified” property for each of the properties shown. These “specified” properties can be ignored. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
DeliveryExtensionRemoved	Boolean	True if the delivery extension used by the subscription has been removed; otherwise, false. (Read-only.)
InvalidParameterValue	Boolean	True if a parameter value saved with a subscription is invalid; otherwise, false. (Read-only.)
MissingParameterValue	Boolean	True if a required parameter value is not saved with a subscription; otherwise, false. (Read-only.)
SharedDataSourceRemoved	Boolean	True if a shared data source used with a subscription has been removed; otherwise, false. (Read-only.)
UnknownReportParameter	Boolean	True if a parameter name saved with a subscription is not recognized as a parameter for this report; otherwise, false. (Read-only.)

BatchHeader

Description: This class contains the Batch ID for a batch of web-service method calls. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
BatchID	String	The identifier for a batch.

CatalogItem

Description: This class contains information about a single item in the Report Catalog. This may be a Reporting Services folder, a report, a shared data source, or a resource. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
CreatedBy	String	The name of the user who created the item. (Read-only.)
CreationDate	Date	The date and time the item was created. (Read-only.)
CreationDateSpecified	Boolean	True if a value for CreationDate is specified; otherwise, false.
Description	String	The description of the item.
ExecutionDate	Date	The date and time a report item was last executed. (Valid only for report items.) (Read-only.)
ExecutionDateSpecified	Boolean	True if a value for ExecutionDate is specified; otherwise, false.
Hidden	Boolean	True if the item is hidden; otherwise, false.
HiddenSpecified	Boolean	True if a value for Hidden is specified; otherwise, false.
ID	String	The ID of the item. (Read-only.)
MimeType	String	The MIME type of a resource item. (Valid only for resource items.) (Read-only.)
ModifiedBy	String	The name of the user who last modified the item. (Read-only.)
ModifiedDate	Date	The date and time the item was last modified. (Read-only.)
ModifiedDateSpecified	Boolean	True if a value for ModifiedDate is specified; otherwise, false.
Name	String	The name of the item.
Path	String	The folder path to the item. (Read-only.)
Size	Integer	The size of the item in bytes. (Read-only.)
SizeSpecified	Boolean	True if a value for Size is specified; otherwise, false.
Type	ItemTypeEnum	The type of the item. Valid values are Unknown, Folder, Report, Resource, LinkedReport, and Datasource. (Read-only.)
VirtualPath	String	The virtual path to the item. This is populated only when viewing items under the MyReports folder. (Read-only.)

DailyRecurrence

Description: This class contains the time that must elapse, in days, before a schedule recurs. This class inherits from RecurrencePattern. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
DaysInterval	Integer	The number of days before a schedule recurs.

DataRetrievalPlan

Description: This class is used to define the data to be selected for a datadriven subscription. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
DataSet	DataSetDefinition	Defines the dataset to use with the data-driven subscription.
Item	DataSourceDefinitionOrReference	Defines the data source to use with the data-driven subscription.

DataSetDefinition

Description: This class contains the information necessary to define a dataset. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
AccentSensitivity	SensitivityEnum	True if this dataset is sensitive to accents. False if this dataset is not sensitive to accents. Auto if the sensitivity setting should be determined from the data provider.
AccentSensitivitySpecified	Boolean	True if a value for AccentSensitivity is specified; otherwise, false.
CaseSensitivity	SensitivityEnum	True if this dataset is case-sensitive. False if this dataset is not case-sensitive. Auto if the sensitivity setting should be determined from the data provider.
CaseSensitivitySpecified	Boolean	True if a value for CaseSensitivity is specified; otherwise, false.
Collation	String	The locale used when sorting the data in the dataset. (Uses the SQL Server collation codes.)
Fields	An Array of Field Objects	An array containing the field information.
KanatypeSensitivity	SensitivityEnum	True if this dataset is kanatype-sensitive. False if this dataset is not kanatype-sensitive. Auto if the sensitivity setting should be determined from the data provider. (This is used only for some Japanese character sets.)
KanatypeSensitivitySpecified	Boolean	True if a value for KanatypeSensitivity has been specified; otherwise, false.
Name	String	The name of the dataset.
Query	QueryDefinition Object	An object containing the query used to retrieve the data.
WidthSensitivity	SensitivityEnum	True if this dataset is width-sensitive. False if this dataset is not width-sensitive. Auto if the sensitivity setting should be determined from the data provider.
WidthSensitivitySpecified	Boolean	True if a value for WidthSensitivity is specified; otherwise, false.

DataSource

Description: This class contains either a reference to a shared data source or an object with the information necessary to define a data source. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Item	A DataSourceReference Object or a DataSourceDefinition Object	If the data source is referencing a shared data source, this is a DataSourceReference object; otherwise, this is a DataSourceDefinition object.
Name	String	The name of the data source.

DataSourceCredentials

Description: This class contains the credentials used to access a data source. This is a class of the ReportExecution2005 and ReportService2005 web service.

Properties:

Property	Type	Description
DataSourceName	String	The name of the data source that uses these credentials.
Password	String	The password used to connect to the data source.
UserName	String	The user name used to connect to the data source.

DataSourceDefinition

Description: This class contains the information necessary to define a data source. This class inherits from DataSourceDefinitionOrReference. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
ConnectString	String	The connection string.
CredentialRetrieval	CredentialRetrievalEnum	Prompt if the user is to be prompted for credentials when accessing this data source. Store if the credentials are stored in the data source definition. Integrated if Windows Authentication is to be used to access the data source. None if no credentials are required.
Enabled	Boolean	True if the data source is enabled; otherwise, false.
EnabledSpecified	Boolean	True if a value for Enabled is specified; otherwise, false.
Extension	String	The name of the data source extension. Valid values include SQL, OLEDB, ODBC, and a custom extension.
ImpersonateUser	Boolean	True if the Report Server is to impersonate the user after a connection has been made to the data source; otherwise, false.
ImpersonateUserSpecified	Boolean	True if a value for ImpersonateUser is specified; otherwise, false.
Password	String	The password when the credentials are stored in the data source definition.
Prompt	String	The message used when prompting the user for credentials.
UseOriginalConnectString	Boolean	True if the data source should revert to the original connection string; otherwise, false.
UserName	String	The user name when the credentials are stored in the data source definition.
WindowsCredentials	Boolean	True if the stored credentials are Windows credentials. False if the stored credentials are database credentials.

DataSourceDefinitionOrReference

Description: This class serves as a parent class. Any class that inherits from the DataSourceDefinitionOrReference class can be used where a Data SourceDefinitionOrReference type object is required. This is a class of the ReportService2005 web service.

Classes Inheriting from This Class:

Class Name	Description
DataSourceDefinition	Used when a data source definition is to be specified.
DataSourceReference	Used when a reference to a shared data source is to be specified.

DataSourcePrompt

Description: This class contains information about the message displayed to the user when prompting for data source credentials. This is a class of the ReportExecution2005 and ReportService2005 web service.

Properties:

Property	Type	Description
DataSourceID	String	The unique ID of a data source.
Name	String	The name of the data source.
Prompt	String	The prompt message.

DataSourceReference

Description: This class contains a reference to a shared data source. This class inherits from DataSourceDefinitionOrReference. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Reference	String	The folder path and name of the shared data source.

DaysOfWeekSelector

Description: This class contains information for the days of the week on which a schedule runs. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Friday	Boolean	True if the schedule is to run on Friday; otherwise, false.
Monday	Boolean	True if the schedule is to run on Monday; otherwise, false.
Saturday	Boolean	True if the schedule is to run on Saturday; otherwise, false.
Sunday	Boolean	True if the schedule is to run on Sunday; otherwise, false.
Thursday	Boolean	True if the schedule is to run on Thursday; otherwise, false.
Tuesday	Boolean	True if the schedule is to run on Tuesday; otherwise, false.
Wednesday	Boolean	True if the schedule is to run on Wednesday; otherwise, false.

DocumentMapNode

Description: This class contains the definition of a single node in a document map. This is a class of the ReportExecution2005 web service.

Properties:

Property	Type	Description
Children	Array of DocumentMapNode Objects	The children of the document map node.
Label	String	The label of the document map node.
UniqueName	String	The unique name of the report item or grouping pointed to by this document map node.

ExecutionInfo

Description: This class describes the state of the current report execution. This is a class of the ReportExecution2005 web service.

Properties:

Property	Type	Description
AllowQueryExecution	Boolean	True if the user can provide values for the parameters used in the query.
CredentialsRequired	Boolean	True if the report requires credentials to be supplied.
DataSourcePrompts	Array of DataSourcePrompt Objects	The prompt strings for each data source used by the report.
ExecutionDateTime	DateTime	The date and time the snapshot associated with the execution was created.
ExecutionID	String	The unique identifier of this report execution.
ExpirationDateTime	DateTime	The date and time this execution expires.
HasDocumentMap	Boolean	True if the report has a document map.
HasSnapshot	Boolean	True if data has been retrieved and processed for the report.
HistoryID	String	Contains the history ID of the report, if the report is from a report history snapshot.
NeedsProcessing	Boolean	True if the snapshot for this execution needs to be created or reprocessed.
NumPages	Integer	The number of logical pages, including soft page breaks, in the report.
Parameters	Array of ReportParameter	The parameters for the execution.
ParametersRequired	Boolean	True if the report requires parameter values.
ReportPath	String	The folder path to the report on the Report Server.

ExpirationDefinition

Description: This class serves as a parent class. Any class that inherits from the ExpirationDefinition class can be used where an ExpirationDefinition type object is required. This is a class of the ReportService2005 web service.

Classes Inheriting from This Class:

Class Name	Description
ScheduleExpiration	Used when a date and time are to be specified for the expiration.
TimeExpiration	Used when an elapsed time, in minutes, should be specified for the expiration.

Extension

Description: This class represents a Reporting Services extension. This is a class of the ReportExecution2005 web service and ReportService2005 web service.

Properties:

Property	Type	Description
ExtensionType	ExtensionTypeEnum	Delivery for a delivery extension, Render for a rendering extension, Data for a data-processing extension, or All to represent all extension types. (Read-only.)
LocalizedName	String	The localized name of the extension for display to the user. (Read-only.)
Name	String	The name of the extension. (Read-only.)
Visible	Boolean	True if the extension is visible to the user interface; otherwise, false.

ExtensionParameter

Description: This class contains information about a setting for a delivery extension. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
DisplayName	String	The name of the extension parameter.
Encrypted	Boolean	True if the Value property should be encrypted; otherwise, false. (Read-only.)
Error	String	An error message describing a problem with the value specified for this extension parameter. (Read-only.)
IsPassword	Boolean	True if the value for this parameter should not be returned in SOAP responses (this prevents passwords from being sent in clear text); otherwise, false. (Read-only.)
Name	String	The name of the device information setting. (Read-only.)
Readonly	Boolean	True if this extension parameter is read-only; otherwise, false. (Read-only.)
Required	Boolean	True if this extension parameter is required; otherwise, false. (Read-only.)
RequiredSpecified	Boolean	True if a value for Required is specified; otherwise, false.
ValidValues	An Array of ValidValue Objects	An array of valid values for this extension parameter.
Value	String	The value of this extension parameter.

ExtensionSettings

Description: This class contains information for a delivery extension. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Extension	Extension Object	An object representing a Reporting Services extension.
ParameterValues	An Array of ParameterValueOfFieldReference Objects	An array of parameter values for this extension.

Field

Description: This class contains information for a field within a dataset. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Alias	String	The alias of a field in a report.
Name	String	The name of a field in a query.

ItemNamespaceHeader

Description: This is used to determine how property information is retrieved with GetProperty. It inherits from SoapHeader. The following property is not inherited, but it is defined in the ItemNamespaceHeader class. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
ItemNamespace	ItemNamespaceEnum	The method used for retrieving properties. Valid values are GUIDBased and PathBased.

MinuteRecurrence

Description: This class contains the time that must elapse, in minutes, before a schedule recurs. This class inherits from RecurrencePattern. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
MinutesInterval	Integer	The number of minutes before a schedule recurs.

ModelCatalogItem

Description: This class contains information about a model. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Description	String	The description of a model catalog item.
Model	String	The folder path and name of the model catalog item.
Perspectives	Array of ModelPerspective Objects	The perspectives of the model catalog item.

ModelDrillthroughReport

Description: This class contains information about a model drillthrough report. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Path	String	The full path and name of the drillthrough report.
Type	ModelDrillthroughTypeEnum	The type of the data presented by the drillthrough report. Valid values are Detail and List.

ModelItem

Description: This class contains a semantic definition of a model item. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Description	String	The description of a model item.
ID	String	The ID of a model item.
ModelItems	Array of ModelItem Objects	The children of a model item.
Name	String	The name of the model item.
Type	ModelItemTypeEnum	The type of the model item. Valid values are Attribute, Entity, Entity Folder, Field Folder, Model, and Role.

ModelPerspective

Description: This class contains information about a model perspective. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Description	String	The description of a perspective.
ID	String	The ID of a perspective.
Name	String	The name of a perspective.

MonthlyDOWRecurrence

Description: This class contains the days of the week, the weeks of the month, and the months of the year on which a schedule runs. This class inherits from RecurrencePattern. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
DaysOfWeek	DaysOfWeekSelector Object	An object that determines the days of the week on which the schedule runs.
MonthsOfYear	MonthsOfYearSelector	An object that determines the months of the year on which the schedule runs.
WhichWeek	WeekNumberEnum	FirstWeek if the schedule is to run the first week of the month, SecondWeek if the schedule is to run the second week of the month, ThirdWeek if the schedule is to run the third week of the month, FourthWeek if the schedule is to run the fourth week of the month, or LastWeek if the schedule is to run the last week of the month.
WhichWeekSpecified	Boolean	True if a value for WhichWeek has been specified; otherwise, false.

MonthlyRecurrence

Description: This class contains the days of the month and the months of the year on which a schedule runs. This class inherits from RecurrencePattern. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Days	String	The days of the month on which the schedule recurs.
MonthsOfYear	MonthsOfYearSelector	An object that determines the months of the year on which the schedule recurs.

MonthsOfYearSelector

Description: This class contains information on the months of the year in which a schedule runs. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
April	Boolean	True if the schedule is to run in April; otherwise, false.
August	Boolean	True if the schedule is to run in August; otherwise, false.
December	Boolean	True if the schedule is to run in December; otherwise, false.
February	Boolean	True if the schedule is to run in February; otherwise, false.
January	Boolean	True if the schedule is to run in January; otherwise, false.
July	Boolean	True if the schedule is to run in July; otherwise, false.
June	Boolean	True if the schedule is to run in June; otherwise, false.
March	Boolean	True if the schedule is to run in March; otherwise, false.
May	Boolean	True if the schedule is to run in May; otherwise, false.
November	Boolean	True if the schedule is to run in November; otherwise, false.
October	Boolean	True if the schedule is to run in October; otherwise, false.
September	Boolean	True if the schedule is to run in September; otherwise, false.

NoSchedule

Description: This class is used when no schedule is associated with an execution snapshot or a history snapshot. This class inherits from Schedule DefinitionOrReference. It does not contain any properties. This is a class of the ReportService2005 web service.

ParameterFieldReference

Description: This class represents a field in a dataset used to supply the value for a parameter. This class inherits from ParameterValueOrFieldReference. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
FieldAlias	String	The alias of a field.
ParameterName	String	The name of a field.

ParameterValue

Description: This class represents the actual value for a parameter. This class inherits from ParameterValueOrFieldReference. This is a class of the ReportExecution2005 web service and the ReportService2005 web service.

Properties:

Property	Type	Description
Label	String	The label used for this parameter.
Name	String	The name of the parameter.
Value	String	The value of the parameter.

ParameterValueOrFieldReference

Description: This class serves as a parent class. Any class that inherits from the ParameterValueOrFieldReference class can be used where a ParameterValueOrFieldReference type object is required. This is a class of the ReportExecution2005 and the ReportService2005 web service.

Classes Inheriting from This Class:

Class Name	Description
ParameterFieldReference	Used when a reference to a field is to be specified.
ParameterValue	Used when a parameter value is to be specified.

Policy

Description: This class represents a domain user or domain group and the security roles assigned to that user or group. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
GroupUserName	String	The name of a domain user or domain group.
Roles	An Array of Role Objects	An array of security roles.

Property

Description: This class represents a property of a Reporting Services item. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Name	String	The name of the property.
Value	String	The value of the property.

QueryDefinition

Description: This class contains information to define a query used for a dataset or a data-driven subscription. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
CommandText	String	The query text (usually a SELECT statement).
CommandType	String	The type of query supplied in the CommandText property. (For data-driven subscriptions, this always has a value of Text.)
Timeout	Integer	The number of seconds the query may execute before it times out.
TimeoutSpecified	Boolean	True if a value for Timeout has been specified; otherwise, false.

RecurrencePattern

Description: This class serves as a parent class. Any class that inherits from the RecurrencePattern class can be used where a RecurrencePattern type object is required. This is a class of the ReportService2005 web service.

Classes Inheriting from This Class:

Class Name	Description
MinuteRecurrence	Used when the schedule is to recur in minutes.
DailyRecurrence	Used when the schedule is to recur on a daily basis.
WeeklyRecurrence	Used when the schedule is to occur on certain days of the week and to recur on a weekly basis.
MonthlyRecurrence	Used when the schedule is to occur on certain days of the month and certain months of the year.
MonthlyDOWRecurrence	Used when the recurrence is to occur on a day of the week, week of the month, and month of the year.

ReportHistorySnapshot

Description: This class contains information defining a history snapshot. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
CreationDate	Date	The date and time the history snapshot was created. (Read-only.)
HistoryID	String	The ID of the history snapshot. (Read-only.)
Size	Integer	The size (in bytes) of the history snapshot. (Read-only.)

ReportParameter

Description: This class contains information about a report parameter. This is a class of the ReportExecution2005 web service and the ReportService2005 web service. Properties vary between the two web services.

Properties:

Property	Type	Description
AllowBlank	Boolean	True if this report parameter can be empty; otherwise, false. (Read-only.)
AllowBlankSpecified	Boolean	True if a value for AllowBlank was specified; otherwise, false.
DefaultValues	String	The default value of the report parameter.
DefaultValuesQueryBased	Boolean	True if the default value comes from a query; otherwise, false. (Read-only.)
DefaultValuesQueryBasedSpecified	Boolean	True if a value for DefaultValuesQueryBased is specified; otherwise, false.
Dependencies	An Array of Strings	An array showing which other report parameters are depended on by the query used to provide the default value and the query used to provide valid values. Used only if the default value or the valid values come from a parameterized query. (Read-only.)
ErrorMessage	String	Any error messages describing errors with this report parameter.
MultiValue	Boolean	True if the parameter can be a multivalued parameter. (Read-only.)
MultiValueSpecified	Boolean	True if a value for MultiValue is specified; otherwise, false.
Name	String	The name of the parameter. (Read-only.)
Nullable	Boolean	True if the report parameter may be null; otherwise, false.
NullableSpecified	Boolean	True if a value for Nullable is specified; otherwise, false.
Prompt	String	The message displayed to the user when prompting for a value for this parameter.
PromptUser	Boolean	True if the user is to be prompted for this report parameter; otherwise, false.
PromptUserSpecified	Boolean	True if a value for PromptUser has been specified; otherwise, false.
QueryParameter	Boolean	True if this parameter is used in a data source query; otherwise, false. (Read-only.)
QueryParameterSpecified	Boolean	True if a value for QueryParameter is specified; otherwise, false.
State		HasValidValue if the report parameter has a valid value, MissingValidValue if a valid value for the report parameter does not exist, HasOutstandingDependencies if other report parameters depended on by this report parameter are not yet specified, or DynamicValuesUnavailable if no values were returned by a query designated to provide the list of valid values. (Read-only.)
StateSpecified	Boolean	True if a value for State is specified; otherwise, false.
Type		Boolean if type boolean, DateTime if type datetime, Float if type float, Integer if type integer, or String if type string. (Read-only.)
TypeSpecified	Boolean	True if a value for Type is specified; otherwise, false.
ValidValues	An Array of ValidValue Objects	An array of the valid values for this report parameter.
ValidValuesQueryBased	Boolean	True if the valid values come from a query; otherwise, false.
ValidValuesQueryBased Specified	Boolean	True if a value for ValidValuesQueryBased is specified; otherwise, false.

Role

Description: This class contains information about a security role. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Description	String	The description of the role.
Name	String	The name of the role.

Schedule

Description: This class contains information about a schedule. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Creator	String	The name of the user who created the schedule. (Read-only.)
Definition	ScheduleDefinition Object	The definition of the schedule.
Description	String	The description of the schedule.
LastRunTime	Date	The date and time the schedule was last run. (Read-only.)
LastRunTimeSpecified	Boolean	True if a value for LastRunTime is specified; otherwise, false.
Name	String	The name of the schedule.
NextRunTime	Date	The date and time the schedule will run next. (Read-only.)
NextRunTimeSpecified	Boolean	True if a value for NextRunTime is specified; otherwise, false.
ReferencesPresent	Boolean	True if this is a shared schedule and it is referenced by reports and subscriptions.
Scheduled	String	The ID of the schedule. (Read-only.)
State	ScheduleStateEnum	Running if one or more reports associated with this schedule are currently running, Ready if one or more reports associated with this schedule are ready to run, Paused if the schedule is paused, Expired if the end date for this schedule has passed, Failing if an error has occurred and the schedule has failed.

ScheduleDefinition

Description: This class contains information for defining a schedule. This class inherits from ScheduleDefinitionOrReference. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
EndDate	Date	The end date and time for the schedule.
EndDateSpecified	Boolean	True if a value for EndDate has been specified; otherwise, false.
Item	RecurrencePattern Object	An object containing information about when the schedule should run.
StartDateTime	Date	The start date and time for the schedule.

ScheduleDefinitionOrReference

Description: This class serves as a parent class. Any class that inherits from the ScheduleDefinitionOrReference class can be used where a ScheduleDefinitionOrReference type object is required. This is a class of the ReportService2005 web service.

Classes Inheriting from This Class:

Class Name	Description
NoSchedule	Used when no schedule is to be specified.
ScheduleDefinition	Used when a schedule definition is to be specified.
ScheduleReference	Used when a reference to a shared schedule is to be specified.

ScheduleExpiration

Description: This class defines when a cached copy of a report should expire. This class inherits from ExpirationDefinition. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Item	ScheduleDefinitionOrReference Object	Either a schedule definition or a reference to a shared schedule.

ScheduleReference

Description: This class contains a reference to a shared schedule. This class inherits from ScheduleDefinitionOrReference. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Definition	ScheduleDefinition Object	The definition of the schedule.
Scheduled	String	The ID of the shared schedule.

SearchCondition

Description: This class provides information on a search within the Report Catalog. This is a class of the ReportService2005 web service.

Properties:

Property	type	Description
Condition	ConditionEnum	Contains if the search must match only a portion of the property's value to be considered a match, Equals if the search must match all the property's value to be considered a match.
ConditionSpecified	Boolean	True if a value for Condition has been specified; otherwise, false.
Name	String	The name of the property being searched.
Value	String	The value to find.

ServerInfoHeader

Description: This class contains information on the current version of the Report Server. This is a class of the ReportExecution2005 web service and the ReportService2005 web service.

Properties:

Property	Type	Description
ReportServerEdition	String	A read-only property containing the edition of the Report Server.
ReportServerVersion	String	A read-only property containing the version of the Report Server.
ReportServerVersionNumber	String	A read-only property containing the version number of the Report Server.

Subscription

Description: This class contains information to define a subscription. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Active	ActiveState Object	The active state of the subscription. (Read-only.)
DeliverySettings	ExtensionSettings Object	The settings specific to the delivery extension.
Description	String	A description of the format and the delivery method.
EventType	String	The type of event that triggers the subscription.
IsDataDriven	Boolean	True if the subscription is data-driven; otherwise, false.
LastExecuted	Date	The date and time the subscription was last executed. (Read-only.)
LastExecutedSpecified	Boolean	True if a value for LastExecuted is specified; otherwise, false.
ModifiedBy	String	The name of the user who last modified the subscription. (Read-only.)
ModifiedDate	Date	The date and time of the last modification to the subscription. (Read-only.)
Owner	String	The user name of the owner of the subscription. (Read-only.)
Path	String	The full path and name of the report associated with the subscription.
Report	String	The name of the report associated with the subscription.
Status	String	The status of the subscription. (Read-only.)
SubscriptionID	String	The ID of the subscription.
VirtualPath	String	The virtual path to the report associated with the subscription. This is populated only if the associated report is under the MyReports folder.

Task

Description: This class contains information about a Reporting Services task. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Description	String	The description of this task. (Read-only.)
Name	String	The name of this task. (Read-only.)
TaskID	String	The ID for this task. (Read-only.)

TimeExpiration

Description: This class contains the time that must elapse, in minutes, before a cached copy of a report expires. This class inherits from ExpirationDefinition. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
Minutes	Integer	The number of minutes before expiration.

ValidValue

Description: This class contains information on a valid value for an extension parameter or a report parameter. This is a class of the ReportExecution2005 web service and the ReportService2005 web service.

Properties:

Property	Type	Description
Label	String	The label for the valid value.
Value	String	The valid value for the setting.

Warning

Description: This class contains information on a warning message or an error message. This is a class of the ReportExecution2005 web service and the ReportService2005 web service.

Properties:

Property	Type	Description
Code	String	The error or warning code. (Read-only.)
Message	String	The error or warning message. (Read-only.)
ObjectName	String	The name of the object associated with the warning or error. (Read-only.)
ObjectType	String	The type of the object associated with the warning or error. (Read-only.)
Severity	String	Warning if this is a warning, Error if this is an error.

WeeklyRecurrence

Description: This class contains the days of the week on which a schedule runs and the number of weeks to elapse before each recurrence. This class inherits from RecurrencePattern. This is a class of the ReportService2005 web service.

Properties:

Property	Type	Description
DaysOfWeek	DaysOfWeekSelector Object	An object that determines the days of the week on which the schedule runs.
WeeksInterval	Integer	The number of weeks before a schedule runs again.
WeeksIntervalSpecified	Boolean	True if a value for WeeksInterval is specified; otherwise, false.