システム変数に格納されているユーザー情報をレポート・データに含める

レポート・データ・モデルには、システム変数に格納されている現在のユーザーに関する情報を含めることができます。

ユーザー情報は、次に説明するようにシステム変数に格納されます。

システム変数	説明
xdo_user_name	レポートを送信するユーザーのユーザーID。次に例を示します: 管理者
xdo_user_roles	レポートを発行するユーザーに割り当てられたロール。次に例を示します: XMLP_ADMIN, XMLP_SCHEDULER
xdo_user_report_oracle_lang	ユーザーのアカウント・プリファレンスからのレポート言語。次に例を示します: ZHS
xdo_user_report_locale	ユーザーのアカウント・プリファレンスからのレポート・ロケール。次に例を示します: en-US
xdo_user_ui_oracle_lang	ユーザーのアカウント・プリファレンスからのユーザー・インタフェース言語。例: US
xdo_user_ui_locale	ユーザーのアカウント・プリファレンスからのユーザー・インタフェース・ロケール。次に例を示します: en-US

「パブリッシャ」は、オンライン・レポートのシステム変数を移入します。スケジュール済ジョブでは、「パブリッシャ」はXDO_USER_REPORT_LOCALE、XDO_USER_UI_LOCALE、XDO_USER_UI_ORACLE_LANG、XDO_USER_REPORT_ORACLE_LANGおよびXDO_USER_REPORT_LOCALEシステム変数に移入しません。

ユーザー・システム変数の要素としての追加

ユーザー情報をデータ・モデルに追加するには、変数をパラメータとして定義し、データ・モデルでパラメータ値を要素として定義します。

また、単に変数をパラメータとして追加し、レポート内のパラメータ値を参照することもできます。

次の問合せでは:

select
:xdo_user_name as USER_ID,
:xdo_user_roles as USER_ROLES,
:xdo_user_report_oracle_lang as REPORT_LANGUAGE,
:xdo_user_report_locale as REPORT_LOCALE,
:xdo_user_ui_oracle_lang as UI_LANGUAGE,
:xdo_user_ui_locale as UI_LOCALE
from dual

次の結果が返されます:

<?xml version="1.0" encoding="UTF-8"?>
<! - Generated by Publisher - >
<DATA_DS>
<G_1>
<USER_ROLES>XMLP_TEMPLATE_DESIGNER, XMLP_DEVELOPER, XMLP_ANALYZER_EXCEL, XMLP_ADMIN, XMLP_ANALYZER_ONLINE, XMLP_SCHEDULER </USER_ROLES>
<REPORT_LANGUAGE>US</REPORT_LANGUAGE>
<REPORT_LOCALE>en_US</REPORT_LOCALE>
<UI_LANGUAGE>US</UI_LANGUAGE>
<UI_LOCALE>en_US</UI_LOCALE>
<USER_ID>administrator</USER_ID>
</G_1>
</DATA_DS>

サンプル・ユース・ケース: ユーザーIDによる返されるデータセットの制限

次の例では、返されるデータをユーザーIDで制限しています。

select EMPLOYEES.LAST_NAME as LAST_NAME,
  EMPLOYEES.PHONE_NUMBER as PHONE_NUMBER,
  EMPLOYEES.HIRE_DATE as HIRE_DATE,
 :xdo_user_name as USERID 
from   HR.EMPLOYEES EMPLOYEES
where lower(EMPLOYEES.LAST_NAME) = :xdo_user_name

lower()関数を使用すると、xdo_user_nameは常に小文字の書式になります。「パブリッシャ」にはUSERIDがないため、ユーザー名を使用して問合せで直接使用するか、参照表に対して問い合せてユーザーIDを検索する必要があります。