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 sunum 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

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

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 ECMA 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 çift tırnak içinde kapatın.
  • 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")

Sunum Değişkenleri

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

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

@{variablename}{defaultvalue}

burada variablename sunum 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 sunum 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 "Hour" >= VALUEOF("prime_begin") AND "Hour" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END