次の方法で共有


ReportingService2010.SetSubscriptionProperties メソッド

定義

サブスクリプションのプロパティを設定します。

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 オブジェクトの配列です。

属性

注釈

次の表に、この操作に関連するヘッダーおよび権限の情報を示します。

SOAP ヘッダーの使用方法 (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
ネイティブ モードで必要なアクセス許可 UpdateAnySubscription または (UpdateSubscription、およびユーザーがレポートの所有者であり、サブスクリプションが時刻指定のサブスクリプションであること)
SharePoint モードで必要なアクセス許可 <xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> または (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts>、およびユーザーがサブスクリプションの所有者であり、サブスクリプションが時刻指定のサブスクリプションであること)

EventType パラメーターの値は、レポート サーバーで構成されたイベント処理拡張機能に対応する必要があります。 イベントの種類がイベント処理拡張機能で処理されない場合、エラー コード rsInvalidEvent の SOAP 例外がスローされます。 このイベントの種類は、通知を作成するイベント処理拡張機能で処理される必要があります。 EventType パラメーターの値を受信すると、イベント処理拡張機能のクエリが実行され、イベントが通知を作成するかどうかが決まります。 通知を作成しない場合、エラー コード rsEventNonSubscribeable の SOAP 例外がスローされます。

MatchData パラメーターの値は、イベントの種類によって異なります。 イベントが TimedSubscription イベントである場合は、MatchData パラメーターとして ScheduleDefinition オブジェクトが必要です。 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 となっており、"CCYY" が年、"MM" が月、"DD" が日を表します。 文字 "T" は日付と時刻の区切り記号を表し、"hh"、"mm"、"ss" はそれぞれ時、分、秒を表します。 この表現の直後に "Z" を付けて、協定世界時 (UTC) を示すことができます。 ローカル時刻と協定世界時の差でタイム ゾーンを示すには、"Z" の前に "+"記号か "-" 記号を付け、"Z" の後ろに UTC との差を hh:mm の形式で表します。

TimedSubscription のスケジュール定義が共有スケジュールである場合、共有スケジュールの ID を MatchData パラメーターとして渡す必要があります。 スケジュール ID は、"4608ac1b-fc75-4149-9e15-5a8b5781b843" のように、String として渡されます。 スケジュール ID は、ListSchedules メソッドを呼び出すことにより取得されます。

イベントがスナップショット更新サブスクリプションである場合は、MatchData パラメーターに null (Visual Basic では Nothing) を設定します。

SharePoint 管理者以外のユーザーの SharePoint ユーザー情報である "勤務先の電子メール" プロパティは、電子メール配信拡張機能で設定した宛先である必要があります。

適用対象