Aracılığıyla paylaş


URL erişimi (SSRS)

SQL Server Reporting Services'te (SSRS) rapor sunucusunun URL erişimi, url isteği aracılığıyla bir rapor sunucusuna komut göndermenizi sağlar. Bu işlevsellik, raporları yerel moddaki bir rapor sunucusunda veya SharePoint kitaplığında işleme yönteminizi özelleştirmenize olanak tanır. Örneğin, belirli bir rapor parametresi değerleri kümesini kullanarak raporu görüntüleyebilir veya rapordaki belirli bir ilgi çekici sayfayı görüntüleyebilirsiniz. Önceden tanımlanmış URL erişim parametrelerini kullanarak bu parametreleri bir URL'de tanımlayabilirsiniz.

İşleme biçimleri için parametreler ekleyerek veya rapor görüntüleyicisinin görünümünü belirterek rapor sunucusunun raporu nasıl işlediğini özelleştirebilirsiniz. Daha sonra bu URL'yi başkalarına göndererek raporunuza tarayıcıda aynı şekilde erişebilmelerini sağlayabilirsiniz.

URL erişimi aracılığıyla gerçekleştirebileceğiniz diğer eylemler şunlardır:

URL erişim kavramları

Rapor sunucusu, rapor sunucusuna yönelik URL isteklerinde bulunan parametreleri işler. Rapor sunucusunun URL isteklerini nasıl işlediği, URL'ye dahil edilen parametrelere, parametre ön eklerine ve öğe türlerine bağlıdır. Rapor sunucusu URL'leri, ortak World Wide Web Consortium W3C/IETF taslak standardı tarafından önerilen URL biçimlendirme yönergelerine bağlıdır. Reporting Services URL işlevselliği, standart URL adreslemlerini destekleyen çoğu internet tarayıcısı veya uygulamayla uyumludur.

URL erişimi söz dizimi

URL istekleri herhangi bir sırada listelenen birden çok parametre içerebilir. Parametreleri ampersand (&) ve ad/değer çiftlerini eşittir işaretiyle (=) ayırabilirsiniz.

Bir URL erişim dizesinin farklı bileşenlerini anlamak, komutları bir SSRS rapor sunucusuna etkili bir şekilde göndermek için gereklidir. URL erişim dizesi şunları içerir:

  • https://[rswebserviceurl]: Rapor sunucusunun web hizmeti URL'si.
  • ?: Parametreleri içeren sorgu dizesinin başlangıcını gösterir.
  • [pathinfo]: Sunucudaki raporun veya öğenin yolu.
  • [&prefix:param=value]: Rapor işlemeyi veya davranışı özelleştiren isteğe bağlı ön eklere sahip bir veya daha fazla parametre.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

Söz dizimi açıklaması

Aşağıdaki bölümde, URL erişim dizesinde kullanılan bazı parametrelerin ayrıntılı bir açıklaması sağlanır. Tam liste için bkz. URL erişim parametresi başvurusu.

rswebserviceurl

Rapor sunucusunun web hizmeti URL'si.

  • Yerel mod için, Reporting Services Configuration Manager'da yapılandırılan web hizmeti rapor sunucusu örneği web hizmeti URL'sidir. Daha fazla bilgi için bkz. Rapor sunucusu URL'lerini yapılandırma (Rapor Sunucusu Yapılandırma Yöneticisi).

    Örneğin:

    https://myrshost/reportserver
    https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE
    
  • SharePoint tümleşik modu için, Reporting Services ile tümleşik bir SharePoint sitesindeki Reporting Services proxy'sinin URL'sidir.

    Örneğin:

    https://myspsite/subsite/_vti_bin/reportserver
    

    Tip

    URL'nin, isteği SharePoint ve Reporting Services HTTP ara sunucusu aracılığıyla yönlendirmek için ara sunucu söz dizimini içermesi _vti_bin önemlidir. Ara sunucu, SharePoint modu rapor sunucuları için raporun uygun şekilde yürütülmesini sağlamak üzere HTTP isteğine gerekli bağlamsal bilgileri ekler.

pathinfo

Yerel mod rapor sunucusu veritabanındaki öğenin göreli yol adı veya SharePoint kataloğundaki öğenin tam URL'si.

Katalog öğesinin yolu. Yerel modda, rapor sunucusu veritabanındaki öğenin, eğik çizgiyle (/) başlayan göreli yoludur. Örneğin:

/AdventureWorks2022/Employee_Sales_Summary_2022

SharePoint tümleşik modu için, öğe uzantısı dahil olmak üzere SharePoint kitaplığındaki öğenin tam URL'sidir. Örneğin:

https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl

&prefix:param=value

URL erişim dizesinde, rapor işlemeyi veya davranışı özelleştirmek için parametreler ve karşılık gelen değerleri eklersiniz. İsim/değer çiftlerinde parametre oluşturmak için syntax'ı param=value, işaretiyle (&) ayırabilirsiniz.

Rapor sunucusu içindeki belirli işlemleri hedeflemek için rs: veya rc: gibi isteğe bağlı ön ekleri kullanın.

Uyarı

URL erişim parametresinin ön eki dahil değilse, parametre rapor sunucusu tarafından rapor parametresi olarak işlenir. Rapor parametrelerinde parametre ön eki kullanılmaz ve büyük/küçük harfe duyarlıdır.

Aşağıdaki örnek, bu makalede açıklandığı gibi URL'nin tamamını gösterir:

https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008