35.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);

パラメータ

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