DEF_SCHEMA_PROCS_FORMAT
DEF_SCHEMA_PROCS_FORMAT process attribute is only applicable to
SQL Server (Windows environment) and Oracle database version of the iProcess Engine.Summary
This attribute allows you to override the default format of the stored procedure name when defining or editing the EAIDB step.
Applies To
This attribute can be set for the RPC_POOL process.
Permissible Values
0, 1, or 2
Default Value
This attribute is not defined automatically when you install or upgrade iProcess Engine. In this case, the default value is:
|
Machine ID |
Process |
Instance |
Value |
|
0 |
ALL |
0 |
0 |
The attribute only appears in the output of the SHOW_ALL_ATTRIBUTES command if you have explicitly assigned a value to it using the SET_ATTRIBUTE command. The default setting is not displayed.
Notes
EAIDB Step for SQL Server:
Defining the Database Stored Procedure to call on 'Process Step' or 'Withdraw Step' can be categorized into below with respect to displaying the Stored Procedure dropdown.
-
With Server and Database name or with only Database Name in input
The Stored Procedure dropdown is displayed with the list of Stored Procedures fetched from the given details and in the following format.
<SCHEMA>.<StoredProcedure>
All the procedures from the given database and that are accessible to the Foreground User are displayed with the schema name. The behavior is the same for New EAIDB step or an Edit. -
Without Server and Database name in input
The Stored Procedure dropdown for a new step displays with the list of stored procedures fetched from the iProcess Engine’s database. The formatted lists are as follows:
-
<SCHEMA>.<StoredProcedure>
Stored procedures from the non-default schema of the Foreground User (basically all other schemas from the iProcess Engine database, other than the user’s default schema), are displayed with the schema name. -
<StoredProcedure>
Stored procedures from the default schema of the Foreground User, are displayed without the schema name. We do have a Process Attribute to suppress this behavior. For example, in the event when a user wants to see the procedures from the default schema with the schema name.The
DEF_SCHEMA_PROCS_FORMATprocess attribute controls the display format of the stored procedures from the default schema. This attribute has no effect on 'point a'.
The valid values are
0,1and2:1- displays the stored procedures from the default schema in<StoredProcedure>format.2- displays the stored procedures from the default schema in<SCHEMA>.<StoredProcedure>format.0ornot set- behaves the same as 1.Edit behaves a bit different occasionally, as the dropdown can be populated in the following two ways.
-
When the dialog is loaded after you click Edit step.
The dropdown list format matches with the already configured Procedure Name. This is mainly to retain the designed format and respect the original intention of the user. The process attributeDEF_SCHEMA_PROCS_FORMAThas no effect on step initial load. -
When you click Refresh.
The dropdown list format matches with the already configured Procedure Name. Here, the user has an option to override this behavior by setting a process attributeDEF_SCHEMA_PROCS_FORMAT.
The role or behavior of
DEF_SCHEMA_PROCS_FORMATprocess attribute value is described as follows:1- displays the stored procedures from the default schema in<StoredProcedure>format.2- displays the stored procedures from the default schema in<SCHEMA>.<StoredProcedure>format.0ornot set- displays the stored procedures in the format of the already configured Procedure Name.Note: Overriding the behavior may result into Procedure Name mismatch errors that was configured earlier and is expected if the user is intending to modify the Procedure Name or the parameters associated. -
EAIDB Step for Oracle:
The Stored Procedure dropdown for EAIDB step is displayed with the list of Stored Procedures fetched from iProcess Engine schemas, SWUSER and SWPRO and from the list of schemas configured in EAIDB_PROCS_SCHEMAS process attribute.
The stored procedure names are displayed in the following formats:
| — | <PackageName>.<Stored Procedure>: stored procedures from all packages.
The Stored Procedure name is prefixed with the Package name when displayed in the dropdown. The |
| — | <Stored Procedure>: all stored procedures from the given schemas. The
Procedure name does not display the owner name in the dropdown unless the behavior is modified by the DEF_SCHEMA_PROCS_FORMAT process attribute. |
Defining the Database Stored Procedure to call a Process Step or a Withdraw Step can be categorized as follows:
| 1. | New Step:
The
|
| 2. | Edit Step:
The
The
|
DEF_SCHEMA_PROCS_FORMAT process attribute gives the
flexibility of overriding the default format of the Procedure Name dropdown, which is needed for backward compatibility with the existing iProcess Procedures. However, it is recommended to use
it cautiously. Otherwise, it may lead to design-time and/or run-time failures.