OSID - osid.personnel.PersonnelManager Service Interface Definition

Interface	osid.personnel.PersonnelManager
Implements	`osid.OsidManager`
Implements	`osid.personnel.PersonnelProfile`
Description	The personnel manager provides access to personnel sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are: `PersonLookupSession:` a session to lookup persons `PersonQuerySession:` a session for querying persons `PersonSearchSession:` a session to search persons `PersonAdminSession:` a session to manage persons `PersonNotificationSession:` a session to subscribe to notifications of person changes `PersonRealmSession:` a session to look up person to realm mappings `PersonRealmAssignmentSession:` a session to manage person to realm mappings `PersonSmartRealmSession:` a session to manage dynamic person to realm mappings `OrganizationLookupSession:` a session to lookup organizations `OrganizationQuerySession:` a session for querying organizations `OrganizationSearchSession:` a session to search organizations `OrganizationAdminSession:` a session to manage organizations `OrganizationNotificationSession:` a session to subscribe to notifications of organization changes `OrganizationHierarchySession:` a session to traverse organization hierarchies `OrganizationHierarchyDesignSession:` a sesion to manage organization hierarchies `OrganizationRealmSession:` a session to look up organization to realm mappings `OrganizationRealmAssignmentSession:` a session to manage organization to realm mappings `OrganizationSmartRealmSession:` a session to manage dynamic organization to realm mappings `PositionLookupSession:` a session to lookup positions `PositionQuerySession:` a session for querying positions `PositionSearchSession:` a session to search positions `PositionAdminSession:` a session to manage positions `PositionNotificationSession:` a session to subscribe to notifications of position changes `PositionRealmSession:` a session to look up position to realm mappings `PositionRealmAssignmentSession:` a session to manage position to realm mappings `PositionSmartRealmSession:` a session to manage dynamic position to realm mappings `AppointmentLookupSession:` a session to lookup appointments `AppointmentQuerySession:` a session for querying appointments `AppointmentSearchSession:` a session to search appointments `AppointmentAdminSession:` a session to manage appointments `AppointmentNotificationSession:` a session to subscribe to notifications of appointment changes `AppointmentRealmSession:` a session to look up appointment to realm mappings `AppointmentRealmAssignmentSession:` a session to manage appointment to realm mappings `AppointmentSmartRealmSession:` a session to manage dynamic appointment to realm mappings `RealmLookupSession:` a session to retrieve realms `RealmQuerySession:` a session for querying realms `RealmSearchSession:` a session to search for realms `RealmAdminSession:` a session to create, update and delete realms `RealmNotificationSession:` a session to receive notifications for changes in realms `RealmHierarchyTraversalSession:` a session to traverse hierarchies of realms `RealmHierarchyDesignSession:` a session to manage hierarchies of realms The personnel manager also provides a profile for determing the supported search types supported by this service.
Method	getPersonLookupSession
Description	Gets the `OsidSession` associated with the person lookup service.
Return	`osid.personnel.PersonLookupSession`		a `PersonLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPersonLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonLookup()` is `true.`
Method	getPersonLookupSessionForRealm
Description	Gets the `OsidSession` associated with the person lookup service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PersonLookupSession`		a `PersonLookupSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPersonLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonLookup()` and `supportsVisibleFederation()` are `true`
Method	getPersonQuerySession
Description	Gets the `OsidSession` associated with the person query service.
Return	`osid.personnel.PersonQuerySession`		a `PersonQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPersonQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonQuery()` is `true.`
Method	getPersonQuerySessionForRealm
Description	Gets the `OsidSession` associated with the person query service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PersonQuerySession`		a `PersonQuerySession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPersonQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonQuery()` and `supportsVisibleFederation()` are `true`
Method	getPersonSearchSession
Description	Gets the `OsidSession` associated with the person search service.
Return	`osid.personnel.PersonSearchSession`		a `PersonSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPersonSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonSearch()` is `true.`
Method	getPersonSearchSessionForRealm
Description	Gets the `OsidSession` associated with the person search service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PersonSearchSession`		a `PersonSearchSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPersonSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonSearch()` and `supportsVisibleFederation()` are `true`
Method	getPersonAdminSession
Description	Gets the `OsidSession` associated with the person administration service.
Return	`osid.personnel.PersonAdminSession`		a `PersonAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPersonAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonAdmin()` is `true.`
Method	getPersonAdminSessionForRealm
Description	Gets the `OsidSession` associated with the person administration service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PersonAdminSession`		a `PersonAdminSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPersonAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonAdmin()` and `supportsVisibleFederation()` are `true`
Method	getPersonNotificationSession
Description	Gets the `OsidSession` associated with the person notification service.
Parameters	`osid.personnel.PersonReceiver`	`personReceiver`	the receiver
Return	`osid.personnel.PersonNotificationSession`		a `PersonNotificationSession`
Errors	NULL_ARGUMENT		`personReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPersonNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonNotification()` is `true.`
Method	getPersonNotificationSessionForRealm
Description	Gets the `OsidSession` associated with the person notification service for the given realm.
Parameters	`osid.personnel.PersonReceiver`	`personReceiver`	the receiver
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PersonNotificationSession`		a `PersonNotificationSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`personReceiver` or `realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPersonNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonNotification()` and `supportsVisibleFederation()` are `true`
Method	getPersonRealmSession
Description	Gets the session for retrieving person to realm mappings.
Return	`osid.personnel.PersonRealmSession`		a `PersonRealmSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPersonRealm()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonRealm()` is `true.`
Method	getPersonRealmAssignmentSession
Description	Gets the session for assigning person to realm mappings.
Return	`osid.personnel.PersonRealmAssignmentSession`		a `PersonRealmAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPersonRealmAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonRealmAssignment()` is `true.`
Method	getPersonSmartRealmSession
Description	Gets the session associated with the person smart realm for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the realm
Return	`osid.personnel.PersonSmartRealmSession`		a `PersonSmartRealmSession`
Errors	NOT_FOUND		`realmId` not found
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPersonSmartRealm()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonSmartRealm()` is `true.`
Method	getOrganizationLookupSession
Description	Gets the `OsidSession` associated with the organization lookup service.
Return	`osid.personnel.OrganizationLookupSession`		an `OrganizationLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsOrganizationLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationLookup()` is `true.`
Method	getOrganizationLookupSessionForRealm
Description	Gets the `OsidSession` associated with the organization lookup service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.OrganizationLookupSession`		an `OrganizationLookupSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsOrganizationLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationLookup()` and `supportsVisibleFederation()` are `true`
Method	getOrganizationQuerySession
Description	Gets the `OsidSession` associated with the organization query service.
Return	`osid.personnel.OrganizationQuerySession`		an `OrganizationQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsOrganizationQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationQuery()` is `true.`
Method	getOrganizationQuerySessionForRealm
Description	Gets the `OsidSession` associated with the organization query service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.OrganizationQuerySession`		an `OrganizationQuerySession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsOrganizationQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationQuery()` and `supportsVisibleFederation()` are `true`
Method	getOrganizationSearchSession
Description	Gets the `OsidSession` associated with the organization search service.
Return	`osid.personnel.OrganizationSearchSession`		an `OrganizationSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsOrganizationSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationSearch()` is `true.`
Method	getOrganizationSearchSessionForRealm
Description	Gets the `OsidSession` associated with the organization search service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.OrganizationSearchSession`		an `OrganizationSearchSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsOrganizationSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationSearch()` and `supportsVisibleFederation()` are `true`
Method	getOrganizationAdminSession
Description	Gets the `OsidSession` associated with the organization administration service.
Return	`osid.personnel.OrganizationAdminSession`		an `OrganizationAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsOrganizationAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationAdmin()` is `true.`
Method	getOrganizationAdminSessionForRealm
Description	Gets the `OsidSession` associated with the organization administration service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.OrganizationAdminSession`		an `OrganizationAdminSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsOrganizationAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationAdmin()` and `supportsVisibleFederation()` are `true`
Method	getOrganizationNotificationSession
Description	Gets the `OsidSession` associated with the organization notification service.
Parameters	`osid.personnel.OrganizationReceiver`	`organizationReceiver`	the receiver
Return	`osid.personnel.OrganizationNotificationSession`		an `OrganizationNotificationSession`
Errors	NULL_ARGUMENT		`organizationReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsOrganizationNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationNotification()` is `true.`
Method	getOrganizationNotificationSessionForRealm
Description	Gets the `OsidSession` associated with the organization notification service for the given realm.
Parameters	`osid.personnel.OrganizationReceiver`	`organizationReceiver`	the receiver
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.OrganizationNotificationSession`		an `OrganizationNotificationSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`organizationReceiver` or `realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsOrganizationNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationNotification()` and `supportsVisibleFederation()` are `true`
Method	getOrganizationHierarchySession
Description	Gets the session traversing organization hierarchies.
Return	`osid.personnel.OrganizationHierarchySession`		an `OrganizationHierarchySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsOrganizationHierarchy() is false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationHierarchy()` is true.
Method	getOrganizationHierarchySessionForRealm
Description	Gets the `OsidSession` associated with the organization heirarchy traversal service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the realm
Return	`osid.personnel.OrganizationHierarchySession`		an `OrganizationHierarchySession`
Errors	NOT_FOUND		`realmId` not found
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		`unable to complete request`
	UNIMPLEMENTED		`supportsOrganizationHierarchy()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationHierarchy()` and `supportsVisibleFederation()` are `true.`
Method	getOrganizationHierarchyDesignSession
Description	Gets the session designing organization hierarchies.
Return	`osid.personnel.OrganizationHierarchyDesignSession`		an `OrganizationHierarchyDesignSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsOrganizationHierarchyDesign() is false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationHierarchyDesign()` is true.
Method	getOrganizationHierarchyDesignSessionForRealm
Description	Gets the `OsidSession` associated with the organization heirarchy design service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the realm
Return	`osid.personnel.OrganizationHierarchyDesignSession`		an `OrganizationHierarchyDesignSession`
Errors	NOT_FOUND		`realmId` not found
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		`unable to complete request`
	UNIMPLEMENTED		`supportsOrganizationHierarchyDesign()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationHierarchyDesign()` and `supportsVisibleFederation()` are `true.`
Method	getOrganizationRealmSession
Description	Gets the session for retrieving organization to realm mappings.
Return	`osid.personnel.OrganizationRealmSession`		an `OrganizationRealmSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsOrganizationRealm()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationRealm()` is `true.`
Method	getOrganizationRealmAssignmentSession
Description	Gets the session for assigning organization to realm mappings.
Return	`osid.personnel.OrganizationRealmAssignmentSession`		an `OrganizationRealmAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsOrganizationRealmAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationRealmAssignment()` is `true.`
Method	getOrganizationSmartRealmSession
Description	Gets the session associated with the organization smart realm for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the realm
Return	`osid.personnel.OrganizationSmartRealmSession`		an `OrganizationSmartRealmSession`
Errors	NOT_FOUND		`realmId` not found
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsOrganizationSmartRealm()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationSmartRealm()` is `true.`
Method	getPositionLookupSession
Description	Gets the `OsidSession` associated with the position lookup service.
Return	`osid.personnel.PositionLookupSession`		a `PositionLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPositionLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionLookup()` is `true.`
Method	getPositionLookupSessionForRealm
Description	Gets the `OsidSession` associated with the position lookup service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PositionLookupSession`		a `PositionLookupSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPositionLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionLookup()` and `supportsVisibleFederation()` are `true`
Method	getPositionQuerySession
Description	Gets the `OsidSession` associated with the position query service.
Return	`osid.personnel.PositionQuerySession`		a `PositionQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPositionQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionQuery()` is `true.`
Method	getPositionQuerySessionForRealm
Description	Gets the `OsidSession` associated with the position query service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PositionQuerySession`		a `PositionQuerySession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPositionQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionQuery()` and `supportsVisibleFederation()` are `true`
Method	getPositionSearchSession
Description	Gets the `OsidSession` associated with the position search service.
Return	`osid.personnel.PositionSearchSession`		a `PositionSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPositionSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionSearch()` is `true.`
Method	getPositionSearchSessionForRealm
Description	Gets the `OsidSession` associated with the position search service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PositionSearchSession`		a `PositionSearchSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPositionSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionSearch()` and `supportsVisibleFederation()` are `true`
Method	getPositionAdminSession
Description	Gets the `OsidSession` associated with the position administration service.
Return	`osid.personnel.PositionAdminSession`		a `PositionAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPositionAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionAdmin()` is `true.`
Method	getPositionAdminSessionForRealm
Description	Gets the `OsidSession` associated with the position administration service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PositionAdminSession`		a `PositionAdminSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPositionAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionAdmin()` and `supportsVisibleFederation()` are `true`
Method	getPositionNotificationSession
Description	Gets the `OsidSession` associated with the position notification service.
Parameters	`osid.personnel.PositionReceiver`	`positionReceiver`	the receiver
Return	`osid.personnel.PositionNotificationSession`		a `PositionNotificationSession`
Errors	NULL_ARGUMENT		`positionReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPositionNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionNotification()` is `true.`
Method	getPositionNotificationSessionForRealm
Description	Gets the `OsidSession` associated with the position notification service for the given realm.
Parameters	`osid.personnel.PositionReceiver`	`positionReceiver`	the receiver
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.PositionNotificationSession`		a `PositionNotificationSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`positionReceiver` or `realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPositionNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionNotification()` and `supportsVisibleFederation()` are `true`
Method	getPositionRealmSession
Description	Gets the session for retrieving position to realm mappings.
Return	`osid.personnel.PositionRealmSession`		a `PositionRealmSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPositionRealm()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionRealm()` is `true.`
Method	getPositionRealmAssignmentSession
Description	Gets the session for assigning position to realm mappings.
Return	`osid.personnel.PositionRealmAssignmentSession`		a `PositionRealmAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPositionRealmAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionRealmAssignment()` is `true.`
Method	getPositionSmartRealmSession
Description	Gets the session associated with the position smart realm for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the realm
Return	`osid.personnel.PositionSmartRealmSession`		a `PositionSmartRealmSession`
Errors	NOT_FOUND		`realmId` not found
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPositionSmartRealm()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionSmartRealm()` is `true.`
Method	getAppointmentLookupSession
Description	Gets the `OsidSession` associated with the appointment lookup service.
Return	`osid.personnel.AppointmentLookupSession`		an `AppointmentLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAppointmentLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentLookup()` is `true.`
Method	getAppointmentLookupSessionForRealm
Description	Gets the `OsidSession` associated with the appointment lookup service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.AppointmentLookupSession`		an `AppointmentLookupSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAppointmentLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentLookup()` and `supportsVisibleFederation()` are `true`
Method	getAppointmentQuerySession
Description	Gets the `OsidSession` associated with the appointment query service.
Return	`osid.personnel.AppointmentQuerySession`		an `AppointmentQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAppointmentQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentQuery()` is `true.`
Method	getAppointmentQuerySessionForRealm
Description	Gets the `OsidSession` associated with the appointment query service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.AppointmentQuerySession`		an `AppointmentQuerySession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAppointmentQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentQuery()` and `supportsVisibleFederation()` are `true`
Method	getAppointmentSearchSession
Description	Gets the `OsidSession` associated with the appointment search service.
Return	`osid.personnel.AppointmentSearchSession`		an `AppointmentSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAppointmentSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentSearch()` is `true.`
Method	getAppointmentSearchSessionForRealm
Description	Gets the `OsidSession` associated with the appointment search service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.AppointmentSearchSession`		an `AppointmentSearchSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAppointmentSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentSearch()` and `supportsVisibleFederation()` are `true`
Method	getAppointmentAdminSession
Description	Gets the `OsidSession` associated with the appointment administration service.
Return	`osid.personnel.AppointmentAdminSession`		an `AppointmentAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAppointmentAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentAdmin()` is `true.`
Method	getAppointmentAdminSessionForRealm
Description	Gets the `OsidSession` associated with the appointment administration service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.AppointmentAdminSession`		an `AppointmentAdminSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAppointmentAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentAdmin()` and `supportsVisibleFederation()` are `true`
Method	getAppointmentNotificationSession
Description	Gets the `OsidSession` associated with the appointment notification service.
Parameters	`osid.personnel.AppointmentReceiver`	`appointmentReceiver`	the receiver
Return	`osid.personnel.AppointmentNotificationSession`		an `AppointmentNotificationSession`
Errors	NULL_ARGUMENT		`appointmentReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAppointmentNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentNotification()` is `true.`
Method	getAppointmentNotificationSessionForRealm
Description	Gets the `OsidSession` associated with the appointment notification service for the given realm.
Parameters	`osid.personnel.AppointmentReceiver`	`appointmentReceiver`	the receiver
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Return	`osid.personnel.AppointmentNotificationSession`		an `AppointmentNotificationSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`appointmentReceiver` or `realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAppointmentNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentNotification()` and `supportsVisibleFederation()` are `true`
Method	getAppointmentRealmSession
Description	Gets the session for retrieving appointment to realm mappings.
Return	`osid.personnel.AppointmentRealmSession`		an `AppointmentRealmSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAppointmentRealm()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentRealm()` is `true.`
Method	getAppointmentRealmAssignmentSession
Description	Gets the session for assigning appointment to realm mappings.
Return	`osid.personnel.AppointmentRealmAssignmentSession`		an `AppointmentRealmAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAppointmentRealmAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentRealmAssignment()` is `true.`
Method	getAppointmentSmartRealmSession
Description	Gets the session associated with the appointment smart realm for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the realm
Return	`osid.personnel.AppointmentSmartRealmSession`		an `AppointmentSmartRealmSession`
Errors	NOT_FOUND		`realmId` not found
	NULL_ARGUMENT		`realmId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAppointmentSmartRealm()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmenSmarttRealm()` is `true.`
