addEntityHierarchyRole

Description
This transaction adds an Entity Hierarchy Role to an existing Hierarchy Node. The Entity Hierarchy Role describes the part played by the Entity in association with its Hierarchy Node.
Web Services
Operation name: addEntityHierarchyRole
Service name: DWLBusinessServices
Example
Add a role of Chief Executive Officer to the Hierarchy Node created for Party A in the SampleCorp Inc. Hierarchy.
Usage information
An Entity can have one to many Entity Hierarchy Roles.

Entity Hierarchy Role type can be associated with one to many Entities.

For a given Hierarchy Node, an Entity can have only one Entity Hierarchy Role of the same type.

The Role Type and Role Value are user definable through Code Table.

The Entities supported in this transaction are the same as those supported in Hierarchy: CONTACT, CONTRACT, GROUP, PERSON, ORGANIZATION, CDPRODTP.

Preconditions
Entity must exist and can be active or inactive.

Hierarchy Node must exist and be active.

Mandatory input
  • HierarchyNodeId
  • RoleType
Inquiry levels
Not applicable
Filter values
Not applicable
Transaction behavior
If Role Start Date is not supplied, it will be defaulted to System Date.

The Role Category Type Code and Role Category Type Value are derived from the Role Type and will only be included in the response of this transaction.

Request message
<TCRMTxType> addEntityHierarchyRole

<TCRMTxObject> DWLEntityHierarchyRoleBObj

<TCRMObject> DWLEntityHierarchyRoleBObj

Response objects
DWLEntityHierarchyRoleBObj
Special note
Not applicable