ReportingService2010.SetItemHistoryOptions Method

Sets item history options that specify when an item history snapshot is created for a specified catalog item. This method applies to the Report item type.

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

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemHistoryOptions", 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("TrustedUserHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
Public Sub SetItemHistoryOptions ( _
    ItemPath As String, _
    EnableManualSnapshotCreation As Boolean, _
    KeepExecutionSnapshots As Boolean, _
    Item As ScheduleDefinitionOrReference _
)
'Usage
Dim instance As ReportingService2010 
Dim ItemPath As String 
Dim EnableManualSnapshotCreation As Boolean 
Dim KeepExecutionSnapshots As Boolean 
Dim Item As ScheduleDefinitionOrReference

instance.SetItemHistoryOptions(ItemPath, _
    EnableManualSnapshotCreation, KeepExecutionSnapshots, _
    Item)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemHistoryOptions", 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("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
public void SetItemHistoryOptions(
    string ItemPath,
    bool EnableManualSnapshotCreation,
    bool KeepExecutionSnapshots,
    ScheduleDefinitionOrReference Item
)

[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemHistoryOptions", 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"TrustedUserHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
void SetItemHistoryOptions(
    String^ ItemPath, 
    bool EnableManualSnapshotCreation, 
    bool KeepExecutionSnapshots, 
    ScheduleDefinitionOrReference^ Item
)

[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemHistoryOptions", 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("TrustedUserHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
member SetItemHistoryOptions : 
        ItemPath:string * 
        EnableManualSnapshotCreation:bool * 
        KeepExecutionSnapshots:bool * 
        Item:ScheduleDefinitionOrReference -> unit

public function SetItemHistoryOptions(
    ItemPath : String, 
    EnableManualSnapshotCreation : boolean, 
    KeepExecutionSnapshots : boolean, 
    Item : ScheduleDefinitionOrReference
)

Parameters

• ItemPath
  Type: System.String
  The fully qualified URL of the item including the file name and, in SharePoint mode, the extension.

• EnableManualSnapshotCreation
  Type: System.Boolean
  Indicates whether item history snapshots can be created through the Web service CreateItemHistorySnapshot method. The default value is true.

• KeepExecutionSnapshots
  Type: System.Boolean
  Indicates whether item execution snapshots are collected for item history. The default value is false.

• Item
  Type: ReportService2010.ScheduleDefinitionOrReference
  The ScheduleDefinition or ScheduleReference object that represents the schedule information for the item history snapshot. If the item history snapshot is not created according to a schedule, pass a NoSchedule object for this parameter.

Remarks

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

SOAP Header Usage	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Native Mode Required Permissions	UpdatePolicy AND CreateSnapshot
SharePoint Mode Required Permissions	EditListItems

See Also

Reference

ReportingService2010 Class

ReportService2010 Namespace