OSI-Directory Services Working Group			Chris Weider
INTERNET-DRAFT						Mark Knopper
							Merit Network
							July 1991

	X.500 Schema for a pilot Educator's Directory Service

Status of this Memo

From kindergarden to graduate school, educators are placing more and more
emphasis on computers, computer techniques, and computer networks. As these
concepts become more pervasive, the Internet is being seen as a valuable tool
for students and educators who previously had neither the resources nor the
time to become involved in computers.  To enhance and support the resources
currently available to and for educators on the Internet, Merit and Educom 
would like to implement a directory of educators and resources using the 
X.500 protocol.

This draft document will be submitted to the RFC editor as a protocol
specification.  Distribution of this memo is unlimited. Please send comments
to the authors or to the discussion group osi-ds@cs.ucl.ac.uk.


INTERNET-DRAFT  	X.500 Schema for Educator Directory  July 1991

SECTION 1: PRELIMINARIES

1.1 Introduction

As computers and computer concepts become more pervasive in the K-12 arena,
educators and students alike are using the Internet to communicate with each
other and to tap into online computerized resources, expanding their range
of educational possibilities and teaching computer literacy. A directory of
educators with Internet access and a directory of resources available on
the Internet would therefore enhance the usefulness of the Internet to 
educators.

Educom has been informally keeping a paper directory of educators, areas of
interest, and resources for some time now, and they have provided the 
motivation and definitions for the schema in this paper.

1.2 Information to be incorporated

The information to be incorporated breaks down into 5 groups; 1 group contains
person-related information, and the rest contain resource-related information.
As a reflection of a new philosophy of object class definition, the new
object class for the additional person information will be an 'auxiliary'
class.


1.2.1 A new auxiliary person object.

A new object class, educatorAuxiliaryPerson, will be created. A typical 
educator's EDB entry will therefore have as superclasses both 'pilotPerson'
and 'educatorAuxiliaryPerson'. The educatorAuxiliaryPerson object class will
contain the following new attributes:

  areaOfInterest: one of a list of keywords (yet to be determined) which
    describe in a 'standardized' way the areas in which the person works or 
    would like to exchange information on.

  gradeLevel: one of: 1) the grade the person teaches or 2) the grade level(s)
    the person is interested in.

  dateOfCreation: a UTC string which contains the date the entry was created.
    Note that this is different from the lastModifiedDate attribute.

  personalComments: a long string in which the person can place a bit of 
   information about themselves.

  department: an attribute which tells which department the educator is in.
  

1.2.2  New resource objects

There are 4 new types of resources object, which have names which do not 
reflect the 'educator' structure as they are intended to have a wide range
of applicability.

1) the listResource object class. This object class is intended to hold 
information about the various lists which are available, for example,
if someone maintained online a list of support organizations for educators, 
there would be a directory entry for it. This will be a subclass of the 
pilotObject class and will contain the following new attributes:


INTERNET-DRAFT          X.500 Schema for Educator Directory  July 1991

  numberOfEntries: a string containing an (approximate) number of entries.

  listOf: a string describing the type of entries (i.e. what this is a list of)

  howToGetList: a string telling how to get the list.

  onlineAvailability: a string containing 'yes' or 'no.

There are additional attributes which are described in detail in Weid[91], see
the object class definition for a complete listing.


2) the newsGroup object class. This will contain directory information
about any news groups that wish to be listed; for example, a news group 
which focuses on Space Science. This will also be a subclass of the 
pilotObject class and will contain the following new attributes:

  numberOfMembers: a string containing the number of members.

  affiliatedOrganization: a string containing the name of the affiliated
    organization (if any).

  associatedMailingList: a string containing the e-mail address of the
    associated mailing list (if any).

There are additional attributes, which are described in Weid[91] and in the 
classes above.  See the object class definition for a complete listing.

3) the educationalNetwork object class. This will contain information about
the educational networks available (e.g. FIDONet). This will be a subclass
of the pilotObject class and will contain the following new attributes:

  geographicalRegion: a string which contains the geographical region which
    the network covers.

There are additional attributes, which are described in Weid[91] and in the
classes above. See the object class definition for a complete listing.

