Extensions to Directory Server Schema
This appendix presents the calendar server's extensions to the LDAP directory server schema. Consult your directory server documentation for information on your directory server schema and how to extend it.
Object class extensions
There are three object class extensions to the directory server schema. Each directory server entry should contain an instance of only one of these object classes. Each class is mutually exclusive with each of the other classes.
Table E.1 · Calendar server object classes
|
| ctCalUser
|
The object class for calendar server users. Note that a calendar server user entry is usually added to an existing user entry in the directory server.
|
| ctCalAdmin
|
The object class for calendar server reserved users.
|
| ctCalResource
|
The object class for calendar server resources.
|
Calendar server object classes
The following tables present the ctCalUser, ctCalAdmin, and ctCalResource object classes respectively.
Each calendar server object class is composed of attributes specific to that class, and attributes inherited from superior classes. All attributes specific to a calendar server object class have the prefix "ctCal" and are of type "case ignore string". See Attribute definitions for descriptions of each of the attributes.
Table E.2 · ctCalUser object class
| Requires |
|
|
objectClass
|
|
| Allows |
|
|
c
|
|
|
ctCalAccess
|
|
|
ctCalAccessDomain
|
|
|
ctCalAdmd
|
|
|
ctCalCountry
|
|
|
ctCalDefaultNoteReminder
|
|
|
ctCalDefaultReminder
|
|
|
ctCalDefaultTaskReminder
|
|
|
ctCalDisplayPrefs
|
|
|
ctCalFlags
|
|
|
ctCalHost
|
|
|
ctCalLanguageId
|
|
|
ctCalMobileTelephoneType
|
|
|
ctCalNodeAlias
|
|
|
ctCalNotifMechanism
|
|
|
ctCalOperatingPrefs
|
|
|
ctCalOrganization
|
|
|
ctCalOrgUnit1
|
|
|
ctCalOrgUnit2
|
|
|
ctCalOrgUnit3
|
|
|
ctCalOrgUnit4
|
|
|
ctCalPasswordRequired
|
|
|
ctCalPreferredSMSCTelephoneNumber
|
|
|
ctCalPrmd
|
|
|
ctCalPublishedType
|
|
|
ctCalRefreshPrefs
|
|
|
ctCalServerVersion
|
|
|
ctCalSMSTimeRange
|
|
|
ctCalSysopCanWritePassword
|
|
|
ctCalTimezone
|
|
|
ctCalXItemId
|
|
|
employeeNumber
|
|
|
generationQualifier
|
|
|
givenName
|
|
|
initials
|
|
|
mail
|
|
|
title
|
|
|
uid
|
|
Table E.3 · ctCalAdmin object class
| Requires |
|
|
objectClass
|
|
|
ctCalXItemId
|
|
| Allows |
|
|
c
|
|
|
cn
|
|
|
ctCalAccess
|
|
|
ctCalAccessDomain
|
|
|
ctCalAdmd
|
|
|
ctCalCountry
|
|
|
ctCalFlags
|
|
|
ctCalHost
|
|
|
ctCalLanguageId
|
|
|
ctCalNodeAlias
|
|
|
ctCalOrganization
|
|
|
ctCalOrgUnit1
|
|
|
ctCalOrgUnit2
|
|
|
ctCalOrgUnit3
|
|
|
ctCalOrgUnit4
|
|
|
ctCalPasswordRequired
|
|
|
ctCalPrmd
|
|
|
ctCalServerVersion
|
|
|
ctCalSysopCanWritePassword
|
|
|
ctCalXItemId
|
|
|
facsimileTelephoneNumber
|
|
|
generationQualifier
|
|
|
givenName
|
|
|
initials
|
|
|
mail
|
|
|
o
|
|
|
ou
|
|
|
postalAddress
|
|
|
sn
|
|
|
telephoneNumber
|
|
|
userPassword
|
|
Table E.4 · ctCalResource object class
| Requires |
|
|
objectClass
|
|
|
cn
|
|
| Allows |
|
|
ctCalAccess
|
|
|
ctCalAccessDomain
|
|
|
ctCalDefaultNoteReminder
|
|
|
ctCalDefaultReminder
|
|
|
ctCalDefaultTaskReminder
|
|
|
ctCalDisplayPrefs
|
|
|
ctCalFlags
|
|
|
ctCalHost
|
|
|
ctCalLanguageId
|
|
|
ctCalNodeAlias
|
|
|
ctCalNotifMechanism
|
|
|
ctCalOperatingPrefs
|
|
|
ctCalPasswordRequired
|
|
|
ctCalRefreshPrefs
|
|
|
ctCalResourceCapacity
|
|
|
ctCalResourceNumber
|
|
|
ctCalServerVersion
|
|
|
ctCalSysopCanWritePassword
|
|
|
ctCalTimezone
|
|
|
ctCalXItemId
|
|
|
facsimileTelephoneNumber
|
|
|
givenName
|
|
|
mail
|
|
|
postalAddress
|
|
|
sn
|
|
|
telephoneNumber
|
|
|
userPassword
|
|
Attribute definitions
The following two tables provide a description of all attributes associated with the calendar server object classes. The first describes attributes specific to the calendar server object classes, and the second describes attributes inherited from superior classes. Note that in the case of inherited attributes, the attribute name may vary with the directory server.
Table E.5 · ctCal* attribute definitions
|
| ctCalAccess
|
Allow/deny access of calendar server user.
|
| ctCalAccessDomain
|
Internet domain or IP from which the calendar server user is allowed to access their calendar server data. For future use.
|
| ctCalAdmd
|
X.400 Administration Management Domain Name (A).
|
| ctCalCountry
|
Country. Not currently in use.
|
| ctCalDefaultNoteReminder
|
Type: Visual, audible, mail, all or none.
Len: Number of minutes before the event for reminder.
|
| ctCalDefaultReminder
|
Type: Visual, audible, mail, all or none.
Len: Number of minutes before the event for reminder.
|
| ctCalDefaultTaskReminder
|
Type: Visual, audible, mail, all or none.
Len: Number of minutes before the event for reminder.
|
| ctCalDisplayPrefs
|
Display preferences.
StartDay: Time in minutes to start day display. EndDay: Time in minutes to end day display. WeekStart: Specifies the first day of the week (i.e. usually Sunday or Monday). TimeIncrement: Time increment in minutes for display. ActiveDays: Specifies days to display (e.g. week days only). TimeFormat: Specifies time format (AM/PM or 24h) for display.
|
| ctCalFlags
|
For future use.
|
| ctCalHost
|
Host name, or IP address in dotted notation, of the computer hosting the calendar server user's data.
|
| ctCalLanguageId
|
Preferred language for incoming mail notification. For future use.
|
| ctCalNodeAlias
|
Mnemonic name of the node on which the calendar server user's data is stored.
|
| ctCalNotifMechanism
|
Specifies mechanism used to notify attendees (usually mail).
|
| ctCalOperatingPrefs
|
Operating preferences.
|
| ctCalOrganization
|
User's organization. Not currently in use; "o" attribute is used for this information.
|
| ctCalOrgUnit1
|
X.400 Organizational Unit 1(OU1).
User's organization. Not currently in use; "ou" attribute is used for this information.
|
| ctCalOrgUnit2
|
X.400 Organizational Unit 2 (OU2).
|
| ctCalOrgUnit3
|
X.400 Organizational Unit 3 (OU3).
|
| ctCalOrgUnit4
|
X.400 Organizational Unit 4 (OU4).
|
| ctCalPasswordRequired
|
Specifies if the user must provide a password to have access to his calendar data.
|
| ctCalPrmd
|
X.400 Private Management Domain Name (P).
|
| ctCalPublishedType
|
Calendar type: Not Published, Published, Event Calendar
|
| ctCalRefreshPrefs
|
Refresh preferences; State: on / off Frequency: Interval in minutes between refreshes.
|
| ctCalResourceCapacity
|
Capacity of resource.
|
| ctCalResourceNumber
|
Identification number of resource.
|
| ctCalServerVersion
|
Version number of the calendar server hosting the user's data.
|
| ctCalSMSTimeRange
|
Time range during which the user does not want to receive SMS messages. Values are expressed in minutes of the day, separated by a colon, e.g. 9 PM to 9 AM is expressed as "1260:540".
|
| ctCalSysopCanWritePassword
|
Specifies if the calendar server SYSOP can overwrite the user's password.
|
| ctCalTimezone
|
Current time zone of the user.
|
| ctCalXItemId
|
Identification number of the node on which the calendar server user's data is stored as well as the identification number of the calendar server user's item.
|
| ctCalMobileTelephoneType
|
Mobile telephone type.
|
| ctCalPreferredSMSCTelephoneNumber
|
Preferred SMSC telephone number.
|
Table E.6 · Inherited attribute definitions
| Attribute name |
Class |
Description |
| c
|
n/a
|
Country.
|
| cn
|
person
|
Common name of the administrator or resource.
|
| employeeNumber
|
inetOrgPerson
|
Employee number of the user.
|
| facsimileTelephoneNumber
or fax
|
organizationalPerson
|
FAX phone number of the administrator or resource.
|
| generationQualifier or gq
|
n/a
|
Generation qualifier.
|
| givenName or gn
|
inetOrgPerson
|
Given name of the user. In the case of a resource, this is the given name of the contact.
|
| initials
|
inetOrgPerson
|
User's initials.
|
| mail or rfc822MailBox
|
inetOrgPerson
|
Email address.
|
| mobile
|
inetOrgPerson
|
Mobile telephone number.
|
| o
|
n/a
|
Organization of the user.
|
| ou
|
organizationalPerson
|
Organizational unit of the user.
|
| postalAddress
|
organizationalPerson
|
Mailing address of the administrator or resource.
|
| sn or surname
|
person
|
Surname of the administrator or resource.
|
| telephoneNumber
|
person
|
Telephone number of the administrator or resource.
|
| title
|
organizationalPerson
|
Job title of the user.
|
| uid
|
inetOrgPerson
|
User identification number.
|
| userPassword
|
person
|
Password with which the administrator or resource binds to the directory server.
|
Default mappings for attribute names
Different directory servers may use different schemata and the same attribute may have different names in different schemata. You may need to change the default names your calendar server uses for certain attributes to ensure these map properly into your directory server schema.
You change these attribute names through configuration parameters contained in the /users/unison/misc/unison.ini file. These parameters are listed here, along with their default values.
Table E.7 · Configuration parameters for LDAP attribute names
| Configuration parameter |
Default value
|
| attr_accessdomain
|
"ctCalAccessDomain"
|
| attr_access
|
"ctCalAccess"
|
| attr_address
|
"postalAddress"
|
| attr_admindomain
|
"ctCalAdmd"
|
| attr_capacity
|
"ctCalResourceCapacity"
|
| attr_commonname
|
"cn"
|
| attr_country
|
" "
|
| attr_defaultnotereminder
|
"ctCalDefaultNoteReminder"
|
| attr_defaultreminder
|
"ctCalDefaultReminder"
|
| attr_defaulttaskreminder
|
"ctCalDefaultTaskReminder"
|
| attr_displayprefs
|
"ctCalDisplayPrefs"
|
| attr_employeeid
|
"employeeNumber"
|
| attr_fax
|
"facsimileTelephoneNumber"
|
| attr_flags
|
"ctCalFlags"
|
| attr_generation
|
"generationQualifier"
|
| attr_givenname
|
"givenName"
|
| attr_groupname
|
"cn"
|
| attr_ host
|
"ctCalHost"
|
| attr_initials
|
"initials"
|
| attr_jobtitle
|
"title"
|
| attr_langid
|
"ctCalLanguageId"
|
| attr_mail
|
"mail"
|
| attr_member
|
"member"
|
| attr_mobile
|
"mobile"
|
| attr_mobiletype
|
"ctCalMobileTelephoneType"
|
| attr_nodealias
|
"ctCalNodeAlias"
|
| attr_notifmechanism
|
"ctCalNotifMechanism"
|
| attr_objclass
|
"objectClass"
|
| attr_operatingprefs
|
"ctCalOperatingPrefs"
|
| attr_organization
|
""
|
| attr_orgunit1
|
"ou"
|
| attr_orgunit2
|
"ctCalOrgUnit2"
|
| attr_orgunit3
|
"ctCalOrgUnit3"
|
| attr_orgunit4
|
"ctCalOrgUnit4"
|
| attr_passwordrequired
|
"ctCalPasswordRequired"
|
| attr_password
|
"userPassword"
|
| attr_phone
|
"telephoneNumber"
|
| attr_privmdomain
|
"ctCalPrmd"
|
| attr_publishedtype
|
"ctCalPublishedType"
|
| attr_refreshprefs
|
"ctCalRefreshPrefs"
|
| attr_resourcename
|
"cn"
|
| attr_resourcenumber
|
"ctCalResourceNumber"
|
| attr_serverversion
|
"ctCalServerVersion"
|
| attr_smscpref
|
"ctCalPreferredSMSCTelephoneNumber"
|
| attr_surname
|
"sn"
|
| attr_sysopcanwritepassword
|
"ctCalSysopCanWritePassword"
|
| attr_timezone
|
"ctCalTimezone"
|
| attr_uid
|
"uid"
|
| attr_uniquemember
|
"uniquemember"
|
| attr_version
|
" "
|
| attr_xitemid
|
"ctCalXItemId"
|
