Authorities that support hierarchies of terms behave differently than other Authorities.
Currently, the following Authorities provide this behavior:
LocationAuthority
PersonAuthority
OrgAuthority
For all queries, the target of the URI is called the "item". Another item that is related to this item using the hierarchy capabilities of a POST or PUT to one of the above Authorities is either a parent, sibling, or child. A parent has a Relation that says there is a subject of the child's CSID, an object of the parent's CSID, and a predicated of RelationshipType.HAS_BROADER or "hasBroader".
Query Parameters
These authorities accept the following query parameters to affect what they return:
ParameterName |
ParameterValue |
Meaning |
|---|---|---|
showRelations |
true or false |
if showRelations=true is sent, the response will include a part called relations-common-list which will contain the item, and any parents. There is a rule that says an item may only have one parent. |
showAllRelations |
true or false |
if showAllRelations=true is sent, the response will include a relations-common-list part that contains the item, the parent, and any siblings. |
showSiblings |
true or false |
if showSiblings=true is sent, the relations-common-list will include the siblings, and neither the item nor the parent. |