4) educatorServiceProvider. This will be a subclass of the Organization object
class and will contain the servicesOffered and publicationsOffered attributes
from Weid[91]. It will contain directory type information about organizations
which provide services for educators (e.g. educational publishers, union 
organizations, etc).



SECTION 2: SCHEMA DESIGN

2.1 ASN.1 definitions for the new attributes.

__ 	__	__	__	__	__	__	__	__	__

areaOfInterest ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-area))

ub-area INTEGER ::= 256

INTERNET-DRAFT          X.500 Schema for Educator Directory  July 1991


gradeLevel ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-grade))

ub-grade INTEGER ::= 64

dateOfCreation ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	UTCTime
	(SIZE (1 .. ub-dateoc))

ub-dateoc INTEGER ::= 128

personalComments ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-openarea))

ub-openarea INTEGER ::= 1024

numberOfEntries ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-noe))

ub-noe INTEGER ::= 128

listOf ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-listof))

ub-listof INTEGER ::= 512

howToGetList ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-howtoget))

ub-howtoget INTEGER ::= 2048

onlineAvailability ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-online))

ub-online INTEGER ::= 16

numberOfMembers ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-numberofmems))

ub-numberofmems INTEGER ::= 64

affiliatedOrganization ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-affiliate))


INTERNET-DRAFT          X.500 Schema for Educator Directory  July 1991

ub-affiliate INTEGER ::= 256

associatedMailingList ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-assocmaillist))

ub-assocmaillist INTEGER ::= 256

geographicalRegion ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-georegion))

ub-georegion INTEGER ::= 256

department ATTRIBUTE
	WITH ATTRIBUTE SYNTAX
	caseIgnoreStringSyntax
	(SIZE (1 .. ub-department))

ub-department INTEGER ::= 256
__	__	__	__	__	__	__	__	__	__
 	ASN.1 description of new attributes

2.2 New object classes

Here follows the ASN.1 definitions of the new object classes:

__	__	__	__	__	__	__	__	__	__

educatorAuxiliaryPerson OBJECT-CLASS
	SUBCLASS OF top 
	MUST CONTAIN { dateOfCreation }
	MAY CONTAIN { areaOfInterest, gradeLevel, personalComments, 
		department }

listResource OBJECT-CLASS
	SUBCLASS OF pilotObject
	MUST CONTAIN { commonName, listOf }
	MAY CONTAIN { numberOfEntries, howToGetList, onlineAvailability,
		producerOfResource, distributorOfResource, contactName,
		telephoneNumber, postalAddress }

newsGroup OBJECT-CLASS
	SUBCLASS OF pilotObject
	MUST CONTAIN { commonName }
	MAY CONTAIN { numberOfMembers, affiliatedOrganization, contactName,
		associatedMailingList, postalAddress, telephoneNumber,
		servicesOffered, publicationsOffered }

educationalNetwork OBJECT-CLASS
	SUBCLASS OF pilotObject
	MUST CONTAIN { commonName }
	MAY CONTAIN { geographicalRegion, logonOrSubscriptionInstructions,
		logoffOfUnsubscribeInstructions, contactName, telephoneNumber,
		postalAddress, costOfUse, servicesOffered, publicationsOffered}

INTERNET-DRAFT          X.500 Schema for Educator Directory  July 1991

serviceProvider OBJECT-CLASS
	SUBCLASS OF organization
	MUST CONTAIN { }
	MAY CONTAIN { servicesOffered, publicationsOffered }

	ASN.1 definitions for the new object classes.
__	__	__	__	__	__	__	__	__	__

SECTION 3: WHO WE ARE

3.1 Author's addresses

	Chris Weider, clw@merit.edu
	Mark Knopper, mak@merit.edu
	Merit Network, Inc.
	1075 Beal Avenue
	Ann Arbor, MI 48109

SECTION 4: REFERENCE(S)

Weid[91]  Weider, C. and Knopper, M. INTERNET-DRAFT Schema for Information
		Resource Description in X.500; in Internet Draft archive
		nnsc.nsf.net as draft-osids-resdescripx500.