Creating a Multiple Item Request

Overview

Purpose

This tutorial demonstrates the submission, review, pushback, correction, and approval of a multiple item change request using an Oracle Data Relationship Governance workflow model.

Time to Complete

Approximately 30 minuntes.

Introduction

In this tutorial, you create a multiple item request by searching and browsing for nodes and then submit the request for intermediate approval and final commitment. As the approver, you review the request, claim and approve the request to send it to the final commitment user. As the commitment user, you run validations and push back the request to the submitting user to make a correction. As the submitting user, you claim the assigned request, make your correction and resubmit the request. As the approving and committing users, you re-approve the new changes to the request.

Prerequisites

Before starting this tutorial, you should:

  • Have access to or have installed Oracle Data Relationship Management 11.1.2.3.301.
  • Have access to or have installed the COAMGT Data Relationship Management application. You can download the application here and use these instructions to install and configure the application.

Creating a Multiple Item Request

  1. Launch Data Relationship Management Web Client.

    The Logon page

    The logon page for Oracle Data Relationship Management is displayed.

  2. Log on to the COAMGMT application as user Operations with a password of Welcome!.

    The Worklist page
  3. The Worklist page is displayed with a list of requests currently assigned to the user is available for review.

  4. Select New Request and then Product Maintenance.
    Note: Load the version if prompted.

    New Request Menu
    New Product Maintenance Request

    The New Request tab is displayed. The workflow model label and description is displayed at the top of the tab.

  5. From the Version drop-down list, select Vision Jan 2013.

    Select Version
  6. Click Add Items to add a request item.

    Add Request Item

    The Add Items dialog box and a list of available workflow tasks are displayed.

  7. Multiple tasks are available to perform within this wokrflow stage. From the Tasks drop-down list, select the Add Product workflow task.

    Add Request Item
  8. Click OK.

    Add Request Item

    The Add Product task is added to the Request Items table and the Item Details fields are displayed below the table.

  9. Define the following values for the new product:

    • Name = P_161
    • Description = Tablet Standard
    • Parent = Tota Productl~P_TP1

    Request Item Values
  10. Click the Update link to temporarily save your changes to the request item.

    Update Request Item

    The request item is updated with your saved changes.

  11. Click Add Items to add a request item.

    Add Request Item

    The Add Items dialog box and a list of available workflow tasks are displayed.

  12. From the Tasks drop-down list, select the Add Product Category workflow task.

    Add Request Item
  13. Click OK.

    Add Request Item

    The Add Product task is added to the Request Items table and the Item Details fields are displayed below the table.

  14. Define the following values for the new product category:

    • Name = P_160
    • Description =myPad Tablet
    • Parent = Total Product~P_TP1

    Request Item Values
  15. Click the Update link to temporarily save your changes to the request item.

    Update Request Item

    The request item is updated with your saved changes.

  16. Repeat steps 10 through 14 to add two other request items for the following new product categories:

    • Name = P_170, Description =Sentinel Server, Parent = Total Product~P_TP1
    • Name = P_180, Description =Envoy Desktop, Parent = Total Product~P_TP1

    Update Request Item

Filtered Node Searching and Browsing

  1. Click Add Items to add a request item and then select the Change Product Category task from the Task drop-down list.

    Add Comment
    Add Comment

    The Add Items dialog box is displayed and enables you to select on or more existing options. The Search tab is selected by default.

  2. In the Search field, type * (asterisk) and click the Search icon (Search).

    Comment Added

    Note that only Computer nodes are returned by the search based on your workflow node access.

  3. Press and hold down Shift and select P_110, P_120, P_130, and P_140 from the search results, and then click the Select button (Select) to select the nodes.

    Request Activity

    Note that only Computer nodes are returned by the search based on your workflow node access.

  4. Select the Browse tab and expand the P_TP1 - Computers node.

    Browse Tab

    Note that you can view only Computers section of the Products hiearachy based on your workflow node access to the hierarchy.

  5. Click OK.

    Browse Tab

    Four additional items are displayed for the request. Note that the last item is selected by default. Because the Change Product Category task is used to make a change for exiisting nodes, the Item Details section displays information in the Current vs. New Value format.

  6. In the Request Items list, select the P_110 item.

    Browse Tab
  7. In the New Value column for the Parent field, click the ellipsis button (Ellipsis).

    Browse Tab

    The Select Parent dialog box is displayed.

  8. Select the Items tab and then select the Total Product~P_170 node as the Parent for the P_110 request item.

    Browse Tab
  9. Click OK and then click the Update link to save the change.

    Browse Tab
  10. Repeat steps 6 through 9 to select the following parent nodes for the request items:

    • For node P_120, select Parent as Total Product~P_170
    • For node P_130, select Parent as Total Product~P_180

