ReportingService2010.SetSubscriptionProperties Metode

Definisi

Ruang nama:

ReportService2010

Rakitan:

ReportService2010.dll

Mengatur properti langganan.

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())

Parameter

SubscriptionID

String

ID langganan.

ExtensionSettings

ExtensionSettings

Objek ExtensionSettings yang berisi daftar pengaturan yang khusus untuk ekstensi pengiriman.

Description

String

Deskripsi yang bermakna yang ditampilkan kepada pengguna.

EventType

String

Jenis peristiwa yang memicu langganan.

MatchData

String

Data yang terkait dengan jenis peristiwa yang ditentukan. Data ini digunakan oleh ekstensi pemrosesan peristiwa untuk mencocokkan langganan dengan peristiwa yang telah diaktifkan.

Parameters

ParameterValue[]

Array ParameterValue objek yang berisi daftar parameter untuk laporan.

Atribut

SoapDocumentMethodAttribute SoapHeaderAttribute

Keterangan

Tabel di bawah ini memperlihatkan informasi header dan izin pada operasi ini.

Penggunaan Header SOAP	(Dalam) TrustedUserHeaderValue (Keluar) ServerInfoHeaderValue
Izin Yang Diperlukan Mode Asli	UpdateAnySubscription ATAU (UpdateSubscription DAN pengguna adalah pemilik laporan dan langganan adalah langganan berwakmata)
Izin Yang Diperlukan Mode SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> OR (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> DAN pengguna adalah pemilik langganan dan langganan adalah langganan berwaklik)

Nilai EventType parameter harus sesuai dengan ekstensi pemrosesan peristiwa yang dikonfigurasi di server laporan. Jika jenis peristiwa tidak ditangani oleh ekstensi pemrosesan peristiwa, pengecualian SOAP dilemparkan dengan kode rsInvalidEventkesalahan . Jenis peristiwa harus ditangani oleh ekstensi pemrosesan peristiwa yang membuat pemberitahuan. Saat nilai untuk EventType parameter diterima, ekstensi pemrosesan peristiwa dikueri untuk menentukan apakah peristiwa membuat pemberitahuan. Jika tidak, pengecualian SOAP dilemparkan dengan kode rsEventNonSubscribeablekesalahan .

Nilai MatchData parameter tergantung pada jenis peristiwa. Jika peristiwa adalah TimedSubscription peristiwa, ScheduleDefinition objek diperlukan sebagai MatchData parameter . Anda harus terlebih dahulu membuat serialisasi ScheduleDefinition objek sebagai XML untuk meneruskannya sebagai nilai string dan membuat langganan berdasarkan jadwal. Struktur XML mungkin menyerupai yang ada dalam contoh berikut:

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

Nilai StartDateTime elemen ketika diteruskan sebagai string XML harus sesuai dengan format tanggal ISO 8601. Standar tanggal dan waktu internasional ini adalah format diperpanjang CCYY-MM-DDThh:mm:ss+/-Z di mana "CC" mewakili abad, "YY" tahun, "MM" bulan dan "DD" hari itu. Huruf "T" adalah pemisah tanggal dan waktu dan "hh", "mm", "ss" masing-masing mewakili jam, menit, dan detik. Representasi ini dapat segera diikuti oleh "Z" untuk menunjukkan Waktu Universal Terkoordinasi (UTC). Untuk menunjukkan zona waktu, dinyatakan sebagai perbedaan antara waktu lokal dan Waktu Universal Terkoordinasi, "Z" didahului oleh tanda "+" atau "-", diikuti oleh perbedaan dari UTC yang diwakili sebagai hh:mm.

Jika definisi jadwal untuk adalah TimedSubscription jadwal bersama, Anda harus meneruskan ID jadwal jadwal bersama sebagai MatchData parameter . ID jadwal diteruskan sebagai String, misalnya, "4608ac1b-fc75-4149-9e15-5a8b5781b843". ID jadwal dapat diperoleh dengan memanggil ListSchedules metode .

Jika peristiwa adalah langganan pembaruan rekam jepret, atur MatchData parameter ke null (Nothing di Visual Basic).

Properti 'Email kerja' pengguna non-administratif SharePoint di Informasi Pengguna SharePoint mereka harus menjadi pengaturan ekstensi pengiriman email TO