• Article

ReportingService2010.GenerateModel Method

Generates a default model on top of a shared data source.

Namespace:  ReportService2010
Assembly:  ReportService2010 (in ReportService2010.dll)

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GenerateModel", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Function GenerateModel ( _
    DataSource As String, _
    Model As String, _
    Parent As String, _
    Properties As Property(), _
    <OutAttribute> ByRef Warnings As Warning() _
) As CatalogItem
'Usage
Dim instance As ReportingService2010
Dim DataSource As String
Dim Model As String
Dim Parent As String
Dim Properties As Property()
Dim Warnings As Warning()
Dim returnValue As CatalogItem

returnValue = instance.GenerateModel(DataSource, _
    Model, Parent, Properties, Warnings)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GenerateModel", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public CatalogItem GenerateModel(
    string DataSource,
    string Model,
    string Parent,
    Property[] Properties,
    out Warning[] Warnings
)

[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GenerateModel", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
CatalogItem^ GenerateModel(
    String^ DataSource, 
    String^ Model, 
    String^ Parent, 
    array<Property^>^ Properties, 
    [OutAttribute] array<Warning^>^% Warnings
)

[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GenerateModel", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member GenerateModel : 
        DataSource:string * 
        Model:string * 
        Parent:string * 
        Properties:Property[] * 
        Warnings:Warning[] byref -> CatalogItem 

public function GenerateModel(
    DataSource : String, 
    Model : String, 
    Parent : String, 
    Properties : Property[], 
    Warnings : Warning[]
) : CatalogItem

Parameters

  • DataSource
    Type: System.String
    The fully qualified URL of the data source including the file name and .rsds file name extension.
  • Parent
    Type: System.String
    The fully qualified URL for the parent folder that will contain the model.
  • Properties
    Type: array<ReportService2010.Property[]
    XML that defines properties to set on the model and values to set them to.
    The top-level element is Properties.
  • Warnings
    Type: array<ReportService2010.Warning[]%
    [out] An array of Warning objects which describe any warnings that may have occurred during the generation of the model. The top-level element is Warning.

Return Value

Type: ReportService2010.CatalogItem
A CatalogItem object for the newly created model.

Remarks

The table below shows header and permissions information on this operation.

SOAP Header Usage

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

Native Mode Required Permissions

ReadProperties on DataSource AND CreateModel on Parent

SharePoint Mode Required Permissions

AddListItems() on Parent AND ViewListItems() on DataSource

The report server sets the IsGenerated property on the generated model when GenerateModel is called.

Models are generated by using the credentials specified in the shared data source. As a result, two different users can generate different models from the same data source. Note that when a shared data source is configured to store credentials in the report server, GenerateModel always impersonates the user whose credentials are stored, even if the shared data source is configured to impersonate the currently authenticated user.

When the model is created, the default model item security is applied to the nodes in the model.

When the model definition is generated, custom properties stored in the model definition are propagated as custom properties on the model item in the folder namespace, and new custom property values overwrite existing custom property values.