ReportingService2005.SetSubscriptionProperties(String, ExtensionSettings, String, String, String, ParameterValue[]) ReportingService2005.SetSubscriptionProperties(String, ExtensionSettings, String, String, String, ParameterValue[]) Method

정의

구독의 속성을 설정합니다. Sets the properties of a subscription.

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);
매개 변수
SubscriptionID
String String

구독의 ID입니다. The ID of the subscription.

ExtensionSettings
ExtensionSettings ExtensionSettings

ExtensionSettings 배달 확장 프로그램에 고유한 설정 목록을 포함 하는 개체입니다. An ExtensionSettings object that contains a list of settings that are specific to the delivery extension.

Description
String String

사용자에게 표시되는 의미 있는 설명입니다. A meaningful description that is displayed to users.

EventType
String String

구독을 트리거하는 이벤트의 유형입니다. The type of event that triggers the subscription.

MatchData
String String

이벤트의 특정 유형과 연결된 데이터입니다. The data that is associated with the specified type of event. 이 데이터는 발생한 이벤트의 구독과 일치하는 이벤트 처리 확장 프로그램에서 사용됩니다. This data is used by an event processing extension to match the subscription with an event that has fired.

Parameters
ParameterValue[]

배열 ParameterValue 보고서에 대 한 매개 변수 목록을 포함 하는 개체입니다. An array of ParameterValue objects that contains a list of parameters for the report.

설명

다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.The table below shows header and permissions information on this operation.

SOAP 헤더SOAP Headers (In) BatchHeaderValue(In) BatchHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
필요한 권한Required Permissions UpdateAnySubscription 또는 (UpdateSubscription 및 사용자가 보고서 소유자 이며 구독이 정해진된 구독 임)UpdateAnySubscription OR (UpdateSubscription AND the user is the report owner and the subscription is a timed subscription)

값은 EventType 처리는 보고서 서버에 구성 된 확장 이벤트에 매개 변수와 일치 해야 합니다.The value of the EventType parameter must correspond to an event processing extension that is configured on the report server. 이벤트 종류는 이벤트 처리 확장 프로그램에서 처리 되지 않으면 오류 코드와 SOAP 예외가 throw 됩니다 rsInvalidEvent합니다.If the event type is not handled by an event processing extension, a SOAP exception is thrown with the error code rsInvalidEvent. 이벤트 종류는 이벤트 알림을 만듭니다 확장을 처리에서 처리 되어야 합니다.The event type must be handled by an event processing extension that creates notifications. 에 대 한 값은 EventType 매개 변수가 수신 되 면 이벤트 알림을 만드는 지 여부를 확인 하려면 이벤트 처리 확장 프로그램 쿼리 됩니다.When a value for the EventType parameter is received, the event processing extension is queried to determine whether the event creates notifications. 오류 코드 함께 SOAP 예외가 발생 하지 않으면 rsEventNonSubscribeable합니다.If it does not, a SOAP exception is thrown with the error code rsEventNonSubscribeable.

값은 MatchData 매개 변수는 이벤트 유형에 따라 다릅니다.The value of the MatchData parameter depends on the event type. 이벤트는 TimedSubscription 이벤트는 ScheduleDefinition 개체는로 필요는 MatchData 매개 변수입니다.If the event is a TimedSubscription event, a ScheduleDefinition object is required as the MatchData parameter. 먼저 직렬화 해야는 ScheduleDefinition 일정에 따라 구독을 만들고 문자열 값으로 전달 하기 위해 XML로 개체입니다.You must first serialize the ScheduleDefinition object as XML in order to pass it as a string value and create a subscription based on the schedule. XML 구조는 다음 예제와 같습니다.The XML structure might look like the one in the following example:

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

값은 StartDateTime 요소는 XML 문자열 변수로 전달 될 때 날짜 형식은 ISO 8601에 대응 되어야 합니다.The value of the StartDateTime element when passed as an XML string should correspond to the date format ISO 8601. 국가별 날짜 및 시간 표준이 값은 확장된 형식 CCYY-m M-Z 여기서 "CC" 나타냅니다 "YY" 세기, 연도, 월 "MM" 및 "DD" + /-DDThh:mm:ss 일 합니다.This international date and time standard is the extended format CCYY-MM-DDThh:mm:ss+/-Z where "CC" represents the century, "YY" the year, "MM" the month and "DD" the day. 문자 "T" 날짜 및 시간 구분 기호 및 "hh"은 "mm", "ss" 시간, 분 및 초를 나타내는 각각.The letter "T" is the date and time separator and "hh", "mm", "ss" represent hour, minute, and second, respectively. 이 표현은 utc (협정 세계시)를 나타내는 "Z"가 즉시 올 수 있습니다.This representation may be immediately followed by a "Z" to indicate Coordinated Universal Time (UTC). 협정 세계시 현지 시간 사이의 차이로 표시 되는 표준 시간대를 나타내는 "Z"는 앞에 "+" 또는 "-" 기호, hh: mm으로 표현 되는 UTC에서 차이 이어서 합니다.To indicate the time zone, represented as the difference between the local time and Coordinated Universal Time, "Z" is preceded by a "+" or "-" sign, followed by the difference from UTC represented as hh:mm.

경우에 대 한 일정 정의 TimedSubscription 은 공유 일정으로 공유 일정의 일정 ID를 전달 해야 합니다는 MatchData 매개 변수입니다.If the schedule definition for a TimedSubscription is a shared schedule, you must pass the schedule ID of the shared schedule as the MatchData parameter. ID로 전달 되는 일정 한 String, 예를 들어 "4608ac1b-fc75-4149-9e15-5a8b5781b843"입니다.The schedule ID is passed as a String, for example, "4608ac1b-fc75-4149-9e15-5a8b5781b843". 일정 ID를 호출 하 여 가져올 수는 ListSchedules 메서드.The schedule ID can be obtained by calling the ListSchedules method.

스냅숏 업데이트 구독 인 경우 설정 MatchData 매개 변수를 null (Nothing Visual basic에서).If the event is a snapshot update subscription, set MatchData parameter to null (Nothing in Visual Basic).

적용 대상