Metoda ReportingService2005.SetDataDrivenSubscriptionProperties
Ustawia właściwości subskrypcja oparta na danych.
Przestrzeń nazw: ReportService2005
Zestaw: ReportService2005 (w ReportService2005.dll)
Składnia
'Deklaracja
<SoapHeaderAttribute("BatchHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", _
ResponseNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Sub SetDataDrivenSubscriptionProperties ( _
DataDrivenSubscriptionID As String, _
ExtensionSettings As ExtensionSettings, _
DataRetrievalPlan As DataRetrievalPlan, _
Description As String, _
EventType As String, _
MatchData As String, _
Parameters As ParameterValueOrFieldReference() _
)
'Użycie
Dim instance As ReportingService2005
Dim DataDrivenSubscriptionID As String
Dim ExtensionSettings As ExtensionSettings
Dim DataRetrievalPlan As DataRetrievalPlan
Dim Description As String
Dim EventType As String
Dim MatchData As String
Dim Parameters As ParameterValueOrFieldReference()
instance.SetDataDrivenSubscriptionProperties(DataDrivenSubscriptionID, _
ExtensionSettings, DataRetrievalPlan, _
Description, EventType, MatchData, _
Parameters)
[SoapHeaderAttribute("BatchHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public void SetDataDrivenSubscriptionProperties(
string DataDrivenSubscriptionID,
ExtensionSettings ExtensionSettings,
DataRetrievalPlan DataRetrievalPlan,
string Description,
string EventType,
string MatchData,
ParameterValueOrFieldReference[] Parameters
)
[SoapHeaderAttribute(L"BatchHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",
ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",
Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
public:
void SetDataDrivenSubscriptionProperties(
String^ DataDrivenSubscriptionID,
ExtensionSettings^ ExtensionSettings,
DataRetrievalPlan^ DataRetrievalPlan,
String^ Description,
String^ EventType,
String^ MatchData,
array<ParameterValueOrFieldReference^>^ Parameters
)
[<SoapHeaderAttribute("BatchHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
member SetDataDrivenSubscriptionProperties :
DataDrivenSubscriptionID:string *
ExtensionSettings:ExtensionSettings *
DataRetrievalPlan:DataRetrievalPlan *
Description:string *
EventType:string *
MatchData:string *
Parameters:ParameterValueOrFieldReference[] -> unit
public function SetDataDrivenSubscriptionProperties(
DataDrivenSubscriptionID : String,
ExtensionSettings : ExtensionSettings,
DataRetrievalPlan : DataRetrievalPlan,
Description : String,
EventType : String,
MatchData : String,
Parameters : ParameterValueOrFieldReference[]
)
Parametry
- DataDrivenSubscriptionID
Typ: System.String
Identyfikator subskrypcja, zwrócony przez CreateDataDrivenSubscription metoda.
- ExtensionSettings
Typ: ReportService2005.ExtensionSettings
ExtensionSettings Obiekt, który zawiera listę ustawień, które są specyficzne dla rozszerzenie dostarczania.
- DataRetrievalPlan
Typ: ReportService2005.DataRetrievalPlan
A DataRetrievalPlan obiekt, który zawiera listę ustawień, które są wymagane do pobierania danych z kwerendy dostarczania dla subskrypcja.
- Description
Typ: System.String
Zrozumiały opis jest wyświetlany użytkownikom.
- EventType
Typ: System.String
Typ zdarzenie wyzwalającego subskrypcja.Prawidłowe wartości to TimedSubscription lub SnapshotUpdated.
- MatchData
Typ: System.String
Dane skojarzone z określonego typu zdarzenie.Dane jest używane przez zdarzenie przetwarzania rozszerzenia w celu dopasowania subskrypcja ze zdarzeniem jest uruchamiany.
- Parameters
Typ: array<ReportService2005.ParameterValueOrFieldReference[]
Tablica ParameterValue obiektów, które zawiera listę parametrów raportu.
Uwagi
W poniższej tabela przedstawiono informacje nagłówka i uprawnienia na tej operacji.
Nagłówki SOAP |
(Ruch wychodzący)ServerInfoHeaderValue |
Wymagane uprawnienia |
Aby sterowanych danymi subskrypcja działać poprawnie, źródło danych, DataRetrievalPlan musi mieć odwołania do obiektu CredentialRetrieval Właściwość zestaw do Magazyn.
Field Obiektów zawartych w DataSet są porównywane z pól, które są mapowane na rozszerzenie dostarczania ustawienia i wartości parametru raportu.Wszystkie pola, które w rozszerzenie dostarczania ustawienia i wartości parametrów raportu również musi wyliczyć w zestawie danych.
Nie sprawdzanie poprawności jest wykonywane dla zapewnienia, że pola wyliczane w zestawie danych są zwracane przez kwerendy dostawy.Jeśli pole, które jest wyliczana w zestawie danych nie zostanie zwrócony przez kwerendę dostawy, serwer raportów zgłasza błąd podczas przetwarzania subskrypcja.
Wartość EventType parametru musi odpowiadać zdarzenie przetwarzania rozszerzenia, która jest skonfigurowana serwer raportów.Jeśli zdarzenie nie jest obsługiwany przez rozszerzenie przetwarzania zdarzeń, protokół SOAP jest wyjątek z kodem błędu rsInvalidEvent.Zdarzenia musi być obsługiwane przez zdarzenie przetwarzania rozszerzenia, która tworzy powiadomienia.Gdy wartość dla EventType parametr jest odbierana, zdarzenie przetwarzania rozszerzenie jest proszeni o określenie, czy tworzy powiadomienia.Jeśli nie, protokół SOAP jest wyjątek z kodem błędu rsEventNonSubscribeable.
Wartość MatchData zależy od parametru typu zdarzenie.Jeśli zdarzenie jest TimedSubscription zdarzenie, ScheduleDefinition obiektu wymagany jest jako MatchData parametru.Musisz najpierw serializować ScheduleDefinition jako XML w celu przekazania go jako wartość ciąg i utworzyć obiekt subskrypcja zależności harmonogramu.Struktura XML może wyglądać tak jak w następującym przykładzie:
<ScheduleDefinition>
<WeeklyRecurrence>
<StartDateTime>2003-02-24T09:00:00-08:00</StartDateTime>
<WeeksInterval>1</WeeksInterval>
<DaysOfWeek>
<Monday>True</Monday>
</DaysOfWeek>
</WeeklyRecurrence>
</ScheduleDefinition>
Wartość początekDataCzas elementu, gdy dane są przekazywane jako ciąg znaków XML powinien odpowiadać format data ISO 8601.Międzynarodowe data i czas standardowy jest rozszerzony format SSRR-MM-DDThh:mm:ss +/-Z którym "DW" reprezentuje stulecia "Rr" rok "MM" miesiąc i "dd" dzień.Litera "T" Data i czas separator i "gg", "mm", "ss" reprezentują godziny, minuty i sekundy odpowiednio.Reprezentacja ta może być natychmiast następuje "Z" Aby wskazać skoordynowanego czasu uniwersalnego (UTC).Aby wskazać strefę czasową, reprezentowany jako różnicę między czas lokalnym a Coordinated Universal czas "Z" jest poprzedzony przez "+" lub "-" znak, różnica z UTC reprezentowane jako hh: mm.
Jeśli definicja harmonogram TimedSubscription jest udostępniony harmonogram, a następnie należy przepuścić identyfikator harmonogramu harmonogram udostępnionego jako MatchData parametru.Harmonogram jest przekazywany identyfikator, jako ciąg, na przykład "4608ac1b-fc75-4149-9e15-5a8b5781b843".Harmonogram można uzyskać Identyfikatora, wywołując ListSchedules metoda.
Można użyć XmlSerializer klasy, aby automatycznie przekonwertować ciąg XML klasy obiektu.Więcej informacji o XmlSerializer klasy, zobacz "Klasa System.Xml.XmlSerializer" w programie Microsoft.NET Framework dokumentacji.
Jeśli zdarzenie jest migawka subskrypcja aktualizacji, wartość MatchData powinny być parametr nullodwołanie o wartości null (Nothing w języku Visual Basic) (nic nie w języku Visual Basic).