ReportingService2010.SetDataDrivenSubscriptionProperties 메서드

정의

데이터 기반 구독의 속성을 설정합니다.

public:
 void SetDataDrivenSubscriptionProperties(System::String ^ DataDrivenSubscriptionID, ReportService2010::ExtensionSettings ^ ExtensionSettings, ReportService2010::DataRetrievalPlan ^ DataRetrievalPlan, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2010::ParameterValueOrFieldReference ^> ^ Parameters);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void SetDataDrivenSubscriptionProperties (string DataDrivenSubscriptionID, ReportService2010.ExtensionSettings ExtensionSettings, ReportService2010.DataRetrievalPlan DataRetrievalPlan, string Description, string EventType, string MatchData, ReportService2010.ParameterValueOrFieldReference[] Parameters);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.SetDataDrivenSubscriptionProperties : string * ReportService2010.ExtensionSettings * ReportService2010.DataRetrievalPlan * string * string * string * ReportService2010.ParameterValueOrFieldReference[] -> unit
Public Sub SetDataDrivenSubscriptionProperties (DataDrivenSubscriptionID As String, ExtensionSettings As ExtensionSettings, DataRetrievalPlan As DataRetrievalPlan, Description As String, EventType As String, MatchData As String, Parameters As ParameterValueOrFieldReference())

매개 변수

ExtensionSettings
ExtensionSettings

배달 확장 프로그램에 고유한 설정 목록을 포함하는 ExtensionSettings 개체입니다.

DataRetrievalPlan
DataRetrievalPlan

구독에 대한 배달 쿼리에서 데이터를 검색하는 데 필요한 설정 목록을 포함하는 DataRetrievalPlan 개체입니다.

Description
String

사용자에게 표시되는 의미 있는 설명입니다.

EventType
String

구독을 트리거하는 이벤트의 유형입니다. 유효한 값은 TimedSubscription 또는 SnapshotUpdated입니다.

MatchData
String

이벤트의 특정 유형과 연결된 데이터입니다. 이 데이터는 발생한 이벤트의 구독과 일치하는 이벤트 처리 확장 프로그램에서 사용됩니다.

Parameters
ParameterValueOrFieldReference[]

보고서에 대한 매개 변수 목록을 포함하는 ParameterValue 개체의 배열입니다.

특성

설명

다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.

SOAP 헤더 사용 (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
기본 모드 필수 권한 UpdateAnySubscription
SharePoint 모드 필수 권한 <xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts>

데이터 기반 구독이 제대로 실행되려면 개체가 참조하는 데이터 원본에 DataRetrievalPlan 속성이 로 설정되어 Store있어야 합니다CredentialRetrieval.

DataSet 포함된 개체는 Field 배달 확장 프로그램 설정 및 보고서 매개 변수 값에 매핑된 필드에 대해 검사됩니다. 배달 확장 프로그램 설정 및 보고서 매개 변수 값에서 참조되는 모든 필드도 데이터 세트에 열거되어야 합니다.

데이터 세트에 열거된 필드가 배달 쿼리에서 반환되는지 확인하기 위해 유효성 검사가 수행되지 않습니다. 데이터 세트에 열거된 필드가 배달 쿼리에서 반환되지 않으면 구독이 처리될 때 보고서 서버에서 오류가 발생합니다.

매개 변수의 EventType 값은 보고서 서버에 구성된 이벤트 처리 확장 프로그램에 해당해야 합니다. 이벤트가 이벤트 처리 확장 프로그램에 의해 처리되지 않으면 오류 코드 rsInvalidEvent와 함께 SOAP 예외가 throw됩니다. 이벤트는 알림을 만드는 이벤트 처리 확장 프로그램에 의해 처리되어야 합니다. 매개 변수 값 EventType 이 수신되면 이벤트 처리 확장 프로그램이 쿼리되어 알림을 만드는지 여부를 확인합니다. 그렇지 않으면 오류 코드 rsEventNonSubscribeable와 함께 SOAP 예외가 throw됩니다.

매개 변수의 MatchData 값은 이벤트 유형에 따라 달라집니다. 이벤트가 TimedSubscription 이벤트인 ScheduleDefinition 경우 개체가 매개 변수로 MatchData 필요합니다. 개체를 ScheduleDefinition 문자열 값으로 전달하고 일정에 따라 구독을 만들려면 먼저 개체를 XML로 직렬화해야 합니다. XML 구조는 다음 예제와 같을 수 있습니다.

<ScheduleDefinition>  
   <WeeklyRecurrence>  
      <StartDateTime>2003-02-24T09:00:00-08:00</StartDateTime>  
      <WeeksInterval>1</WeeksInterval>  
      <DaysOfWeek>  
         <Monday>True</Monday>  
         </DaysOfWeek>  
   </WeeklyRecurrence>  
</ScheduleDefinition>  

XML 문자열로 전달될 때 StartDateTime 요소의 값은 날짜 형식 ISO 8601에 해당해야 합니다. 이 국제 날짜 및 시간 표준은 확장된 형식 CCYY-MM-DDThh:mm:ss+/-Z입니다. 여기서 "CC"는 세기, "YY" 연도, 월 "MM" 및 "DD"를 나타냅니다. 문자 "T"는 날짜 및 시간 구분 기호이며 "hh", "mm", "ss"는 각각 시간, 분 및 초를 나타냅니다. 이 표현 바로 뒤에 "Z"가 표시되어 UTC(협정 세계시)를 나타낼 수 있습니다. 현지 시간과 협정 세계시 사이의 차이로 표현되는 표준 시간대를 나타내기 위해 "Z"는 "+" 또는 "-" 기호 뒤에 hh:mm로 표시된 UTC와 차이가 잇습니다.

TimedSubscription에 대한 일정 정의가 공유 일정인 경우 공유 일정의 일정 ID를 매개 변수로 MatchData 전달해야 합니다. 일정 ID는 로 전달됩니다( 예: String"4608ac1b-fc75-4149-9e15-5a8b5781b843"). 메서드를 호출하여 일정 ID를 ListSchedules 가져올 수 있습니다.

XmlSerializer 클래스를 사용하여 개체 클래스를 XML 문자열로 자동으로 변환할 수 있습니다. XmlSerializer 클래스에 대한 자세한 내용은 "System.Xml. Microsoft .NET Framework 설명서의 XmlSerializer 클래스"

이벤트가 스냅샷 업데이트 구독인 경우 매개 변수 값 MatchData 은 (NothingVisual Basic의 경우)이어야 합니다 null .

적용 대상