ヘッダーをスキップ
Oracle® Application Express APIリファレンス
リリース3.2
B53798-03
  目次へ移動
目次
前
前 		 次
次		  

7 APEX_INSTANCE_ADMIN

APEX_INSTANCE_ADMINパッケージには、Oracle Application Expressのランタイム環境を管理するためのユーティリティが用意されています。APEX_INSTANCE_ADMINパッケージを使用すると、電子メール設定、ウォレット設定、レポート出力設定などの取得と設定を行い、スキームとワークスペースのマッピングを管理できます。APEX_INSTANCE_ADMINは、SYS、SYSTEM、APEX_030200のデータベース・ユーザーに加え、ロールAPEX_ADMINISTRATOR_ROLEが付与されているすべてのデータベース・ユーザーが実行できます。

このセクションの構成は次のとおりです。

ADD_SCHEMAプロシージャ

ADD_SCHEMAプロシージャは、ワークスペースとスキーマのマッピングにスキーマを追加します。

構文

APEX_INSTANCE_ADMIN.ADD_SCHEMA(
    p_workspace    IN VARCHAR2,
    p_schema       IN VARCHAR2);

パラメータ

表7-1に、ADD_SCHEMAプロシージャで使用可能なパラメータを示します。

表7-1 ADD_SCHEMAのパラメータ

パラメータ 説明

p_workspace

スキーマ・マッピングを追加するワークスペースの名前。

p_schema

スキーマとワークスペースのマッピングに追加するスキーマ。

例

次の例に、ADD_SCHEMAプロシージャを使用してスキーマをワークスペースにマッピングする方法を示します。

BEGIN
    APEX_INSTANCE_ADMIN.ADD_SCHEMA('MY_WORKSPACE','FRANK');
END;

ADD_WORKSPACEプロシージャ

ADD_WORKSPACEプロシージャは、Application Expressインスタンスにワークスペースを追加します。

構文

APEX_INSTANCE_ADMIN.ADD_WORKSPACE(
    p_workspace_id        IN NUMBER DEFAULT NULL,
    p_workspace           IN VARCHAR2,
    p_primary_schema      IN VARCHAR2,
    p_additional_schemas  IN VARCHAR2 );

パラメータ

表7-2に、ADD_WORKSPACEプロシージャで使用可能なパラメータを示します。

表7-2 ADD_WORKSPACEのパラメータ

パラメータ 説明

p_workspace_id

Application Expressインスタンス内でワークスペースを一意に識別するID。これをNULLのままにすると、新しい一意のIDが割り当てられます。

p_workspace

追加するワークスペースの名前。

p_primary_schema

新しいワークスペースに関連付けるプライマリ・データベース・スキーマ。

p_additional_schemas

このワークスペースに関連付ける追加スキーマを列挙したコロン区切りのリスト。

例

次の例に、ADD_WORKSPACEプロシージャを使用して、HRおよびOE用の追加のスキーマ・マッピングとともにSCOTTというプライマリ・スキーマを使用するMY_WORKSPACEという新しいワークスペースを追加する方法を示します。

BEGIN
    APEX_INSTANCE_ADMIN.ADD_WORKSPACE(8675309,'MY_WORKSPACE','SCOTT','HR:OE');
END;

GET_PARAMETERファンクション

GET_PARAMETERファンクションは、ランタイム環境の管理に使用されるパラメータの値を取得します。

構文

APEX_INSTANCE_ADMIN.GET_PARAMETER(
    p_parameter     IN VARCHAR2)
RETURN VARCHAR2;

パラメータ

表7-3に、GET_PARAMETERファンクションで使用可能なパラメータを示します。

表7-3 GET_PARAMETERのパラメータ

パラメータ 説明

p_parameter

取得するインスタンス・パラメータ。

「使用可能なパラメータ値」を参照してください。

例

次の例に、GET_PARAMETERファンクションを使用して、Oracle Application Expressインスタンスに対して現在定義されているSMTP_HOST_ADDRESSパラメータを取得する方法を示します。

