תחביר להפניית משתנים

אפשר להפנות למשתנים בניתוחים ובלוחות מידע.

אופן ההפניה למשתנה תלוי במשימה שאתה מבצע. למשימות שבהן מוצגים לפניך שדות בתיבת דו-שיח, עליך לציין רק את הסוג והשם של המשתנה ולא את התחביר המלא. לדוגמה: הפניה למשתנה בהגדרת מסנן.

למשימות אחרות, כמו הפנייה למשתנה בכותרת תצוגה, יש לציין את תחביר המשתנה. התחביר שבו נעשה שימוש תלוי בסוג המשתנה המתואר בטבלה הבאה.

סוג תחביר דוגמה

מושב עבודה

@{biServer.variables['NQ_SESSION.variablename']}

כאשר variablename הוא שם המשתנה של מושב העבודה, לדוגמה DISPLAYNAME.

@{biServer.variables['NQ_SESSION.SalesRegion']}

מודל סמנטי (מאגר נתונים)

@{biServer.variables.variablename}

או

@{biServer.variables['variablename']}

כאשר variablename הוא השם של משתנה, לדוגמה, prime_begin

@{biServer.variables.prime_begin}

או

@{biServer.variables['prime_begin']}

מצגת או בקשה

@{variables.variablename}[format]{defaultvalue}

או

@{scope.variables['variablename']}

כאשר:

variablename הוא השם של משתנה המצגת או הבקשה, לדוגמה, MyFavoriteRegion.

אופציונלי - format הוא מסכת תבנית התלויה בסוג הנתונים של המשתנה, לדוגמה #,##0, MM/DD/YY hh:mm:ss. שים לב שהפורמט אינו מוחל על ערך ברירת המחדל.

(אופציונלי) - defaultvalue הוא הפניה לקבוע או למשתנה המציינת ערך בו יש להשתמש אם המשתנה שאליו מפנה variablename לא מאוכלס.

scope מזהה את המתארים של המשתנה. יש לציין את הטווח כאשר השימוש במשתנה הוא בכמה רמות - ניתוחים, דפי לוח מידע ולוחות מידע, וברצונך לגשת לערך ספציפי. אם אתה לא מגדיר את הטווח, סדר הקדימות הוא ניתוחים, דפי לוחות מידע ולוחות מידע.

בעת השימוש במנחה לוח מידע עם משתנה מצגת שיכול להכיל ערכים מרובים, התחביר משתנה בהתאם לסוג העמודה. ערכים מרובים מעוצבים כערכים מופרדים בפסיקים ולכן, פסוק תבנית כלשהו מוחל על כל ערך לפני שהם מחוברים באמצעות פסיקים.

@{variables.MyFavoriteRegion}{EASTERN REGION}

או

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

או

@{dashboard.variables['MyFavoriteRegion']}

או

(@{myNumVar}[#,##0]{1000})

או

(@{variables.MyOwnTimestamp}[YY-MM-DD hh:mm:ss]{)

או

(@{myTextVar}{A, B, C})

גלובלי

@{global.variables.variablename}

כאשר variablename הוא השם של המשתנה הגלובלי, לדוגמה, gv_region. כאשר מפנים למשתנה גלובלי, יש להשתמש בשם מלא כפי שמוצג בדוגמה.

מוסכמת מתן הזהות למשתנים גלובליים חייבת לציית למפרטי שפת התסריט ECMA של JavaScript. אורך השם אינו יכול לעלות על 200 תווים והשם אינו יכול לכלול רווחים משובצים, מילים שמורות ותווים מיוחדים. אם אינך בקיא בדרישות שפת JavaScript, עיין במדריך של צד שלישי

@{global.variables.gv_date_n_time}

אפשר להפנות גם למשתנים בביטויים. הקווים המנחים להפניה למשתנים בביטויים מתוארים בנושאים הבאים:

משתני מושב עבודה

תוכל להשתמש בהנחיות הבאות להפניה למשתני מושב עבודה בביטויים.

  • כלול את משתנה מושב העבודה כארגומנט של הפונקציה VALUEOF.
  • תחום את שם המשתנה במרכאות כפולות.
  • ציין לפני משתנה מושב העבודה את התחילית NQ_SESSION עם נקודה אחריה.
  • יש לתחום את NQ_SESSION במירכאות כפולות.
  • תחום את החלק NQ_SESSION ואת שם משתנה מושב העבודה בסוגריים.

לדוגמה:

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

משתני מצגת

תוכל להשתמש בקווים המנחים הבאים להפניה למשתנה מצגת בביטויים.

בעת הפניה למשתני מצגת, השתמש בתחביר הבא:

@{variablename}{defaultvalue}

כאשר variablename הוא שם משתנה המצגת ו-defaultvalue (אופציונלי) הוא הפניה לקבוע או למשתנה המציינת ערך בו יש להשתמש אם המשתנה שאליו מפנה variablename אינו מאוכלס.

כדי להמיר (type-cast) את המשתנה למחרוזת או לכלול משתנים מרובים, תחום את כל המשתנה בין מרכאות בודדות, לדוגמה:

'@{user.displayName}'

אם אחרי הסימן @ לא מופיע {, המערכת מטפלת בו כסימן @. בעת השימוש במשתנה מצגת שיכולים להיות לו ערכים מרובים, התחביר משתנה בהתאם לסוג העמודה.

השתמש בתחביר הבא ב-SQL לסוג העמודה הספציפי כדי ליצור משפטי SQL תקפים:

  • טקסט - (@{variablename}['@']{'defaultvalue'})

  • מספר - (@{variablename}{defaultvalue})

  • תאריך-שעה - (@{variablename}{timestamp 'defaultvalue'})

  • תאריך, רק התאריך - (@{variablename}{date 'defaultvalue'})

  • שעה, רק השעה - (@{variablename}{time 'defaultvalue'})

לדוגמה:

'@{user.displayName}'

משתני מודל סמנטי (מאגר נתונים)

תוכל להשתמש בקווים המנחים הבאים להפניה למשתני מודל סמנטי (מאגר נתונים) בביטויים.

  • כלול את המשתנה כארגומנט של הפונקציה VALUEOF.
  • תחום את שם המשתנה במרכאות כפולות.
  • הפנה למשתנה של מודל סמנטי (מאגר נתונים) סטטי באמצעות שם.
  • הפנה למשתנה של מודל סמנטי (מאגר נתונים) דינמי באמצעות שמו המלא.

לדוגמה:

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