SW_MODIFY_CASEDATA
By using the SW_MODIFY_CASEDATA procedure, you can modify the data of an existing case. Use an SW_ADD_PACK_DATA procedure to specify the data to be modified. Then, an immediately following SW_MODIFY_CASEDATA posts an instruction to the BG process to carry out the change. You can use the SW_MODIFY_CASEDATA procedure to set case data for main procedures and sub-procedures.
This event is audited, using audit message 058. See TIBCO iProcess Engine Administrator’s Guide for details of audit messages.
Syntax
SW_MODIFY_CASEDATA (
proc_name | in varchar2(8), |
proc_maj_ver | in number(5), |
proc_min_ver | in number(5), |
case_number | in integer, |
reason | in varchar(2), |
user_id | in varchar2(24)) |
where:
|
•
|
proc_name is the name of the procedure that you want to modify a case of. |
|
•
|
proc_maj_ver is either the major version number of the proc_name procedure, or -1. See the notes . |
|
•
|
proc_min_ver is either the minor version number of the proc_name procedure, or -1. See the notes . |
|
•
|
case_number is the case number of the main procedure for which the data is to be modified. |
|
•
|
reason is a reason for the case data modification, used in the audit trail. |
|
•
|
user_id is the name of the iProcess user who is performing the modification. |
Notes
Instead of using the specific major and/or minor version number of the procedure, you can specify both the proc_maj_ver and proc_min_ver parameters as -1. If you do this, iProcess will use the version number of the procedure that the case was originally started with or, that it has subsequently been migrated to (if a subsequent version has been released while the case is still in progress).
|
Note
|
If you specify one version number parameter as -1, you must specify the other one as -1 as well.
|
Example
This example modifies data for case 876 of the Transfer procedure. The SW_ADD_PACK_DATA statement changes the value of the TEXT1 field to "New customer name". The SW_MODIFY_CASEDATA call then identifies the procedure and case to be changed, and provides the "Modified For Graft" message which will be displayed in the audit trail.
EXEC ssolite_data.SW_ADD_PACK_DATA('TEXT1', 'New customer name');
EXEC ssolite.SW_MODIFY_CASEDATA('Transfer', -1, -1, 876, 'Modified For Graft', 'swadmin');