Understanding Ownership Approvals

The Ownership approval method allows you to invite approvers based on an ownership property that you define for nodes in a viewpoint.

The ownership property on a node identifies the user who is responsible for approving requests for that node. After you assign an ownership property on the policy, the users that you identify are invited to approve any changes in request items that include that node. Each invited node owner must approve the request in order to fulfill the policy.

Note:

The term "owner" in the context of Ownership approval methods is not the same as the Owner permission on a data chain object. Node owners get invited as approvers on an approval policy, which grants only the ability to approve requests for that node. Node owners are not automatically granted any additional permissions for that node, such as the ability to view or edit that node.

Considerations

  • You can configure the Ownership method on Approval policies only. You cannot configure the Ownership method on Commit or Notification policies.
  • You can define multiple ownership properties on a node, which enables you to have more than one node owner as approvers for that node. Each property must be on a separate approval policy, since you can assign only one ownership property per policy.
  • The users that you designate as owners are chosen from a Users application (see Working with Users Applications) using Node data type properties with the User subtype (see Node Data Type Subtypes).
  • If the owner of a node is changed while a request is In Flight, the new owner is invited to approve and the previous owner is no longer invited to approve. If the previous owner has already approved the request, that approval is retained in the request history.
  • If a node owner is not available (for example, the owner is not a valid user or is out of the office), the request is escalated. See Policy Reminders and Escalations.

Process Flow

The following describes the general process flow when setting up ownership approvals. It is not intended as a step-by-step procedure, but rather an overview of the steps that are required in order to utilize the ownership approval method.

  1. Set up a Users application to store your users. (See Working with Users Applications.)

    Important: In order to be assigned as a node owner, a user in your Users application must be a valid user in Oracle Enterprise Data Management Cloud (CoreStats.EDM User = True). The system uses the User.Email Address property in the Users application to determine valid users. See Predefined Properties for Users Applications.

  2. Create a Node data type property with the User subtype to use as an ownership property. See Creating Properties Manually.
  3. Associate the property with a node type in the viewpoint. See Adding a Property to a Node Type.

    Tip:

    For the Assigned Node Set and Allowed Node Types, select the appropriate node set and node types from the Users application that you created in step 1.
  4. Configure an approval policy to use the Ownership method. (See Creating and Enabling Approval Policies).
    1. For Approval Method, select Ownership.
    2. For Ownership Property, select the property that you configured as an ownership property (created in step 2, above).
    3. Enable and save the policy.
  5. Assign the node owners:
    1. In the viewpoint, create a request and set the value of the ownership property (created in step 2, above) for each node to a user in your Users application.

      Tip:

      Setting the value of this property to be inherited or derived can simplify this process.
    2. Submit and complete the request.

Request Processing

After you have configured your Users application, viewpoint, and approval policies for ownership approvals, invitees and policy fulfillment are calculated based on the value of the ownership property. When a request with an ownership policy reaches the Approve stage:

  1. The Ownership policy is evaluated on the node for each request item that is associated with the policy.
  2. For each node, the value of the ownership property is checked, and each user referenced by the ownership property is invited to approve the request. The users must be valid users in Oracle Enterprise Data Management Cloud.
  3. Each invitee must approve the request in order to fulfill the policy.
  4. If an invitee is not a valid user or is out of the office, the request is escalated.

Best Practices

  • Node owners can always approve requests via the request inspector (see Request Inspector Actions). However, in order to be able to visualize the request changes in a viewpoint, node owners must have at least Participant (Read) access to the viewpoints that contains the nodes that they are owners on. See Security for Views and Viewpoints.
  • Enable the Ownership Approval Permission application-specific validation to display a validation error or warning when a request or viewpoint is validated if the node owner does not have at least Participant (Read) access to the viewpoint. See Working with Application Specific and Generic Validations.
  • When you create the property that you will be using as the ownership property, set it as Required in the viewpoint so that node owners are always assigned to each node.
  • Set up ownership properties as inherited (in a hierarchy viewpoint) or derived from a lookup (in a list viewpoint) so that when new nodes are added the ownership property is automatically populated.
  • When you configure your ownership property, use the Selection Criteria Property, Select Criteria Operator, and Selection Criteria Value fields to ensure that only valid users are able to be assigned as node owners. See Node Data Type Parameters.

    For example:

    • Selection Criteria Property: EDM User
    • Select Criteria Operator: Equal
    • Selection Criteria Value: 1 (True)
  • Create a separate list viewpoint specifically to maintain node ownership. This enables you to govern node ownership separately from any data changes.
  • If you add a user in Access Control that you want to use as a node owner, you must also add them in your Users application before they can be used as an ownership approval user.