ReportingService2010.FindItems Method

Returns items from a report server database or SharePoint library that match the search criteria.

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

Syntax

'Declaration
<SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/FindItems", RequestNamespace := "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    ResponseNamespace := "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Function FindItems ( _
    Folder As String, _
    BooleanOperator As BooleanOperatorEnum, _
    SearchOptions As Property(), _
    SearchConditions As SearchCondition() _
) As CatalogItem()
'Usage
Dim instance As ReportingService2010
Dim Folder As String
Dim BooleanOperator As BooleanOperatorEnum
Dim SearchOptions As Property()
Dim SearchConditions As SearchCondition()
Dim returnValue As CatalogItem()

returnValue = instance.FindItems(Folder, _
    BooleanOperator, SearchOptions, _
    SearchConditions)
[SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/FindItems", RequestNamespace = "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public CatalogItem[] FindItems(
    string Folder,
    BooleanOperatorEnum BooleanOperator,
    Property[] SearchOptions,
    SearchCondition[] SearchConditions
)
[SoapDocumentMethodAttribute(L"http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/FindItems", RequestNamespace = L"http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = L"http://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:
array<CatalogItem^>^ FindItems(
    String^ Folder, 
    BooleanOperatorEnum BooleanOperator, 
    array<Property^>^ SearchOptions, 
    array<SearchCondition^>^ SearchConditions
)
[<SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/FindItems", RequestNamespace = "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member FindItems : 
        Folder:string * 
        BooleanOperator:BooleanOperatorEnum * 
        SearchOptions:Property[] * 
        SearchConditions:SearchCondition[] -> CatalogItem[] 
public function FindItems(
    Folder : String, 
    BooleanOperator : BooleanOperatorEnum, 
    SearchOptions : Property[], 
    SearchConditions : SearchCondition[]
) : CatalogItem[]

Parameters

  • Folder
    Type: System.String
    The fully qualified URL of the folder to search. To search the entire report server database, specify the root folder (/).
  • BooleanOperator
    Type: ReportService2010.BooleanOperatorEnum
    The logical operator that is applied to connect the search conditions. Possible values are AND and OR. The default value is AND.
  • SearchOptions
    Type: array<ReportService2010.Property[]
    An array of Property objects that defines the names and values of search options.
    The supported search options are:
    Resursive : specify True to perform recursive search in all subfolders; otherwise, False.

Return Value

Type: array<ReportService2010.CatalogItem[]
An array of CatalogItem objects in the report server database that correspond to the specified search criteria.

Remarks

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

SOAP Header Usage

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

Native Mode Required Permissions

None

SharePoint Mode Required Permissions

None

The length of the Folder parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

The Folder parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name.

Only one instance of a property name can be supplied in the set of search conditions, and the search text is case-insensitive.

The report server does not support wildcard characters in the middle of the search condition. Wildcard characters include %, _, [, ], ^, and -. If a wildcard character is present, the report server treats the character literally.

The items that are returned are only those for which a user has ReadProperties permission in native mode and ViewListItems() permission in SharePoint integrated mode.

In SharePoint mode, this method does not return any item of type Resource, because resources are not stored in, nor synchronized to, the report server database in SharePoint mode.