add parameter p_dml_view_trigger_name

Author: ogobrecht

README.md

@@ -79,7 +79,7 @@ SIGNATURE
 ```sql
 PACKAGE om_tapigen AUTHID CURRENT_USER IS
 c_generator         CONSTANT VARCHAR2(10 CHAR) := 'OM_TAPIGEN';
-c_generator_version CONSTANT VARCHAR2(10 CHAR) := '0.5.2.33';
+c_generator_version CONSTANT VARCHAR2(10 CHAR) := '0.5.2.34';
 ```
 
 
@@ -114,10 +114,11 @@ PROCEDURE compile_api
   p_double_quote_names          IN BOOLEAN  DEFAULT TRUE,  -- If true, object names (owner, table, columns) are placed in double quotes.
   p_default_bulk_limit          IN INTEGER  DEFAULT 1000,  -- The default bulk size for the set based methods (create_rows, read_rows, update_rows)
   p_enable_dml_view             IN BOOLEAN  DEFAULT FALSE, -- If true, a view with an instead of trigger is generated, which simply calls the API methods - can be useful for low code frontends like APEX.
-  p_dml_view_name               IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the DML view - you can use substitutions like #TABLE_NAME# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_dml_view_name               IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the DML view - you can use substitutions like #TABLE_NAME# , #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_dml_view_trigger_name       IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the DML view trigger - you can use substitutions like #TABLE_NAME#, #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
   p_enable_one_to_one_view      IN BOOLEAN  DEFAULT FALSE, -- If true, a 1:1 view with read only is generated - useful when you want to separate the tables into an own schema without direct user access.