Saving a Draft Request

  1. In the toolbar, click the Save button (Save).

    Save Request dialog box

    The Save Request dialog box is displayed.

  2. In the Request Title box, enter Computer Products Reorganization and click OK.

    Request drafted

    The New Request tab is changed to Computer Products Reorganization, the Workflow Properties area of the page displays the Draft status of the request, and the Request Activity area displays a new record stating creation of the request.

Submitting the Request

  1. In the toolbar, click the Validate button (Validate).

    Request Submitted

    Request item P_140 displays a validation failure indicator.

  2. In the Action column for the P_140 request item, click the Validation Error icon (Validation Error) to show the validation errors.

    Request Submitted
  3. Click OK to close the Warning dialog box.

  4. In the New Value column for the Parent field, click the ellipsis button (Ellipsis).

    Browse Tab

    The Select Parent dialog box is displayed.

  5. Select the Items tab and then select the Total Product~P_180 node as the Parent for the P_140 request item.

    Browse Tab
  6. Click OK and then click the Update link to save the change.

    Updated Change
  7. In the toolbar, click the Validate button (Validate) to ensure all validation failures have been resolved.

    Re-validating Request

    The request is validated without failrues.

  8. In the toolbar, click the Submit button (Submit).

    Request Submitted

    The request is submitted to the workflow model for assignment to the next user(s). The Workflow Path area displays the request status (Submitted) and the current stage of the request in bold font. The previous stage that has been completed is marked with a checkmark icon. The Request Activity area displays new records stating submission of the request. Note that the submitted request is no longer editable or actionable by the submitting user.

  9. Close the Computer Products Reorganization tab and log out as user Operations.

Reviewing Assigned Requests, Claiming and Approving the Request

  1. Log in to the COAMGMT application as user jcooper with a password Welcome!.

    Worklist

    The Worklist page displays the assigned Computer Products Reorganizattion request and its summary.

  2. Click the Open button (Open) to open the request.

    Opened request

    The Computer Products Reorganization request is opened on a new tab. Note that the Item Details of the request item in the request are not yet editable.

  3. Click the Claim button (Claim) to act upon the request.

    Claimed request

    The Workflow Properties area displays that the request is claimed by user jcooper. Note that item details are still read-only because the active stage is an Approval only stage.

  4. In the toolbar, click the Approve button (Approve).

    Request Submitted

    The request is submitted to the workflow model for assignment to the next user(s). The Workflow Path area displays the request status (Submitted) and the current stage of the request in bold font. The previous stage that has been completed is marked with a checkmark icon. The Request Activity area displays new records stating submission of the request.

  5. Close the Computer Products Reorganization tab and log out as user jcooper.

Pushing Back the Request

  1. Log in as user jstein with a password Welcome! and then select the Worklist task group.

    Worklist

    The Worklist page and the list of assigned requests are displayed.

  2. Click the Open button (Open) to open the request.

    Opened request

    The Computer Products Reorganization request is opened on a new tab. Review the Item Details area for the P_161 request item. Note that the product is a tablet product but its Parent is not the new tablet product category (P_160).

  3. Click the Claim button (Claim) to act upon the request.

    Claimed request

    The Workflow Properties area displays that the request is claimed by user JStein and the request is in the final workflow stage (Commit Product Changes). The item details for the P_161 request are editable with the exception of the Parent which can only be edited in the stage where the request item was added.

  4. In the toolbar, click the Pushback button (Pushback) to send the request back to the submitting user so he can make the correction. Select the Specify Product Changes stage as the target for the pushback and enter the reason for the pushback (for example, enter The product category for item P_161 should be P_160. Make the correction and resubmit.)

    The Pushback.
  5. Click OK.

    The Pushback.

    The Workflow Paths area displays that the request is now back to the Specify Product Changes workflow stage. The comment and pushback are added to the Request Activity area along with the user and a timestamp.

  6. Close the Computer Products Reorganization tab and log out as user jstein.

