SOAP kullanarak Reporting Services'i entegre edin - Windows uygulaması

Rapor sunucusunun tam işlevselliğine Reporting Services SOAP API'si üzerinden erişebilirsiniz. SOAP API, bir Web hizmetidir ve bu nedenle özel iş uygulamalarınıza kurumsal raporlama özellikleri sağlamak için kolayca erişilebilir. Web servisine, Windows uygulamasında sadece hizmete çağrı yapan kod yazarak erişebilirsiniz. Microsoft .NET Framework'ü kullanarak, Web servisinin özelliklerini ve yöntemlerini ortaya çıkaran bir proxy sınıfı oluşturabilirsiniz. Daha sonra tanıdık bir altyapı ve araçlar kullanarak Reporting Services teknolojisi üzerine kurulmuş iş uygulamaları oluşturabilirsiniz.

Windows Forms kullanarak Rapor Yönetimi işlevselliğini entegre edin

URL erişiminden farklı olarak, SOAP API, rapor sunucusu aracılığıyla erişilebilir olan tüm yönetim fonksiyonları setini sunar. Bu, Report Manager'ın tüm yönetici işlevselliğinin geliştiricilere SOAP aracılığıyla erişilebilir olduğu anlamına gelir. Bu nedenle, Windows Forms kullanarak tam bir yönetim ve yönetim aracı geliştirebilirsiniz. Örneğin, Windows uygulamanızda kullanıcıların rapor sunucusu isim alanının içeriğini almasını sağlamak isteyebilirsiniz. Web servis ListChildren yöntemini kullanarak rapor sunucusu veritabanındaki tüm öğeleri listeleyebilir ve ardından Listview, Treeview veya Combobox kontrolünü kullanarak bu öğeleri kullanıcılarınıza gösterebilirsiniz. Bir kullanıcı bir formda bir düğme seçtiğinde, bir kullanıcının My Reports klasöründeki mevcut raporların mevcut listesini almak için aşağıdaki Web servis kodu kullanılabilir:

' Button click event that retrieves a list of reports from  
' the My Reports folder and displays them in a combo box  
Private Sub listReportsButton_Click(sender As Object, e As System.EventArgs)  
   ' Create a new Web service object and set credentials  
   ' to Windows Authentication  
   Dim rs As New ReportingService2010()  
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials  
  
   ' Return the list of items in My Reports  
   Dim items As CatalogItem() = rs.ListChildren("/Adventureworks Sample Reports", False)  
  
   Dim ci As CatalogItem  
   For Each ci In  items  
      ' If the item is a report, add it to   
      ' a combo box  
      If ci.TypeName = "Report" Then  
         catalogComboBox.Items.Add(ci.Name)  
      End If  
   Next ci  
End Sub 'listReportsButton_Click  

// Button click event that retrieves a list of reports from  
// the My Reports folder and displays them in a combo box  
private void listReportsButton_Click(object sender, System.EventArgs e)  
{  
   // Create a new Web service object and set credentials  
   // to Windows Authentication  
   ReportingService2010 rs = new ReportingService2010();  
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  
  
   // Return the list of items in My Reports  
   CatalogItem[] items = rs.ListChildren("/Adventureworks Sample Reports", false);  
  
   foreach (CatalogItem ci in items)  
   {  
      // If the item is a report, add it to   
      // a combo box  
      if (ci.TypeName == "Report")  
         catalogComboBox.Items.Add(ci.Name);  
   }  
}

Buradan, kullanıcıların Combo kutusundan raporu seçip form üzerinde web tarayıcısı kontrolü veya görüntü kontrolü kullanarak önizlemelerini sağlayabilirsiniz.

Windows Forms kullanarak Rapor Görüntüleme ve Gezinmeyi etkinleştirin

Raporları Windows Forms uygulamalarınıza entegre etmek için iki yöntem mevcuttur.

SOAP API'sini kullanarak desteklenen render formatlarından Render herhangi birine rapor verebilirsiniz. SOAP üzerinden rapor görüntüleme ve gezinmeyi etkinleştirmenin küçük dezavantajları vardır:

  • URL erişimi yoluyla HTML Viewer ile birlikte gelen rapor araç çubuğunun yerleşik işlevselliğinden yararlanamazsınız.

  • HTML'e render ederseniz, bu yöntemle herhangi bir görselleri veya kaynakları ek akış RenderStream olarak ayrı olarak render etmelisiniz.

  • URL erişimiyle rapor oluşturmak, SOAP API'sine göre küçük bir performans avantajı sağlar.

Ancak, Render SOAP API yöntemi raporları render etmek ve programatik olarak çeşitli çıktı formatlarına kaydetmek için kullanılabilir. Bu yöntem, kullanıcı etkileşimi gerektiren URL erişimine göre bir avantajdır. SOAP API Render yöntemiyle bir rapor oluşturduğunuzda, desteklenen çıktı formatlarından herhangi birine render yapabilirsiniz.

Ayrıca Microsoft Visual Studio 2008 ile birlikte sunulan ücretsiz dağıtılabilir Rapor Görüntüleyici kontrollerini de kullanabilirsiniz. Report Viewer kontrolleri, Reporting Services işlevselliğini özel uygulamalara kolayca entegre etmeyi sağlar. Report Viewer kontrolleri, uygulama özellik setinin parçası olarak önceden tasarlanmış, tam olarak yazılmış raporlar sunmak isteyen geliştiriciler için tasarlanmıştır. Örneğin, bir web sitesi yönetim uygulaması, şirket web sitelerinde tıklama akışı analizini gösteren raporlar içerebilir. Kontrolleri bir uygulamaya gömmek, Reporting Services sunucu bileşenlerini uygulama dağıtımınıza dahil etmek için daha kolay bir alternatif sunar. Kontroller, rapor işlevselliği sağlar, ancak Reporting Services'te bulunan ekstra rapor yazarlığı, yayımlama veya dağıtım ve teslimat desteği yoktur.

Report Viewer kontrollerinin iki versiyonu vardır: biri zengin Windows istemci uygulamaları için, diğeri ise ASP.NET uygulamaları için. Kontroller hem yerel işleme hem de uzaktan işlem modlarını destekler. Yerel işlem modunda, uygulamanız rapor tanımını ve veri setlerini sağlar ve rapor işlemesini tetikler. Uzaktan işleme modunda, veri alımı ve rapor işleme rapor sunucusunda gerçekleşir ve kontrol görüntüleme ve rapor navigasyonu için kullanılır. Bu model, masaüstünden kurumsal sisteme ölçeklendirilebilen zengin uygulamalar oluşturmanıza olanak tanır.

Report Viewer kontrolleri Visual Studio online Yardım'da belgelenmiştir. Daha fazla bilgi için Visual Studio ürün dokümantasyonuna bakınız.

İlgili içerik

  • Last updated on