1. APIリファレンス
  2. APEX_UI_DEFAULT_UPDATE
  3. UPD_COLUMNプロシージャ

42.11 UPD_COLUMNプロシージャ

指定した表および列が、ユーザー・インタフェースのデフォルト値に基づくユーザーのスキーマの表内に存在する場合、指定したパラメータが更新されます。'null%'が渡されると、関連付けられたパラメータの値はnullに設定されます。

構文

APEX_UI_DEFAULT_UPDATE.UPD_COLUMN (
    p_table_name            IN VARCHAR2,
    p_column_name           IN VARCHAR2,
    p_group_id              IN VARCHAR2  DEFAULT NULL,
    p_label                 IN VARCHAR2  DEFAULT NULL,
    p_help_text             IN VARCHAR2  DEFAULT NULL,
    p_display_in_form       IN VARCHAR2  DEFAULT NULL,
    p_display_seq_form      IN VARCHAR2  DEFAULT NULL,
    p_mask_form             IN VARCHAR2  DEFAULT NULL,
    p_default_value         IN VARCHAR2  DEFAULT NULL,
    p_required              IN VARCHAR2  DEFAULT NULL,
    p_display_width         IN VARCHAR2  DEFAULT NULL,
    p_max_width             IN VARCHAR2  DEFAULT NULL,
    p_height                IN VARCHAR2  DEFAULT NULL,
    p_display_in_report     IN VARCHAR2  DEFAULT NULL,
    p_display_seq_report    IN VARCHAR2  DEFAULT NULL,
    p_mask_report           IN VARCHAR2  DEFAULT NULL,
    p_alignment             IN VARCHAR2  DEFAULT NULL);

パラメータ

表42-11 UPD_COLUMNのパラメータ

パラメータ 説明

p_table_name

列のUIのデフォルト値を更新する表の名前

p_column_name

UIのデフォルト値を更新する列の名前

p_group_id

列に関連付けられているグループのID

p_label

この表またはビューに対してフォームを作成する場合に、この列が含まれていると、これがアイテムのラベルとして使用されます。レポートまたは表形式フォームを作成する場合に、この列が含まれていると、これが列ヘッダーとして使用されます。

p_help_text

この表またはビューに対してフォームを作成する場合、これは作成されるアイテムのヘルプ・テキストになります。

p_display_in_form

この表またはビューに対してフォームを作成する場合、これによって、作成されるフォーム・ページにこの列が表示されるかどうかが決定されます。有効な値は、YおよびNです。

p_display_seq_form

この表またはビューに対してフォームを作成する場合、これによって、作成されるフォーム・ページに表示される列の順序が決定されます。

p_mask_form

この表またはビューに対してフォームを作成する場合、これによって、アイテムに適用されるマスク(999-99-9999など)が指定されます。これは、キャラクタ・ベースのアイテムには使用されません。

p_default_value

この表またはビューに対してフォームを作成する場合、これによって、この列から作成されるアイテムのデフォルト値が指定されます。

p_required

この表またはビューに対してフォームを作成する場合、これによって、アイテムが必ずNOT NULLになるような検証を生成することが指定されます。有効な値は、YおよびNです。

p_display_width

この表またはビューに対してフォームを作成する場合、これによって、この列から作成されるアイテムの表示幅が指定されます。

p_max_width

この表またはビューに対してフォームを作成する場合、これによって、この列から作成されるアイテムにユーザーが入力できる文字列の最大長が指定されます。

p_height

この表またはビューに対してフォームを作成する場合、これによって、この列から作成されるアイテムの表示の高さが指定されます。

p_display_in_report

この表またはビューに対してレポートを作成する場合、これによって、作成されるレポートにこの列が表示されるかどうかが決定されます。有効な値は、YおよびNです。

p_display_seq_report

この表またはビューに対してレポートを作成する場合、これによって、作成されるレポートに表示される列の順序が決定されます。

p_mask_report

この表またはビューに対してレポートを作成する場合、これによって、データに対して適用されるマスク(999-99-9999など)が指定されます。これは、キャラクタ・ベースのアイテムには使用されません。

p_alignment

この表またはビューに対してレポートを作成する場合、これによって、作成されるレポート列の位置合せが決定されます。有効な値は、L(左)、C(中央)およびR(右)です。

ノート:

p_group_idからp_alignmentに'null%'を設定すると、値は無効になります。値が渡されない場合、その列は更新されません。

例

次の例では、現在のスキーマに含まれるUIのデフォルト値の表ディクショナリ内のEMP表定義で、列DEPT_NOを更新します。また、group_idをnullに設定します。 

BEGIN
    apex_ui_default_update.upd_column (
       p_table_name    => 'EMP',
       p_column_name   => 'DEPT_NO',
       p_group_id      => 'null%' );
END;

親トピック: APEX_UI_DEFAULT_UPDATE