-  p_one_to_one_view_name        IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the 1:1 view - you can use substitutions like #TABLE_NAME# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
-  p_api_name                    IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the API - you can use substitutions like #TABLE_NAME# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_one_to_one_view_name        IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the 1:1 view - you can use substitutions like #TABLE_NAME#, #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_api_name                    IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the API - you can use substitutions like #TABLE_NAME#, #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
   p_sequence_name               IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the create_row methods - same substitutions like with API name possible.
   p_exclude_column_list         IN VARCHAR2 DEFAULT NULL,  -- If not null, the provided comma separated column names are excluded on inserts and updates (virtual columns are implicitly excluded).
   p_audit_column_mappings       IN VARCHAR2 DEFAULT NULL,  -- If not null, the provided comma separated column names are excluded and populated by the API (you don't need a trigger for update_by, update_on...).
@@ -163,10 +164,11 @@ FUNCTION compile_api_and_get_code
   p_double_quote_names          IN BOOLEAN  DEFAULT TRUE,  -- If true, object names (owner, table, columns) are placed in double quotes.
   p_default_bulk_limit          IN INTEGER  DEFAULT 1000,  -- The default bulk size for the set based methods (create_rows, read_rows, update_rows)
   p_enable_dml_view             IN BOOLEAN  DEFAULT FALSE, -- If true, a view with an instead of trigger is generated, which simply calls the API methods - can be useful for low code frontends like APEX.
-  p_dml_view_name               IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the DML view - you can use substitutions like #TABLE_NAME# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_dml_view_name               IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the DML view - you can use substitutions like #TABLE_NAME# , #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_dml_view_trigger_name       IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the DML view trigger - you can use substitutions like #TABLE_NAME#, #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
   p_enable_one_to_one_view      IN BOOLEAN  DEFAULT FALSE, -- If true, a 1:1 view with read only is generated - useful when you want to separate the tables into an own schema without direct user access.
-  p_one_to_one_view_name        IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the 1:1 view - you can use substitutions like #TABLE_NAME# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
-  p_api_name                    IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the API - you can use substitutions like #TABLE_NAME# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_one_to_one_view_name        IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the 1:1 view - you can use substitutions like #TABLE_NAME#, #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_api_name                    IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the API - you can use substitutions like #TABLE_NAME#, #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
   p_sequence_name               IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the create_row methods - same substitutions like with API name possible.
   p_exclude_column_list         IN VARCHAR2 DEFAULT NULL,  -- If not null, the provided comma separated column names are excluded on inserts and updates (virtual columns are implicitly excluded).
   p_audit_column_mappings       IN VARCHAR2 DEFAULT NULL,  -- If not null, the provided comma separated column names are excluded and populated by the API (you don't need a trigger for update_by, update_on...).
@@ -214,10 +216,11 @@ FUNCTION get_code
   p_double_quote_names          IN BOOLEAN  DEFAULT TRUE,  -- If true, object names (owner, table, columns) are placed in double quotes.
   p_default_bulk_limit          IN INTEGER  DEFAULT 1000,  -- The default bulk size for the set based methods (create_rows, read_rows, update_rows)
   p_enable_dml_view             IN BOOLEAN  DEFAULT FALSE, -- If true, a view with an instead of trigger is generated, which simply calls the API methods - can be useful for low code frontends like APEX.
-  p_dml_view_name               IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the DML view - you can use substitutions like #TABLE_NAME# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_dml_view_name               IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the DML view - you can use substitutions like #TABLE_NAME# , #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_dml_view_trigger_name       IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the DML view trigger - you can use substitutions like #TABLE_NAME#, #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
   p_enable_one_to_one_view      IN BOOLEAN  DEFAULT FALSE, -- If true, a 1:1 view with read only is generated - useful when you want to separate the tables into an own schema without direct user access.
-  p_one_to_one_view_name        IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the 1:1 view - you can use substitutions like #TABLE_NAME# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
-  p_api_name                    IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the API - you can use substitutions like #TABLE_NAME# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_one_to_one_view_name        IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the 1:1 view - you can use substitutions like #TABLE_NAME#, #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
+  p_api_name                    IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the API - you can use substitutions like #TABLE_NAME#, #TABLE_NAME_26# or #TABLE_NAME_4_20# (treated as substr(table_name, 4, 20)).
   p_sequence_name               IN VARCHAR2 DEFAULT NULL,  -- If not null, the given name is used for the create_row methods - same substitutions like with API name possible.
   p_exclude_column_list         IN VARCHAR2 DEFAULT NULL,  -- If not null, the provided comma separated column names are excluded on inserts and updates (virtual columns are implicitly excluded).
   p_audit_column_mappings       IN VARCHAR2 DEFAULT NULL,  -- If not null, the provided comma separated column names are excluded and populated by the API (you don't need a trigger for update_by, update_on...).

docs/changelog.md

@@ -39,15 +39,15 @@ Please use for all comments, discussions, feature requests or bug reports the Gi
 - added: support for audit columns (parameters p_audit_column_mappings and p_audit_user_expression)
 - added: support for a row version column (parameter p_row_version_column_mapping)
 - added: support for a 1:1 view with read only (parameter p_enable_one_to_one_view)
-- added: support for naming the generated views (parameters p_dml_view_name and p_one_to_one_view_name)
+- added: support for naming all generated objects (parameters p_dml_view_name, p_dml_view_trigger_name and p_one_to_one_view_name)
 - added: double quoting of table and column names can now be configured (parameter p_double_quote_names, default true)
 - added: update function with return clause (mainly for use in create_or_update_row to prevent read row after update)
 - added: unit tests with utPLSQL (it will be a permanent task to improve the tests with every new feature or bugfix)
 - removed: support for a generic change log (parameter p_enable_generic_change_log - makes no sense anymore with bulk processing and multi column primary keys)
 - removed: prevent updates if columns do not differ (remove was needed to support all possible column types and for performance reasons)
 - removed: parameter p_reuse_existing_api_params (usage was was not logic, simply provide always your needed parameters and create scripts or a wrapper)
 - removed: procedure recreate_existing_apis (this was a parameterless procedure which reused the existing API parameters, you can still do this with the help of the pipelined function view_existing_apis)
-- fixed: identity columns are always hidden on create methods (is now handled correct and in the sense of an API)
+- fixed: identity columns are always hidden on create methods (is now handled correct and in the sense of a table API)
 
 ## 0.5.2 (2020-05-09)
 

docs/parameters.md

@@ -29,6 +29,7 @@
 - [p_default_bulk_limit (since v0.6.0)](#p_default_bulk_limit-since-v060)
 - [p_enable_dml_view (since v0.4.0)](#p_enable_dml_view-since-v040)
 - [p_dml_view_name (since v0.6.0)](#p_dml_view_name-since-v060)
+- [p_dml_view_trigger_name (since v0.6.0)](#p_dml_view_trigger_name-since-v060)
 - [p_enable_one_to_one_view (since v0.6.0)](#p_enable_one_to_one_view-since-v060)
 - [p_one_to_one_view_name (since v0.6.0)](#p_one_to_one_view_name-since-v060)
 - [p_api_name (since v0.5.0)](#p_api_name-since-v050)
@@ -137,11 +138,25 @@
 
 - String (varchar2), default: null
 - If not null, the given name is used for the DML view
-- You can use substitutions - examples:
+- You can use the substitutions `#TABLE_NAME#`, `#COLUMN_PREFIX#` and `#PK_COLUMN#` (the first column on multicolumn primary keys)
+- Examples:
+  - `#TABLE_NAME#` is substituted as `table_name`
   - `#TABLE_NAME_20#` is treated as `substr(table_name, 1, 20)`
   - `#TABLE_NAME_5_20#` is treated as `substr(table_name, 5, 20)`
   - `#TABLE_NAME_-20_20#` is treated as `substr(table_name, -20, 20)`
-  - For table EMP and `p_dml_view_name => '#TABLE_NAME_26#_V'` you get `EMP_V`
+  - For TABLE_NAME_WITH_29_CHARACTERS and `p_dml_view_name => '#TABLE_NAME_24#_DML_V'` you get `TABLE_NAME_WITH_29_CHARA_DML_V`
+
+## p_dml_view_trigger_name (since v0.6.0)
+
+- String (varchar2), default: null
+- If not null, the given name is used for the DML view trigger
+- You can use the substitutions `#TABLE_NAME#`, `#COLUMN_PREFIX#` and `#PK_COLUMN#` (the first column on multicolumn primary keys)
+- Examples:
+  - `#TABLE_NAME#` is substituted as `table_name`
+  - `#TABLE_NAME_20#` is treated as `substr(table_name, 1, 20)`
+  - `#TABLE_NAME_5_20#` is treated as `substr(table_name, 5, 20)`
+  - `#TABLE_NAME_-20_20#` is treated as `substr(table_name, -20, 20)`
+  - For TABLE_NAME_WITH_29_CHARACTERS and `p_dml_view_trigger_name => '#TABLE_NAME_24#_IOIUD'` you get `TABLE_NAME_WITH_29_CHARA_IOIUD`
 
 ## p_enable_one_to_one_view (since v0.6.0)
 
@@ -153,21 +168,25 @@
 
 - String (varchar2), default: null
 - If not null, the given name is used for the 1:1 view
-- You can use substitutions - examples:
+- You can use the substitutions `#TABLE_NAME#`, `#COLUMN_PREFIX#` and `#PK_COLUMN#` (the first column on multicolumn primary keys)
+- Examples:
+  - `#TABLE_NAME#` is substituted as `table_name`
   - `#TABLE_NAME_20#` is treated as `substr(table_name, 1, 20)`
   - `#TABLE_NAME_5_20#` is treated as `substr(table_name, 5, 20)`
   - `#TABLE_NAME_-20_20#` is treated as `substr(table_name, -20, 20)`
-  - For table EMP and `p_one_to_one_view_name => '#TABLE_NAME_26#_V'` you get `EMP_V`
+  - For TABLE_NAME_WITH_29_CHARACTERS and `p_one_to_one_view_name => '#TABLE_NAME_28#_V'` you get `TABLE_NAME_WITH_29_CHARACTER_V`
 
 ## p_api_name (since v0.5.0)
 
 - String (varchar2), default: null
 - If not null, the given name is used for the API
-- You can use substitutions - examples:
+- You can use the substitutions `#TABLE_NAME#`, `#COLUMN_PREFIX#` and `#PK_COLUMN#` (the first column on multicolumn primary keys)
+- Examples:
+  - `#TABLE_NAME#` is substituted as `table_name`
   - `#TABLE_NAME_20#` is treated as `substr(table_name, 1, 20)`
   - `#TABLE_NAME_5_20#` is treated as `substr(table_name, 5, 20)`
   - `#TABLE_NAME_-20_20#` is treated as `substr(table_name, -20, 20)`
-  - For table EMP and `p_api_name => '#TABLE_NAME_26#_API'` you get `EMP_API`
+  - For TABLE_NAME_WITH_29_CHARACTERS and `p_api_name => '#TABLE_NAME_26#_API'` you get `TABLE_NAME_WITH_29_CHARACT_API`
 
 ## p_sequence_name (since v0.2.0)