ReportingService2005.SetSubscriptionProperties 메서드

  • 참조

정의

네임스페이스:
ReportService2005
어셈블리:
ReportService2005.dll

구독의 속성을 설정합니다.

public:
 void SetSubscriptionProperties(System::String ^ SubscriptionID, ReportService2005::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2005::ParameterValue ^> ^ Parameters);
public void SetSubscriptionProperties (string SubscriptionID, ReportService2005.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2005.ParameterValue[] Parameters);
member this.SetSubscriptionProperties : string * ReportService2005.ExtensionSettings * string * string * string * ReportService2005.ParameterValue[] -> unit
Public Sub SetSubscriptionProperties (SubscriptionID As String, ExtensionSettings As ExtensionSettings, Description As String, EventType As String, MatchData As String, Parameters As ParameterValue())

매개 변수

SubscriptionID
String

구독의 ID입니다.

ExtensionSettings
ExtensionSettings

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

Description
String

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

EventType
String

구독을 트리거하는 이벤트의 유형입니다.

MatchData
String

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

Parameters
ParameterValue[]

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

설명

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

(Out) ServerInfoHeaderValue
필요한 권한 UpdateAnySubscription OR(UpdateSubscription 및 사용자가 보고서 소유자이고 구독이 시간 제한 구독임)

매개 변수의 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 가져올 수 있습니다.

이벤트가 스냅샷 업데이트 구독인 경우 매개 변수를 null (Visual Basic의 경우)로Nothing 설정합니다MatchData.

적용 대상