One document matched: draft-cal-resource-schema-05.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE rfc PUBLIC '' 'http://xml.resource.org/public/rfc/rfc2629.dtd' [
<!ENTITY RFC2119 PUBLIC '' 'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml'>
<!ENTITY RFC2739 PUBLIC '' 'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2739.xml'>
<!ENTITY RFC3339 PUBLIC '' 'http://xml.resource.org/public/rfc/bibxml/reference.RFC.3339.xml'>
<!ENTITY RFC4519 PUBLIC '' 'http://xml.resource.org/public/rfc/bibxml/reference.RFC.4519.xml'>
<!ENTITY RFC4524 PUBLIC '' 'http://xml.resource.org/public/rfc/bibxml/reference.RFC.4524.xml'>
<!ENTITY cardrev PUBLIC '' 'http://xml.resource.org/public/rfc/bibxml3/reference.I-D.ietf-vcarddav-vcardrev.xml'>
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt"?>
<?rfc rfcedstyle="yes" ?>
<?rfc toc="yes"?>
<?rfc tocdepth="6"?><!-- default = 3 -->
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>
<!-- <?rfc strict="yes"?> -->
<!-- <?rfc comments="yes"?> -->
<!-- <?rfc inline="yes"?> -->
<rfc category="std" ipr='trust200902' docName='draft-cal-resource-schema-05' xmlns:x='http://purl.org/net/xml2rfc/ext'>
<front>
<title abbrev="Schema for Resources">Schema for representing resources for calendaring and scheduling services</title>
<author initials="C." surname="Joy" fullname="Ciny Joy">
<organization abbrev="Oracle">Oracle Corporation</organization>
<address>
<postal>
<street>
4210 Network Circle
</street>
<city>
Santa Clara
</city>
<region>
CA
</region>
<code> 95054 </code>
<country>
USA
</country>
</postal>
<email>
ciny.joy@oracle.com
</email>
<uri>
http://www.oracle.com/
</uri>
</address>
</author>
<author initials="C." surname="Daboo" fullname="Cyrus Daboo">
<organization abbrev="Apple Inc.">
Apple Inc.
</organization>
<address>
<postal>
<street>
1 Infinite Loop
</street>
<city>
Cupertino
</city>
<region>
CA
</region>
<code> 95014 </code>
<country>
USA
</country>
</postal>
<email>
cyrus@daboo.name
</email>
<uri>
http://www.apple.com/
</uri>
</address>
</author>
<author initials="M." surname="Douglass" fullname="Michael Douglass">
<organization abbrev="RPI">Rensselaer Polytechnic Institute</organization>
<address>
<postal>
<street>110 8th Street</street>
<city>Troy</city>
<region>NY</region>
<code>12180</code>
<country>USA</country>
</postal>
<email>douglm@rpi.edu</email>
<uri>http://www.rpi.edu/</uri>
</address>
</author>
<date month='August' year='2011' />
<area>
Applications
</area>
<abstract>
<t>
This specification describes a schema for representing resources for calendaring and scheduling.
A resource in the scheduling context is any shared entity that can be scheduled by a calendar user, but does not control its own attendance status.
</t>
</abstract>
</front>
<middle>
<section title='Introduction'>
<t>
This specification defines a schema for representing resources to ease the discovery and scheduling of resources between any calendar client and server. <vspace />
LDAP and vCard mappings of the schema are described in this document. The Object model chosen is the lowest common denominator to adapt for LDAP.
</t>
</section>
<section title='Conventions Used in This Document'>
<t>
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in <xref target="RFC2119" />.
</t>
</section>
<section title='General Considerations'>
<t>
Data values must have valid representation for the chosen format with respect to escape characters, line folding, and so on.
</t>
</section>
<section title='Resource Object'>
<t>
A resource object definition should contain all information required to find and schedule the right resource.
For this, it should contain all, or a set of the attributes described in <xref target="res_attrs" />.
The cn attribute, described in <xref target="cn" /> MUST be present in any resource object.
Additional proprietary attributes may be defined as well, but must begin with "X-". Clients encountering attributes they don't know about must ignore them.
</t>
<t>
Attributes or Properties required to contact the resource are not included in this specification.
LDAP attributes defined in <xref target='RFC4519' /> and VCARD properties defined in <xref target="I-D.ietf-vcarddav-vcardrev">vCard Format Specification</xref> can be used to include contact information for the resource.
</t>
<section title='LDAP Resource ObjectClass Definition' anchor="resobj_ldap">
<t>
In LDAP, a resource object SHOULD be defined as an objectclass with attributes
as defined in <xref target="res_attrs" />.
This objectClass MUST be an auxiliary class. Its Superior class is the
calEntry objectClass as defined in Section 2.4.3.1 of <xref target='RFC2739' />.
<vspace />
Definition of the CalendarResource ObjectClass:
<artwork><![CDATA[
( 1.3.6.1.1.x.1.1
NAME 'CalendarResource'
DESC 'Calendar Resource Object Class'
SUP calEntry
AUXILIARY
MUST (cn)
MAY (kind $ nickname $ description $ ou $ categories $
member $ uniquemember $ accessibilityurl $ capacity $
owner $ resourcemanager $ timezoneid $
multiplebookings $ maxinstances $
bookingwindowstart $ bookingwindowend $
vcarduid $ related) )
]]></artwork>
</t>
</section>
</section>
<section title='Resource Attributes' anchor="res_attrs">
<section title='Common Name' anchor="cn">
<list style="hanging">
<t hangText="Description:"> <vspace />
Full name of the resource. This attribute MUST be defined for a resource object.
</t>
<t hangText="ValueType:"> <vspace />
String value.
</t>
<t hangText="Example value:"> <vspace />
Room One
</t>
</list>
<section title="LDAP Attribute Definition" anchor="cn_ldap">
<t>
cn attribute as defined in Section 2.3 of <xref target='RFC4519' />. This attribute MUST be present in a CalendarResource object.
</t>
</section>
<section title="VCard Property Definition" anchor="cn_vcard">
<t>
FN property as defined in Section 6.2.1 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Kind' anchor="res_kind">
<list style="hanging">
<t hangText="Description:"> <vspace />
The kind of object represented.
</t>
<t hangText="ValueType:"> <vspace />
Some of the possible values are "Location", "Individual", "CalendarResource", or "Group". <vspace />
Location is used for any physical location resource such as room, building, etc. <vspace />
Individual is used for for a human resource such as driver, technician, etc. <vspace />
CalendarResource is used for any physical object that can scheduled like projector, printer, etc. <vspace />
Group is used to specify a group of resources with a specific skill set. For example: drivers, electricians, etc.
</t>
<t hangText="Example value:"> <vspace />
Location
</t>
</list>
<section title="LDAP Definition" anchor="reskindobj_ldap">
<t>
In LDAP, this information can be represented by including the right category objectlass. <vspace />
Possible objectclasses are: <vspace />
Person objectclass as defined in Section 3.12 of <xref target='RFC4519' />. <vspace />
groupOfNames objectclass as defined in Section 3.5 of <xref target='RFC4519' />. <vspace />
groupOfUniqueNames objectclass as defined in Section 3.6 of <xref target='RFC4519' />. <vspace />
device objectclass as defined in Section 3.4 of <xref target='RFC4519' />. <vspace />
room objectclass as defined in Section 3.8 of <xref target='RFC4524' />. <vspace />
In the absence of an objectclass that accurately describes the type of the object, the KIND attribute defined below MUST be used.
</t>
<section title="LDAP Attribute Definition" anchor="reskind_ldap">
<t>Definition of the kind LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.1
NAME 'Kind'
DESC 'Kind of Object'
EQUALITY caseIgnoreMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.15
SINGLE-VALUE )
]]></artwork>
</t>
</section>
</section>
<section title="VCard Property Definition" anchor="reskind_vcard">
<t>
Property KIND that specifies the kind of object represented, as defined in Section 6.1.4 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
A new value of "calendarresource" will be used to represent any physical object or device.
</t>
</section>
<section title="Mapping of KIND value between LDAP and VCard representations" anchor="kind_map">
<texttable>
<preamble>KIND Value Mapping Table:</preamble>
<ttcol align='left'>LDAP Objectclass</ttcol>
<ttcol align='left'>VCard Value</ttcol>
<c>person</c>
<c>individual</c>
<c>groupOfNames or groupOfUniqueNames</c>
<c>group</c>
<c>device</c>
<c>calendarresource</c>
<c>room</c>
<c>location</c>
</texttable>
</section>
</section>
<section title='Unique ID' anchor="unique_id">
<list style="hanging">
<t hangText="Description:"> <vspace />
A Unique Identifier.
</t>
<t hangText="ValueType:"> <vspace />
Single string value.
</t>
<t hangText="Example value:"> <vspace />
room1-id1
</t>
</list>
<section title="LDAP Attribute Definition" anchor="uid_ldap">
<t>
Definition of the vcarduid LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.1
NAME 'VcardUid'
DESC 'VCard UniqueID'
EQUALITY caseExactMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.15
SINGLE-VALUE )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="uid_vcard">
<t>
UID property as defined in Section 6.7.6 of <xref target="I-D.ietf-vcarddav-vcardrev" />.
</t>
</section>
</section>
<section title='Nick Name' anchor="nickname">
<list style="hanging">
<t hangText="Description:"> <vspace />
A short or popular name for the resource.
</t>
<t hangText="ValueType:"> <vspace />
String value.
</t>
<t hangText="Example value:"> <vspace />
TheOne
</t>
</list>
<section title="LDAP Attribute Definition" anchor="nick_ldap">
<t>
Definition of the nickname LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.2
NAME 'NickName'
DESC 'Nick Name'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="nick_vcard">
<t>
NICKNAME property as defined in Section 6.2.3 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Description' anchor="desc">
<list style="hanging">
<t hangText="Description:"> <vspace />
Description of the resource.
</t>
<t hangText="ValueType:"> <vspace />
String value.
</t>
<t hangText="Example value:"> <vspace />
Room 1 in Building X
</t>
</list>
<section title="LDAP Attribute Definition" anchor="desc_ldap">
<t>
description attribute as defined in Section 2.5 of <xref target='RFC4519' />.
</t>
</section>
<section title="VCard Property Definition" anchor="desc_vcard">
<t>
NOTE property as defined in Section 6.7.2 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Organizational Unit' anchor="ou">
<list style="hanging">
<t hangText="Description:"> <vspace />
Organizations the resource belongs to.
</t>
<t hangText="ValueType:"> <vspace />
String value.
</t>
<t hangText="Example value:"> <vspace />
EngineeringDepartment
</t>
</list>
<section title="LDAP Attribute Definition" anchor="ou_ldap">
<t>
ou attribute as defined in Section 2.20 of <xref target='RFC4519' />.
</t>
</section>
<section title="VCard Property Definition" anchor="ou_vcard">
<t>
ORG property as defined in Section 6.6.4 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Categories' anchor="categories">
<list style="hanging">
<t hangText="Description:"> <vspace />
Categories the resource falls under or tags for easy discovery of the resource.
</t>
<t hangText="ValueType:"> <vspace />
String value.
Multi-valued attribute with one attribute per text value in LDAP.
One or more text values separated by a COMMA character in VCard property value.
</t>
<t hangText="Example value:"> <vspace />
Rooms
</t>
</list>
<section title="LDAP Attribute Definition" anchor="cat_ldap">
<t>
Definition of the categories LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.3
NAME 'Categories'
DESC 'Categories'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="cat_vcard">
<t>
CATEGORIES property as defined in Section 6.7.1 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Group Member' anchor="grpmem">
<list style="hanging">
<t hangText="Description:"> <vspace />
List of unique resources in a group of resources object.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/printer1.html <vspace />
http://www.example.com/printer2.html
</t>
</list>
<section title="LDAP Attribute Definition" anchor="mem_ldap">
<t>
member attribute as defined in Section 2.17 or uniquemember attribute
as defined in Section 2.40 of <xref target='RFC4519' />.
</t>
</section>
<section title="VCard Property Definition" anchor="mem_vcard">
<t>
MEMBER property as defined in Section 6.6.5 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Admittance Info' anchor="adm_info">
<list style="hanging">
<t>Description: <vspace />
Information required to gain access to the resource.
</t>
<t>ValueType: <vspace />
Object value.
</t>
</list>
<section title="LDAP ObjectClass Definition" anchor="adminfo_ldap">
<t>
Definition of the admittanceinfo LDAP objectclass:
<artwork><![CDATA[
( 1.3.6.1.1.x.1.2
NAME 'AdmittanceInfo'
DESC 'Calendar Resource Admittance Info Class'
SUP CalendarResource
AUXILIARY
MAY (admittanceurl $ restricted) )
]]></artwork>
</t>
</section>
<section title='Restricted Access' anchor="restrict">
<list style="hanging">
<t hangText="Description:"> <vspace />
Is access to the resource restricted?
</t>
<t hangText="ValueType:"> <vspace />
Boolean value.
</t>
<t hangText="Example value:"> <vspace />
TRUE
</t>
</list>
<section title="LDAP Attribute Definition" anchor="restrict_ldap">
<t>
Definition of the restricted LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.4
NAME 'Restricted'
DESC 'Access Restricted'
EQUALITY booleanMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.7
SINGLE-VALUE )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="restrict_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify if access is restricted or not.
</t>
<t hangText="Type value:"> A single boolean value.
</t>
<t hangText="Cardinality:"> (0,1)
</t>
<t hangText="ABNF:"> <vspace />
RESTRICTEDACCESS-param = ; no parameter allowed <vspace />
RESTRICTEDACCESS-value = boolean
</t>
<t hangText="Example:"> <vspace />
RESTRICTEDACCESSS:TRUE
</t>
</list>
</section>
</section>
<section title='Admittance Info URL' anchor="adm_infourl">
<list style="hanging">
<t hangText="Description:"> <vspace />
URL pointing to complete information for accessing the resource including getting accessibility rights, special entrances, and so on.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/room1_admittance.html
</t>
</list>
<section title="LDAP Attribute Definition" anchor="adminfourl_ldap">
<t>
Definition of the admittanceurl LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.5
NAME 'AdmittanceURL'
DESC 'Cal Resource Admittance Info URL'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="adminfourl_vcard">
<list style="hanging">
<t hangText="Purpose:">To specify URL pointing to Admission Information.
</t>
<t hangText="Type value:">URI.
</t>
<t hangText="Cardinality:">(0,n)
</t>
<t hangText="ABNF:"> <vspace />
ADMISSIONINFO-param = "VALUE=uri" / any-param <vspace />
ADMISSIONINFO-value = uri
</t>
<t hangText="Example:"> <vspace />
ADMISSIONINFO:http://www.example.com/room1_admittance.html
</t>
</list>
</section>
</section>
</section>
<section title='Accessibility' anchor="access">
<list style="hanging">
<t hangText="Description:"> <vspace />
Special resource accessibility info for the physically disabled.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/room1_specialaccess.html
</t>
</list>
<section title="LDAP Attribute Definition" anchor="access_ldap">
<t>
Definition of the accessibilityurl LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.6
NAME 'accessibilityURL'
DESC 'Cal Resource accessibility Info URL'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="access_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify URL pointing to Disabled Access Information.
</t>
<t hangText="Type value:"> URI.
</t>
<t hangText="Cardinality:"> (0,n)
</t>
<t hangText="ABNF:"> <vspace />
ACCESSIBILITYINFO-param = "VALUE=uri" / any-param <vspace />
ACCESSIBILITYINFO-value = uri
</t>
<t hangText="Example:"> <vspace />
ACCESSIBILITYINFO:http://www.example.com/room1_specialaccess.html
</t>
</list>
</section>
</section>
<section title='Capacity' anchor="capacity">
<list style="hanging">
<t hangText="Description:"> <vspace />
Capacity of the resource.
</t>
<t hangText="ValueType:"> <vspace />
Integer.
</t>
<t hangText="Example value:"> <vspace />
10
</t>
</list>
<section title="LDAP Attribute Definition" anchor="cap_ldap">
<t>
Definition of the capacity LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.7
NAME 'Capacity'
DESC 'Cal Resource Capacity'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.27 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="cap_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify Capacity Information.
</t>
<t hangText="Type value:"> integer.
</t>
<t hangText="Cardinality:"> (0,n)
</t>
<t hangText="ABNF:"> <vspace />
CAPACITY-param = "VALUE=integer" / any-param <vspace />
CAPACITY-value = integer
</t>
<t>Example: <vspace />
CAPACITY:10
</t>
</list>
</section>
</section>
<section title='Inventory Info' anchor="inventory_info">
<list style="hanging">
<t hangText="Description:"> <vspace />
Information on resources available as part of this resource.
</t>
<t hangText="ValueType:"> <vspace />
Object value.
</t>
</list>
<section title="LDAP ObjectClass Definition" anchor="inventoryinfo_ldap">
<t>
Definition of the inventoryinfo LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.1.3
NAME 'InventoryInfo'
DESC 'Calendar Resource Inventory Info Class'
SUP CalendarResource
AUXILIARY
MAY (inventorylist $ inventoryurl) )
]]></artwork>
</t>
</section>
<section title='Inventory List' anchor="inventorylist">
<list style="hanging">
<t hangText="Description:"> <vspace />
List of resources available as part of this resource.
</t>
<t hangText="ValueType:"> <vspace />
String value.
Multi-valued attribute with one attribute per text value in LDAP.
One or more text values separated by a COMMA character in VCard property value.
</t>
<t hangText="Example value:"> <vspace />
Printer
</t>
</list>
<section title="LDAP Attribute Definition" anchor="inventlist_ldap">
<t>
Definition of the inventorylist LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.8
NAME 'InventoryList'
DESC 'Inventory List'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="inventlist_vcard">
<list style="hanging">
<t hangText="Purpose:"> List the resources available as part of this resource.
</t>
<t hangText="Type value:"> One or more text values separated by a COMMA character
(ASCII decimal 44).
</t>
<t hangText="Cardinality:"> (0,n)
</t>
<t hangText="ABNF:"> <vspace />
INVENTORYLIST-param = "VALUE=text" / any-param <vspace />
INVENTORYLIST-value = text
</t>
<t>Example: <vspace />
INVENTORYLIST:projector, phone
</t>
</list>
</section>
</section>
<section title='Inventory URL' anchor="inventory">
<list style="hanging">
<t hangText="Description:"> <vspace />
A URL pointing to other resource URLs part of this resource.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/room1_inventory.html
</t>
</list>
<section title="LDAP Attribute Definition" anchor="invent_ldap">
<t>
Definition of the inventoryurl LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.9
NAME 'InventoryURL'
DESC 'Cal Resource Inventory Info URL'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="invent_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify URL pointing to Inventory Information.
</t>
<t hangText="Type value:"> URI.
</t>
<t hangText="Cardinality:"> (0,n)
</t>
<t hangText="ABNF:"> <vspace />
INVENTORYURL-param = "VALUE=uri" / any-param <vspace />
INVENTORYURL-value = uri
</t>
<t>Example: <vspace />
INVENTORYURL:http://www.example.com/room1_inventory.html
</t>
</list>
</section>
</section>
</section>
<section title='Owner' anchor="owner">
<list style="hanging">
<t hangText="Description:"> <vspace />
Pointer to the owners of the resource. An owner is anyone who has complete authority over the resource, from naming to overall availability.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/room1_ownerinfo.html
</t>
</list>
<section title="LDAP Attribute Definition" anchor="owner_ldap">
<t>
owner attribute as defined in Section 2.21 of <xref target='RFC4519' />.
</t>
</section>
<section title="VCard Property Definition" anchor="owner_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify URL pointing to Resource Owner. It MAY refer to something other than a vCard object.
</t>
<t hangText="Type value:"> URI.
</t>
<t hangText="Cardinality:"> (0,n)
</t>
<t hangText="ABNF:"> <vspace />
RESOURCEOWNER-param = "VALUE=uri" / any-param <vspace />
RESOURCEOWNER-value = uri
</t>
<t hangText="Example:"> <vspace />
RESOURCEOWNER:http://www.example.com/room1_owner.vcf
</t>
</list>
</section>
</section>
<section title='Resource Manager' anchor="manager">
<list style="hanging">
<t hangText="Description:"> <vspace />
Pointer to the managers of the resource. A manager is someone responsible for the day-to-day up keep of the resource.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/room1_managerinfo.html
</t>
</list>
<section title="LDAP Attribute Definition" anchor="manager_ldap">
<t>
Definition of the resourcemanager LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.10
NAME 'ResourceManager'
DESC 'Cal Resource Manager Info'
EQUALITY distinguishedNameMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="manager_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify URL pointing to Resource Manager.
</t>
<t hangText="Type value:"> URI.
</t>
<t hangText="Cardinality:"> (0,n)
</t>
<t hangText="ABNF:"> <vspace />
RESOURCEMANAGER-param = "VALUE=uri" / any-param <vspace />
RESOURCEMANAGER-value = uri
</t>
<t hangText="Example:"> <vspace />
RESOURCEMANAGER:http://www.example.com/room1_manager.vcf
</t>
</list>
</section>
</section>
<section title='Calendar URL' anchor="cal_url">
<list style="hanging">
<t hangText="Description:"> <vspace />
URL to access calendar data of the resource.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/calendar/home/Room1/calendar/
</t>
</list>
<section title="LDAP Attribute Definition" anchor="calurl_ldap">
<t>
Calendar access attribute calCAPURI as defined in Section 2.4.4.3 and calOtherCAPURIs as defined in Section 2.4.4.7 of <xref target='RFC2739' /> respectively.
</t>
</section>
<section title="VCard Property Definition" anchor="calurl_vcard">
<t>
Calendar access property CAPURI as defined in Section 2.3.3 of <xref target='RFC2739' />.
</t>
</section>
</section>
<section title='FreeBusy URL' anchor="fb_url">
<list style="hanging">
<t hangText="Description:"> <vspace />
URL to read freebusy information of the resource's calendar.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/freebusy/home/Room1/
</t>
</list>
<section title="LDAP Attribute Definition" anchor="fburl_ldap">
<t>
Calendar access attribute calFBURL as defined in Section 2.4.4.2 and calOtherFBURLs as defined in Section 2.4.4.6 of <xref target='RFC2739' /> respectively.
</t>
</section>
<section title="VCard Property Definition" anchor="fburl_vcard">
<t>
FBURL attribute as defined in Section 2.3.1 of <xref target='RFC2739' /> and further explained in Section 6.9.1 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Scheduling Address' anchor="sched_addr">
<list style="hanging">
<t hangText="Description:"> <vspace />
Address used for scheduling the resource by a Calendaring and Scheduling service.
</t>
<t hangText="ValueType:"> <vspace />
String value.
</t>
<t hangText="Example value:"> <vspace />
mailto:room1@example.com
</t>
</list>
<section title="LDAP Attribute Definition" anchor="saddr_ldap">
<t>
Scheduling Address attribute calCalAdrURI as defined in Section 2.4.4.4 and calOtherCalAdrURIs as defined in Section 2.4.4.8 of <xref target='RFC2739' /> respectively.
This is the address that would be used by a Scheduling and Calendaring application to schedule the resource.
Its value must be a uri string, in most cases a mailto: uri. The mail attribute value of the resource should be used for scheduling, in the absence of this attribute.
</t>
</section>
<section title="VCard Property Definition" anchor="saddr_vcard">
<t>
Scheduling Address property CALADRURI as defined in Section 2.3.2 <xref target='RFC2739' /> and further explained in Section 6.9.2 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
This is the address that would be used by a Scheduling and Calendaring application to schedule the resource.
Its value must be a uri string, in most cases a mailto: uri. The EMAIL property value of the resource should be used for scheduling, in the absence of this attribute.
</t>
</section>
</section>
<section title='Time Zone' anchor="tzid">
<list style="hanging">
<t hangText="Description:"> <vspace />
TimeZone Identifier for the timezone the resource is in.
</t>
<t hangText="ValueType:"> <vspace />
String value.
</t>
<t hangText="Example value:"> <vspace />
America/New_York
</t>
</list>
<section title="LDAP Attribute Definition" anchor="tzid_ldap">
<t>
Definition of the timezoneid LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.11
NAME 'TimeZoneID'
DESC 'Cal Time Zone ID'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="tzid_vcard">
<t>
TimeZone property TZ as defined in Section 6.5.1 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Multiple Bookings' anchor="multibook">
<list style="hanging">
<t hangText="Description:"> <vspace />
Number of simultaneous bookings allowed.
</t>
<t hangText="ValueType:"> <vspace />
Integer value. <vspace />
Value of 0 indicates no limits.
</t>
<t hangText="Example value:"> <vspace />
1
</t>
</list>
<section title="LDAP Attribute Definition" anchor="mbook_ldap">
<t>
Definition of the multiplebookings LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.12
NAME 'Multiplebookings'
DESC 'Cal Num Bookings Allowed'
EQUALITY integerMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.27
SINGLE-VALUE )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="mbook_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify number of simultaneous bookings allowed.
</t>
<t hangText="Type value:"> integer.
</t>
<t hangText="Cardinality:"> (0,1)
</t>
<t hangText="ABNF:"> <vspace />
MULTIBOOK-param = "VALUE=integer" / any-param <vspace />
MULTIBOOK-value = integer
</t>
<t hangText="Example:"> <vspace />
MULTIBOOK:10
</t>
</list>
</section>
</section>
<section title='Maximum Instances' anchor="max_inst">
<list style="hanging">
<t hangText="Description:"> <vspace />
Maximum number of instances of an event, the resource can be scheduled for from NOW.
</t>
<t hangText="ValueType:"> <vspace />
Integer value. <vspace />
Value of 0 indicates no limits.
</t>
<t hangText="Example value:"> <vspace />
60
</t>
</list>
<section title="LDAP Attribute Definition" anchor="maxinst_ldap">
<t>
Definition of the maxinstances LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.13
NAME 'MaxInstances'
DESC 'Cal Maximum Instances allowed'
EQUALITY integerMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.27
SINGLE-VALUE )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="maxinst_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify maximum number of instances of an event, the resource can be scheduled for from NOW.
</t>
<t hangText="Type value:"> integer.
</t>
<t hangText="Cardinality:"> (0,1)
</t>
<t hangText="ABNF:"> <vspace />
MAXINSTANCES-param = "VALUE=integer" / any-param <vspace />
MAXINSTANCES-value = integer
</t>
<t hangText="Example:"> <vspace />
MAXINSTANCES:10
</t>
</list>
</section>
</section>
<section title='BookingWindow Start' anchor="bwin_start">
<list style="hanging">
<t hangText="Description:"> <vspace />
Defines how much time in advance the resource can be booked. The value of
this property is used to calculate the earliest date and time when a resource
can be reserved for an event starting on a specific date and time.<vspace />
If this property value is defined, the resource may be booked for an event
at a certain time, only if the current time is equal to or after the date
and time calculated by subtracting this value from the event's proposed
start time. If this property is absent, then the resource may be booked at
any time before the end of the booking window.
</t>
<t>ValueType: Duration value. <vspace />
The format is based on the
<xref target="ISO.8601.2004"/>
duration representation basic format with designators for the duration of time.
The format can represent nominal durations (weeks and days) and accurate
durations (hours, minutes, and seconds).
The syntax is further defined in Appendix A, "Duration" section of <xref target='RFC3339' />.
</t>
<t hangText="Example value:"> <vspace />
P3M
</t>
</list>
<section title="LDAP Attribute Definition" anchor="bwinstart_ldap">
<t>
Definition of the bookingwindowstart LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.14
NAME 'BookingWindowStart'
DESC 'Cal Booking Window Start'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
SINGLE-VALUE )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="bwinstart_vcard">
<list style="hanging">
<t hangText="Purpose:">
To specify how much time in advance the resource can be booked.
</t>
<t hangText="Type value:"> duration. <vspace />
The format is based on the
<xref target="ISO.8601.2004"/>
duration representation basic format with designators for the duration of time.
The format can represent nominal durations (weeks and days) and accurate
durations (hours, minutes, and seconds).
The syntax is further defined in Appendix A, "Duration" section of <xref target='RFC3339' />.
</t>
<t hangText="Cardinality:"> (0,1)
</t>
<t hangText="ABNF:"> <vspace />
BOOKINGWINDOWSTART-param = "VALUE=text" / any-param <vspace />
BOOKINGWINDOWSTART-value = text
</t>
<t hangText="Example:"> <vspace />
BOOKINGWINDOWSTART:P3M
</t>
</list>
</section>
</section>
<section title='BookingWindow End' anchor="bwin_end">
<list style="hanging">
<t hangText="Description:"> <vspace />
Defines how much time in advance the resource booking is closed.
The value of this property is used to calculate the latest date
and time when a resource can be reserved for an event starting on
a specific date and time.<vspace />
If the current time is equal to or before the value obtained by
subtracting BookingWindowEnd from the start date and time of the
event, then the resource may be booked. If this property is absent,
then the resource may be booked anytime from booking window start
to the start of the event. <vspace />
BookingWindow Start and End together provide the window of time a
resource can be booked, relative to the start time of the event.<vspace />
<artwork>
If BookingWindowStart = BwS,
BookingWindowEnd = BwE,
Current Time = CT and
Event Start Time = ST,
a resource can be booked at a certain time only if
CT is equal to or after (ST - BwS)
and CT is equal to or before (ST - BwE)
</artwork>
</t>
<t>ValueType: Duration value. <vspace />
The format is based on the
<xref target="ISO.8601.2004"/>
duration representation basic format with designators for the duration of time.
The format can represent nominal durations (weeks and days) and accurate
durations (hours, minutes, and seconds).
The syntax is further defined in Appendix A, "Duration" section of <xref target='RFC3339' />.
</t>
<t hangText="Example value:"> <vspace />
P5D
</t>
</list>
<section title="LDAP Attribute Definition" anchor="bwinend_ldap">
<t>
Definition of the bookingwindowend LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.15
NAME 'BookingWindowEnd'
DESC 'Cal Booking Window End'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
SINGLE-VALUE )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="bwinend_vcard">
<list style="hanging">
<t hangText="Purpose:">
To specify how much time in advance the resource booking is closed.
</t>
<t hangText="Type value:"> duration. <vspace />
The format is based on the
<xref target="ISO.8601.2004"/>
duration representation basic format with designators for the duration of time.
The format can represent nominal durations (weeks and days) and accurate
durations (hours, minutes, and seconds).
The syntax is further defined in Appendix A, "Duration" section of <xref target='RFC3339' />.
</t>
<t hangText="Cardinality:"> (0,1)
</t>
<t hangText="ABNF:"> <vspace />
BOOKINGWINDOWEND-param = "VALUE=text" / any-param <vspace />
BOOKINGWINDOWEND-value = text
</t>
<t hangText="Example:"> <vspace />
BOOKINGWINDOWEND:P5D
</t>
</list>
</section>
</section>
<section title='Scheduling Approval Info' anchor="appr_info">
<list style="hanging">
<t hangText="Description:"> <vspace />
Information regarding approval of a scheduling request to the resource.
</t>
<t hangText="ValueType:"> <vspace />
Object value.
</t>
</list>
<section title="LDAP ObjectClass Definition" anchor="appr_ldap">
<t>
Definition of the schedapprovalinfo LDAP objectclass:
<artwork><![CDATA[
( 1.3.6.1.1.x.1.4
NAME 'SchedApprovalInfo'
DESC 'Calendar Sched Approval Class'
SUP CalendarResource
AUXILIARY
MAY (autoschedule $ approvalinfourl $ schedadmin) )
]]></artwork>
</t>
</section>
<section title='Auto schedule' anchor="auto">
<list style="hanging">
<t hangText="Description:"> <vspace />
No approval required. Automatically scheduled.
</t>
<t hangText="ValueType:"> <vspace />
Boolean value.
</t>
<t hangText="Example value:"> <vspace />
TRUE
</t>
</list>
<section title="LDAP Attribute Definition" anchor="auto_ldap">
<t>
Definition of the autoschedule LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.16
NAME 'Autoschedule'
DESC 'Cal Scheduling no approval required'
EQUALITY booleanMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.7
SINGLE-VALUE )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="auto_vcard">
<list style="hanging">
<t hangText="Purpose:">
To specify if invitations should be automatically scheduled.
</t>
<t hangText="Type value:"> Boolean.
</t>
<t hangText="Cardinality:"> (0,1)
</t>
<t hangText="ABNF:"> <vspace />
AUTOSCHEDULE-param = "VALUE=boolean" / any-param <vspace />
AUTOSCHEDULE-value = "TRUE" / "FALSE"
</t>
<t hangText="Example:"> <vspace />
AUTOSCHEDULE:TRUE
</t>
</list>
</section>
</section>
<section title='Approval Info URL' anchor="appr_infourl">
<list style="hanging">
<t hangText="Description:"> <vspace />
URL pointing to complete information on scheduling request approval
process for the resource.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/room1_approval.html
</t>
</list>
<section title="LDAP Attribute Definition" anchor="apprinfourl_ldap">
<t>
Definition of the approvalinfourl LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.17
NAME 'ApprovalInfoURL'
DESC 'Cal Sched Approval Info'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="apprinfourl_vcard">
<list style="hanging">
<t hangText="Purpose:">
To specify URL pointing to Scheduling Approval Information.
</t>
<t hangText="Type value:"> URI.
</t>
<t hangText="Cardinality:"> (0,n)
</t>
<t hangText="ABNF:"> <vspace />
APPROVALINFO-param = "VALUE=uri" / any-param <vspace />
APPROVALINFO-value = uri
</t>
<t hangText="Example:"> <vspace />
APPROVALINFO:http://www.example.com/room1_approval.html
</t>
</list>
</section>
</section>
<section title='Scheduling Admin Contact' anchor="schedadm_contact">
<list style="hanging">
<t hangText="Description:"> <vspace />
Contact information for the scheduling approvers, if approval required.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/SchedAdmin1.vcf
</t>
</list>
<section title="LDAP Attribute Definition" anchor="schedadm_ldap">
<t>
Definition of the schedadmin LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.18
NAME 'SchedAdmin'
DESC 'Cal Sched Admin Info'
EQUALITY distinguishedNameMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="schedadm_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify URL pointing to Scheduling Manager.
</t>
<t hangText="Type value:"> URI.
</t>
<t hangText="Cardinality:"> (0,n)
</t>
<t hangText="ABNF:"> <vspace />
SCHEDADMIN-param = "VALUE=uri" / any-param <vspace />
SCHEDADMIN-value = uri
</t>
<t hangText="Example:"> <vspace />
SCHEDADMIN:http://www.example.com/SchedAdmin1.vcf
</t>
</list>
</section>
</section>
</section>
<section title='Cost' anchor="cost">
<list style="hanging">
<t hangText="Description:"> <vspace />
Scheduling costs for this resource.
</t>
<t hangText="ValueType:"> <vspace />
Object value.
</t>
</list>
<section title="LDAP ObjectClass Definition" anchor="cost_ldap">
<t>
Definition of the cost LDAP objectclass:
<artwork><![CDATA[
( 1.3.6.1.1.x.1.5
NAME 'CalendarResourceCost'
DESC 'Calendar Resource Cost Object Class'
SUP CalendarResource
AUXILIARY
MAY (nocost $ costurl)
]]></artwork>
</t>
</section>
<section title='Nocost' anchor="free">
<list style="hanging">
<t hangText="Description:"> <vspace />
No cost for using the resource. Can be used for a resource scheduling query.
</t>
<t hangText="ValueType:"> <vspace />
Boolean value.
</t>
<t hangText="Example value:"> <vspace />
TRUE
</t>
</list>
<section title="LDAP Attribute Definition" anchor="nocost_ldap">
<t>
Definition of the nocost LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.19
NAME 'Nocost'
DESC 'Free or Priced resource'
EQUALITY booleanMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.7
SINGLE-VALUE )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="nocost_vcard">
<list style="hanging">
<t hangText="Purpose:">To specify if resource usage is free.
</t>
<t hangText="Type value:"> A single boolean value.
</t>
<t hangText="Cardinality:"> (0,1)
</t>
<t hangText="ABNF:"> <vspace />
NOCOST-param = ; no parameter allowed <vspace />
NOCOST-value = boolean
</t>
<t hangText="Example:"> <vspace />
NOCOST:TRUE
</t>
</list>
</section>
</section>
<section title='Cost URL' anchor="cost_url">
<list style="hanging">
<t hangText="Description:"> <vspace />
URL pointing to complete pricing information for usage of the resource.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/cost.html
</t>
</list>
<section title="LDAP Attribute Definition" anchor="costurl_ldap">
<t>
Definition of the costurl LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.20
NAME 'CostURL'
DESC 'Cal Resource Cost Info'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="costurl_vcard">
<list style="hanging">
<t hangText="Purpose:"> To specify URL pointing Resource Scheduling Cost Information.
</t>
<t hangText="Type value:"> URI.
</t>
<t hangText="Cardinality:"> (0,n)
</t>
<t hangText="ABNF:"> <vspace />
COSTINFO-param = "VALUE=uri" / any-param <vspace />
COSTINFO-value = uri
</t>
<t hangText="Example:"> <vspace />
COSTINFO:http://www.example.com/cost.html
</t>
</list>
</section>
</section>
</section>
<section title='Related' anchor="relate">
<list style="hanging">
<t hangText="Description:"> <vspace />
Specify a relationship with another resource.
</t>
<t hangText="ValueType:"> <vspace />
URL value.
</t>
<t hangText="Example value:"> <vspace />
http://www.example.com/printer1.html
</t>
</list>
<section title="LDAP Attribute Definition" anchor="relate_ldap">
<t>
Definition of the related LDAP attribute:
<artwork><![CDATA[
( 1.3.6.1.1.x.0.21
NAME 'Related'
DESC 'Related URL'
EQUALITY uniqueMemberMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.34 )
]]></artwork>
</t>
</section>
<section title="VCard Property Definition" anchor="relate_vcard">
<t>
The property RELATED as defined in Section 6.6.6 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
</section>
<section title='Examples'>
<section title='LDAP Examples'>
<section title='Location Resource'>
<t>
<artwork>
dn: cn=Room One,ou=Engineering,dc=example,dc=com
objectclass: top
objectclass: calendarresource
objectclass: admittanceinfo
objectclass: inventoryinfo
objectclass: schedapprovalinfo
objectclass: calendarresourcecost
objectclass: room
vcarduid: room1-id
cn: Room One
ou: Engineering
nickname: The One
description: Room 1 in Engineering Building X
categories: rooms
categories: engineering_resources
restricted: TRUE
admittanceurl: http://www.example.com/room1_admittance.html
accessibilityurl: http://www.example.com/room1_specialaccess.html
capacity: 100
inventorylist: phone
inventorylist: projector
inventoryurl: http://www.example.com/room1_inventory.html
owner: cn=RoomOwner,ou=Engineering,dc=example,dc=com
resourcemanager: cn=RoomOwner,ou=Engineering,dc=example,dc=com
calcapuri: http://www.example.com/calendar/home/Room1/calendar/
calfburl: http://www.example.com/freebusy/home/Room1/
calcaladruri: mailto:room1@example.com
timezoneid: America/Los_Angeles
multiplebookings: 1
maxinstances: 10
bookingwindowstart:P3M
bookingwindowend: P3D
autoschedule: FALSE
approvalinfourl: http://www.example.com/room1_approval.html
schedadmin: cn=RoomOwner,ou=Engineering,dc=example,dc=com
nocost: FALSE
costurl: http://www.example.com/cost.html
</artwork>
</t>
</section>
<section title='Role Resources Group'>
<t>
<artwork>
dn: cn=Drivers X,ou=Transportation,dc=example,dc=com
objectclass: top
objectclass: groupOfuniqueNames
objectclass: calendarresource
objectclass: schedapprovalinfo
objectclass: calendarresourcecost
vcarduid: driversX-id
cn: Driver One
ou: Transportation
nickname: The X
description: Drivers in the Transportation department driver pool X
categories: drivers
uniquemember: cn=Driver1,ou=Transportation,dc=example,dc=com
uniquemember: cn=Driver2,ou=Transportation,dc=example,dc=com
uniquemember: cn=Driver3,ou=Transportation,dc=example,dc=com
owner: cn=Transportation_Manager,ou=Transportation,dc=example,dc=com
calfburl: http://www.example.com/freebusy/home/DriversX/
calcaladruri: mailto:driversX@example.com
timezoneid: America/Los_Angeles
multiplebookings: 3
maxinstances: 10
bookingwindowstart:P3M
bookingwindowend: P3D
autoschedule: FALSE
approvalinfourl: http://www.example.com/driversX_approval.html
schedadmin: cn=TransportationManager,ou=Transportation,dc=example,dc=com
nocost: FALSE
costurl: http://www.example.com/driversXcost.html
</artwork>
</t>
</section>
</section>
<section title='VCard Examples'>
<section title='Location Resource'>
<t>
<artwork>
BEGIN:VCARD
VERSION:4.0
UID:urn:uuid:room1-id
KIND: location
FN: Room One
ORG: Engineering
NICKNAME: The One
NOTE: Room 1 in Engineering Building X
CATEGORIES: rooms, engineering_resources
RESTRICTEDACCESS: TRUE
ADMISSIONINFO: http://www.example.com/room1_admittance.html
ACCESSIBILITYINFO: http://www.example.com/room1_specialaccess.html
CAPACITY: 100
INVENTORYLIST: phone, projector
INVENTORYURL: http://www.example.com/room1_inventory.html
RESOURCEOWNER: http://www.example.com/ResOwner1.vcf
RESOURCEMANAGER: http://www.example.com/ResManager1.vcf
CAPURI: http://www.example.com/calendar/home/Room1/calendar/
FBURL: http://www.example.com/freebusy/home/Room1/
CALADRURI: mailto:room1@example.com
TZ: America/Los_Angeles
MULTIBOOK: 1
MAXINSTANCES: 10
BOOKINGWINDOWSTART:P3M
BOOKINGWINDOWEND: P3D
AUTOSCHEDULE: FALSE
APPROVALINFO: http://www.example.com/room1_approval.html
SCHEDADMIN: http://www.example.com/SchedAdmin1.vcf
NOCOST: FALSE
COSTINFO: http://www.example.com/cost.html
END:VCARD
</artwork>
</t>
</section>
<section title='Role Resources Group'>
<t>
<artwork>
BEGIN:VCARD
VERSION:4.0
UID:urn:uuid:driverXPool-id
KIND: group
FN: Driver X Pool
ORG: Transportation
NICKNAME: The X Group
NOTE: Drivers in the Transportation department driver pool X
CATEGORIES: drivers
MEMBER:urn:uuid:driver1-id
MEMBER:urn:uuid:driver2-id
MEMBER:urn:uuid:driver3-id
RESOURCEOWNER: http://www.example.com/DriversManager.vcf
FBURL: http://www.example.com/freebusy/home/DriversX/
CALADRURI: mailto:driversX@example.com
TZ: America/Los_Angeles
MULTIBOOK: 3
MAXINSTANCES: 10
BOOKINGWINDOWSTART:P3M
BOOKINGWINDOWEND: P3D
AUTOSCHEDULE: FALSE
APPROVALINFO: http://www.example.com/driversX_approval.html
SCHEDADMIN: http://www.example.com/DriversX_SchedAdmin.vcf
NOCOST: FALSE
COSTINFO: http://www.example.com/driversXcost.html
END:VCARD
</artwork>
</t>
</section>
</section>
</section>
<section title="Security Considerations" anchor="SECURITY_CONSIDERATIONS">
<t>
As this document only defines schema for representing resource information
for calendaring and scheduling and does not refer to the actual storage
mechanism itself, or the calendaring and scheduling protocol,
no special security considerations are required as part of this document.
</t>
</section><!-- SECURITY_CONSIDERATIONS -->
<section title='IANA Considerations' anchor ='iana_registry'>
<section title='LDAP Objectclass and Attribute Registration'>
<t>
New LDAP objectclasses and attributes defined in this document need to be registered by the Internet Assigned Numbers Authority (IANA) as requested in the following template. Once the assignment is done, this document needs to be updated with the right OID numbers for all the newly defined objectclasses and attributes.
</t>
<t>
<artwork>
Subject: Request for LDAP Descriptor Registration
Descriptor (short name): See table below
Object Identifier: See table below
Person & email address to contact for further information:
Ciny Joy <ciny.joy@oracle.com>
Usage: See table below
Specification: draft-cal-resource-schema
Author/Change Controller: IESG
</artwork>
</t>
<texttable>
<preamble>New LDAP ObjectClass and Attributes Table:</preamble>
<ttcol align='left'>Name</ttcol>
<ttcol align='left'>Type</ttcol>
<ttcol align='left'>Definition</ttcol>
<ttcol align='left'>OID</ttcol>
<c>CalendarResource</c>
<c>ObjectClass</c>
<c><xref target="resobj_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>Kind</c>
<c>Attribute</c>
<c><xref target="reskind_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>VcardUid</c>
<c>Attribute</c>
<c><xref target="uid_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>NickName</c>
<c>Attribute</c>
<c><xref target="nick_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>Categories</c>
<c>Attribute</c>
<c><xref target="cat_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>AdmittanceInfo</c>
<c>ObjectClass</c>
<c><xref target="adminfo_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>Restricted</c>
<c>Attribute</c>
<c><xref target="restrict_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>AdmittanceURL</c>
<c>Attribute</c>
<c><xref target="adminfourl_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>AccessibilityURL</c>
<c>Attribute</c>
<c><xref target="access_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>Capacity</c>
<c>Attribute</c>
<c><xref target="cap_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>InventoryInfo</c>
<c>ObjectClass</c>
<c><xref target="inventoryinfo_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>InventoryList</c>
<c>Attribute</c>
<c><xref target="inventlist_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>InventoryURL</c>
<c>Attribute</c>
<c><xref target="invent_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>ResourceManager</c>
<c>Attribute</c>
<c><xref target="manager_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>TimeZoneID</c>
<c>Attribute</c>
<c><xref target="tzid_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>MultipleBookings</c>
<c>Attribute</c>
<c><xref target="mbook_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>MaxInstances</c>
<c>Attribute</c>
<c><xref target="maxinst_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>BookingWindowStart</c>
<c>Attribute</c>
<c><xref target="bwinstart_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>BookingWindowEnd</c>
<c>Attribute</c>
<c><xref target="bwinend_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>SchedApprovalInfo</c>
<c>ObjectClass</c>
<c><xref target="appr_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>Autoschedule</c>
<c>Attribute</c>
<c><xref target="auto_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>ApprovalInfoURL</c>
<c>Attribute</c>
<c><xref target="apprinfourl_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>SchedAdmin</c>
<c>Attribute</c>
<c><xref target="schedadm_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>CalendarResourceCost</c>
<c>ObjectClass</c>
<c><xref target="cost_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>Nocost</c>
<c>Attribute</c>
<c><xref target="nocost_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>CostURL</c>
<c>Attribute</c>
<c><xref target="costurl_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
<c>Related</c>
<c>Attribute</c>
<c><xref target="relate_ldap" /></c>
<c>IANA-ASSIGNED-OID</c>
</texttable>
</section>
<section title='VCard Property and Value Registration'>
<t>
The following new VCard Properties need to be registered by IANA.
</t>
<texttable>
<preamble>New VCard Properties Table:</preamble>
<ttcol align='left'>VCard Property Name</ttcol>
<ttcol align='left'>VCard Property Definition</ttcol>
<c>RESTRICTEDACCESS</c>
<c><xref target="restrict_vcard" /></c>
<c>ADMISSIONINFO</c>
<c><xref target="adminfourl_vcard" /></c>
<c>ACCESSIBILITYINFO</c>
<c><xref target="access_vcard" /></c>
<c>CAPACITY</c>
<c><xref target="cap_vcard" /></c>
<c>INVENTORYLIST</c>
<c><xref target="inventlist_vcard" /></c>
<c>INVENTORYURL</c>
<c><xref target="invent_vcard" /></c>
<c>RESOURCEOWNER</c>
<c><xref target="owner_vcard" /></c>
<c>RESOURCEMANAGER</c>
<c><xref target="manager_vcard" /></c>
<c>MAXINSTANCE</c>
<c><xref target="maxinst_vcard" /></c>
<c>BOOKINGWINDOWSTART</c>
<c><xref target="bwinstart_vcard" /></c>
<c>BOOKINGWINDOWEND</c>
<c><xref target="bwinend_vcard" /></c>
<c>AUTOSCHEDULE</c>
<c><xref target="auto_vcard" /></c>
<c>APPROVALINFO</c>
<c><xref target="apprinfourl_vcard" /></c>
<c>SCHEDADMIN</c>
<c><xref target="schedadm_vcard" /></c>
<c>NOCOST</c>
<c><xref target="nocost_vcard" /></c>
<c>COSTINFO</c>
<c><xref target="costurl_vcard" /></c>
</texttable>
<t>
The following new VCard Property Values need to be registered by IANA.
</t>
<texttable>
<preamble>New VCard Property Values Table:</preamble>
<ttcol align='left'>VCard Property Name</ttcol>
<ttcol align='left'>Additional VCard Property Value</ttcol>
<ttcol align='left'>Value Definition</ttcol>
<c>KIND</c>
<c>calendarresource</c>
<c><xref target="reskind_vcard" /></c>
</texttable>
</section>
</section>
<section title='Acknowledgments'>
<t>
This specification is a result of discussions that took place within the Calendaring and Scheduling Consortium's Resource Technical Committee. The authors thank the participants of that group, and specifically the following individuals for contributing their ideas and support: Arnaud Quillaud, Adam Lewenberg, Andrew Laurence, Guy Stalnaker, Mimi Mugler, Dave Thewlis, Bernard Desruisseaux, Alain Petit, Andrew Sciberras, and Jason Miller.
</t>
</section>
</middle>
<back>
<references title='Normative References'>
&RFC2119;
&RFC4519;
&RFC2739;
&RFC3339;
&RFC4524;
&cardrev;
<reference anchor="ISO.8601.2004">
<front>
<title>
Data elements and interchange formats --
Information interchange --
Representation of dates and times
</title>
<author>
<organization>
International Organization for Standardization
</organization>
</author>
<date year="2004"/>
</front>
</reference><!-- ISO.8601.2004-->
</references>
</back>
</rfc>
| PAFTECH AB 2003-2026 | 2026-04-23 08:24:30 |