OSID - osid.personnel.batch.PersonnelBatchProxyManager Service Interface Definition

Interface	osid.personnel.batch.PersonnelBatchProxyManager
Implements	`osid.OsidProxyManager`
Implements	`osid.personnel.batch.PersonnelBatchProfile`
Description	The personnel batch proxy manager provides access to personnel batch sessions and provides interoperability tests for various aspects of this service. Methods in this manager support the passing of a `Proxy` object. The sessions included in this manager are: `PersonBatchAdminSession:` a session to create, modify and delete persons in bulk `OrganizationBatchAdminSession:` a session to create, modify and delete organizations in bulk `PositionBatchSession:` a session to create, modify and delete positions in bulk `AppointmentBatchAdminSession:` a session to create, modify and delete appointments in bulk `RealmBatchAdminSession:` a session to create, modify and delete realms in bulk
Method	getPersonBatchAdminSession
Description	Gets the `OsidSession` associated with the bulk person administration service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.personnel.batch.PersonBatchAdminSession`		a `PersonBatchAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPersonBatchAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonBatchAdmin()` is `true.`
Method	getPersonBatchAdminSessionForRealm
Description	Gets the `OsidSession` associated with the bulk person administration service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.personnel.batch.PersonBatchAdminSession`		a `PersonBatchAdminSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPersonBatchAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPersonBatchAdmin()` and `supportsVisibleFederation()` are `true`
Method	getOrganizationBatchAdminSession
Description	Gets the `OsidSession` associated with the bulk organization administration service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.personnel.batch.OrganizationBatchAdminSession`		an `OrganizationBatchAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsOrganizationBatchAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationBatchAdmin()` is `true.`
Method	getOrganizationBatchAdminSessionForRealm
Description	Gets the `OsidSession` associated with the bulk organization administration service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.personnel.batch.OrganizationBatchAdminSession`		an `OrganizationBatchAdminSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsOrganizationBatchAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsOrganizationBatchAdmin()` and `supportsVisibleFederation()` are `true`
Method	getPositionBatchAdminSession
Description	Gets the `OsidSession` associated with the bulk position administration service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.personnel.batch.PositionBatchAdminSession`		a `PositionBatchAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPositionBatchAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionBatchAdmin()` is `true.`
Method	getPositionBatchAdminSessionForRealm
Description	Gets the `OsidSession` associated with the bulk position administration service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.personnel.batch.PositionBatchAdminSession`		a `PositionBatchAdminSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPositionBatchAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPositionBatchAdmin()` and `supportsVisibleFederation()` are `true`
Method	getAppointmentBatchAdminSession
Description	Gets the `OsidSession` associated with the bulk appointment administration service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.personnel.batch.AppointmentBatchAdminSession`		an `AppointmentBatchAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAppointmentBatchAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentBatchAdmin()` is `true.`
Method	getAppointmentBatchAdminSessionForRealm
Description	Gets the `OsidSession` associated with the bulk appointment administration service for the given realm.
Parameters	`osid.id.Id`	`realmId`	the `Id` of the `Realm`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.personnel.batch.AppointmentBatchAdminSession`		an `AppointmentBatchAdminSession`
Errors	NOT_FOUND		no `Realm` found by the given `Id`
	NULL_ARGUMENT		`realmId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAppointmentBatchAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAppointmentBatchAdmin()` and `supportsVisibleFederation()` are `true`
Method	getRealmBatchAdminSession
Description	Gets the `OsidSession` associated with the bulk realm administration service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.personnel.batch.RealmBatchAdminSession`		a `RealmBatchAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRealmBatchAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRealmBatchAdmin()` is `true.`