Correcting and Re-Submitting the Request

  1. Log in as user Operations with a password Welcome!.

    Worklist

    The Worklist page and the list of assigned requests are displayed.

  2. Click the Open button (Open) to open the request.

    Opened request

    The Computer Products Reorganization request is opened on a new tab. Review the Item Details area for the P_161 request item. Note that the product is a tablet product but its Parent is not the new tablet product category (P_160).

  3. Click the Claim button (Claim) to act upon the request.

    Claimed request

    The Workflow Properties area displays that the request is claimed by user Operations and the request is in the initial workflow stage (Specify Product Changes).

  4. Click Add Items to add a request item.

    Add Request Item

    The Add Items dialog box and a list of available workflow tasks are displayed.

  5. Select the Change Product Category task from the Task drop-down list, select the Items tab, and then select the P_161 item.

    Browse Tab
  6. Click OK.

    Browse Tab
  7. In the New Value column for the Parent field, click the ellipsis button (Ellipsis).

    Browse Tab

    The Select Parent dialog box is displayed.

  8. Select the Items tab and then select the Total Product~P_160 node as the Parent for the P_161 request item.

    Browse Tab
  9. Click OK and then click the Update link to save the change.

    Updated Change
  10. In the toolbar, click the Submit button (Submit) to re-submit the request for approval.

    The Pushback.

    The request is submitted to the workflow model for assignment to the next user(s). The Workflow Path area displays the request status (Submitted) and the current stage of the request in bold font. The previous stage that has been completed is marked with a checkmark icon.

  11. Close the Computer Products Reorganization tab and log out as user Operations.

Re-Approving the Request

  1. Log in to the COAMGMT application as user jcooper with a password Welcome!.

    Worklist

    The Worklist page displays the assigned Computer Products Reorganizattion request and its summary.

  2. Click the Open button (Open) to open the request.

    Opened request

    The Computer Products Reorganization request is opened on a new tab. Note that the Item Details of the request item in the request are not yet editable.

  3. Click the Claim button (Claim) to act upon the request.

    Claimed request

    The Workflow Properties area displays that the request is claimed by user jcooper.

  4. In the toolbar, click the Approve button (Approve) to re-approve the request with the correction made.

    Request Submitted

    The request is submitted to the workflow model for assignment to the next user(s). The Workflow Path area displays the request status (Submitted) and the current stage of the request in bold font. The previous stage that has been completed is marked with a checkmark icon.

  5. Close the Computer Products Reorganization tab and log out as user jcooper.

  6. Log in as user jstein with a password Welcome! and then select the Worklist task group.

    Worklist

    The Worklist page and the list of assigned requests are displayed.

  7. Click the Open button (Open) to open the request.

    Opened request
  8. Click the Claim button (Claim) to act upon the request.

    Claimed request

    The Workflow Properties area displays that the request is claimed by user JStein and the request is in the final workflow stage (Commit Product Changes).

  9. In the toolbar, click the Approve button (Approve) to re-approve the request with the correction made.

    Request Submitted

    The Workflow Path indicates that all required workflow stages have been completed.

  10. Close the Computer Products Reorganization tab and log out as user jstein.

Summary

In this tutorial, you learned:

  • As the request creator, to create a multiple item change request by searching and browsing for nodes and then submit the request for intermediate approval and final commitment.
  • As the approver, to review the request, claim and approve the request to send it to the final commitment user.
  • As the commitment user, to run validations and push back the request to the submitting user to make a correction.
  • As the submitting user, to make your correction and resubmit the request.
  • As the approving and committing users, to re-approve the new changes to the request.

Resources

To navigate this Oracle by Example tutorial, note the following:

Topic List:
Click a topic to navigate to that section.
Expand All Topics:
Click the button to show or hide the details for the sections. By default, all topics are collapsed.
Hide All Images:
Click the button to show or hide the screenshots. By default, all images are displayed.
Print:
Click the button to print the content. The content that is currently displayed or hidden is printed.

To navigate to a particular section in this tutorial, select the topic from the list.