DECLARE
    L_VAL VARCHAR2(4000);
BEGIN
    L_VAL :=APEX_INSTANCE_ADMIN.GET_PARAMETER('SMTP_HOST_ADDRESS');
    DBMS_OUTPUT.PUT_LINE('The SMTP Host Setting Is: '||L_VAL);
END;

GET_SCHEMASファンクション

GET_SCHEMASファンクションは、特定のワークスペースにマッピングされているスキーマのカンマ区切りリストを取得します。

構文

APEX_INSTANCE_ADMIN.GET_SCHEMAS(
    p_workspace     IN VARCHAR2)
RETURN VARCHAR2;

パラメータ

表7-4に、GET_SCHEMASファンクションで使用可能なパラメータを示します。

表7-4 GET_SCHEMASのパラメータ

パラメータ 説明

p_workspace

スキーマ・リストを取得するワークスペースの名前。

例

次の例に、GET_SCHEMAファンクションを使用して、ワークスペースにマッピングされた基礎となるスキーマを取得する方法を示します。

DECLARE
    L_VAL VARCHAR2(4000);
BEGIN
    L_VAL :=APEX_INSTANCE_ADMIN.GET_SCHEMAS('MY_WORKSPACE');
    DBMS_OUTPUT.PUT_LINE('The schemas for my workspace: '||L_VAL);
END;

REMOVE_SAVED_REPORTSプロシージャ

REMOVE_SAVED_REPORTSプロシージャは、特定のアプリケーションまたはインスタンス全体に対してユーザーが保存したすべての対話モード・レポートの設定を削除します。

構文

APEX_INSTANCE_ADMIN.REMOVE_SAVED_REPORTS(
    p_application_id     IN NUMBER DEFAULT NULL);

パラメータ

表7-5に、REMOVE_SAVED_REPORTSプロシージャで使用可能なパラメータを示します。

表7-5 REMOVE_SAVED_REPORTSパラメータ

パラメータ 説明

p_application_id

ユーザーが保存した対話モード・レポートの情報を削除する対象アプリケーションのID。このパラメータをNULLのままにしておくと、インスタンス全体に対してユーザーが保存したすべての対話モード・レポートが削除されます。

例

次の例に、REMOVE_SAVED_REPORTSプロシージャを使用して、IDが100のアプリケーションに対してユーザーが保存した対話モード・レポートの情報を削除する方法を示します。

BEGIN
    APEX_INSTANCE_ADMIN.REMOVE_SAVED_REPORTS(100);
END;

REMOVE_SCHEMAプロシージャ

このREMOVE_SCHEMAは、ワークスペースからスキーマへのマッピングを削除します。

構文

APEX_INSTANCE_ADMIN.REMOVE_SCHEMA(
    p_workspace     IN VARCHAR2,
    p_schema        IN VARCHAR2);

パラメータ

表7-6に、REMOVE_SCHEMAプロシージャで使用可能なパラメータを示します。

表7-6 REMOVE_SCHEMAのパラメータ

パラメータ 説明

p_workspace

スキーマ・マッピングを削除するワークスペースの名前。

p_schema

スキーマとワークスペースのマッピングから削除するスキーマ。

例

次の例に、REMOVE_SCHEMAプロシージャを使用して、ワークスペースとスキーマのマッピングMY_WORKSPACEからFrankというスキーマを削除する方法を示します。

BEGIN
    APEX_INSTANCE_ADMIN.REMOVE_SCHEMA('MY_WORKSPACE','FRANK');
END;

REMOVE_WORKSPACEプロシージャ

REMOVE_WORKSPACEプロシージャは、Application Expressインスタンスからワークスペースを削除します。

構文

APEX_INSTANCE_ADMIN.REMOVE_WORKSPACE(
    p_workspace         IN VARCHAR2,
    p_drop_users        IN VARCHAR2 DEFAULT 'N',
    p_drop_tablespaces  IN VARCHAR2 DEFAULT 'N' );

パラメータ

表7-7に、REMOVE_WORKSPACEプロシージャで使用可能なパラメータを示します。

