ReportingService2006.CreateSubscription Yöntemi
Bir abonelik için belirtilen rapor oluşturur rapor sunucusu veritabanı.
Ad Alanı: ReportService2006
Derleme: ReportService2006 (ReportService2006 içinde.dll)
Sözdizimi
'Bildirim
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateSubscription", RequestNamespace := "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", _
ResponseNamespace := "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
Public Function CreateSubscription ( _
Report As String, _
ExtensionSettings As ExtensionSettings, _
Description As String, _
EventType As String, _
MatchData As String, _
Parameters As ParameterValue() _
) As String
'Kullanım
Dim instance As ReportingService2006
Dim Report As String
Dim ExtensionSettings As ExtensionSettings
Dim Description As String
Dim EventType As String
Dim MatchData As String
Dim Parameters As ParameterValue()
Dim returnValue As String
returnValue = instance.CreateSubscription(Report, _
ExtensionSettings, Description, _
EventType, MatchData, Parameters)
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateSubscription", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
public string CreateSubscription(
string Report,
ExtensionSettings ExtensionSettings,
string Description,
string EventType,
string MatchData,
ParameterValue[] Parameters
)
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateSubscription", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
String^ CreateSubscription(
String^ Report,
ExtensionSettings^ ExtensionSettings,
String^ Description,
String^ EventType,
String^ MatchData,
array<ParameterValue^>^ Parameters
)
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateSubscription", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
member CreateSubscription :
Report:string *
ExtensionSettings:ExtensionSettings *
Description:string *
EventType:string *
MatchData:string *
Parameters:ParameterValue[] -> string
public function CreateSubscription(
Report : String,
ExtensionSettings : ExtensionSettings,
Description : String,
EventType : String,
MatchData : String,
Parameters : ParameterValue[]
) : String
Parametreler
- Report
Tür: System.String
Rapor dosya adını ve .rdl dosya adı uzantısı da dahil olmak üzere tam url.
- ExtensionSettings
Tür: ReportService2006.ExtensionSettings
Bir ExtensionSettings özgü olan ayarların bir listesini içeren bir nesne teslim uzantısı.
- Description
Tür: System.String
Kullanıcılara görüntülenen anlamlı bir açıklama.
- EventType
Tür: System.String
Abonelik tetikleyen olay türü.Geçerli değerler TimedSubscription veya SnapshotUpdated.
- MatchData
Tür: System.String
Belirtilen ile ilişkili verileri EventType parametresi.Bu parametre, bir olay, abonelik harekete bir olayla eşleştirmek için kullanılır.
- Parameters
Tür: array<ReportService2006.ParameterValue[]
Bir dizi ParameterValue için rapor parametreleri listesini içeren nesneleri
Dönüş Değeri
Tür: System.String
SharePoint Kitaplığı'nda aboneliği benzersiz şekilde tanımlayan bir abonelik kimliği.
Açıklamalar
Aşağıdaki tablo üstbilgi ve izinler bu işlemi gösterir.
soap üstbilgileri |
(Giden)ServerInfoHeaderValue |
Gerekli izinler |
ViewListItems()AND (ManageAlerts() OR CreateAlerts()) |
Kullanabileceğiniz GetExtensionSettings yöntem için gerekli ayarların bir listesini almak içinbir teslim uzantısı.Bu gerekli ayarları için değerleri geçmesi gereken ExtensionSettings parametresi.E-posta teslimi ayarları hakkında daha fazla bilgi için bkz: Raporlama Hizmetleri teslim uzantısı ayarları.
Değeri EventType parametresi gerekir için yapılandırılmış bir olaya karşılık gelen rapor sunucusu.Abonelikleri oluşturmak için kullanılan iki olayların TimedSubscription ve SnapshotUpdated.Use ListEvents yöntem için rapor sunucusu yapılandırılmış tüm olayların bir listesini döndürmek için
Değeri MatchData parametresi bağlıdır olay türü.Olay ise, bir TimedSubscription olay, bir ScheduleDefinition nesnesi olarak gerekli MatchData parametresi.Seri hale, ilk getirmek gerekir ScheduleDefinition Nesne bir dize değeri olarak geçirmek ve esas Abonelik oluşturmak için xml olarakzamanlama.Aşağıdaki örnekte, bir xml yapısı benzer:
<ScheduleDefinition>
<WeeklyRecurrence>
<StartDateTime>2004-06-24T09:00:00-08:00</StartDateTime>
<WeeksInterval>1</WeeksInterval>
<DaysOfWeek>
<Monday>True</Monday>
</DaysOfWeek>
</WeeklyRecurrence>
</ScheduleDefinition>
Değeri StartDateTime bir xml olarak iletildiğinde öğesi dize ISO 8601 tarih biçimine karşılık gelmelidir.Bu uluslararası tarih ve saat genişletilmiş standart yyyy biçimi-mm-DDThh:mm:ss z +/-burada "cc" "yy" yüzyýlý simgeler, Yıl, "mm" ay ve "Gg" gün."t" harfi Tarih ve saat ayracı ve "ss", "mm", "ss" olduğunu saat, dakika ve saniye temsil sırasıyla.Bu gösterim hemen bir "z" izlenebilir Eşgüdümlü evrensel saat (utc) göstermek için.Eşgüdümlü Evrensel Saat, "z" ve yerel saat arasındaki farkı olarak gösterilen saat dilimini belirtmek için tarafından öncesinde bir "+" veya "-" ss: dd temsil edilen utc Farkı arkasından işareti.
Varsa zamanlamayı tanımı için bir TimedSubscription paylaşılan bir zamanlama. paylaşılan zamanlama zamanlama kimliği geçmesi gereken MatchData parametresi.Kimliği olarak geçirdi zamanlama bir dize, örneğin, "4608ac1b-fc75-4149-9e15-5a8b5781b843".Zamanlama kimliği elde edilebilir çağırarak ListSchedules yöntem.
Kullanabileceğiniz XmlSerializer , nesne sınıfı bir xml biçimine dönüştürmek için sınıf dize otomatik olarak.
Olay ise, bir SnapshotUpdated abonelik, değeri MatchData olması gereken nullnull başvuru (Visual Basic'te Nothing) (veya hiçbir şey Visual Basic).
Bu yöntem kullanıldığında, küme LastExecuted için abonelik özellik yok, Status için abonelik özellik Yeni Abonelikve Active için abonelik özellik doğru.ModifiedBy Ve ModifiedDate rapor özelliklerini de güncelleştirildi.
Belirtilen herhangi bir zamanlama MatchData parametresi, aynı sitede olmalıdır ve Report.
Örnekler
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
class Sample
{
static void Main(string[] args)
{
ReportingService2006 rs = new ReportingService2006();
rs.Url = "http://<Server Name>" +
"/_vti_bin/ReportServer/ReportService2006.asmx";
rs.Credentials =
System.Net.CredentialCache.DefaultCredentials;
string report = "http://<Server Name>" +
"/Docs/Documents/AdventureWorks Sample Reports" +
"/Sales Order Detail.rdl";
string desc = "Send to Document Library";
string eventType = "TimedSubscription";
string scheduleXml =
@"<ScheduleDefinition>" +
" <StartDateTime>2003-02-24T09:00:00-08:00" +
" </StartDateTime>" +
" <WeeklyRecurrence>" +
" <WeeksInterval>1</WeeksInterval>" +
" <DaysOfWeek>" +
" <Monday>True</Monday>" +
" </DaysOfWeek>" +
" </WeeklyRecurrence>" +
"</ScheduleDefinition>";
ParameterValue[] extensionParams = new ParameterValue[6];
extensionParams[0] = new ParameterValue();
extensionParams[0].Name = "RENDER_FORMAT";
extensionParams[0].Value = "EXCEL";
extensionParams[1] = new ParameterValue();
extensionParams[1].Name = "FILENAME";
extensionParams[1].Value = "Sales Order Detail";
extensionParams[2] = new ParameterValue();
extensionParams[2].Name = "FILEEXTN";
extensionParams[2].Value = "True";
extensionParams[3] = new ParameterValue();
extensionParams[3].Name = "PATH";
extensionParams[3].Value = "http://<Server Name>" +
"/Docs/Documents/AdventureWorks Sample Reports/";
extensionParams[4] = new ParameterValue();
extensionParams[4].Name = "WRITEMODE";
extensionParams[4].Value = "Overwrite";
extensionParams[5] = new ParameterValue();
extensionParams[5].Name = "AUTOCOPY";
extensionParams[5].Value = "False";
string matchData = scheduleXml;
ExtensionSettings extSettings = new ExtensionSettings();
extSettings.ParameterValues = extensionParams;
extSettings.Extension = "Report Server DocumentLibrary";
try
{
rs.CreateSubscription(report, extSettings, desc,
eventType, matchData, null);
}
catch (SoapException e)
{
Console.WriteLine(e.Detail.InnerXml.ToString());
}
}
}
Imports System
Imports System.IO
Imports System.Text
Imports System.Web.Services
Imports System.Web.Services.Protocols
Class Sample
Public Shared Sub Main()
Dim rs As New ReportingService2006()
rs.Url = "http://<Server Name>" + _
"/_vti_bin/ReportServer/ReportService2006.asmx"
rs.Credentials = _
System.Net.CredentialCache.DefaultCredentials
Dim report As String = "http://<Server Name>/Docs/" + _
"Documents/AdventureWorks Sample Reports/" + _
"Sales Order Detail.rdl"
Dim desc As String = "Send to Document Library"
Dim eventType As String = "TimedSubscription"
Dim scheduleXml As String = _
"<ScheduleDefinition>" + _
" <StartDateTime>2003-02-24T09:00:00-08:00</StartDateTime>" + _
" <WeeklyRecurrence>" + _
" <WeeksInterval>1</WeeksInterval>" + _
" <DaysOfWeek>" + _
" <Monday>True</Monday>" + _
" </DaysOfWeek>" + _
" </WeeklyRecurrence>" + _
"</ScheduleDefinition>"
Dim extensionParams(6) As ParameterValue
extensionParams(0) = New ParameterValue()
extensionParams(0).Name = "RENDER_FORMAT"
extensionParams(0).Value = "EXCEL"
extensionParams(1) = New ParameterValue()
extensionParams(1).Name = "FILENAME"
extensionParams(1).Value = "Sales Order Detail"
extensionParams(2) = New ParameterValue()
extensionParams(2).Name = "FILEEXTN"
extensionParams(2).Value = "True"
extensionParams(3) = New ParameterValue()
extensionParams(3).Name = "PATH"
extensionParams(3).Value = "http://<Server Name>" + _
"/Docs/Documents/AdventureWorks Sample Reports/"
extensionParams(4) = New ParameterValue()
extensionParams(4).Name = "WRITEMODE"
extensionParams(4).Value = "Overwrite"
extensionParams(5) = New ParameterValue()
extensionParams(5).Name = "AUTOCOPY"
extensionParams(5).Value = "False"
Dim matchData As String = scheduleXml
Dim extSettings As New ExtensionSettings()
extSettings.ParameterValues = extensionParams
extSettings.Extension = "Report Server DocumentLibrary"
Try
rs.CreateSubscription(report, extSettings, desc, _
eventType, matchData, Nothing)
Catch e As SoapException
Console.WriteLine(e.Detail.InnerXml.ToString())
End Try
End Sub
End Class