Package org.osid.personnel

package org.osid.personnel

The Open Service Interface Definitions for the org.osid.personnel service.

The Personnel OSID defines people and organizations.

Persons

A Person is a people. Persons define identification information such as names and institutional identifiers.

Organization

An Organization is a hierarchical structure of organizational units. Every OsidCatalog has one organization hierarchy

Position

A Position is a job description performed in the context of an Organization . A Position has a job level represented using a Grade, optional salary range, as well as a set of learning Objectives used to convey the desired qualifications for the position.

Positions are not canonical in that they belong to a specific Organization although Positions from parent Organizations may be visible to its sub organizational units. A canonical position that can be reused across Organizations can be represented with a combination of the Positition genus Type and Grade level.

Appointment

An Appointment is an OsidRelationship relating Persons to Positions . The effective dates of an Appointment may be used to indicate the term of employment.

Example

A software company is an Organization with each of a Sales, Marketing, and Engineering organizational unit. The Engineering Organization has 10 "level 6" programming Positions requiring a Proficiency in Java with a salary range of $110-$130K. Cathy holds one of these positions with a full-time Appointment at $125K and job title of "senior developer" busgeted under the Engineering department financial Activity .

Resource OSID Orchestration

OSIDs reference Resources for people, places, and things. The Resource provides a lightweight simple abstraction to satisfy the common case of resolving an OSID Id into a display name, genus Type , or description. In many cases, the Resource implies a Person or an Organization .

The Personnel OSID provides a more detailed view of Persons and Organizations as well as capturing the relationships between employees and their organizational units. The Personnel OSID may supply the backing for a Resource OSID where it is desired to use these entities throughout other services.

Realm Cataloging

Persons, Organizations, Positions , and Appointments are mapped to Realms for organization. Realms can be managed hierarchically to federate multiple collections of Persons .

Every Realm has one organization hierarchy. By selecting the Realm is , in effect, selecting the organizational hierarchy. Each hierarchy may expose multiple organizational roots that do not have to be related. Looking up and searching Organizations exposes all of their organizational units. It may be helpful to retrieve the organizational roots for a Realm and navigating from there.

Copyright © 2012 Ingenescus. All Rights Reserved.

This Work is being provided by the copyright holder(s) subject to the following license. By obtaining, using and/or copying this Work, you agree that you have read, understand, and will comply with the following terms and conditions.

Permission to use, copy and distribute unmodified versions of this Work, for any purpose, without fee or royalty is hereby granted, provided that you include the above copyright notices and the terms of this license on ALL copies of the Work or portions thereof.

You may modify or create Derivatives of this Work only for your internal purposes. You shall not distribute or transfer any such Derivative of this Work to any location or to any third party. For the purposes of this license, "Derivative" shall mean any derivative of the Work as defined in the United States Copyright Act of 1976, such as a translation or modification.

This Work and the information contained herein is provided on an "AS IS" basis WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE WORK OR THE USE OR OTHER DEALINGS IN THE WORK.

The export of software employing encryption technology may require a specific license from the United States Government. It is the responsibility of any person or organization contemplating export to obtain such a license before exporting this Work.

Related Packages

Package	Description
org.osid	The Open Service Interface Definitions for the org.osid service.
org.osid.personnel.batch	The Open Service Interface Definitions for the org.osid.personnel.batch service.
org.osid.personnel.records

Interfaces

