プライマリ・コンテンツに移動

Oracle® Application Express APIリファレンス リリース5.1 E85937-02 |
| 目次 | 索引

前 | 次 |

# 27.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);

パラメータ

表27-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;