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

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

前 | 次 |

# 27.9 UPD_AD_COLUMNプロシージャ

列名がユーザー・インタフェースのデフォルト値の属性ディクショナリで見つかると、その列エントリは、指定したパラメータを使用して更新されます。null%'が渡されると、関連付けられたパラメータの値はnullに設定されます。

構文

    APEX_UI_DEFAULT_UPDATE.UPD_AD_COLUMN (
        p_column_name           IN  VARCHAR2,
        p_new_column_name       IN  VARCHAR2  DEFAULT NULL,
        p_label                 IN  VARCHAR2  DEFAULT NULL,
        p_help_text             IN  VARCHAR2  DEFAULT NULL,
        p_format_mask           IN  VARCHAR2  DEFAULT NULL,
        p_default_value         IN  VARCHAR2  DEFAULT NULL,
        p_form_format_mask      IN  VARCHAR2  DEFAULT NULL,
        p_form_display_width    IN  VARCHAR2  DEFAULT NULL,
        p_form_display_height   IN  VARCHAR2  DEFAULT NULL,
        p_form_data_type        IN  VARCHAR2  DEFAULT NULL,
        p_report_format_mask    IN  VARCHAR2  DEFAULT NULL,
        p_report_col_alignment  IN  VARCHAR2  DEFAULT NULL);

パラメータ

表27-9 UPD_AD_COLUMNのパラメータ

パラメータ | 説明
--- | ---
`p_column_name` | 更新する列の名前
`p_new_column_name` | 列の名前を変更する場合、列の新しい名前
`p_label` | アイテム・ラベルおよびレポートの列ヘッダーに使用されます。
`p_help_text` | アイテムおよび対話モード・レポート列のヘルプ・テキストに使用されます。
`p_format_mask` | アイテムおよびレポート列の書式マスクとして使用されます。フォーム固有の書式マスクのレポートで上書きできます。
`p_default_value` | アイテムのデフォルト値として使用されます。
`p_form_format_mask` | 指定した場合、アイテムの書式マスクとして使用されます。一般的な書式マスクの値をオーバーライドします。
`p_form_display_width` | この属性定義を使用するすべてのアイテムの幅として使用されます。
`p_form_display_height` | この属性定義を使用するすべてのアイテムの高さとして使用されます(テキスト領域、シャトルなどのアイテム・タイプでのみ使用されます)。
`p_form_data_type` | アイテムのデータ型として使用されます(自動検証になります)。有効な値は、`VARCHAR`、`NUMBER`および`DATE`です。
`p_report_format_mask` | 指定した場合、レポート列の書式マスクとして使用されます。一般的な書式マスクの値をオーバーライドします。
`p_report_col_alignment` | レポート列のデータの位置合せに使用されます(たとえば数値は、一般に右揃えにします)。有効な値は、LEFT、CENTERおよびRIGHTです。

注意:

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

例

次の例では、form_format_maskにnullを設定して、現在のスキーマに関連付けられているワークスペース内で、UIのデフォルト値の属性ディクショナリの`CREATED_BY`列を更新します。

    BEGIN
        apex_ui_default_update.upd_ad_column (
           p_column_name      => 'CREATED_BY',
           p_form_format_mask => 'null%');
    END;