Oracle® Identity Manager Design Console Guide Release 9.0 Part Number B32143-01 |
|
|
View PDF |
This appendix describes the scope, content, and description of the Form Version Control Utility. It contains the following topics:
The following table provides a scope of the functions that are implemented with this utility:
Functionality | Implemented (Yes/No) | Comments |
---|---|---|
Upgrade process form version | Yes | Ensure that the target form version exists and is the active form version. |
Upgrade child form version | Yes | The child form version is automatically upgraded to the child form attached with the active parent form. |
Update values on parent form | Yes | Ensure that the target form version exists and has the fields whose values you are trying to update. |
Update values on child form | Yes | Ensure that the target child form exists and the user is provisioned with the child form. |
Insert values on child form | Yes | Ensure that fields that you are inserting exist on the child form version that is attached with the active parent form. |
The following table lists and describes the names and paths of the files that comprise the utility.
File Name with Path | Description |
---|---|
<XLCLIENT_HOME>\ lib\xlFvcUtil.jar | This jar file contains the Form Version Control utility classes required to run it. |
<XLCLIENT_HOME>\xlFvcUtil.ear | This ear file contains the Form Version Control utility classes required to run it. This ear file is packaged to run with WebSphere launchClient utility. |
<XLCLIENT_HOME>\fvc.properties | This file contains all the configuration properties regarding the source and target form versions, the fields on them, their values as well as child form information. |
<XLCLIENT_HOME>\fvcutil.cmd
<XLCLIENT_HOME>\fvcutil_websphere.cmd |
These are cmd and shell scripts to run the Form Version Control Utility on windows and UNIX. |
Form Version Control utility is designed to update custom process forms version number field as well as data in the additional process form fields. The utility is launched from command console, and operates using command line parameters for login and a properties file. The properties in the parameters as well as validity of user's login and password are verified and appropriate error messages are produced to signify an error when one occurs.
Per system requirements, utility will update only process forms for objects whose status is not "Revoked".
The utility has special provisioning for the case where form field values need to be updated but form version should remain the same. In this case the <version to> and <version from> parameters must be the same. The utility will not create and error, but will update field values instead for the version specified, while not changing the version value itself.
The utility does not have any feature that will allow it to "insert" a child record. A child table record is considered to be a single child table field. Thus, if the following entries exist in the fvc.properties
file:
Child;UD_CF3_FIELD7;tiger;Insert
Child;UD_CF3_FIELD8;mad;Insert
Child;UD_CF3_FIELD9;me2;Insert
This will create three different rows in the child table, instead of creating and inserting a single child record having the above values for the three fields.
The utility can only be used to update custom process forms when a value of "Active Version" is assigned to the ToVersion
property in the fvc.properties file.
Default values for new fields must be defined in the property files.