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
- 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