idnits 2.17.1 draft-cal-resource-schema-03.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- == There are 1 instance of lines with non-RFC6890-compliant IPv4 addresses in the document. If these are example addresses, they should be changed. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year -- The document date (November 29, 2010) is 4898 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Outdated reference: A later version (-22) exists of draft-ietf-vcarddav-vcardrev-13 Summary: 0 errors (**), 0 flaws (~~), 3 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Network Working Group C. Joy 3 Internet-Draft Oracle 4 Intended status: Standards Track C. Daboo 5 Expires: June 2, 2011 Apple Inc. 6 M. Douglass 7 RPI 8 November 29, 2010 10 Schema for representing resources for calendaring and scheduling 11 services 12 draft-cal-resource-schema-03 14 Abstract 16 This specification describes a schema for representing resources for 17 calendaring and scheduling. A resource in the scheduling context is 18 any shared entity that can be scheduled by a calendar user, but does 19 not control its own attendance status. 21 Status of This Memo 23 This Internet-Draft is submitted in full conformance with the 24 provisions of BCP 78 and BCP 79. 26 Internet-Drafts are working documents of the Internet Engineering 27 Task Force (IETF). Note that other groups may also distribute 28 working documents as Internet-Drafts. The list of current Internet- 29 Drafts is at http://datatracker.ietf.org/drafts/current/. 31 Internet-Drafts are draft documents valid for a maximum of six months 32 and may be updated, replaced, or obsoleted by other documents at any 33 time. It is inappropriate to use Internet-Drafts as reference 34 material or to cite them other than as "work in progress." 36 This Internet-Draft will expire on June 2, 2011. 38 Copyright Notice 40 Copyright (c) 2010 IETF Trust and the persons identified as the 41 document authors. All rights reserved. 43 This document is subject to BCP 78 and the IETF Trust's Legal 44 Provisions Relating to IETF Documents 45 (http://trustee.ietf.org/license-info) in effect on the date of 46 publication of this document. Please review these documents 47 carefully, as they describe your rights and restrictions with respect 48 to this document. Code Components extracted from this document must 49 include Simplified BSD License text as described in Section 4.e of 50 the Trust Legal Provisions and are provided without warranty as 51 described in the Simplified BSD License. 53 Table of Contents 55 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 5 56 2. Conventions Used in This Document . . . . . . . . . . . . . . 5 57 3. General Considerations . . . . . . . . . . . . . . . . . . . . 5 58 4. Resource Object . . . . . . . . . . . . . . . . . . . . . . . 5 59 4.1. LDAP Resource ObjectClass Definition . . . . . . . . . . . 5 60 5. Resource Attributes . . . . . . . . . . . . . . . . . . . . . 6 61 5.1. Common Name . . . . . . . . . . . . . . . . . . . . . . . 6 62 5.1.1. LDAP Attribute Definition . . . . . . . . . . . . . . 6 63 5.1.2. VCard Property Definition . . . . . . . . . . . . . . 6 64 5.2. Kind . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 65 5.2.1. LDAP Attribute Definition . . . . . . . . . . . . . . 7 66 5.2.2. VCard Property Definition . . . . . . . . . . . . . . 7 67 5.3. Unique ID . . . . . . . . . . . . . . . . . . . . . . . . 7 68 5.3.1. LDAP Attribute Definition . . . . . . . . . . . . . . 7 69 5.3.2. VCard Property Definition . . . . . . . . . . . . . . 8 70 5.4. Nick Name . . . . . . . . . . . . . . . . . . . . . . . . 8 71 5.4.1. LDAP Attribute Definition . . . . . . . . . . . . . . 8 72 5.4.2. VCard Property Definition . . . . . . . . . . . . . . 8 73 5.5. Description . . . . . . . . . . . . . . . . . . . . . . . 8 74 5.5.1. LDAP Attribute Definition . . . . . . . . . . . . . . 8 75 5.5.2. VCard Property Definition . . . . . . . . . . . . . . 9 76 5.6. Organizational Unit . . . . . . . . . . . . . . . . . . . 9 77 5.6.1. LDAP Attribute Definition . . . . . . . . . . . . . . 9 78 5.6.2. VCard Property Definition . . . . . . . . . . . . . . 9 79 5.7. Categories . . . . . . . . . . . . . . . . . . . . . . . . 9 80 5.7.1. LDAP Attribute Definition . . . . . . . . . . . . . . 9 81 5.7.2. VCard Property Definition . . . . . . . . . . . . . . 10 82 5.8. Group Member . . . . . . . . . . . . . . . . . . . . . . . 10 83 5.8.1. LDAP Attribute Definition . . . . . . . . . . . . . . 10 84 5.8.2. VCard Property Definition . . . . . . . . . . . . . . 10 85 5.9. Admittance Info . . . . . . . . . . . . . . . . . . . . . 10 86 5.9.1. LDAP ObjectClass Definition . . . . . . . . . . . . . 10 87 5.9.2. Restricted Access . . . . . . . . . . . . . . . . . . 11 88 5.9.2.1. LDAP Attribute Definition . . . . . . . . . . . . 11 89 5.9.2.2. VCard Property Definition . . . . . . . . . . . . 11 90 5.9.3. Admittance Info URL . . . . . . . . . . . . . . . . . 11 91 5.9.3.1. LDAP Attribute Definition . . . . . . . . . . . . 12 92 5.9.3.2. VCard Property Definition . . . . . . . . . . . . 12 93 5.10. Accessibility . . . . . . . . . . . . . . . . . . . . . . 12 94 5.10.1. LDAP Attribute Definition . . . . . . . . . . . . . . 12 95 5.10.2. VCard Property Definition . . . . . . . . . . . . . . 13 96 5.11. Capacity . . . . . . . . . . . . . . . . . . . . . . . . . 13 97 5.11.1. LDAP Attribute Definition . . . . . . . . . . . . . . 13 98 5.11.2. VCard Property Definition . . . . . . . . . . . . . . 13 99 5.12. Inventory Info . . . . . . . . . . . . . . . . . . . . . . 14 100 5.12.1. LDAP ObjectClass Definition . . . . . . . . . . . . . 14 101 5.12.2. Inventory List . . . . . . . . . . . . . . . . . . . . 14 102 5.12.2.1. LDAP Attribute Definition . . . . . . . . . . . . 14 103 5.12.2.2. VCard Property Definition . . . . . . . . . . . . 15 104 5.12.3. Inventory URL . . . . . . . . . . . . . . . . . . . . 15 105 5.12.3.1. LDAP Attribute Definition . . . . . . . . . . . . 15 106 5.12.3.2. VCard Property Definition . . . . . . . . . . . . 15 107 5.13. Owner Info . . . . . . . . . . . . . . . . . . . . . . . . 16 108 5.13.1. LDAP Attribute Definition . . . . . . . . . . . . . . 16 109 5.13.2. VCard Property Definition . . . . . . . . . . . . . . 16 110 5.14. Resource Manager Info . . . . . . . . . . . . . . . . . . 16 111 5.14.1. LDAP Attribute Definition . . . . . . . . . . . . . . 17 112 5.14.2. VCard Property Definition . . . . . . . . . . . . . . 17 113 5.15. Calendar URL . . . . . . . . . . . . . . . . . . . . . . . 17 114 5.15.1. LDAP Attribute Definition . . . . . . . . . . . . . . 17 115 5.15.2. VCard Property Definition . . . . . . . . . . . . . . 18 116 5.16. FreeBusy URL . . . . . . . . . . . . . . . . . . . . . . . 18 117 5.16.1. LDAP Attribute Definition . . . . . . . . . . . . . . 18 118 5.16.2. VCard Property Definition . . . . . . . . . . . . . . 18 119 5.17. Scheduling Address . . . . . . . . . . . . . . . . . . . . 18 120 5.17.1. LDAP Attribute Definition . . . . . . . . . . . . . . 18 121 5.17.2. VCard Property Definition . . . . . . . . . . . . . . 19 122 5.18. Time Zone . . . . . . . . . . . . . . . . . . . . . . . . 19 123 5.18.1. LDAP Attribute Definition . . . . . . . . . . . . . . 19 124 5.18.2. VCard Property Definition . . . . . . . . . . . . . . 19 125 5.19. Multiple Bookings . . . . . . . . . . . . . . . . . . . . 19 126 5.19.1. LDAP Attribute Definition . . . . . . . . . . . . . . 20 127 5.19.2. VCard Property Definition . . . . . . . . . . . . . . 20 128 5.20. Maximum Instances . . . . . . . . . . . . . . . . . . . . 20 129 5.20.1. LDAP Attribute Definition . . . . . . . . . . . . . . 20 130 5.20.2. VCard Property Definition . . . . . . . . . . . . . . 21 131 5.21. BookingWindow Start . . . . . . . . . . . . . . . . . . . 21 132 5.21.1. LDAP Attribute Definition . . . . . . . . . . . . . . 22 133 5.21.2. VCard Property Definition . . . . . . . . . . . . . . 22 134 5.22. BookingWindow End . . . . . . . . . . . . . . . . . . . . 22 135 5.22.1. LDAP Attribute Definition . . . . . . . . . . . . . . 23 136 5.22.2. VCard Property Definition . . . . . . . . . . . . . . 23 137 5.23. Scheduling Approval Info . . . . . . . . . . . . . . . . . 24 138 5.23.1. LDAP ObjectClass Definition . . . . . . . . . . . . . 24 139 5.23.2. Auto schedule . . . . . . . . . . . . . . . . . . . . 24 140 5.23.2.1. LDAP Attribute Definition . . . . . . . . . . . . 24 141 5.23.2.2. VCard Property Definition . . . . . . . . . . . . 24 142 5.23.3. Approval Info URL . . . . . . . . . . . . . . . . . . 25 143 5.23.3.1. LDAP Attribute Definition . . . . . . . . . . . . 25 144 5.23.3.2. VCard Property Definition . . . . . . . . . . . . 25 146 5.23.4. Scheduling Admin Contact . . . . . . . . . . . . . . . 26 147 5.23.4.1. LDAP Attribute Definition . . . . . . . . . . . . 26 148 5.23.4.2. VCard Property Definition . . . . . . . . . . . . 26 149 5.24. Cost . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 150 5.24.1. LDAP ObjectClass Definition . . . . . . . . . . . . . 27 151 5.24.2. Nocost . . . . . . . . . . . . . . . . . . . . . . . . 27 152 5.24.2.1. LDAP Attribute Definition . . . . . . . . . . . . 27 153 5.24.2.2. VCard Property Definition . . . . . . . . . . . . 27 154 5.24.3. Cost URL . . . . . . . . . . . . . . . . . . . . . . . 28 155 5.24.3.1. LDAP Attribute Definition . . . . . . . . . . . . 28 156 5.24.3.2. VCard Property Definition . . . . . . . . . . . . 28 157 5.25. Related . . . . . . . . . . . . . . . . . . . . . . . . . 28 158 5.25.1. LDAP Attribute Definition . . . . . . . . . . . . . . 29 159 5.25.2. VCard Property Definition . . . . . . . . . . . . . . 29 160 6. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 161 6.1. LDAP Examples . . . . . . . . . . . . . . . . . . . . . . 29 162 6.1.1. Location Resource . . . . . . . . . . . . . . . . . . 29 163 6.1.2. Role Resources Group . . . . . . . . . . . . . . . . . 30 164 6.2. VCard Examples . . . . . . . . . . . . . . . . . . . . . . 31 165 6.2.1. Location Resource . . . . . . . . . . . . . . . . . . 31 166 6.2.2. Role Resources Group . . . . . . . . . . . . . . . . . 32 167 7. Security Considerations . . . . . . . . . . . . . . . . . . . 33 168 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 33 169 8.1. LDAP Objectclass and Attribute Registration . . . . . . . 33 170 8.2. VCard Property Registration . . . . . . . . . . . . . . . 35 171 9. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 36 172 10. Normative References . . . . . . . . . . . . . . . . . . . . . 36 174 1. Introduction 176 This specification defines a schema for representing resources to 177 ease the discovery and scheduling of resources between any calendar 178 client and server. 179 LDAP and vCard mappings of the schema are described in this document. 180 The Object model chosen is the lowest common denominator to adapt for 181 LDAP. 183 2. Conventions Used in This Document 185 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 186 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 187 document are to be interpreted as described in [RFC2119]. 189 3. General Considerations 191 Data values must have valid representation for the chosen format with 192 respect to escape characters, line folding, and so on. 194 4. Resource Object 196 A resource object definition should contain all information required 197 to find and schedule the right resource. For this, it should contain 198 all, or a set of the attributes described in Section 5. The cn 199 attribute, described in Section 5.1 MUST be present in any resource 200 object. Additional proprietary attributes may be defined as well, 201 but must begin with "X-". Clients encountering attributes they don't 202 know about must ignore them. 204 Attributes or Properties required to contact the resource are not 205 included in this specification. LDAP attributes defined in [RFC4519] 206 and VCARD properties defined in vCard Format Specification 207 [I-D.ietf-vcarddav-vcardrev] can be used to include contact 208 information for the resource. 210 4.1. LDAP Resource ObjectClass Definition 212 In LDAP, a resource object SHOULD be defined as an objectclass with 213 attributes as defined in Section 5. This objectClass MUST be an 214 auxiliary class. Its Superior class is the calEntry objectClass as 215 defined in Section 2.4.3.1 of [RFC2739]. 216 Definition of the CalendarResource ObjectClass: 218 ( 1.3.6.1.1.x.1.1 219 NAME 'CalendarResource' 220 DESC 'Calendar Resource Object Class' 221 SUP calEntry 222 AUXILIARY 223 MUST (cn) 224 MAY (kind $ nickname $ description $ ou $ categories $ 225 member $ uniquemember $ accessibilityurl $ capacity $ 226 owner $ resourcemanager $ timezoneid $ 227 multiplebookings $ maxinstances $ 228 bookingwindowstart $ bookingwindowend $ 229 vcarduid $ related) ) 231 5. Resource Attributes 233 5.1. Common Name 235 Description: 236 Full name of the resource. This attribute MUST be defined for a 237 resource object. 239 ValueType: 240 String value. 242 Example value: 243 Room One 245 5.1.1. LDAP Attribute Definition 247 cn attribute as defined in Section 2.3 of [RFC4519]. This attribute 248 MUST be present in a CalendarResource object. 250 5.1.2. VCard Property Definition 252 FN property as defined in Section 7.2.1 of 253 [I-D.ietf-vcarddav-vcardrev]. 255 5.2. Kind 257 Description: 258 The kind of object represented. 260 ValueType: 261 Some of the possible values are "Location", "Thing", or "Group". 262 Location is used for any physical location resource such as room, 263 building, etc. 264 Thing is used for any physical object that can scheduled like 265 projector, printer, etc. 267 Group is used to specify a group of resources with a specific 268 skill set. For example: drivers, electricians, etc. 270 Example value: 271 Location 273 5.2.1. LDAP Attribute Definition 275 Definition of the kind LDAP attribute: 277 ( 1.3.6.1.1.x.0.1 278 NAME 'Kind' 279 DESC 'Kind of Object' 280 EQUALITY caseIgnoreMatch 281 SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 282 SINGLE-VALUE ) 284 5.2.2. VCard Property Definition 286 Property KIND that specifies the kind of object represented, as 287 defined in Section 6.1.5 of [I-D.ietf-vcarddav-vcardrev]. 289 5.3. Unique ID 291 Description: 292 A Unique Identifier. 294 ValueType: 295 Single string value. 297 Example value: 298 room1-id1 300 5.3.1. LDAP Attribute Definition 302 Definition of the vcarduid LDAP attribute: 304 ( 1.3.6.1.1.x.0.1 305 NAME 'VcardUid' 306 DESC 'VCard UniqueID' 307 EQUALITY caseExactMatch 308 SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 309 SINGLE-VALUE ) 311 5.3.2. VCard Property Definition 313 UID property as defined in Section 6.7.7 of 314 [I-D.ietf-vcarddav-vcardrev]. 316 5.4. Nick Name 318 Description: 319 A short or popular name for the resource. 321 ValueType: 322 String value. 324 Example value: 325 TheOne 327 5.4.1. LDAP Attribute Definition 329 Definition of the nickname LDAP attribute: 331 ( 1.3.6.1.1.x.0.2 332 NAME 'NickName' 333 DESC 'Nick Name' 334 EQUALITY caseIgnoreIA5Match 335 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 337 5.4.2. VCard Property Definition 339 NICKNAME property as defined in Section 7.2.3 of 340 [I-D.ietf-vcarddav-vcardrev]. 342 5.5. Description 344 Description: 345 Description of the resource. 347 ValueType: 348 String value. 350 Example value: 351 Room 1 in Building X 353 5.5.1. LDAP Attribute Definition 355 description attribute as defined in Section 2.5 of [RFC4519]. 357 5.5.2. VCard Property Definition 359 NOTE property as defined in Section 7.7.2 of 360 [I-D.ietf-vcarddav-vcardrev]. 362 5.6. Organizational Unit 364 Description: 365 Organizations the resource belongs to. 367 ValueType: 368 String value. 370 Example value: 371 EngineeringDepartment 373 5.6.1. LDAP Attribute Definition 375 ou attribute as defined in Section 2.20 of [RFC4519]. 377 5.6.2. VCard Property Definition 379 ORG property as defined in Section 7.6.4 of 380 [I-D.ietf-vcarddav-vcardrev]. 382 5.7. Categories 384 Description: 385 Categories the resource falls under or tags for easy discovery of 386 the resource. 388 ValueType: 389 String value. 391 Example value: 392 Rooms, EngineeringResources 394 5.7.1. LDAP Attribute Definition 396 Definition of the categories LDAP attribute: 398 ( 1.3.6.1.1.x.0.3 399 NAME 'Categories' 400 DESC 'Categories' 401 EQUALITY caseIgnoreIA5Match 402 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 404 5.7.2. VCard Property Definition 406 CATEGORIES property as defined in Section 6.7.1 of 407 [I-D.ietf-vcarddav-vcardrev]. 409 5.8. Group Member 411 Description: 412 List of unique resources in a group of resources object. 414 ValueType: 415 URL value. 417 Example value: 418 http://www.example.com/printer1.html 419 http://www.example.com/printer2.html 421 5.8.1. LDAP Attribute Definition 423 member attribute as defined in Section 2.17 or uniquemember attribute 424 as defined in Section 2.40 of [RFC4519]. 426 5.8.2. VCard Property Definition 428 MEMBER property as defined in Section 7.6.5 of 429 [I-D.ietf-vcarddav-vcardrev]. 431 5.9. Admittance Info 433 Description: 434 Information required to gain access to the resource. 436 ValueType: 437 Object value. 439 5.9.1. LDAP ObjectClass Definition 441 Definition of the admittanceinfo LDAP objectclass: 443 ( 1.3.6.1.1.x.1.2 444 NAME 'AdmittanceInfo' 445 DESC 'Calendar Resource Admittance Info Class' 446 SUP CalendarResource 447 AUXILIARY 448 MAY (admittanceurl $ restricted) ) 450 5.9.2. Restricted Access 452 Description: 453 Is access to the resource restricted? 455 ValueType: 456 Boolean value. 458 Example value: 459 TRUE 461 5.9.2.1. LDAP Attribute Definition 463 Definition of the restricted LDAP attribute: 465 ( 1.3.6.1.1.x.0.4 466 NAME 'Restricted' 467 DESC 'Access Restricted' 468 EQUALITY booleanMatch 469 SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 ) 471 5.9.2.2. VCard Property Definition 473 Purpose: To specify if access is restricted or not. 475 Type value: A single boolean value. 477 Cardinality: (0,1) 479 ABNF: 480 RESTRICTEDACCESS-param = ; no parameter allowed 481 RESTRICTEDACCESS-value = boolean 483 Example: 484 RESTRICTEDACCESSS:TRUE 486 5.9.3. Admittance Info URL 488 Description: 489 URL pointing to complete information for accessing the resource 490 including getting accessibility rights, special entrances, and so 491 on. 493 ValueType: 494 URL value. 496 Example value: 497 http://www.example.com/room1_admittance.html 499 5.9.3.1. LDAP Attribute Definition 501 Definition of the admittanceurl LDAP attribute: 503 ( 1.3.6.1.1.x.0.5 504 NAME 'AdmittanceURL' 505 DESC 'Cal Resource Admittance Info URL' 506 EQUALITY caseIgnoreIA5Match 507 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 509 5.9.3.2. VCard Property Definition 511 Purpose: To specify URL pointing to Admission Information. 513 Type value: URI. 515 Cardinality: (0,n) 517 ABNF: 518 ADMISSIONINFO-param = "VALUE=uri" / any-param 519 ADMISSIONINFO-value = uri 521 Example: 522 ADMISSIONINFO:http://www.example.com/room1_admittance.html 524 5.10. Accessibility 526 Description: 527 Special resource accessibility info for the physically disabled. 529 ValueType: 530 URL value. 532 Example value: 533 http://www.example.com/room1_specialaccess.html 535 5.10.1. LDAP Attribute Definition 537 Definition of the accessibilityurl LDAP attribute: 539 ( 1.3.6.1.1.x.0.6 540 NAME 'accessibilityURL' 541 DESC 'Cal Resource accessibility Info URL' 542 EQUALITY caseIgnoreIA5Match 543 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 545 5.10.2. VCard Property Definition 547 Purpose: To specify URL pointing to Disabled Access Information. 549 Type value: URI. 551 Cardinality: (0,n) 553 ABNF: 554 ACCESSIBILITYINFO-param = "VALUE=uri" / any-param 555 ACCESSIBILITYINFO-value = uri 557 Example: 558 ACCESSIBILITYINFO:http://www.example.com/room1_specialaccess.html 560 5.11. Capacity 562 Description: 563 Capacity of the resource. 565 ValueType: 566 Integer. 568 Example value: 569 10 571 5.11.1. LDAP Attribute Definition 573 Definition of the capacity LDAP attribute: 575 ( 1.3.6.1.1.x.0.7 576 NAME 'Capacity' 577 DESC 'Cal Resource Capacity' 578 EQUALITY caseIgnoreIA5Match 579 SYNTAX 1.3.6.1.4.1.1466.115.121.1.27 ) 581 5.11.2. VCard Property Definition 583 Purpose: To specify Capacity Information. 585 Type value: integer. 587 Cardinality: (0,n) 589 ABNF: 590 CAPACITY-param = "VALUE=integer" / any-param 591 CAPACITY-value = integer 592 Example: 593 CAPACITY:10 595 5.12. Inventory Info 597 Description: 598 Information on resources available as part of this resource. 600 ValueType: 601 Object value. 603 5.12.1. LDAP ObjectClass Definition 605 Definition of the inventoryinfo LDAP attribute: 607 ( 1.3.6.1.1.x.1.3 608 NAME 'InventoryInfo' 609 DESC 'Calendar Resource Inventory Info Class' 610 SUP CalendarResource 611 AUXILIARY 612 MAY (inventorylist $ inventoryurl) ) 614 5.12.2. Inventory List 616 Description: 617 List of resources available as part of this resource. 619 ValueType: 620 String value. One or more text values separated by a COMMA 621 character. 623 Example value: 624 Printer, Projector 626 5.12.2.1. LDAP Attribute Definition 628 Definition of the inventorylist LDAP attribute: 630 ( 1.3.6.1.1.x.0.8 631 NAME 'InventoryList' 632 DESC 'Inventory List' 633 EQUALITY caseIgnoreIA5Match 634 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 636 5.12.2.2. VCard Property Definition 638 Purpose: List the resources available as part of this resource. 640 Type value: One or more text values separated by a COMMA character 641 (ASCII decimal 44). 643 Cardinality: (0,n) 645 ABNF: 646 INVENTORYLIST-param = "VALUE=text" / any-param 647 INVENTORYLIST-value = text 649 Example: 650 INVENTORYLIST:projector, phone 652 5.12.3. Inventory URL 654 Description: 655 A URL pointing to other resource URLs part of this resource. 657 ValueType: 658 URL value. 660 Example value: 661 http://www.example.com/room1_inventory.html 663 5.12.3.1. LDAP Attribute Definition 665 Definition of the inventoryurl LDAP attribute: 667 ( 1.3.6.1.1.x.0.9 668 NAME 'InventoryURL' 669 DESC 'Cal Resource Inventory Info URL' 670 EQUALITY caseIgnoreIA5Match 671 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 673 5.12.3.2. VCard Property Definition 675 Purpose: To specify URL pointing to Inventory Information. 677 Type value: URI. 679 Cardinality: (0,n) 680 ABNF: 681 INVENTORYURL-param = "VALUE=uri" / any-param 682 INVENTORYURL-value = uri 684 Example: 685 INVENTORYURL:http://www.example.com/room1_inventory.html 687 5.13. Owner Info 689 Description: 690 Complete information on the owners of the resource. An owner is 691 anyone who has complete authority over the resource, from naming 692 to overall availability. 694 ValueType: 695 URL value. 697 Example value: 698 http://www.example.com/room1_ownerinfo.html 700 5.13.1. LDAP Attribute Definition 702 owner attribute as defined in Section 2.21 of [RFC4519]. 704 5.13.2. VCard Property Definition 706 Purpose: To specify URL pointing to Resource Owner Information. 708 Type value: URI. 710 Cardinality: (0,n) 712 ABNF: 713 RESOURCEOWNERINFO-param = "VALUE=uri" / any-param 714 RESOURCEOWNERINFO-value = uri 716 Example: 717 RESOURCEOWNERINFO:http://www.example.com/room1_owner.vcf 719 5.14. Resource Manager Info 721 Description: 722 Information on the managers of the resource. A manager is someone 723 responsible for the day-to-day up keep of the resource. 725 ValueType: 726 URL value. 728 Example value: 729 http://www.example.com/room1_managerinfo.html 731 5.14.1. LDAP Attribute Definition 733 Definition of the resourcemanager LDAP attribute: 735 ( 1.3.6.1.1.x.0.10 736 NAME 'ResourceManager' 737 DESC 'Cal Resource Manager Info' 738 EQUALITY caseIgnoreIA5Match 739 SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 ) 741 5.14.2. VCard Property Definition 743 Purpose: To specify URL pointing to Resource Manager Information. 745 Type value: URI. 747 Cardinality: (0,n) 749 ABNF: 750 RESOURCEMANAGERINFO-param = "VALUE=uri" / any-param 751 RESOURCEMANAGERINFO-value = uri 753 Example: 754 RESOURCEMANAGERINFO:http://www.example.com/room1_manager.vcf 756 5.15. Calendar URL 758 Description: 759 URL to access calendar data of the resource. 761 ValueType: 762 URL value. 764 Example value: 765 http://www.example.com/calendar/home/Room1/calendar/ 767 5.15.1. LDAP Attribute Definition 769 Calendar access attribute calCAPURI as defined in Section 2.4.4.3 and 770 calOtherCAPURIs as defined in Section 2.4.4.7 of [RFC2739] 771 respectively. 773 5.15.2. VCard Property Definition 775 Calendar access property CAPURI as defined in Section 2.3.3 of 776 [RFC2739]. 778 5.16. FreeBusy URL 780 Description: 781 URL to read freebusy information of the resource's calendar. 783 ValueType: 784 URL value. 786 Example value: 787 http://www.example.com/freebusy/home/Room1/ 789 5.16.1. LDAP Attribute Definition 791 Calendar access attribute calFBURL as defined in Section 2.4.4.2 and 792 calOtherFBURLs as defined in Section 2.4.4.6 of [RFC2739] 793 respectively. 795 5.16.2. VCard Property Definition 797 FBURL attribute as defined in Section 2.3.1 of [RFC2739] and further 798 explained in Section 7.9.1 of [I-D.ietf-vcarddav-vcardrev]. 800 5.17. Scheduling Address 802 Description: 803 Address used for scheduling the resource by a Calendaring and 804 Scheduling service. 806 ValueType: 807 String value. 809 Example value: 810 mailto:room1@example.com 812 5.17.1. LDAP Attribute Definition 814 Scheduling Address attribute calCalAdrURI as defined in Section 815 2.4.4.4 and calOtherCalAdrURIs as defined in Section 2.4.4.8 of 816 [RFC2739] respectively. This is the address that would be used by a 817 Scheduling and Calendaring application to schedule the resource. Its 818 value must be a uri string, in most cases a mailto: uri. The mail 819 attribute value of the resource should be used for scheduling, in the 820 absence of this attribute. 822 5.17.2. VCard Property Definition 824 Scheduling Address property CALADRURI as defined in Section 2.3.2 825 [RFC2739] and further explained in Section 7.9.2 of 826 [I-D.ietf-vcarddav-vcardrev]. This is the address that would be used 827 by a Scheduling and Calendaring application to schedule the resource. 828 Its value must be a uri string, in most cases a mailto: uri. The 829 EMAIL property value of the resource should be used for scheduling, 830 in the absence of this attribute. 832 5.18. Time Zone 834 Description: 835 TimeZone Identifier for the timezone the resource is in. 837 ValueType: 838 String value. 840 Example value: 841 America/New_York 843 5.18.1. LDAP Attribute Definition 845 Definition of the timezoneid LDAP attribute: 847 ( 1.3.6.1.1.x.0.11 848 NAME 'TimeZoneID' 849 DESC 'Cal Time Zone ID' 850 EQUALITY caseIgnoreIA5Match 851 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 853 5.18.2. VCard Property Definition 855 TimeZone property TZ as defined in Section 7.5.1 of 856 [I-D.ietf-vcarddav-vcardrev]. 858 5.19. Multiple Bookings 860 Description: 861 Number of simultaneous bookings allowed. 863 ValueType: 864 Integer value. 865 Value of 0 indicates no limits. 867 Example value: 868 1 870 5.19.1. LDAP Attribute Definition 872 Definition of the multiplebookings LDAP attribute: 874 ( 1.3.6.1.1.x.0.12 875 NAME 'Multiplebookings' 876 DESC 'Cal Num Bookings Allowed' 877 EQUALITY integerMatch 878 SYNTAX 1.3.6.1.4.1.1466.115.121.1.27 ) 880 5.19.2. VCard Property Definition 882 Purpose: To specify number of simultaneous bookings allowed. 884 Type value: integer. 886 Cardinality: (0,1) 888 ABNF: 889 MULTIBOOK-param = "VALUE=integer" / any-param 890 MULTIBOOK-value = integer 892 Example: 893 MULTIBOOK:10 895 5.20. Maximum Instances 897 Description: 898 Maximum number of instances of an event, the resource can be 899 scheduled for from NOW. 901 ValueType: 902 Integer value. 903 Value of 0 indicates no limits. 905 Example value: 906 60 908 5.20.1. LDAP Attribute Definition 910 Definition of the maxinstances LDAP attribute: 912 ( 1.3.6.1.1.x.0.13 913 NAME 'MaxInstances' 914 DESC 'Cal Maximum Instances allowed' 915 EQUALITY integerMatch 916 SYNTAX 1.3.6.1.4.1.1466.115.121.1.27 ) 918 5.20.2. VCard Property Definition 920 Purpose: To specify maximum number of instances of an event, the 921 resource can be scheduled for from NOW. 923 Type value: integer. 925 Cardinality: (0,1) 927 ABNF: 928 MAXINSTANCES-param = "VALUE=integer" / any-param 929 MAXINSTANCES-value = integer 931 Example: 932 MAXINSTANCES:10 934 5.21. BookingWindow Start 936 Description: 937 Defines how much time in advance the resource can be booked. The 938 value of this property is used to calculate the earliest date and 939 time when a resource can be reserved for an event starting on a 940 specific date and time. 941 If this property value is defined, the resource may be booked for 942 an event at a certain time, only if the current time is equal to 943 or after the date and time calculated by subtracting this value 944 from the event's proposed start time. If this property is absent, 945 then the resource may be booked at any time before the end of the 946 booking window. 948 ValueType: Duration value. 949 The format is based on the [ISO.8601.2004] duration representation 950 basic format with designators for the duration of time. The 951 format can represent nominal durations (weeks and days) and 952 accurate durations (hours, minutes, and seconds). 954 Example value: 955 P3M 957 5.21.1. LDAP Attribute Definition 959 Definition of the bookingwindowstart LDAP attribute: 961 ( 1.3.6.1.1.x.0.14 962 NAME 'BookingWindowStart' 963 DESC 'Cal Booking Window Start' 964 EQUALITY caseIgnoreIA5Match 965 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 967 5.21.2. VCard Property Definition 969 Purpose: To specify how much time in advance the resource can be 970 booked. 972 Type value: duration. 973 The format is based on the [ISO.8601.2004] duration representation 974 basic format with designators for the duration of time. The 975 format can represent nominal durations (weeks and days) and 976 accurate durations (hours, minutes, and seconds). 978 Cardinality: (0,1) 980 ABNF: 981 BOOKINGWINDOWSTART-param = "VALUE=text" / any-param 982 BOOKINGWINDOWSTART-value = text 984 Example: 985 BOOKINGWINDOWSTART:P3M 987 5.22. BookingWindow End 989 Description: 990 Defines how much time in advance the resource booking is closed. 991 The value of this property is used to calculate the latest date 992 and time when a resource can be reserved for an event starting on 993 a specific date and time. 994 If the current time is equal to or before the value obtained by 995 subtracting BookingWindowEnd from the start date and time of the 996 event, then the resource may be booked. If this property is 997 absent, then the resource may be booked anytime from booking 998 window start to the start of the event. 999 BookingWindow Start and End together provide the window of time a 1000 resource can be booked, relative to the start time of the event. 1002 If BookingWindowStart = BwS, 1003 BookingWindowEnd = BwE, 1004 Current Time = CT and 1005 Event Start Time = ST, 1006 a resource can be booked at a certain time only if 1007 CT is equal to or after (ST - BwS) 1008 and CT is equal to or before (ST - BwE) 1010 ValueType: Duration value. 1011 The format is based on the [ISO.8601.2004] duration representation 1012 basic format with designators for the duration of time. The 1013 format can represent nominal durations (weeks and days) and 1014 accurate durations (hours, minutes, and seconds). 1016 Example value: 1017 P5D 1019 5.22.1. LDAP Attribute Definition 1021 Definition of the bookingwindowend LDAP attribute: 1023 ( 1.3.6.1.1.x.0.15 1024 NAME 'BookingWindowEnd' 1025 DESC 'Cal Booking Window End' 1026 EQUALITY caseIgnoreIA5Match 1027 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 1029 5.22.2. VCard Property Definition 1031 Purpose: To specify how much time in advance the resource booking is 1032 closed. 1034 Type value: duration. 1035 The format is based on the [ISO.8601.2004] duration representation 1036 basic format with designators for the duration of time. The 1037 format can represent nominal durations (weeks and days) and 1038 accurate durations (hours, minutes, and seconds). 1040 Cardinality: (0,1) 1042 ABNF: 1043 BOOKINGWINDOWEND-param = "VALUE=text" / any-param 1044 BOOKINGWINDOWEND-value = text 1046 Example: 1047 BOOKINGWINDOWEND:P5D 1049 5.23. Scheduling Approval Info 1051 Description: 1052 Information regarding approval of a scheduling request to the 1053 resource. 1055 ValueType: 1056 Object value. 1058 5.23.1. LDAP ObjectClass Definition 1060 Definition of the schedapprovalinfo LDAP objectclass: 1062 ( 1.3.6.1.1.x.1.4 1063 NAME 'SchedApprovalInfo' 1064 DESC 'Calendar Sched Approval Class' 1065 SUP CalendarResource 1066 AUXILIARY 1067 MAY (autoschedule $ approvalinfourl $ schedadmin) ) 1069 5.23.2. Auto schedule 1071 Description: 1072 No approval required. Automatically scheduled. 1074 ValueType: 1075 Boolean value. 1077 Example value: 1078 TRUE 1080 5.23.2.1. LDAP Attribute Definition 1082 Definition of the autoschedule LDAP attribute: 1084 ( 1.3.6.1.1.x.0.16 1085 NAME 'Autoschedule' 1086 DESC 'Cal Scheduling no approval required' 1087 EQUALITY booleanMatch 1088 SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 ) 1090 5.23.2.2. VCard Property Definition 1092 Purpose: To specify if invitations should be automatically 1093 scheduled. 1095 Type value: Boolean. 1097 Cardinality: (0,1) 1099 ABNF: 1100 AUTOSCHEDULE-param = "VALUE=boolean" / any-param 1101 AUTOSCHEDULE-value = "TRUE" / "FALSE" 1103 Example: 1104 AUTOSCHEDULE:TRUE 1106 5.23.3. Approval Info URL 1108 Description: 1109 URL pointing to complete information on scheduling request 1110 approval process for the resource. 1112 ValueType: 1113 URL value. 1115 Example value: 1116 http://www.example.com/room1_approval.html 1118 5.23.3.1. LDAP Attribute Definition 1120 Definition of the approvalinfourl LDAP attribute: 1122 ( 1.3.6.1.1.x.0.17 1123 NAME 'ApprovalInfoURL' 1124 DESC 'Cal Sched Approval Info' 1125 EQUALITY caseIgnoreIA5Match 1126 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 1128 5.23.3.2. VCard Property Definition 1130 Purpose: To specify URL pointing to Scheduling Approval Information. 1132 Type value: URI. 1134 Cardinality: (0,n) 1136 ABNF: 1137 APPROVALINFO-param = "VALUE=uri" / any-param 1138 APPROVALINFO-value = uri 1140 Example: 1141 APPROVALINFO:http://www.example.com/room1_approval.html 1143 5.23.4. Scheduling Admin Contact 1145 Description: 1146 Contact information for the scheduling approvers, if approval 1147 required. 1149 ValueType: 1150 URL value. 1152 Example value: 1153 http://www.example.com/SchedAdmin1.vcf 1155 5.23.4.1. LDAP Attribute Definition 1157 Definition of the schedadmin LDAP attribute: 1159 ( 1.3.6.1.1.x.0.18 1160 NAME 'SchedAdmin' 1161 DESC 'Cal Sched Admin Info' 1162 EQUALITY caseIgnoreIA5Match 1163 SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 ) 1165 5.23.4.2. VCard Property Definition 1167 Purpose: To specify URL pointing to Scheduling Manager Information. 1169 Type value: URI. 1171 Cardinality: (0,n) 1173 ABNF: 1174 SCHEDADMININFO-param = "VALUE=uri" / any-param 1175 SCHEDADMININFO-value = uri 1177 Example: 1178 SCHEDADMININFO:http://www.example.com/SchedAdmin1.vcf 1180 5.24. Cost 1182 Description: 1183 Scheduling costs for this resource. 1185 ValueType: 1186 Object value. 1188 5.24.1. LDAP ObjectClass Definition 1190 Definition of the cost LDAP objectclass: 1192 ( 1.3.6.1.1.x.1.5 1193 NAME 'CalendarResourceCost' 1194 DESC 'Calendar Resource Cost Object Class' 1195 SUP CalendarResource 1196 AUXILIARY 1197 MAY (nocost $ costurl) 1199 5.24.2. Nocost 1201 Description: 1202 No cost for using the resource. Can be used for a resource 1203 scheduling query. 1205 ValueType: 1206 Boolean value. 1208 Example value: 1209 TRUE 1211 5.24.2.1. LDAP Attribute Definition 1213 Definition of the nocost LDAP attribute: 1215 ( 1.3.6.1.1.x.0.19 1216 NAME 'Nocost' 1217 DESC 'Free or Priced resource' 1218 EQUALITY booleanMatch 1219 SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 ) 1221 5.24.2.2. VCard Property Definition 1223 Purpose: To specify if resource usage is free. 1225 Type value: A single boolean value. 1227 Cardinality: (0,1) 1229 ABNF: 1230 NOCOST-param = ; no parameter allowed 1231 NOCOST-value = boolean 1233 Example: 1234 NOCOST:TRUE 1236 5.24.3. Cost URL 1238 Description: 1239 URL pointing to complete pricing information for usage of the 1240 resource. 1242 ValueType: 1243 URL value. 1245 Example value: 1246 http://www.example.com/cost.html 1248 5.24.3.1. LDAP Attribute Definition 1250 Definition of the costurl LDAP attribute: 1252 ( 1.3.6.1.1.x.0.20 1253 NAME 'CostURL' 1254 DESC 'Cal Resource Cost Info' 1255 EQUALITY caseIgnoreIA5Match 1256 SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 ) 1258 5.24.3.2. VCard Property Definition 1260 Purpose: To specify URL pointing Resource Scheduling Cost 1261 Information. 1263 Type value: URI. 1265 Cardinality: (0,n) 1267 ABNF: 1268 COSTINFO-param = "VALUE=uri" / any-param 1269 COSTINFO-value = uri 1271 Example: 1272 COSTINFO:http://www.example.com/cost.html 1274 5.25. Related 1276 Description: 1277 Specify a relationship with another resource. 1279 ValueType: 1280 URL value. 1282 Example value: 1283 http://www.example.com/printer1.html 1285 5.25.1. LDAP Attribute Definition 1287 Definition of the related LDAP attribute: 1289 ( 1.3.6.1.1.x.0.21 1290 NAME 'Related' 1291 DESC 'Related URL' 1292 EQUALITY uniqueMemberMatch 1293 SYNTAX 1.3.6.1.4.1.1466.115.121.1.34 ) 1295 5.25.2. VCard Property Definition 1297 The property RELATED as defined in Section 6.6.6 of 1298 [I-D.ietf-vcarddav-vcardrev]. 1300 6. Examples 1302 6.1. LDAP Examples 1304 6.1.1. Location Resource 1305 dn: cn=Room One,ou=Engineering,dc=example,dc=com 1306 objectclass: top 1307 objectclass: calendarresource 1308 objectclass: admittanceinfo 1309 objectclass: inventoryinfo 1310 objectclass: schedapprovalinfo 1311 objectclass: calendarresourcecost 1312 kind: location 1313 vcarduid: room1-id 1314 cn: Room One 1315 ou: Engineering 1316 nickname: The One 1317 description: Room 1 in Engineering Building X 1318 categories: rooms 1319 categories: engineering_resources 1320 restricted: TRUE 1321 admittanceurl: http://www.example.com/room1_admittance.html 1322 accessibilityurl: http://www.example.com/room1_specialaccess.html 1323 capacity: 100 1324 inventorylist:phone, projector 1325 inventoryurl: http://www.example.com/room1_inventory.html 1326 owner: cn=RoomOwner,ou=Engineering,dc=example,dc=com 1327 resourcemanager: cn=RoomOwner,ou=Engineering,dc=example,dc=com 1328 calcapuri: http://www.example.com/calendar/home/Room1/calendar/ 1329 calfburl: http://www.example.com/freebusy/home/Room1/ 1330 calcaladruri: mailto:room1@example.com 1331 timezoneid: America/Los_Angeles 1332 multiplebookings: 1 1333 maxinstances: 10 1334 bookingwindowstart:P3M 1335 bookingwindowend: P3D 1336 autoschedule: FALSE 1337 approvalinfourl: http://www.example.com/room1_approval.html 1338 schedadmin: cn=RoomOwner,ou=Engineering,dc=example,dc=com 1339 nocost: FALSE 1340 costurl: http://www.example.com/cost.html 1342 6.1.2. Role Resources Group 1343 dn: cn=Drivers X,ou=Transportation,dc=example,dc=com 1344 objectclass: top 1345 objectclass: groupOfuniqueNames 1346 objectclass: calendarresource 1347 objectclass: schedapprovalinfo 1348 objectclass: calendarresourcecost 1349 kind: group 1350 vcarduid: driversX-id 1351 cn: Driver One 1352 ou: Transportation 1353 nickname: The X 1354 description: Drivers in the Transportation department driver pool X 1355 categories: drivers 1356 uniquemember: cn=Driver1,ou=Transportation,dc=example,dc=com 1357 uniquemember: cn=Driver2,ou=Transportation,dc=example,dc=com 1358 uniquemember: cn=Driver3,ou=Transportation,dc=example,dc=com 1359 owner: cn=Transportation_Manager,ou=Transportation,dc=example,dc=com 1360 calfburl: http://www.example.com/freebusy/home/DriversX/ 1361 calcaladruri: mailto:driversX@example.com 1362 timezoneid: America/Los_Angeles 1363 multiplebookings: 3 1364 maxinstances: 10 1365 bookingwindowstart:P3M 1366 bookingwindowend: P3D 1367 autoschedule: FALSE 1368 approvalinfourl: http://www.example.com/driversX_approval.html 1369 schedadmin: cn=TransportationManager,ou=Transportation,dc=example,dc=com 1370 nocost: FALSE 1371 costurl: http://www.example.com/driversXcost.html 1373 6.2. VCard Examples 1375 6.2.1. Location Resource 1376 BEGIN:VCARD 1377 VERSION:4.0 1378 UID:urn:uuid:room1-id 1379 KIND: location 1380 FN: Room One 1381 ORG: Engineering 1382 NICKNAME: The One 1383 NOTE: Room 1 in Engineering Building X 1384 CATEGORIES: rooms 1385 CATEGORIES: engineering_resources 1386 RESTRICTEDACCESS: TRUE 1387 ADMISSIONINFO: http://www.example.com/room1_admittance.html 1388 ACCESSIBILITYINFO: http://www.example.com/room1_specialaccess.html 1389 CAPACITY: 100 1390 INVENTORYLIST: phone, projector 1391 INVENTORYURL: http://www.example.com/room1_inventory.html 1392 RESOURCEOWNERINFO: http://www.example.com/ResOwner1.vcf 1393 RESOURCEMANAGERINFO: http://www.example.com/ResManager1.vcf 1394 CAPURI: http://www.example.com/calendar/home/Room1/calendar/ 1395 FBURL: http://www.example.com/freebusy/home/Room1/ 1396 CALADRURI: mailto:room1@example.com 1397 TZ: America/Los_Angeles 1398 MULTIBOOK: 1 1399 MAXINSTANCES: 10 1400 BOOKINGWINDOWSTART:P3M 1401 BOOKINGWINDOWEND: P3D 1402 AUTOSCHEDULE: FALSE 1403 APPROVALINFO: http://www.example.com/room1_approval.html 1404 SCHEDADMININFO: http://www.example.com/SchedAdmin1.vcf 1405 NOCOST: FALSE 1406 COSTINFO: http://www.example.com/cost.html 1407 END:VCARD 1409 6.2.2. Role Resources Group 1410 BEGIN:VCARD 1411 VERSION:4.0 1412 UID:urn:uuid:driverXPool-id 1413 KIND: group 1414 FN: Driver X Pool 1415 ORG: Transportation 1416 NICKNAME: The X Group 1417 NOTE: Drivers in the Transportation department driver pool X 1418 CATEGORIES: drivers 1419 MEMBER:urn:uuid:driver1-id 1420 MEMBER:urn:uuid:driver2-id 1421 MEMBER:urn:uuid:driver3-id 1422 RESOURCEOWNERINFO: http://www.example.com/DriversManager.vcf 1423 FBURL: http://www.example.com/freebusy/home/DriversX/ 1424 CALADRURI: mailto:driversX@example.com 1425 TZ: America/Los_Angeles 1426 MULTIBOOK: 3 1427 MAXINSTANCES: 10 1428 BOOKINGWINDOWSTART:P3M 1429 BOOKINGWINDOWEND: P3D 1430 AUTOSCHEDULE: FALSE 1431 APPROVALINFO: http://www.example.com/driversX_approval.html 1432 SCHEDADMININFO: http://www.example.com/DriversX_SchedAdmin.vcf 1433 NOCOST: FALSE 1434 COSTINFO: http://www.example.com/driversXcost.html 1435 END:VCARD 1437 7. Security Considerations 1439 As this document only defines schema for representing resource 1440 information for calendaring and scheduling and does not refer to the 1441 actual storage mechanism itself, or the calendaring and scheduling 1442 protocol, no special security considerations are required as part of 1443 this document. 1445 8. IANA Considerations 1447 8.1. LDAP Objectclass and Attribute Registration 1449 New LDAP objectclasses and attributes defined in this document need 1450 to be registered by the Internet Assigned Numbers Authority (IANA) as 1451 requested in the following template. Once the assignment is done, 1452 this document needs to be updated with the right OID numbers for all 1453 the newly defined objectclasses and attributes. 1455 Subject: Request for LDAP Descriptor Registration 1456 Descriptor (short name): See table below 1457 Object Identifier: See table below 1458 Person & email address to contact for further information: 1459 Ciny Joy 1460 Usage: See table below 1461 Specification: draft-cal-resource-schema 1462 Author/Change Controller: IESG 1464 New LDAP ObjectClass and Attributes Table: 1466 +-------------------+------------+----------------+-----------------+ 1467 | Name | Type | Definition | OID | 1468 +-------------------+------------+----------------+-----------------+ 1469 | CalendarResource | ObjectClas | Section 4.1 | IANA-ASSIGNED-O | 1470 | | s | | ID | 1471 | Kind | Attribute | Section 5.2.1 | IANA-ASSIGNED-O | 1472 | | | | ID | 1473 | VcardUid | Attribute | Section 5.3.1 | IANA-ASSIGNED-O | 1474 | | | | ID | 1475 | NickName | Attribute | Section 5.4.1 | IANA-ASSIGNED-O | 1476 | | | | ID | 1477 | Categories | Attribute | Section 5.7.1 | IANA-ASSIGNED-O | 1478 | | | | ID | 1479 | AdmittanceInfo | ObjectClas | Section 5.9.1 | IANA-ASSIGNED-O | 1480 | | s | | ID | 1481 | Restricted | Attribute | Section 5.9.2. | IANA-ASSIGNED-O | 1482 | | | 1 | ID | 1483 | AdmittanceURL | Attribute | Section 5.9.3. | IANA-ASSIGNED-O | 1484 | | | 1 | ID | 1485 | AccessibilityURL | Attribute | Section 5.10.1 | IANA-ASSIGNED-O | 1486 | | | | ID | 1487 | Capacity | Attribute | Section 5.11.1 | IANA-ASSIGNED-O | 1488 | | | | ID | 1489 | InventoryInfo | ObjectClas | Section 5.12.1 | IANA-ASSIGNED-O | 1490 | | s | | ID | 1491 | InventoryList | Attribute | Section 5.12.2 | IANA-ASSIGNED-O | 1492 | | | .1 | ID | 1493 | InventoryURL | Attribute | Section 5.12.3 | IANA-ASSIGNED-O | 1494 | | | .1 | ID | 1495 | ResourceManager | Attribute | Section 5.14.1 | IANA-ASSIGNED-O | 1496 | | | | ID | 1497 | TimeZoneID | Attribute | Section 5.18.1 | IANA-ASSIGNED-O | 1498 | | | | ID | 1499 | MultipleBookings | Attribute | Section 5.19.1 | IANA-ASSIGNED-O | 1500 | | | | ID | 1501 | MaxInstances | Attribute | Section 5.20.1 | IANA-ASSIGNED-O | 1502 | | | | ID | 1503 | BookingWindowStar | Attribute | Section 5.21.1 | IANA-ASSIGNED-O | 1504 | t | | | ID | 1505 | BookingWindowEnd | Attribute | Section 5.22.1 | IANA-ASSIGNED-O | 1506 | | | | ID | 1507 | SchedApprovalInfo | ObjectClas | Section 5.23.1 | IANA-ASSIGNED-O | 1508 | | s | | ID | 1509 | Autoschedule | Attribute | Section 5.23.2 | IANA-ASSIGNED-O | 1510 | | | .1 | ID | 1511 | ApprovalInfoURL | Attribute | Section 5.23.3 | IANA-ASSIGNED-O | 1512 | | | .1 | ID | 1513 | SchedAdmin | Attribute | Section 5.23.4 | IANA-ASSIGNED-O | 1514 | | | .1 | ID | 1515 | CalendarResourceC | ObjectClas | Section 5.24.1 | IANA-ASSIGNED-O | 1516 | ost | s | | ID | 1517 | Nocost | Attribute | Section 5.24.2 | IANA-ASSIGNED-O | 1518 | | | .1 | ID | 1519 | CostURL | Attribute | Section 5.24.3 | IANA-ASSIGNED-O | 1520 | | | .1 | ID | 1521 | Related | Attribute | Section 5.25.1 | IANA-ASSIGNED-O | 1522 | | | | ID | 1523 +-------------------+------------+----------------+-----------------+ 1525 8.2. VCard Property Registration 1527 The following new VCard Properties need to be registered by IANA. 1529 New VCard Properties Table: 1531 +---------------------+---------------------------+ 1532 | VCard Property Name | VCard Property Definition | 1533 +---------------------+---------------------------+ 1534 | RESTRICTEDACCESS | Section 5.9.2.2 | 1535 | ADMISSIONINFO | Section 5.9.3.2 | 1536 | ACCESSIBILITYINFO | Section 5.10.2 | 1537 | CAPACITY | Section 5.11.2 | 1538 | INVENTORYLIST | Section 5.12.2.2 | 1539 | INVENTORYURL | Section 5.12.3.2 | 1540 | RESOURCEOWNER | Section 5.13.2 | 1541 | RESOURCEMANAGER | Section 5.14.2 | 1542 | MAXINSTANCE | Section 5.20.2 | 1543 | BOOKINGWINDOWSTART | Section 5.21.2 | 1544 | BOOKINGWINDOWEND | Section 5.22.2 | 1545 | AUTOSCHEDULE | Section 5.23.2.2 | 1546 | APPROVALINFO | Section 5.23.3.2 | 1547 | APPROVERINFO | Section 5.23.4.2 | 1548 | NOCOST | Section 5.24.2.2 | 1549 | COSTINFO | Section 5.24.3.2 | 1550 +---------------------+---------------------------+ 1552 9. Acknowledgments 1554 This specification is a result of discussions that took place within 1555 the Calendaring and Scheduling Consortium's Resource Technical 1556 Committee. The authors thank the participants of that group, and 1557 specifically the following individuals for contributing their ideas 1558 and support: Arnaud Quillaud, Adam Lewenberg, Andrew Laurence, Guy 1559 Stalnaker, Mimi Mugler, Dave Thewlis, Bernard Desruisseaux, Alain 1560 Petit, and Jason Miller. 1562 10. Normative References 1564 [I-D.ietf-vcarddav-vcardrev] Perreault, S. and P. Resnick, "vCard 1565 Format Specification", 1566 draft-ietf-vcarddav-vcardrev-13 (work 1567 in progress), August 2010. 1569 [ISO.8601.2004] International Organization for 1570 Standardization, "Data elements and 1571 interchange formats -- Information 1572 interchange -- Representation of dates 1573 and times", 2004. 1575 [RFC2119] Bradner, S., "Key words for use in RFCs 1576 to Indicate Requirement Levels", 1577 BCP 14, RFC 2119, March 1997. 1579 [RFC2739] Small, T., Hennessy, D., and F. Dawson, 1580 "Calendar Attributes for vCard and 1581 LDAP", RFC 2739, January 2000. 1583 [RFC4519] Sciberras, A., "Lightweight Directory 1584 Access Protocol (LDAP): Schema for User 1585 Applications", RFC 4519, June 2006. 1587 Authors' Addresses 1589 Ciny Joy 1590 Oracle Corporation 1591 4150 Network Circle 1592 Santa Clara, CA 95054 1593 USA 1595 EMail: ciny.joy@oracle.com 1596 URI: http://www.oracle.com/ 1597 Cyrus Daboo 1598 Apple Inc. 1599 1 Infinite Loop 1600 Cupertino, CA 95014 1601 USA 1603 EMail: cyrus@daboo.name 1604 URI: http://www.apple.com/ 1606 Michael Douglass 1607 Rensselaer Polytechnic Institute 1608 110 8th Street 1609 Troy, NY 12180 1610 USA 1612 EMail: douglm@rpi.edu 1613 URI: http://www.rpi.edu/