Hierarchy¶

class dlkit.services.hierarchy.Hierarchy(provider_manager, catalog, runtime, proxy, **kwargs)¶

Bases: dlkit.osid.objects.OsidCatalog, dlkit.osid.sessions.OsidSession

A Hierarchy represents an authenticatable identity.

Like all OSID objects, a Hierarchy is identified by its Id and any persisted references should use the Id.

get_hierarchy_record(hierarchy_record_type)¶

Gets the hierarchy record corresponding to the given Hierarchy record Type.

This method is used to retrieve an object implementing the requested record. The hierarchy_record_type may be the Type returned in get_record_types() or any of its parents in a Type hierarchy where has_record_type(hierarchy_record_type) is true .

Parameters:	hierarchy_record_type (`osid.type.Type`) – the type of the record to retrieve
Returns:	the hierarchy record
Return type:	`osid.hierarchy.records.HierarchyRecord`
Raise:	`NullArgument` – `hierarchy_record_type` is `null`
Raise:	`OperationFailed` – unable to complete request
Raise:	`Unsupported` – `has_record_type(hierarchyrecord_type)` is `false`

compliance: mandatory – This method must be implemented.