變數有助於確保將相同的資訊與文字準確地顯示在多個位置。
您可以在 Oracle BI Enterprise Edition 的數個區域參照變數,包括分析、儀表板、KPI、動作、代理程式及條件。例如,假設您要建立分析而且要在其標題顯示目前使用者的名稱。您可以透過參照變數來達成。
您可以使用五種類型的變數:
階段作業
儲存區域
展示
要求
全域
階段作業變數是使用者登入時起始的變數。
當使用者開始階段作業時,Oracle BI Server 會建立新的階段作業變數的執行處理並加以起始。
階段作業變數的執行處理數目和 Oracle BI Server上作用中的階段作業數目相同。階段作業變數的每個執行處理可以起始為不同的值。
階段作業變數將由初始化區塊 (INIT BLOCK) 中指定的查詢填入。這些階段作業 INIT BLOCK 通常只在登入時執行一次。不過,如果 INIT BLOCK 被標示為延緩執行,則可以在以後參照相關變數時再執行。
階段作業 INIT BLOCK 通常和查詢敘述句關聯,但也可以和 LDAP 物件關聯。如需 INIT BLOCK 的詳細資訊,請參閱 Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 中的 Working with Initialization Blocks。
階段作業變數有兩種類型:
系統 — Oracle BI Server 和 Oracle BI Presentation Services 用於特定用途的階段作業變數。
系統階段作業變數具有保留名稱且不可用於其他種類的變數 (例如,靜態或動態儲存區域變數和非系統階段作業變數)。
非系統 — 管理員所建立並命名的系統變數。例如,管理員可能建立一個 SalesRegion 非系統變數,用於起始使用者的銷售地區名稱。
管理員使用 Oracle BI 管理工具建立非系統階段作業變數。
註:
部分系統階段作業變數 (例如,USERGUID 或 ROLES) 無法被要求變數覆寫。其他系統階段作業變數 (例如,DATA_TZ 和 DATA_DISPLAY_TZ (時區)) 如果設定在「Oracle BI 管理工具」中,則可以被覆寫。如需詳細資訊,請參閱 Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 中的 Working with Repository Variables。
如需詳細資訊,請參閱 Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 中的 About Session Variables。
儲存區域變數是一種在任何時間點都只有單一值的變數。
儲存區域變數有兩種類型:
靜態 — 其值會持續保存而且在管理員決定變更之前不會變更的儲存區域變數。
動態 — 其值由 INIT BLOCK 中指定的查詢填入的儲存區域變數。您可以指定 INIT BLOCK 的重新整理間隔。動態 INIT BLOCK 會以指定的間隔自動重新整理其變數值。
動態 INIT BLOCK 只能和一個查詢關聯 (亦即透過 SQL 敘述句、ADF 查詢或其他支援的資料來源)。如需 INIT BLOCK 的詳細資訊,請參閱 Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 中的 Working with Initialization Blocks。
管理員使用 Oracle BI 管理工具建立儲存區域變數。
如需詳細資訊,請參閱 Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 中的 About Repository Variables。
展示變數使用儀表板提示建立並供儀表板提示使用。
展示變數是一種您可以在建立下列其中一種儀表板提示類型的過程中建立的變數:
資料欄提示 — 作為資料欄提示之一部分而建立的展示變數將和某個資料欄關聯,而且該變數可接受的值來自資料欄值。
若要建立作為資料欄提示之一部分的展示變數,您必須在「新建提示」對話方塊 (或「編輯提示」對話方塊) 的設定變數欄位中選取展示變數,然後在變數名稱欄位中輸入變數名稱。
如需使用資料欄提示的資訊,請參閱建立資料欄提示。
變數提示 — 作為變數提示之一部分而建立的展示變數不會和任何資料欄關聯,您可以定義該變數可接受的值。
若要建立作為變數提示之一部分的展示變數,您必須在「新建提示」對話方塊 (或「編輯提示」對話方塊) 的提示欄位中選取展示變數,然後在變數名稱欄位中輸入變數名稱。
如需使用變數提示的資訊,請參閱建立變數提示。
展示變數的值是由用來建立變數的資料欄或變數提示所填入。也就是說,每次使用者在資料欄或變數提示中選取一或多個值時,展示變數的值會設成使用者選取的一或多個值。
要求變數會暫時覆寫提示資料庫要求。
要求變數可讓您覆寫階段作業變數的值,但僅限於從資料欄提示或變數提示起始之資料庫要求的持續時間。
註:
部分系統階段作業變數 (例如,USERGUID 或 ROLES) 無法被要求變數覆寫。其他系統階段作業變數 (例如,DATA_TZ 和 DATA_DISPLAY_TZ (時區)) 如果設定在「Oracle BI 管理工具」中,則可以被覆寫。如需詳細資訊,請參閱 Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 中的 Working with Repository Variables。
您可以在建立下列其中一種類型之儀表板提示的過程中建立要求變數:
資料欄提示 — 作為資料欄提示之一部分而建立的要求變數會和某個資料欄關聯,而且該變數可接受的值來自資料欄值。
若要建立作為資料欄提示之一部分的要求變數,您必須在新建提示對話方塊 (或編輯提示對話方塊) 的設定變數中選取要求變數,然後在變數名稱欄位中輸入要覆寫的階段作業變數名稱。
如需使用資料欄提示的資訊,請參閱建立資料欄提示。
變數提示 — 作為變數提示之一部分而建立的要求變數不會和任何資料欄關聯,您可以定義該變數可接受的值。
若要建立要求變數作為變數提示的一部分,您必須在新建提示對話方塊 (或編輯提示對話方塊) 的提示欄位中選取要求變數,然後在變數名稱欄位中輸入您要覆寫的階段作業變數名稱。
如需使用變數提示的資訊,請參閱建立變數提示。
要求變數的值將由建立該要求變數的資料欄提示或變數提示填入。也就是說,每次使用者在資料欄或變數提示中選取值時,要求變數的值會設定為使用者選取的值。不過,值的有效期間僅限於從使用者按下提示的執行按鈕到分析結果傳回至儀表板的期間。
註:
只有字串與數字要求變數才能支援多個值。所有其他資料類型都只會傳遞第一個值。