001: /**********************************************************************************
002: * $URL: https://source.sakaiproject.org/svn/profile/tags/sakai_2-4-1/edu-person-api/src/java/org/sakaiproject/api/common/edu/person/EduPerson.java $
003: * $Id: EduPerson.java 8424 2006-04-27 20:23:44Z ggolden@umich.edu $
004: ***********************************************************************************
005: *
006: * Copyright (c) 2003, 2004, 2005, 2006 The Sakai Foundation.
007: *
008: * Licensed under the Educational Community License, Version 1.0 (the "License");
009: * you may not use this file except in compliance with the License.
010: * You may obtain a copy of the License at
011: *
012: * http://www.opensource.org/licenses/ecl1.php
013: *
014: * Unless required by applicable law or agreed to in writing, software
015: * distributed under the License is distributed on an "AS IS" BASIS,
016: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
017: * See the License for the specific language governing permissions and
018: * limitations under the License.
019: *
020: **********************************************************************************/package org.sakaiproject.api.common.edu.person;
021:
022: /**
023: * See Internet2 EduPerson specification.
024: * <p>
025: * EduPerson is an auxiliary object class for campus directories designed to facilitate communication among higher education institutions. It consists of a set of data elements or attributes about individuals within higher education, along with
026: * recommendations on the syntax and semantics of the data that may be assigned to those attributes.
027: * </p>
028: *
029: * @author <a href="mailto:lance@indiana.edu">Lance Speelmon </a>
030: */
031: public interface EduPerson extends InetOrgPerson {
032: /**
033: * Specifies the person's relationship(s) to the institution in broad categories such as student, faculty, staff, alum, etc. (See controlled vocabulary). Permissible values (if controlled) faculty, student, staff, alum, member, affiliate, employee.
034: *
035: * @return
036: */
037: public String getAffiliation();
038:
039: /**
040: * Specifies the person's relationship(s) to the institution in broad categories such as student, faculty, staff, alum, etc. (See controlled vocabulary). Permissible values (if controlled) faculty, student, staff, alum, member, affiliate, employee.
041: *
042: * @return
043: */
044: public void setAffiliation(String affiliation);
045:
046: /**
047: * URI (either URN or URL) that indicates a set of rights to specific resources.
048: *
049: * @return
050: */
051: public String getEntitlement();
052:
053: /**
054: * URI (either URN or URL) that indicates a set of rights to specific resources.
055: */
056: public void setEntitlement(String entitlement);
057:
058: /**
059: * Person's nickname, or the informal name by which they are accustomed to be hailed.
060: *
061: * @return
062: */
063: public String getNickname();
064:
065: /**
066: * Person's nickname, or the informal name by which they are accustomed to be hailed.
067: */
068: public void setNickname(String nickname);
069:
070: /**
071: * The distinguished name (DN) of the of the directory entry representing the institution with which the person is associated.
072: *
073: * @return
074: */
075: public String getOrgDn();
076:
077: /**
078: * The distinguished name (DN) of the of the directory entry representing the institution with which the person is associated.
079: */
080: public void setOrgDn(String orgDn);
081:
082: /**
083: * The distinguished name(s) (DN) of the directory entries representing the person's Organizational Unit(s). May be multivalued, as for example, in the case of a faculty member with appointments in multiple departments or a person who is a student in
084: * one department and an employee in another.
085: *
086: * @return
087: */
088: public String getOrgUnitDn();
089:
090: /**
091: * The distinguished name(s) (DN) of the directory entries representing the person's Organizational Unit(s). May be multivalued, as for example, in the case of a faculty member with appointments in multiple departments or a person who is a student in
092: * one department and an employee in another.
093: *
094: * @return
095: */
096: public void setOrgUnitDn(String orgUnitDn);
097:
098: /**
099: * Specifies the person's PRIMARY relationship to the institution in broad categories such as student, faculty, staff, alum, etc. (See controlled vocabulary). Permissible values (if controlled) faculty, student, staff, alum, member, affiliate,
100: * employee.
101: *
102: * @return
103: */
104: public String getPrimaryAffiliation();
105:
106: /**
107: * Specifies the person's PRIMARY relationship to the institution in broad categories such as student, faculty, staff, alum, etc. (See controlled vocabulary). Permissible values (if controlled) faculty, student, staff, alum, member, affiliate,
108: * employee.
109: *
110: * @return
111: */
112: public void setPrimaryAffiliation(String primaryAffiliation);
113:
114: /**
115: * The distinguished name (DN) of the directory entry representing the person's primary Organizational Unit(s).
116: *
117: * @return
118: */
119: public String getPrimaryOrgUnitDn();
120:
121: /**
122: * The distinguished name (DN) of the directory entry representing the person's primary Organizational Unit(s).
123: */
124: public void setPrimaryOrgUnitDn(String primaryOrgUnitDn);
125:
126: /**
127: * The "NetID" of the person for the purposes of inter-institutional authentication. Should be stored in the form of user_at_univ.edu, where univ.edu is the name of the local security domain.
128: *
129: * @return
130: */
131: public String getPrincipalName();
132:
133: /**
134: * The "NetID" of the person for the purposes of inter-institutional authentication. Should be stored in the form of user_at_univ.edu, where univ.edu is the name of the local security domain.
135: *
136: * @return
137: */
138: public void setPrincipalName(String principalName);
139: }
|