MDM Change Request Approval human service
The application toolkit contains the MDM Change Request Approval human service that provides a workflow that presents a ChangeRequest business object to the user.
- Usage
- The human service enables a user, such as a data steward, to either
approve or reject the changes in a change request. The human service
also presents confirmation, error, or completion windows to the user,
depending on the outcome of the request sent o the MDM operational
server. The human service also performs the update request to the
MDM operational server. The human service provides error checking
logic to ensure that inbound ChangeRequest business objects contain
changes and provides exception handling on the update to the MDM operational
server.
Although this human service is designed for a solution that is included in IBM® Stewardship Center, you can use this human service independently.
To use the human service outside the IBM Stewardship Center, specify values for the variables.
To use this human service inside another human service, you must adjust the human service to account for the two exit nodes, Approved and Rejected. iIn the Process Designer you need to draw two lines from the service. One line for the approved path and one line for the rejected path. When you draw a line from this human service to another node in your service, the Process Designer indicates if that line represents the approved path or rejected path. If you do not draw the two lines, a problem could occur with your human service. This issue does not apply when a business process definition calls the MDM Change Request Approval human service. With a business process definition, the exit nodes are not exposed.
This human service also has a special Error Exit point. This exit point occurs if no change request is passed in, or the change request has no changes in it. Before going through this exit point, the human service displays a message to the user which states that there are no changes. The exit point has a specific error code of NoChanges, which can be detected when you attach an error intermediate event to your invocation of this human service. In this situation, a business process definition that starts this human service is capable of detecting this specific error if required.
- Variables
- This human service uses the following variables:
Table 1. Variables for the MDM Change Request Approval human service. Variable name Variable type Data type Description changeRequest Input ChangeRequest The ChangeRequest business object. Contains the new values for the attributes that are included in the change request. connection Input MDM_Connection The MDM_Connection business object. Contains the information for a connection to the operational server. - hostname
- locale
- port
- password
- requestUser
- serverType. This parameter is deprecated. The serverType parameter is used to document the server type that is being used. For example: virtual, physical, and so forth. The application toolkit components do not use this parameter.
- username
- usessl
context Input Name Value Pair (List) A list of name-value pairs that defines the context information to display in the user interface. This list provides the data steward with additional attributes associated with the change request. For example, if the change request is to change the City, the data steward needs context to understand more about who or what the change is for. If the change is for Amanda Hernandez, you can use the context variable to pass in Given Name 1: Amanda Surname: Hernandez.
decisionReason Output String The text that is provided by the data steward in the Decision reason field. This field is used to explain the reason for approving or rejecting the change request. approved Output Boolean Specifies whether the change request was approved. The default is false. updatedObject Output ANY The object that contains the updates, as a result of the approval of the changes. savedOriginalObject Private ANY Save the original object value. The coach view changes the displayed object data. endMsg Private String The message to display in the End dialog box. showEndDialog Private Boolean Controls whether the End dialog box is shown. The default is false. showErrorDialog Private Boolean Controls whether the Error dialog box is shown. The default is false. exception Private MDM_Exception The MDM_Exception business object. This variable is a representation of the failure to commit the data to the MDM operational server. sendToStream Private Boolean Controls whether the text in the decisionReason output variable is displayed on the @Mentions and Stream tabs.