Question
Trying to understand how hierarchies are set up in Reltio.
How is parent/child of a directional relationship matched to super- / sub-entities?
Can we see these details in the UI?
Answer
In a hierarchical relationship, the child is the start object and is the sub-entity; the parent is the end object and is the super-entity. As an example, an HCP would be a child of an HCA.
D&B and Company hierarchy facets enable you to view hierarchical relationships and add, edit, or remove parent or child entities.
The Graph perspective in the UI will give relationship details, not hierarchy information. The below API will give you more detailed information by Entity URI:
GET {Tenant_URL}/entities/{Object_URI}
Section configuration/relationTypes/... will give you start and end objects.
| type | Relationship type of a relationship | String, Relation Types URI |
configuration/relationTypes/Employment |
"type":"configuration/relationTypes/Employment","startObject":{"uri":"relations/r1/startObject","objectURI":"entities/e1","type":"configuration/entityTypes/Individual","label":"John Smith","directionalLabel":"employee"},"endObject":{"uri":"relations/r1/endObject","objectURI":"entities/e2","type":"configuration/entityTypes/Organization","label":"Super Company","directionalLabel":"employer"},
Get Hops
This function returns entities and relations traversed with N-hop operation.
Request
GET {TenantURL}/entities/{entity object uri}/_hops
Response
Collections of traversed entities and relations with default details:
- Relations:
- uri - URI of a relation
- type - type of a relation
- startObject - has information about start object uri, and this object directionalLabel
- endObject- has information about end object uri, and this object directionalLabel
- Properies defined in select parameter
- Entities:
- uri - URI of an entity that is traverced
- type - type of an entity
- label - label of an entity
- Properies defined in select parameter
- traversedRelationsCount - number of relations of an entity that were traversed with this operation
- untraversedRelationsCount- number of relations of an entity that were not traversed with this operation
GET {TenantURL}/entities/1/_hops?select=entities.attributes.Gender&max=5&deep=1Headers: Authorization: Bearer 204938ca-2cf7-44b0-b11a-1b4c59984512{"relations": [{"uri":"relations/1_2","type":"configuration/relationTypes/Parent","startObject": {"objectURI":"entities/1","directionalLabel":"mother"},"endObject": {"objectURI":"entities/2","directionalLabel":"daughter"},"direction":"directed"},{"uri":"relations/1_3","type":"configuration/relationTypes/Parent","startObject": {"objectURI":"entities/1","directionalLabel":"mother"},"endObject": {"objectURI":"entities/3","directionalLabel":"son"},"direction":"directed"},{"uri":"relations/2_3","type":"configuration/relationTypes/Sibling","startObject": {"objectURI":"entities/2","directionalLabel":"sister"},"endObject": {"objectURI":"entities/3","directionalLabel":"brother"},"direction":"undirected"}],"entities": [{"uri":"entities/1","type":"configuration/entityTypes/Individual","label":"Ann Roman","untraversedRelationsCount": 0,"traversedRelationsCount": 2,"attributes": {"Gender": [{"value":"Female"}]}},{"uri":"entities/2","type":"configuration/entityTypes/Individual","label":"Marsha Smith","untraversedRelationsCount": 0,"traversedRelationsCount": 2,"attributes": {"Gender": [{"value":"Female"}]}},{"uri":"entities/3","type":"configuration/entityTypes/Individual","label":"John Roman","untraversedRelationsCount": 0,"traversedRelationsCount": 2,"attributes": {"Gender": [{"value":"Male"}]}}]}
References
https://docs.reltio.com/profiles/graphperspective.html
https://docs.reltio.com/datadrivenapps/acct360dnbcompanyhierarchy.html
Comments
Please sign in to leave a comment.