Gelişmiş Teknikler: Değişkenlerde Depolanan Değerlere Başvurma

Başlığı geçerli kullanıcının adını görüntüleyen bir analiz oluşturmak isteyebilirsiniz. Bunu bir değişkene başvurarak yapabilirsiniz.

Analiz, kumanda tablosu ve eylemlerinizde bir kaç farklı değişken tipine referans verebilirsiniz: oturum, semantik model (veri havuzu), sunum, istek ve genel. İçerik yetkilileri sunum, istek ve global değişkenleri kendileri tanımlayabilir ancak diğer tipler (oturum ve semantik model (veri havuzu) sizin için semantik modelde tanımlanır.

Not: Oracle Analitik, veri kaynağı bağlantısı kimlik bilgilerinde :user ve :password değişkenlerini desteklemez.

Değişken Türü	Şurada tanımlandı	Tanımlayan	Daha Fazla Bilgi
Oturum Sistem Sistem dışı	Semantik model	Veri modelini yazanlar	Oturum Değişkenleri Hakkında
Semantik Model (Veri Havuzu) Dinamik Statik	Semantik model	Veri modelini yazanlar	Semantik Model (Veri Havuzu) Değişkenleri Hakkında
Sunu	Analiz ve kumanda tabloları için bilgi istemleri	İçerik yetkilileri	Sunum Değişkenleri Hakkında
İstek	Analiz ve kumanda tabloları için bilgi istemleri	İçerik yetkilileri	İstek Değişkenleri Hakkında
Genel	Analizler	Yöneticiler	Genel Değişkenler Hakkında ve Genel Değişkenler Oluşturma

Oturum Değişkenleri Hakkında

Kullanıcı oturum açtığında oturum değişkenleri başlatılmaz.

Bu değişkenler her bir kullanıcı için gezinme oturumları süresi boyunca mevcuttur ve kullanıcı gözatıcıyı kapatıldığında veya oturumu kapadığında süreleri sona erer. İki tür oturum değişkeni vardır: sistem ve sistem dışı.

Sistem Oturumu Değişkenleri

Raporlar ve kumanda tablolarında kullanabileceğiniz bazı sistem oturumu değişkenleri var.

Herhangi başka bir değişken türü için kullanamamanız amacıyla sistem oturumu değişkenlerinin ayrılmış adları vardır.

Sistem Oturumu Değişkeni	Açıklama	Örnek SQL Sorgu Değeri (Değişken iletişim kutusu)
PORTALPATH	Oturum açtıktan sonra kullanıcının gördüğü kumanda tablosu öndeğerini belirtir (oturum açtıktan sonra bu tercihi geçersiz kılabilirler).	Kullanıcı oturum açtığında 'mydashboard' görüntülemek için: select ‘/shared/_portal/mydashboard’ from dual;
TIMEZONE	Kullanıcı oturum açtığında zaman dilimi öndeğerini belirtir. Kullanıcının zaman dilimi genel olarak kullanıcı profilinden doldurulur. Kullanıcılar tercihler yoluyla zaman dilimi öndeğerlerini değiştirebilir (Hesabım).	Kullanıcı oturum açtığında zaman dilimini ayarlamak için: select ‘(GMT-08:00) Pacific Time (US & Canada)’ from dual;
DATA_TZ	Veriye yönelik orijinal zaman diliminden konum belirler. Kullanıcıların uygun dilimi görebilmeleri için bu değişken bir zaman dilimini dönüştürmenizi sağlar.	Zaman verilerini Doğu Standart Saatine (EST) dönüştürmek için: select ‘GMT-05:00’ from dual; Bu örnek, Greenwich Saati'ni (GMT) ifade eder- 5 saat
DATA_DISPLAY_TZ	Veri görüntülemek için zaman dilimini belirtir.	Standart Doğu Saatini (EST) görüntülemek için: select ‘GMT-05:00’ from dual; Bu örnek, Greenwich Saati'ni (GMT) ifade eder- 5 saat

Sistem Dışı Oturum Değişkenleri

Sistem dışı oturum değişkenleri semantik modelinizde adlandırılır ve oluşturulur.

Örneğin, veri modelleyiciniz yönetici, bir kullanıcının oturum açtığında satış bölgesinin adını başlatan bir Satış Bölgesi değişkeni oluşturabilir.

Semantik Model (Veri Havuzu) Değişkenleri Hakkında

Semantik model (veri havuzu) değişkeni, herhangi bir zamanda tek bir değere sahip olan bir değişkendir.

Semantik model (veri havuzu) değişkenleri statik veya dinamik olabilir. Statik bir semantik model (veri havuzu) değişkeni, yönetici değiştirinceye kadar değişmeden devam eden değere sahiptir. Dinamik bir semantik model (veri havuzu) değişkeni, sorgulardan dönen verilerin yenilediği değere sahiptir.

Sunum Değişkenleri Hakkında

Bir sütun bilgi istemi veya değişken bilgi istemi oluştururken bir sunum değişkeni oluşturursunuz.

Tür	Açıklama
Sütun bilgi istemi	Bir sütun isteminin parçası olarak oluşturulan sunum değişkeni sütun ile ilişkilendirilir ve bu değişkenin alabileceği değerler sütun değerlerinden gelir. Bir sütun isteminin parçası olarak bir sunum değişkeni oluşturmak için Yeni İstem iletişim kutusunda Bir değişken ayarla alanındaki Sunum Değişkeni'ni seçmeniz gerekir. Değişken Adı alanına değişken için bir ad girin.
Değişken bilgi istemi	Bir değişken isteminin parçası olarak oluşturulan sunum değişkeni herhangi bir sütun ile ilişkilendirilmez. Bu yüzden sunum değişkeninin alabileceği değerleri siz tanımlarsınız. Bir değişken isteminin parçası olarak bir sunum değişkeni oluşturmak için Yeni İstem iletişim kutusunda İstem alanındaki Sunum Değişkeni'ni seçmeniz gerekir. Değişken Adı alanına değişken için bir ad girin.

Tür

Açıklama

Sütun bilgi istemi

Bir sütun isteminin parçası olarak oluşturulan sunum değişkeni sütun ile ilişkilendirilir ve bu değişkenin alabileceği değerler sütun değerlerinden gelir.

Bir sütun isteminin parçası olarak bir sunum değişkeni oluşturmak için Yeni İstem iletişim kutusunda Bir değişken ayarla alanındaki Sunum Değişkeni'ni seçmeniz gerekir. Değişken Adı alanına değişken için bir ad girin.

Değişken bilgi istemi

Bir değişken isteminin parçası olarak oluşturulan sunum değişkeni herhangi bir sütun ile ilişkilendirilmez. Bu yüzden sunum değişkeninin alabileceği değerleri siz tanımlarsınız.

Bir değişken isteminin parçası olarak bir sunum değişkeni oluşturmak için Yeni İstem iletişim kutusunda İstem alanındaki Sunum Değişkeni'ni seçmeniz gerekir. Değişken Adı alanına değişken için bir ad girin.

Bir sunum değişkeninin değeri birlikte oluşturulduğu sütun veya değişken istemi tarafından doldurulur. Bu olay şu şekilde gerçekleşir: Bir kullanıcının sütun veya değişken isteminde bir veya daha fazla değer seçtiği her seferde, sunum değişkeninin değeri kullanıcının seçtiği değer veya değerlere ayarlanır.

İstek Değişkenleri Hakkında

İstek değişkeni, bir sütun istemi tarafından başlatılan veritabanı isteğinin süresi boyunca bir oturum değeri üzerine yazmanıza olanak sağlar. Bir istek değişkenini, sütun değişkeni oluşturma işleminin bir parçası olarak oluşturabilirsiniz.

Bir istek değişkenini, aşağıdaki kumanda tablosu istem türlerini oluşturma işleminin bir parçası olarak oluşturabilirsiniz.

Bir sütun isteminin parçası olarak oluşturulan istek değişkeni sütun ile ilişkilendirilir ve bu değişkenin alabileceği değerler sütun değerlerinden gelir.

Bir sütun isteminin parçası olarak bir istek değişkeni oluşturmak için Yeni İstem iletişim kutusunda Bir değişken ayarla alanındaki İstek Değişkeni'ni seçmeniz gerekir. Değişken Adı alanına üzerine yazdırılacak oturum değişkeninin adını girin.
Bir değişken isteminin parçası olarak oluşturulan istek değişkeni herhangi bir sütun ile ilişkilendirilmez. Bu yüzden istek değişkeninin alabileceği değerleri siz tanımlarsınız.

Değişken isteminin parçası olarak bir istek değişkeni oluşturmak için Yeni İstem iletişim kutusunda (veya İstem Düzenle iletişim kutusunda) İstem alanındaki İstek Değişkeni'ni seçmeniz gerekir. Daha sonra Değişken Adı alanına üzerine yazdırmak istediğiniz oturum değişkeninin adını girin.

Bir istek değişkeninin değeri birlikte oluşturulduğu sütun istemi tarafından doldurulur. Bu olay şu şekilde gerçekleşir: Bir kullanıcının sütun isteminde bir değer seçtiği her seferde, istem değişkeninin değeri kullanıcının seçtiği değere ayarlanır. Ancak bu değer, kullanıcının istem için Git düğmesine başladığı andan, analiz sonuçlarının kumanda tablosuna döndürüldüğü ana kadar geçen süre için geçerlidir.

İstek değişkenleri belirli sistem oturum değişkenleri (USERGUID veya ROLES gibi) üzerine yazamazlar. DATA_TZ ve DATA_DISPLAY_TZ (Saat Dilimi) gibi diğer sistem oturum değişkenleri Model Yönetim Aracında konfigüre edilirse üzerine yazılabilir.

Yalnızca dize ve sayısal istek değişkenleri çoklu değerleri destekler. Tüm diğer veri türleri yalnızca birinci değeri iletir.

Genel Değişkenler Hakkında

Genel değişken, belli bir veri türünün bir değerle birleştirilmesiyle oluşturulmuş bir sütundur. Değer; Tarih, Tarih ve Saat, Sayı, Metin ve Saat olabilir.

Genel değişken, analizin yürütüldüğü zaman değerlendirilir ve genel değişkenin değeri uygun şekilde yerine geçirilir.

Sadece İş Zekası Hizmet Yöneticisi rolüne sahip kullanıcılar global değişkenleri yönetebilir (ekle, düzenle ve sil).

Sütun Formülünü Düzenle iletişim kutusunu kullanarak, analiz oluşturma işlemi sırasında bir genel değer oluşturursunuz. Değişken daha sonra kataloga kaydedilir ve belli bir geçici sistem içindeki diğer tüm analizler için kullanılabilir hale getirilir.

Genel Değişkenler Oluşturma

Bir hesabı genel bir değişken olarak kaydedip daha sonra farklı analizlerde kullanabilirsiniz.

Düzenlemek için analizi açın.
Seçilen Sütunlar bölmesinde, sütun adının yanındaki Seçenekler'e tıklayın.

.gif'' çiziminin açıklaması
Sütun Formülü sekmesini görüntülemek için Formülü Düzenle'ye tıklayın.
Değişken'e tıklayın ve Global seçin.
Yeni Global Değişken Ekle'ye tıklayın.

.gif'' çiziminin açıklaması
Ad alanı için bir değer girin. Örneğin, gv_region, date_and_time_global_variable veya rev_eastern_region_calc_gv.
Genel değişken adı, değişkene başvurulduğunda tam nitelenmiş olmalı. Bu yüzden, adın "global.variables" şeklinde bir öneki vardır. Örneğin, geliri hesaplamak için ayarlanan bir genel değişken, Sütun Formülü iletişim kutusunda şu şekilde görünür:
"Base Facts"."1- Revenue"*@{global.variables.gv_qualified}
Tür ve Değer için değer girin.
- Veri türü olarak "Tarih ve Saat"i seçiyorsanız, değerleri şu örnekteki gibi girin: 03/25/2004 12:00:00 AM
- Bir ifadeyi ve hesabı değer olarak giriyorsanız, şu örnekte olduğu gibi Metin veri türünü kullanmanız gerekir: "Base Facts"."1- Revenue"*3.1415
Tamam'a tıklayın. Yeni genel değişken, Genel Değişken Ekle iletişim kutusuna eklenir.
Oluşturduğunuz yeni global değişkeni seçin ve Tamam'a tıklayın. Sütun Formülünü Düzenle iletişim kutusu, Sütun Formülü bölmesine eklenen genel değişkenle birlikte görüntülenir. Özel Başlıklar onay kutusu otomatik olarak seçilir.
Değişkeni daha doğru yansıtmak için genel değişken atadığınız sütun için yeni bir ad girin.
Tamam'a tıklayın.

Başvuru Değişkenleri İçin Sözdizimi

Analizlerdeki ve kumanda tablolarındaki değişkenlere başvurabilirsiniz.

Bir değişkene nasıl başvuracağınız gerçekleştirmekte olduğunuz göreve bağlıdır. İletişim kutusunda alanlar bulunan görevler için (örneğin, filtre tanımındaki bir değişkene başvurma), yalnızca değişkenin türünü ve adını (tam sözdizimini değil) belirtmeniz gerekir.

Başlık görünümündeki bir değişkene başvurma gibi diğer görevler için, değişkenin sözdizimi belirtilir. Kullandığınız sözdizimi aşağıdaki tabloda açıklandığı gibi değişkenin türüne bağlıdır.

Tür	Sözdizimi	Örnek
Oturum	@{biServer.variables['NQ_SESSION.variablename']} burada variablename, oturum değişkeninin adıdır (örneğin DISPLAYNAME).	@{biServer.variables['NQ_SESSION.SalesRegion]}
Semantik Model (Veri Havuzu)	@{biServer.variables.variablename} veya @{biServer.variables['variablename']} burada variablename değişkenin adıdır (örneğin prime_begin)	@{biServer.variables.prime_begin} veya @{biServer.variables['prime_begin']}
Sunum veya istek	@{variables.variablename}[format]{defaultvalue} veya @{scope.variables['variablename']} burada: variablename, sunum veya istek değişkeninin adıdır (örneğin, En Sevdiğim Bölge). (isteğe bağlı) format, değişkenin veri türüne bağlı bir format maskesidir (örneğin #,##0, GG/AA/YY ss:dd:ss). (Format öndeğeri için geçerli değildir.) (isteğe bağlı) defaultvalue, variablename tarafından başvuruda bulunulan değişken doldurulmamışsa, kullanılacak değeri gösteren sabit veya değişken bir referanstır. scope değişkenin niteleyicilerini belirler. Bir değişken birden çok düzeyde (analizler, kumanda tablosu sayfaları ve kumanda tabloları) kullanıldığında ve siz belirli bir değere erişmek istediğinizde kapsamı belirlemeniz gerekir. (Kapsamı belirlemezseniz, öncelik sırası analizler, kumanda tablosu sayfaları ve kumanda tabloları olur.) Birden çok değer içerebilen sunu değişkenine sahip bir kumanda tablosu istemi kullanırken, sözdizimi sütun türüne bağlı olarak değişir. Çoklu değerler virgülle ayrılmış değerler şeklinde formatlanır ve bu yüzden, herhangi bir format yantümcesi değerler virgülle birleştirilmeden önce tüm değerlere uygulanır.	@{variables.MyFavoriteRegion}{EASTERN REGION} veya @{MyFavoriteRegion} veya @{dashboard.variables['MyFavoriteRegion']} veya (@{myNumVar}[#,##0]{1000}) veya (@{variables.MyOwnTimestamp}[YY-MM-DD hh:mm:ss]{) veya (@{myTextVar}{A, B, C})
Genel	@{global.variables.variablename} burada variablename genel değişkenin (örneğin, gv_region) adıdır. Genel bir değişkene başvuruda bulunurken, örnekte gösterildiği gibi tam nitelenmiş adı kullanmanız gerekir. Genel değişkenlerin adlandırma kuralları, JavaScript'in EMCA Betik dili belirtimlerine uymalıdır. Ad 200 karakteri aşmamalı; katıştırılmış boşluk, ayrılmış kelime ve özel karakter içermemelidir. JavaScripting dil gereksinimlerine aşina değilseniz, başka bir şirket referansına başvurun	@{global.variables.gv_date_n_time}

Ayrıca ifadeler içindeki değişkenlere de başvurabilirsiniz. İfadelerde başvurulan değişkenler için kılavuzlar aşağıdaki konularda açıklanmıştır:

Oturum Değişkenleri

İfadelerdeki oturum değişkenlerine başvurmak için aşağıdaki yönergeleri kullanabilirsiniz.

Oturum değişkenini VALUEOF fonksiyonunun bağımsız bir değişkeni olarak dahil edin.
Değişken adını çift tırnak içine alın.
Oturum değişkeninin başına NQ_SESSION ve bir nokta getirin.
NQ_SESSION kısmını ve oturum değişkeni adını parantez içine alın.

Örneğin:

"Market"."Region"=VALUEOF(NQ_SESSION."SalesRegion")

Sunu Değişkenleri

İfadelerdeki gösterim değişkenine başvurmak için aşağıdaki yönergeleri kullanabilirsiniz.

Bir sunu değişkenine başvuruda bulunurken şu sözdizimini kullanın:

@{variablename}{defaultvalue}

burada variablename sunu değişkeninin adıdır ve defaultvalue (isteğe bağlı), variablename tarafından başvuruda bulunulan değişken doldurulmamışsa, kullanılacak değeri gösteren sabit veya değişken bir referanstır.

Değişkeni bir dizeye yazmak (yani değişkeni dönüştürmek) için tüm değişkeni tek tırnağın içine alın. Örneğin:

'@{user.displayName}'

@ işaretinin ardından { gelmiyorsa, @ işareti, @ işareti olarak işlev görür. Birden çok değer alabilen bir sunu değişkeni kullandığınızda, sözdizimi sütun türüne bağlı olarak değişir.

Geçerli SQL deyimini oluşturmak amacıyla, belirlenen sütun türü için SQL'de aşağıdaki sözdizimini kullanın.

Metin - (@{variablename}['@']{'defaultvalue'})
Sayısal - (@{variablename}{defaultvalue})
Tarih-zaman - (@{variablename}{timestamp 'defaultvalue'})
Tarih (sadece tarih) - (@{variablename}{date 'defaultvalue'})
Zaman (sadece zaman) - (@{variablename}{time 'defaultvalue'})

Örneğin:

'@{user.displayName}'

Semantik Model (Veri Havuzu) Değişkenleri

İfadelerdeki semantik model (veri havuzu) değişkenlerine referans vermek için aşağıdaki yönergeleri kullanabilirsiniz.

Değişkeni VALUEOF fonksiyonunun bağımsız değişkeni olarak dahil edin.
Değişken adını çift tırnak içine alın.
Adına göre statik semantik model (veri havuzu) değişkenine bakın.
Dinamik bir semantik model (veri havuzu) değişkenine tam nitelenmiş adıyla bakın.

Örneğin:

CASE WHEN "Saat" >= VALUEOF("prime_begin") AND "Saat" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END