ReportingService2010.SetSubscriptionProperties 메서드

참조

정의

네임스페이스:: ReportService2010

어셈블리:: ReportService2010.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

public:
 void SetSubscriptionProperties(System::String ^ SubscriptionID, ReportService2010::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2010::ParameterValue ^> ^ Parameters);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetSubscriptionProperties", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public void SetSubscriptionProperties (string SubscriptionID, ReportService2010.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2010.ParameterValue[] Parameters);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetSubscriptionProperties", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.SetSubscriptionProperties : string * ReportService2010.ExtensionSettings * string * string * string * ReportService2010.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 개체의 배열입니다.

특성: SoapDocumentMethodAttribute SoapHeaderAttribute

설명

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


SOAP 헤더 사용	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
기본 모드 필수 권한	UpdateAnySubscription OR(UpdateSubscription 및 사용자가 보고서 소유자이고 구독이 시간 제한 구독임)
SharePoint 모드 필수 권한	<xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> OR(<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> 및 사용자가 구독 소유자이고 구독이 시간 제한 구독임)

매개 변수의 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.

SharePoint 사용자 정보에 있는 SharePoint 비관리 사용자의 '회사 전자 메일' 속성은 TO 전자 메일 배달 확장 프로그램 설정이어야 합니다.

적용 대상

다음을 통해 공유

ReportingService2010.SetSubscriptionProperties 메서드

정의

매개 변수

설명

적용 대상

추가 리소스