表7-7 REMOVE_WORKSPACEのパラメータ

パラメータ 説明

p_workspace

削除するワークスペースの名前。

p_drop_users

'Y'を指定すると、ワークスペースに関連付けられているデータベース・ユーザーも削除されます。デフォルトは'N'です。

p_drop_tablespaces

'Y'を指定すると、ワークスペースに関連付けられているデータベース・ユーザーに関連付けられた表領域も削除されます。デフォルトは'N'です。

例

次の例に、REMOVE_WORKSPACEプロシージャを使用して、関連するデータベース・ユーザーおよび表領域とともにMY_WORKSPACEという既存のワークスペースを削除する方法を示します。

BEGIN
    APEX_INSTANCE_ADMIN.REMOVE_WORKSPACE('MY_WORKSPACE','Y','Y');
END;

SET_PARAMETERプロシージャ

SET_PARAMETERプロシージャは、ランタイム環境の管理に使用されるパラメータを設定します。

構文

APEX_INSTANCE_ADMIN.SET_PARAMETER(
    p_parameter     IN VARCHAR2,
    p_value         IN VARCHAR2 DEFAULT 'N');

パラメータ

表7-8に、SET_PARAMETERプロシージャで使用可能なパラメータを示します。

表7-8 SET_PARAMETERのパラメータ

パラメータ 説明

p_parameter

設定するインスタンス・パラメータ。

p_value

パラメータの値。

「使用可能なパラメータ値」を参照してください。

例

次の例に、SET_PARAMETERプロシージャを使用して、Oracle Application ExpressインスタンスのSMTP_HOST_ADDRESSパラメータを設定する方法を示します。

BEGIN
    APEX_INSTANCE_ADMIN.SET_PARAMETER('SMTP_HOST_ADDRESS','mail.mycompany.com');
END;

使用可能なパラメータ値

表7-9に、APEX_INSTANCE_ADMINパッケージ内で設定可能なすべてのパラメータ(電子メール、ウォレット、レポート出力用のパラメータなど)の値を示します。

表7-9 使用可能なパラメータ

パラメータ名 説明

SMTP_FROM

割当てリクエストの承認や、パスワードのリセットなど、電子メールを作成する管理タスクに対する送信元アドレスを定義します。

有効な電子メール・アドレスを入力します。次に例を示します。

someone@somewhere.com

SMTP_HOST_ADDRESS

SMTPサーバーのサーバー・アドレスを定義します。別のサーバーをSMTPリレーとして使用する場合は、このパラメータをそのサーバーのアドレスに変更します。

デフォルト設定:

localhost

SMTP_HOST_PORT

メール・リクエスト用にSMTPサーバーが待機するポートを定義します。

デフォルト設定:

25

WALLET_PATH

ファイル・システムでのウォレットへのパス。次に例を示します。

file:/home/<username>/wallets

WALLET_PWD

ウォレットに関連付けられているパスワード。

PRINT_BIB_LICENSED

標準サポートまたは拡張サポートのいずれかを指定します。拡張サポートの場合は、Oracle BI Publisherの使用許諾が必要です。有効な値は、次のとおりです。

  • STANDARD

  • ADVANCED

PRINT_SVR_PROTOCOL

有効な値は、次のとおりです。

  • http

  • https

PRINT_SVR_HOST

プリント・サーバー変換エンジンのホスト・アドレス(localhostなど)を指定します。プリント・サーバーが別の場所にインストールされている場合は、対応するホスト・アドレスを入力します。

PRINT_SVR_PORT

プリント・サーバー・エンジンのポート(8888など)を定義します。値は、正の整数である必要があります。

PRINT_SVR_SCRIPT

プリント・サーバー・エンジンのスクリプトを定義します。次に例を示します。

/xmlpserver/convert


参照:

『Oracle Application Express管理ガイド』の「ランタイム環境での電子メールの構成」、「ランタイム環境でのウォレットの構成」および「ランタイム環境でのレポート出力設定の構成」

  前
前 		 次
次
  目次へ移動
目次