Yerleşik Genel Değerler ve Kullanıcı Başvuruları (Rapor Oluşturucusu ve SSRS)
Globals ve User koleksiyonlarını içeren Yerleşik alanlar koleksiyonu, bir rapor işlendiğinde Reporting Services tarafından sağlanan genel değerleri temsil eder. Globals topluluğu, raporun adı, rapor işlemenin başladığı zaman ve rapor üstbilgisi veya altbilgisi için geçerli sayfa numaraları gibi değerleri sağlar. User topluluğu, kullanıcı tanımlayıcıyı ve dil ayarlarını sağlar. Bu değerler, bir rapordaki sonuçları filtrelemek üzere ifadelerde kullanılabilir.
[!NOT]
SQL Server Data Tools'daki Rapor Oluşturucusu ve Rapor Tasarımcısı ile rapor tanımları (.rdl) oluşturabilir ve bunları değiştirebilirsiniz. Her yazma ortamı raporları ve ilişkili öğeleri oluşturmak, açmak ve kaydetmek için farklı yollar sağlar. Daha fazla bilgi için, Web'de microsoft.com sitesinde Rapor Tasarımcısı'nda ve Oluşturucusu'nda Rapor Tasarlama makalesine bakın.
Genel Topluluğu Kullanma
Globals topluluğu, rapor için genel değişkenleri içerir. Tasarım yüzeyinde bu değişkenler bir & (ve işareti) öneki ile birlikte görüntülenir; örneğin, [&ReportName]. Aşağıdaki tabloda, Globals topluluğunun üyeleri açıklanmaktadır.
Üye |
Tür |
Açıklama |
---|---|---|
ExecutionTime |
DateTime |
Raporun çalışmaya başladığı tarih ve saat. |
PageNumber |
Integer |
Sayfa numarasını sıfırlayan sayfa sonlarına göre geçerli sayfanın numarası. Rapor işleme işleminin başlangıcında, ilk değer 1 olarak ayarlanır. İşlenen her sayfayla birlikte sayfa numarası artırılır. Dikdörtgen, veri bölgesi, veri bölgesi grubu veya haritada sayfa sonları içindeki sayfaları numaralandırmak için, PageBreak özelliğinde ResetPageNumber özelliğini True olarak ayarlayın. Tablix sütunu hiyerarşi gruplarında desteklenmez. PageNumber yalnızca sayfa üstbilgilerinde veya sayfa altbilgilerinde bulunan ifadelerde kullanılabilir. |
ReportFolder |
String |
Raporu içeren klasörün tam yolu. Bu, rapor sunucusu URL’sini içermez. |
ReportName |
String |
Raporun, rapor sunucusu veritabanında depolanan adı. |
ReportServerUrl |
String |
Raporun çalıştırılmakta olduğu rapor sunucusunun URL’si. |
TotalPages |
Integer |
PageNumber özelliğini sıfırlayan sayfa sonlarına göre toplam sayfa sayısı. Hiçbir sayfa sonu ayarlanmazsa, bu değer OverallTotalPages ile aynı olur. TotalPages yalnızca sayfa üstbilgilerinde veya sayfa altbilgilerinde bulunan ifadelerde kullanılabilir. |
PageName |
String |
Sayfanın adı. Rapor işleme işleminin başlangıcında, ilk değer bir rapor özelliği olan InitialPageName özelliğinden ayarlanır. Her rapor öğesi işlendikçe, bu değerin yerini dikdörtgenin, veri bölgesinin, veri bölgesi grubunun veya haritanın buna karşılık gelen PageName değeri alır. Tablix sütunu hiyerarşi gruplarında desteklenmez. PageName yalnızca sayfa üstbilgilerinde veya sayfa altbilgilerinde bulunan ifadelerde kullanılabilir. |
OverallPageNumber |
Integer |
Raporun tamamı için geçerli sayfanın numarası. ResetPageNumber özelliği bu değeri etkilemez. OverallPageNumberyalnızca sayfa üstbilgilerinde veya sayfa altbilgilerinde bulunan ifadelerde kullanılabilir. |
OverallTotalPages |
Integer |
Raporun tamamı için toplam sayfa sayısı. ResetPageNumber özelliği bu değeri etkilemez. OverallTotalPagesyalnızca sayfa üstbilgilerinde veya sayfa altbilgilerinde bulunan ifadelerde kullanılabilir. |
RenderFormat |
RenderFormat |
Geçerli işleme isteği hakkındaki bilgiler. Daha fazla bilgi için bir sonraki bölümde "RenderFormat" konusuna bakın. |
Globals topluluğunun üyeleri bir değişken döndürür. Bu topluluğun bir üyesini, belirli bir veri türü gerektiren bir ifadede kullanmak istiyorsanız önce değişkeni yayınlamalısınız. Örneğin, yürütme zamanı değişkenini bir Tarih biçimine dönüştürmek için =CDate(Globals!ExecutionTime) kullanın. Daha fazla bilgi için, bkz. İfadelerdeki Veri Türleri (Rapor Oluşturucusu ve SSRS).
RenderFormat
Aşağıdaki tabloda RenderFormat için üyeler açıklanmaktadır.
Üye |
Tür |
Açıklama |
---|---|---|
Ad |
String |
RSReportServer yapılandırma dosyasına kaydedildiği şekliyle işleyenin adı. Rapor işleme döngüsünün belirli bölümleri sırasında kullanılabilir. |
IsInteractive |
Boolean |
Geçerli işleme isteğinin etkileşimli işleme biçimi kullanıp kullanmadığı. |
DeviceInfo |
Salt okunur ad/değer koleksiyonu |
Geçerli işleme isteğindeki deviceinfo parametrelerinin anahtar/değer çiftleri. Dize değerleri, anahtarı veya koleksiyonun içinde bir dizini kullanarak belirtilebilir. |
Örnekler
Aşağıdaki örneklerde, Globals topluluğuna yapılan bir başvurunun bir ifadede nasıl kullanılacağı açıklanmaktadır:
Raporun altbilgisindeki metin kutusuna yerleştirilen bu ifade, rapordaki sayfa numarasını ve toplam sayfa sayısını verir:
=Globals.PageNumber & " of " & Globals.TotalPages
Bu ifade, raporun adını ve çalıştırılma zamanını sağlar. Zaman, kısa tarih için olan Microsoft .NET Framework biçimlendirme dizesi ile biçimlendirilir:
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
Kullanıcı Topluluğunu Kullanma
User topluluğu, raporu çalıştıran kullanıcı hakkındaki verileri içerir. Bir raporda görüntülenen verileri filtrelemek için, örneğin yalnızca geçerli kullanıcının verilerini göstermek veya Kullanıcı Kimliğini örneğin bir rapor başlığında göstermek için bu topluluğu kullanabilirsiniz. Tasarım yüzeyinde bu değişkenler bir & (ve işareti) öneki ile birlikte görüntülenir; örneğin, [&UserID].
Aşağıdaki tabloda, User topluluğunun üyeleri açıklanmaktadır.
Üye |
Tür |
Açıklama |
---|---|---|
Language |
String |
Raporu çalıştıran kullanıcının dili. Örneğin, en-US. |
UserID |
String |
Raporu çalıştıran kullanıcının kimliği. Windows Kimlik Doğrulaması kullanıyorsanız bu değer, geçerli kullanıcının etki alanı hesabıdır. Değer, Windows Kimlik Doğrulaması veya özel bir kimlik doğrulaması kullanabilen Reporting Services güvenlik uzantısı tarafından belirlenir. |
Bir raporda birden fazla dilin desteklenmesi hakkında daha fazla bilgi için, SQL Server Books Online adresindeki Reporting Services belgelerinde "Solution Design Considerations for Multi-Lingual or Global Deployments" (Çok Dilde veya Genel Dağıtımlar için Çözüm Tasarımında Dikkate Alınacak Noktalar) belgesine bakın.
Yerel Ayarları Kullanma
ir raporun kullanıcıya nasıl göründüğünü belirlemek için, User.Language değeri üzerinden bir istemci bilgisayardaki yerel ayarlara başvurmak için ifadeleri kullanabilirsiniz. Örneğin, yerel değere bağlı farklı bir sorgu ifadesi kullanan bir rapor oluşturabilirsiniz. Sorgu, döndürülen dile bağlı olarak farklı bir sütundan yerelleştirilmiş bilgileri almak üzere değiştirilebilir. Ayrıca, bu değişkene bağlı olarak rapor veya rapor öğelerindeki dil ayarlarında da bir ifade kullanabilirsiniz.
[!NOT]
Bir raporun dil ayarlarını değiştirebilseniz de, bunun yol açabileceği ekran sorunlarına dikkat etmelisiniz. Örneğin, raporun yerel ayarını değiştirmek, rapordaki tarih biçimini değiştirebilir ancak para birimi biçimini de değiştirebilir. Para birimi için bir dönüştürme işlemi olmadığı sürece bu raporda yanlış para birimi simgesinin görüntülenmesine neden olabilir. Bunu önlemek için değiştirmek istediğiniz bireysel öğeler hakkındaki dil bilgilerini ayarlayın veya para birimi verileri içeren öğeyi belirli bir dile ayarlayın.
Anlık Görüntü veya Geçmiş Raporları için Kullanıcı Kimliğini Belirleme
Bazı durumlarda, User!UserID değişkenini içeren raporlar, raporu görüntüleyen geçerli kullanıcıya özel rapor verilerini gösteremeyebilir.
Ayrıca bkz.
Başvuru
İfade İletişim Kutusu (Rapor Oluşturucusu)
İfade Örnekleri (Rapor Oluşturucusu ve SSRS)
Kavramlar
İfadeler (Rapor Oluşturucusu ve SSRS)
İfadelerdeki Veri Türleri (Rapor Oluşturucusu ve SSRS)
Sayıları ve Tarihleri Biçimlendirme (Rapor Oluşturucusu ve SSRS)