Yerleşik Genel Değerler ve Kullanıcı Başvuruları (Rapor Oluşturucusu ve SSRS)

Makale
01/15/2013

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.

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.