Class	Description
Appointment	An Appointment relates a Position to a Position .
AppointmentAdminSession	This session creates, updates, and deletes Appointments .
AppointmentForm	This is the form for creating and updating Appointment objects.
AppointmentList	Like all OsidLists , AppointmentList provides a means for accessing Appointment elements sequentially either one at a time or many at a time.
AppointmentLookupSession	This session defines methods for retrieving appointments.
AppointmentNotificationSession	This session defines methods to receive notifications on adds/changes to Appointment objects.
AppointmentQuery	This is the query for searching appointments.
AppointmentQueryInspector	The query inspectors provide a means of accessing the match terms of a query.
AppointmentQuerySession	This session provides methods for querying Appointment objects.
AppointmentRealmAssignmentSession	This session provides methods to re-assign Appointments to Bilings .
AppointmentRealmSession	This session provides methods to retrieve Appointment to Realm mappings.
AppointmentReceiver	The appointment receiver is the consumer supplied interface for receiving notifications pertaining to new or deleted appointments.
AppointmentSearch	The search interface for governing appointment searches.
AppointmentSearchOrder	An interface for specifying the ordering of search results.
AppointmentSearchResults	This interface provides a means to capture results of a search.
AppointmentSearchSession	This session provides methods for searching Appointment objects.
AppointmentSmartRealmSession	This session manages queries and sequencing to create "smart" dynamic catalogs.
Organization	An Organization .
OrganizationAdminSession	This session creates, updates, and deletes Organizations .
OrganizationForm	This is the form for creating and updating Organization objects.
OrganizationHierarchyDesignSession	This session defines methods for managing a hierarchy of Organization objects.
OrganizationHierarchySession	This session defines methods for traversing a hierarchy of Organization objects.
OrganizationList	Like all OsidLists , OrganizationList provides a means for accessing Organization elements sequentially either one at a time or many at a time.
OrganizationLookupSession	This session defines methods for retrieving organizations.
OrganizationNode	This interface is a container for a partial hierarchy retrieval.
OrganizationNodeList	Like all OsidLists , OrganizationNodeList provides a means for accessing OrganizationNode elements sequentially either one at a time or many at a time.
OrganizationNotificationSession	This session defines methods to receive notifications on adds/changes to Organization objects.
OrganizationQuery	This is the query for searching organizations.
OrganizationQueryInspector	The query inspectors provide a means of accessing the match terms of a query.
OrganizationQuerySession	This session provides methods for querying Organization objects.
OrganizationRealmAssignmentSession	This session provides methods to re-assign Organizations to Bilings .
OrganizationRealmSession	This session provides methods to retrieve Organization to Realm mappings.
OrganizationReceiver	The organization receiver is the consumer supplied interface for receiving notifications pertaining to new or deleted organizations.
OrganizationSearch	The search interface for governing organization searches.
OrganizationSearchOrder	An interface for specifying the ordering of search results.
OrganizationSearchResults	This interface provides a means to capture results of a search.
OrganizationSearchSession	This session provides methods for searching Organization objects.
OrganizationSmartRealmSession	This session manages queries and sequencing to create "smart" dynamic catalogs.
Person	A Person .
PersonAdminSession	This session creates, updates, and deletes Persons .
PersonForm	This is the form for creating and updating Person objects.
PersonList	Like all OsidLists , PersonList provides a means for accessing Person elements sequentially either one at a time or many at a time.
PersonLookupSession	This session defines methods for retrieving persons.
PersonnelManager	The personnel manager provides access to personnel sessions and provides interoperability tests for various aspects of this service.
PersonnelProfile	The personnel profile describes the interoperability among personnel services.
PersonnelProxyManager	The personnel manager provides access to personnel sessions and provides interoperability tests for various aspects of this service.
PersonNotificationSession	This session defines methods to receive notifications on adds/changes to Person objects.
PersonQuery	This is the query for searching persons.
PersonQueryInspector	The query inspectors provide a means of accessing the match terms of a query.
PersonQuerySession	This session provides methods for querying Person objects.
PersonRealmAssignmentSession	This session provides methods to re-assign Persons to Bilings .
PersonRealmSession	This session provides methods to retrieve Person to Realm mappings.
PersonReceiver	The person receiver is the consumer supplied interface for receiving notifications pertaining to new or deleted persons.
PersonSearch	The search interface for governing person searches.
PersonSearchOrder	An interface for specifying the ordering of search results.
PersonSearchResults	This interface provides a means to capture results of a search.
PersonSearchSession	This session provides methods for searching Person objects.
PersonSmartRealmSession	This session manages queries and sequencing to create "smart" dynamic catalogs.
Position	A Position in an Organization .
PositionAdminSession	This session creates, updates, and deletes Positions .
PositionForm	This is the form for creating and updating Position objects.
PositionList	Like all OsidLists , PositionList provides a means for accessing Position elements sequentially either one at a time or many at a time.
PositionLookupSession	This session defines methods for retrieving positions.
PositionNotificationSession	This session defines methods to receive notifications on adds/changes to Position objects.
PositionQuery	This is the query for searching positions.
PositionQueryInspector	The query inspectors provide a means of accessing the match terms of a query.
PositionQuerySession	This session provides methods for querying Position objects.
PositionRealmAssignmentSession	This session provides methods to re-assign Positions to Bilings .
PositionRealmSession	This session provides methods to retrieve Position to Realm mappings.
PositionReceiver	The position receiver is the consumer supplied interface for receiving notifications pertaining to new or deleted positions.
PositionSearch	The search interface for governing position searches.
PositionSearchOrder	An interface for specifying the ordering of search results.
PositionSearchResults	This interface provides a means to capture results of a search.
PositionSearchSession	This session provides methods for searching Position objects.
PositionSmartRealmSession	This session manages queries and sequencing to create "smart" dynamic catalogs.
Realm	A Realm represents a collection of persons.
RealmAdminSession	This session creates, updates, and deletes Realms .
RealmForm	This is the form for creating and updating Realms .Like all OsidForm objects, various data elements may be set here for use in the create and update methods in the RealmAdminSession .
RealmHierarchyDesignSession	This session manages a hierarchy of realms.
RealmHierarchySession	This session defines methods for traversing a hierarchy of Realm objects.
RealmList	Like all OsidLists , RealmList provides a means for accessing Realm elements sequentially either one at a time or many at a time.
RealmLookupSession	This session provides methods for retrieving Realm objects.
RealmNode	This interface is a container for a partial hierarchy retrieval.
RealmNodeList	Like all OsidLists , RealmNodeList provides a means for accessing RealmNode elements sequentially either one at a time or many at a time.
RealmNotificationSession	This session defines methods to receive notifications on adds/changes to Realm objects.
RealmQuery	This is the query for searching for realms.
RealmQueryInspector	The query inspectors provide a means of accessing the match terms of a query.
RealmQuerySession	This session provides methods for querying Realm objects.
RealmReceiver	The realm receiver is the consumer supplied interface for receiving notifications pertaining to new, updated or deleted Realm objects.
RealmSearch	The search interface for governing realm searches.
RealmSearchOrder	An interface for specifying the ordering of search results.
RealmSearchResults	This interface provides a means to capture results of a search.
RealmSearchSession	This session provides methods for searching Realm objects.