Method	getRealmLookupSession
Description	Gets the `OsidSession` associated with the realm lookup service.
Return	`osid.personnel.RealmLookupSession`		a `RealmLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRealmLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRealmLookup()` is `true.`
Method	getRealmQuerySession
Description	Gets the `OsidSession` associated with the realm query service.
Return	`osid.personnel.RealmQuerySession`		a `RealmQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRealmQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRealmQuery()` is `true.`
Method	getRealmSearchSession
Description	Gets the `OsidSession` associated with the realm search service.
Return	`osid.personnel.RealmSearchSession`		a `RealmSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRealmSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRealmSearch()` is `true.`
Method	getRealmAdminSession
Description	Gets the `OsidSession` associated with the realm administrative service.
Return	`osid.personnel.RealmAdminSession`		a `RealmAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRealmAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRealmAdmin()` is `true.`
Method	getRealmNotificationSession
Description	Gets the `OsidSession` associated with the realm notification service.
Parameters	`osid.personnel.RealmReceiver`	`realmReceiver`	the receiver
Return	`osid.personnel.RealmNotificationSession`		a `RealmNotificationSession`
Errors	NULL_ARGUMENT		`realmReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRealmNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRealmNotification()` is `true.`
Method	getRealmHierarchySession
Description	Gets the `OsidSession` associated with the realm hierarchy service.
Return	`osid.personnel.RealmHierarchySession`		a `RealmHierarchySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRealmHierarchy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRealmHierarchy()` is `true.`
Method	getRealmHierarchyDesignSession
Description	Gets the `OsidSession` associated with the realm hierarchy design service.
Return	`osid.personnel.RealmHierarchyDesignSession`		a `RealmHierarchyDesignSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRealmHierarchyDesign()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRealmHierarchyDesign()` is `true.`
Method	getPersonnelBatchManager
Description	Gets a `PersonnelBatchManager.`
Return	`osid.personnel.batch.PersonnelBatchManager`		a `PersonnelBatchManager`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPersonnelBatch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonnelBatch()` is `true.`