One document matched: draft-cal-resource-schema-00.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 RFC4519 PUBLIC '' 'http://xml.resource.org/public/rfc/bibxml/reference.RFC.4519.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-00' 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>
4150 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='April' year='2010' />
<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 />
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='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" />.
Resource Kind, described in <xref target="res_kind" />, and Unique ID, described in <xref target="unique_id" />, 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>
This document specifies whether a given Attribute or Property is required for a query to find the right resource, or is used to just give additional information during scheduling of the resource.
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'>
<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 MUST be the calEntry objectClass as defined in Section 2.4.3.1 of <xref target='RFC2739' />
<artwork><![CDATA[
( 1.3.6.1.1.x.1.1
NAME 'CalendarResource'
DESC 'Calendar Resource Object Class'
SUP calEntry
AUXILIARY
MUST (calresourcekind $ uid)
MAY (cn $ nickname $ description $ ou $ categories $ member $
uniquemember $ accessabilityurl $ capacity $ owner $
resourcemanager $ timezoneid $ multiplebookings $
maxinstances $ bookingwindowstart $ bookingwindowend $
resourcenotes) )
]]></artwork>
</t>
</section>
</section>
<section title='Resource Attributes' anchor="res_attrs">
<section title='Resource Kind' anchor="res_kind">
<t>
Description: <vspace />
The kind of resource. Required for a meaningful resource scheduling query and MUST be defined.
</t>
<t>ValueType: <vspace />
Some of the possible values are "Location", "Thing", or "Group". <vspace />
Location is used for any physical location resource such as room, building, etc. <vspace />
Thing 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>Example value: <vspace />
Location
</t>
<section title="LDAP Attribute Definition" anchor="reskind_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.0.1
NAME 'CalResourceKind'
DESC 'Calendar Resource Kind'
EQUALITY caseIgnoreMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.15
SINGLE-VALUE )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="reskind_vcard">
<t>
Property KIND that specifies the kind of objected represented, as defined in Section 6.1.5 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Unique ID' anchor="unique_id">
<t>Description: <vspace />
A Unique Identifier. Not required for a resource scheduling query but MUST be defined.
</t>
<t>ValueType: <vspace />
Single string value.
</t>
<t>Example value: <vspace />
room1-id1
</t>
<section title="LDAP Attribute Definition" anchor="uid_ldap">
<t>
uid attribute as defined in Section 2.39 of <xref target="RFC4519" />.
</t>
</section>
<section title="VCard Property Definition" anchor="uid_vcard">
<t>
UID property as defined in Section 7.7.7 of <xref target="I-D.ietf-vcarddav-vcardrev" />.
</t>
</section>
</section>
<section title='Common Name' anchor="cn">
<t>Description: <vspace />
Full name of the resource. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
String value.
</t>
<t>Example value: <vspace />
Room One
</t>
<section title="LDAP Attribute Definition" anchor="cn_ldap">
<t>
cn attribute as defined in Section 2.3 of <xref target='RFC4519' />.
</t>
</section>
<section title="VCard Property Definition" anchor="cn_vcard">
<t>
FN property as defined in Section 7.2.1 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Nick Name' anchor="nickname">
<t>Description: <vspace />
A short or popular name for the resource. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
String value.
</t>
<t>Example value: <vspace />
TheOne
</t>
<section title="LDAP Attribute Definition" anchor="nick_ldap">
<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>
</section>
<section title="VCard Property Definition" anchor="nick_vcardk">
<t>
NICKNAME property as defined in Section 7.2.3 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Description' anchor="desc">
<t>Description: <vspace />
Description of the resource. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
String value.
</t>
<t>Example value: <vspace />
Room 1 in Building X
</t>
<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 7.7.2 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Organizational Unit' anchor="ou">
<t>Description: <vspace />
Organizations the resource belongs to. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
String value.
</t>
<t>Example value: <vspace />
EngineeringDepartment
</t>
<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 7.6.4 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Categories' anchor="categories">
<t>Description: <vspace />
Categories the resource falls under or tags for easy discovery of the resource. Can be used for a resource scheduling query.
</t>
<t>ValueType: <vspace />
String value.
</t>
<t>Example value: <vspace />
Rooms, EngineeringResources
</t>
<section title="LDAP Attribute Definition" anchor="cat_ldap">
<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>
</section>
<section title="VCard Property Definition" anchor="cat_vcard">
<t>
CATEGORIES property as defined in Section 7.7.1 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Group Member' anchor="grpmem">
<t>Description: <vspace />
List of unique resources in a group of resources object. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/printer1.html <vspace />
http://www.example.com/printer2.html
</t>
<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 7.6.5 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Admittance Info' anchor="adm_info">
<t>Description: <vspace />
Information required to gain access to the resource.
</t>
<t>ValueType: <vspace />
Object value.
</t>
<section title="LDAP ObjectClass Definition" anchor="adminfo_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.1.2
NAME 'AdmittanceInfo'
DESC 'Calendar Resource Admittance Info Class'
SUP CalendarResource
AUXILIARY
MUST (admittanceurl)
MAY (restricted) )
]]></artwork>
</section>
<section title='Restricted Access' anchor="restrict">
<t>Description: <vspace />
Is access to the resource restricted? Can be used for a resource scheduling query.
</t>
<t>ValueType: <vspace />
Boolean value.
</t>
<t>Example value: <vspace />
True
</t>
<section title="LDAP Attribute Definition" anchor="restrict_ldap">
<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 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="restrict_vcard">
<t>
Purpose: To specify if access is restricted or not.
</t>
<t>
Type value: A single boolean value.
</t>
<t>
Cardinality: (0,1)
</t>
<t>
ABNF: <vspace />
RESTRICTEDACCESS-param = ; no parameter allowed <vspace />
RESTRICTEDACCESS-value = boolean
</t>
<t>
Example: <vspace />
RESTRICTEDACCESSS:True
</t>
</section>
</section>
<section title='Admittance Info URL' anchor="adm_infourl">
<t>Description: <vspace />
URL pointing to complete information for accessing the resource including getting accessibility rights, special entrances, and so on.
Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/room1_admittance.html
</t>
<section title="LDAP Attribute Definition" anchor="adminfourl_ldap">
<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>
</section>
<section title="VCard Property Definition" anchor="adminfourl_vcard">
<t>
Purpose: To specify URL pointing to Admission Information.
</t>
<t>
Type value: URI.
</t>
<t>
Cardinality: (0,n)
</t>
<t>
ABNF: <vspace />
ADMISSIONINFO-param = "VALUE=uri" / any-param <vspace />
ADMISSIONINFO-value = uri
</t>
<t>
Example: <vspace />
ADMISSIONINFO:http://www.example.com/room1_admittance.html
</t>
</section>
</section>
</section>
<section title='Accessibility' anchor="access">
<t>Description: <vspace />
Special resource accessibility info for the physically disabled. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/room1_specialaccess.html
</t>
<section title="LDAP Attribute Definition" anchor="access_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.0.6
NAME 'AccessabilityURL'
DESC 'Cal Resource Accessability Info URL'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="access_vcard">
<t>
Purpose: To specify URL pointing to Disabled Access Information.
</t>
<t>
Type value: URI.
</t>
<t>
Cardinality: (0,n)
</t>
<t>
ABNF: <vspace />
ACCESSABILITYINFO-param = "VALUE=uri" / any-param <vspace />
ACCESSABILITYINFO-value = uri
</t>
<t>
Example: <vspace />
ACCESSABILITYINFO:http://www.example.com/room1_specialaccess.html
</t>
</section>
</section>
<section title='Capacity' anchor="capacity">
<t>Description: <vspace />
Capacity of the resource. Can be used for a resource scheduling query.
</t>
<t>ValueType: <vspace />
Integer.
</t>
<t>Example value: <vspace />
10
</t>
<section title="LDAP Attribute Definition" anchor="cap_ldap">
<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>
</section>
<section title="VCard Property Definition" anchor="cap_vcard">
<t>
Purpose: To specify Capacity Information.
</t>
<t>
Type value: integer.
</t>
<t>
Cardinality: (0,n)
</t>
<t>
ABNF: <vspace />
CAPACITY-param = "VALUE=integer" / any-param <vspace />
CAPACITY-value = integer
</t>
<t>
Example: <vspace />
CAPACITY:10
</t>
</section>
</section>
<section title='Inventory Info' anchor="inventory_info">
<t>Description: <vspace />
Information on resources available as part of this resource.
</t>
<t>ValueType: <vspace />
Object value.
</t>
<section title="LDAP ObjectClass Definition" anchor="inventoryinfo_ldap">
<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>
</section>
<section title='Inventory List' anchor="inventorylist">
<t>Description: <vspace />
List of resources available as part of this resource. Can be used for a resource scheduling query.
</t>
<t>ValueType: <vspace />
String value. One or more text values separated by a COMMA character.
</t>
<t>Example value: <vspace />
Printer, Projector
</t>
<section title="LDAP Attribute Definition" anchor="inventlist_ldap">
<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>
</section>
<section title="VCard Property Definition" anchor="inventlist_vcard">
<t>
Purpose: List the resources available as part of this resource.
</t>
<t>
Type value: One or more text values separated by a COMMA character
(ASCII decimal 44). <vspace />
</t>
<t>
Cardinality: (0,n)
</t>
<t>
ABNF: <vspace />
INVENTORYLIST-param = "VALUE=text" / any-param <vspace />
INVENTORYLIST-value = text
</t>
<t>
Example: <vspace />
INVENTORYLIST:projector, phone
</t>
</section>
</section>
<section title='Inventory URL' anchor="inventory">
<t>Description: <vspace />
A URL pointing to other resource URLs related to this resource. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/room1_inventory.html
</t>
<section title="LDAP Attribute Definition" anchor="invent_ldap">
<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>
</section>
<section title="VCard Property Definition" anchor="invent_vcard">
<t>
Purpose: To specify URL pointing to Inventory Information.
</t>
<t>
Type value: URI.
</t>
<t>
Cardinality: (0,n)
</t>
<t>
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>
</section>
</section>
</section>
<section title='Owner Info' anchor="owner">
<t>Description: <vspace />
Complete information on the owners of the resource. An owner is anyone who has complete authority over the resource, from naming to overall availability.
Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/room1_ownerinfo.html
</t>
<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">
<t>
Purpose: To specify URL pointing to Resource Owner Information.
</t>
<t>
Type value: URI.
</t>
<t>
Cardinality: (0,n)
</t>
<t>
ABNF: <vspace />
RESOURCEOWNERINFO-param = "VALUE=uri" / any-param <vspace />
RESOURCEOWNERINFO-value = uri
</t>
<t>
Example: <vspace />
RESOURCEOWNERINFO:http://www.example.com/room1_owner.vcf
</t>
</section>
</section>
<section title='Resource Manager Info' anchor="manager">
<t>Description: <vspace />
Information on the managers of the resource. A manager is someone responsible for the day-to-day up keep of the resource. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/room1_managerinfo.html
</t>
<section title="LDAP Attribute Definition" anchor="manager_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.0.10
NAME 'ResourceManager'
DESC 'Cal Resource Manager Info'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="manager_vcard">
<t>
Purpose: To specify URL pointing to Resource Manager Information.
</t>
<t>
Type value: URI.
</t>
<t>
Cardinality: (0,n)
</t>
<t>
ABNF: <vspace />
RESOURCEMANAGERINFO-param = "VALUE=uri" / any-param <vspace />
RESOURCEMANAGERINFO-value = uri
</t>
<t>
Example: <vspace />
RESOURCEMANAGERINFO:http://www.example.com/room1_manager.vcf
</t>
</section>
</section>
<section title='Calendar URL' anchor="cal_url">
<t>Description: <vspace />
URL to access calendar data of the resource. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/calendar/home/Room1/calendar/
</t>
<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">
<t>Description: <vspace />
URL to read freebusy information of the resource's calendar. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/freebusy/home/Room1/
</t>
<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 7.9.1 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Scheduling Address' anchor="sched_addr">
<t>Description: <vspace />
Address used for scheduling the resource by a Calendaring and Scheduling service. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
String value.
</t>
<t>Example value: <vspace />
mailto:room1@example.com
</t>
<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 7.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">
<t>Description: <vspace />
TimeZone Identifier for the timezone the resource is in. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
String value.
</t>
<t>Example value: <vspace />
America/New_York
</t>
<section title="LDAP Attribute Definition" anchor="tzid_ldap">
<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>
</section>
<section title="VCard Property Definition" anchor="tzid_vcard">
<t>
TimeZone property TZ as defined in Section 7.5.1 of <xref target='I-D.ietf-vcarddav-vcardrev' />.
</t>
</section>
</section>
<section title='Multiple Bookings' anchor="multibook">
<t>Description: <vspace />
Number of simultaneous bookings allowed. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
Integer value. <vspace />
Value of 0 indicates no limits.
</t>
<t>Example value: <vspace />
1
</t>
<section title="LDAP Attribute Definition" anchor="mbook_ldap">
<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 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="mbook_vcard">
<t>
Purpose: To specify number of simultaneous bookings allowed.
</t>
<t>
Type value: integer.
</t>
<t>
Cardinality: (0,1)
</t>
<t>
ABNF: <vspace />
MULTIBOOK-param = "VALUE=integer" / any-param <vspace />
MULTIBOOK-value = integer
</t>
<t>
Example: <vspace />
MULTIBOOK:10
</t>
</section>
</section>
<section title='Maximum Instances' anchor="max_inst">
<t>Description: <vspace />
Maximum number of instances of an event, the resource can be scheduled for from NOW. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
Integer value. <vspace />
Value of 0 indicates no limits.
</t>
<t>Example value: <vspace />
60
</t>
<section title="LDAP Attribute Definition" anchor="maxinst_ldap">
<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 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="maxinst_vcard">
<t>
Purpose: To specify maximum number of instances of an event, the resource can be scheduled for from NOW.
</t>
<t>
Type value: integer.
</t>
<t>
Cardinality: (0,1)
</t>
<t>
ABNF: <vspace />
MAXINSTANCES-param = "VALUE=integer" / any-param <vspace />
MAXINSTANCES-value = integer
</t>
<t>
Example: <vspace />
MAXINSTANCES:10
</t>
</section>
</section>
<section title='BookingWindow Start' anchor="bwin_start">
<t>Description: <vspace />
Defines how much time in advance the resource can be booked. That is, what is the earliest opportunity for booking a resource for a given date and time.
Not required for a resource scheduling query.
</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).
</t>
<t>Example value: <vspace />
-P3M
</t>
<section title="LDAP Attribute Definition" anchor="bwinstart_ldap">
<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 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="bwinstart_vcard">
<t>
Purpose: To specify how much time in advance the resource can be booked.
</t>
<t>
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).
</t>
<t>
Cardinality: (0,1)
</t>
<t>
ABNF: <vspace />
BOOKINGSTART-param = "VALUE=text" / any-param <vspace />
BOOKINGSTART-value = text
</t>
<t>
Example: <vspace />
BOOKINGSTART:-P3M
</t>
</section>
</section>
<section title='BookingWindow End' anchor="bwin_end">
<t>Description: <vspace />
Defines how much time in advance the resource booking is closed. That is, what is the latest opportunity for booking a resource for a given date or time.
Not required for a resource scheduling query.
BookingWindow Start and End together provide the window of time a resource can be booked relative to the start of the event.
</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).
</t>
<t>Example value: <vspace />
-P5D
</t>
<section title="LDAP Attribute Definition" anchor="bwinend_ldap">
<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 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="bwinend_vcard">
<t>
Purpose: To specify how much time in advance the resource booking is closed.
</t>
<t>
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).
</t>
<t>
Cardinality: (0,1)
</t>
<t>
ABNF: <vspace />
BOOKINGEND-param = "VALUE=text" / any-param <vspace />
BOOKINGEND-value = text
</t>
<t>
Example: <vspace />
BOOKINGEND:-P5D
</t>
</section>
</section>
<section title='Scheduling Approval Info' anchor="appr_info">
<t>Description: <vspace />
Information regarding approval of a scheduling request to the resource.
</t>
<t>ValueType: <vspace />
Object value.
</t>
<section title="LDAP ObjectClass Definition" anchor="appr_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.1.4
NAME 'SchedApprovalInfo'
DESC 'Calendar Sched Approval Class'
SUP CalendarResource
AUXILIARY
MAY(autoaccept $ approvalinfourl $ schedadmin) )
]]></artwork>
</section>
<section title='Auto accept' anchor="auto">
<t>Description: <vspace />
No approval required. Auto accepted. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
Boolean value.
</t>
<t>Example value: <vspace />
True
</t>
<section title="LDAP Attribute Definition" anchor="auto_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.0.16
NAME 'Autoaccept'
DESC 'Cal Scheduling auto accept'
EQUALITY booleanMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="auto_vcard">
<t>
Purpose: To specify if invitations should be automatically accepted.
</t>
<t>
Type value: Boolean.
</t>
<t>
Cardinality: (0,1)
</t>
<t>
ABNF: <vspace />
AUTOACCEPT-param = "VALUE=boolean" / any-param <vspace />
AUTOACCEPT-value = "TRUE" / "FALSE"
</t>
<t>
Example: <vspace />
AUTOACCEPT:TRUE
</t>
</section>
</section>
<section title='Approval Info URL' anchor="appr_infourl">
<t>Description: <vspace />
URL pointing to complete information on scheduling request approval process for the resource.
Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/room1_approval.html
</t>
<section title="LDAP Attribute Definition" anchor="apprinfourl_ldap">
<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>
</section>
<section title="VCard Property Definition" anchor="apprinfourl_vcard">
<t>
Purpose: To specify URL pointing to Scheduling Approval Information.
</t>
<t>
Type value: URI.
</t>
<t>
Cardinality: (0,n)
</t>
<t>
ABNF: <vspace />
APPROVALINFO-param = "VALUE=uri" / any-param <vspace />
APPROVALINFO-value = uri
</t>
<t>
Example: <vspace />
APPROVALINFO:http://www.example.com/room1_approval.html
</t>
</section>
</section>
<section title='Scheduling Admin Contact' anchor="schedadm_contact">
<t>Description: <vspace />
Contact information for the scheduling approvers, if approval required. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/SchedAdmin1.vcf
</t>
<section title="LDAP Attribute Definition" anchor="schedadm_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.0.18
NAME 'SchedAdmin'
DESC 'Cal Sched Admin Info'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="schedadm_vcard">
<t>
Purpose: To specify URL pointing to Scheduling Manager Information.
</t>
<t>
Type value: URI.
</t>
<t>
Cardinality: (0,n)
</t>
<t>
ABNF: <vspace />
SCHEDADMININFO-param = "VALUE=uri" / any-param <vspace />
SCHEDADMININFO-value = uri
</t>
<t>
Example: <vspace />
SCHEDADMININFO:http://www.example.com/SchedAdmin1.vcf
</t>
</section>
</section>
</section>
<section title='Cost' anchor="cost">
<t>Description: <vspace />
Scheduling costs for this resource.
</t>
<t>ValueType: <vspace />
Object value.
</t>
<section title="LDAP ObjectClass Definition" anchor="cost_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.1.5
NAME 'CalendarResourceCost'
DESC 'Calendar Resource Cost Object Class'
SUP CalendarResource
AUXILIARY
MAY (free $ costurl)
]]></artwork>
</section>
<section title='Free' anchor="free">
<t>Description: <vspace />
No cost for using the resource. Can be used for a resource scheduling query.
</t>
<t>ValueType: <vspace />
Boolean value.
</t>
<t>Example value: <vspace />
True
</t>
<section title="LDAP Attribute Definition" anchor="free_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.0.19
NAME 'Free'
DESC 'Free or Priced resource'
EQUALITY booleanMatch
SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="free_vcard">
<t>
Purpose: To specify if resource usage is free.
</t>
<t>
Type value: A single boolean value.
</t>
<t>
Cardinality: (0,1)
</t>
<t>
ABNF: <vspace />
FREE-param = ; no parameter allowed <vspace />
FREE-value = boolean
</t>
<t>
Example: <vspace />
FREE:True
</t>
</section>
</section>
<section title='Cost URL' anchor="cost_url">
<t>Description: <vspace />
URL pointing to complete pricing information for usage of the resource. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
URL value.
</t>
<t>Example value: <vspace />
http://www.example.com/cost.html
</t>
<section title="LDAP Attribute Definition" anchor="costurl_ldap">
<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>
</section>
<section title="VCard Property Definition" anchor="costurl_vcard">
<t>
Purpose: To specify URL pointing Resource Scheduling Cost Information.
</t>
<t>
Type value: URI.
</t>
<t>
Cardinality: (0,n)
</t>
<t>
ABNF: <vspace />
COSTINFO-param = "VALUE=uri" / any-param <vspace />
COSTINFO-value = uri
</t>
<t>
Example: <vspace />
COSTINFO:http://www.example.com/cost.html
</t>
</section>
</section>
</section>
<section title='ResourceNotes' anchor="notes">
<t>Description: <vspace />
Extra information on the resource. Not required for a resource scheduling query.
</t>
<t>ValueType: <vspace />
Text value.
</t>
<t>Example value: <vspace />
This is a special resource.
</t>
<section title="LDAP Attribute Definition" anchor="notes_ldap">
<artwork><![CDATA[
( 1.3.6.1.1.x.0.21
NAME 'ResourceNotes'
DESC 'Cal Resource Notes'
EQUALITY caseIgnoreIA5Match
SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
]]></artwork>
</section>
<section title="VCard Property Definition" anchor="notes_vcard">
<t>
NOTE property as defined in Section 6.7.2 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
calresourcekind: location
uid: 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
accessabilityurl: http://www.example.com/room1_specialaccess.html
capacity: 100
inventorylist:phone, 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
autoaccept: false
approvalinfourl: http://www.example.com/room1_approval.html
schedadmin: cn=RoomOwner,ou=Engineering,dc=example,dc=com
free: false
costurl: http://www.example.com/cost.html
resourcenotes: This is a special resource.
</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
calresourcekind: group
uid: 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
autoaccept: false
approvalinfourl: http://www.example.com/driversX_approval.html
schedadmin: cn=TransportationManager,ou=Transportation,dc=example,dc=com
free: false
costurl: http://www.example.com/driversXcost.html
resourcenotes: This is Driver Pool X with three drivers.
</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
CATEGORIES: engineering_resources
RESTRICTED-ACCESS: true
ADMISSIONINFO: http://www.example.com/room1_admittance.html
ACCESSABILITYINFO: http://www.example.com/room1_specialaccess.html
CAPACITY: 100
INVENTORYLIST: phone, projector
INVENTORYURL: http://www.example.com/room1_inventory.html
RESOURCEOWNERINFO: http://www.example.com/ResOwner1.vcf
RESOURCEMANAGERINFO: 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
BOOKINGSTART:-P3M
BOOKINGEND: -P3D
AUTOACCEPT: false
APPROVALINFO: http://www.example.com/room1_approval.html
SCHEDADMININFO: http://www.example.com/SchedAdmin1.vcf
FREE: 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
RESOURCEOWNERINFO: 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
BOOKINGSTART:-P3M
BOOKINGEND: -P3D
AUTOACCEPT: false
APPROVALINFO: http://www.example.com/driversX_approval.html
SCHEDADMININFO: http://www.example.com/DriversX_SchedAdmin.vcf
FREE: 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 ='vcard_registry'>
<t>
A new IANA token 'resource', that can be used as a value representing a Resource in a VCard,
as defined in <xref target="reskind_vcard" /> needs to be registered.
In addition, 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>SPECIALACCESS</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>INVENTORYINFO</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>BOOKINGSTART</c>
<c><xref target="bwinstart_vcard" /></c>
<c>BOOKINGEND</c>
<c><xref target="bwinend_vcard" /></c>
<c>AUTOACCEPT</c>
<c><xref target="auto_vcard" /></c>
<c>APPROVALINFO</c>
<c><xref target="apprinfourl_vcard" /></c>
<c>APPROVERINFO</c>
<c><xref target="schedadm_vcard" /></c>
<c>FREE</c>
<c><xref target="free_vcard" /></c>
<c>COST</c>
<c><xref target="costurl_vcard" /></c>
</texttable>
</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, and Jason Miller.
</t>
</section>
</middle>
<back>
<references title='Normative References'>
&RFC2119;
&RFC4519;
&RFC2739;
&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:27:40 |