view Side-By-Side changes
XCON O. Novo Internet-Draft G. Camarillo Intended status: Standards Track Ericsson Expires:October 19, 2007May 3, 2008 D. Morgan Fidelity Investments R. Even PolycomApril 17,October 31, 2007 Conference Information Data Model for Centralized Conferencing (XCON)draft-ietf-xcon-common-data-model-05.txtdraft-ietf-xcon-common-data-model-06.txt Status of this Memo By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. This Internet-Draft will expire onOctober 19, 2007.May 3, 2008. Copyright Notice Copyright (C) The IETF Trust (2007). Abstract This document defines an Extensible Markup Language (XML)-based conference information data model for centralized conferencing (XCON). A conferenceobject, which can be manipulated using a conference control protocol, at ainformation data model is designed to convey information about the conferenceserver represents aand about participation in the Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page 1] Internet-Draft Data Model SchemaAprilOctober 2007particular instantiation of this data model.conference. The conference information data model defined in this documentisconstitutes an extension of(and thus, compatible with)themodeldata format specified in the Session Initiation Protocol (SIP) Event Package for Conference State.Novo, et al. Expires October 19, 2007 [Page 2] Internet-Draft Data Model Schema April 2007Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 6 3. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.1. Data ModelStructureFormat . . . . . . . . . . . . . . . . . . . . 6 3.2.Role Definitions . . . . . . . . .Data Model Namespace . . . . . . . . . . . .7 3.2.1. Role in a Floor. . . . . . . 6 3.3. The Conference Object Identifier . . . . . . . . . . . .8 3.2.2. Changing Roles. 7 3.4. Data Model Structure . . . . . . . . . . . . . . . . . . . 8 4. Data Model Definition . . . . . . . . . . . . . . . . . . . .89 4.1.<conference-description> .<conference-info> . . . . . . . . . . . . . . . .13 4.1.1. <conference-time>. . . . 12 4.2. <conference-description> . . . . . . . . . . . . . .14 4.1.2. <conf-uris>. . . 13 4.2.1. <display-text> . . . . . . . . . . . . . . . . . .15 4.1.3. <service-uris>. . 13 4.2.2. <subject> . . . . . . . . . . . . . . . . . .16 4.1.4. <maximum-user-count>. . . . 13 4.2.3. <free-text> . . . . . . . . . . . . .16 4.1.5. <available-media>. . . . . . . . 13 4.2.4. <keywords> . . . . . . . . . .16 4.1.5.1. <controls>. . . . . . . . . . . . 13 4.2.5. <allow-sidebars> . . . . . . . .17 4.1.5.1.1. mute. . . . . . . . . . . 13 4.2.6. <conference-time> . . . . . . . . . .17 4.1.5.1.2. pause-video. . . . . . . . 14 4.2.7. <conf-uris> . . . . . . . . .17 4.1.5.1.3. gain. . . . . . . . . . . . 15 4.2.8. <service-uris> . . . . . . . . .18 4.1.5.1.4. video-layout. . . . . . . . . . . 15 4.2.9. <maximum-user-count> . . . . . .18 4.2. <host-info>. . . . . . . . . . . 15 4.2.10. <available-media> . . . . . . . . . . . .19 4.3. <conference-state>. . . . . . 15 4.3. <host-info> . . . . . . . . . . . . . .19 4.4. <floor-information>. . . . . . . . . 18 4.4. <conference-state> . . . . . . . . . .19 4.5. <users>. . . . . . . . . . 18 4.4.1. <allow-conference-event-subscription> . . . . . . . . 18 4.4.2. <user-count> . . . . . . .21 4.5.1. <allowed-users-list>. . . . . . . . . . . . . . 18 4.4.3. <active> . . .22 4.5.2. <user>. . . . . . . . . . . . . . . . . . . . 18 4.4.4. <locked> . . . .22 4.5.2.1. <from-mixer>, <to-mixer>. . . . . . . . . . . . .24 4.5.2.1.1. <floor>. . . . . . 19 4.5. <floor-information> . . . . . . . . . . . . .24 4.5.3. <sidebars-by-ref>. . . . . . 19 4.5.1. <conference-ID> . . . . . . . . . . . .24 4.5.4. <sidebars-by-val>. . . . . . . 19 4.5.2. <allow-floor-events> . . . . . . . . . . .24 5. RELAX NG Schema. . . . . . 19 4.5.3. <floor-request-handling> . . . . . . . . . . . . . . . 19 4.5.4. <conference-floor-policy> . .25 6. XML Schema Extensibility. . . . . . . . . . . . 20 4.6. <users> . . . . . . .32 7. XML Example. . . . . . . . . . . . . . . . . . 20 4.6.1. <join-handling> . . . . . . .33 8. Security Considerations. . . . . . . . . . . . 21 4.6.2. <user-admission-policy> . . . . . . .41 9. IANA Considerations. . . . . . . . 21 4.6.3. <allowed-users-list> . . . . . . . . . . . . .41 9.1. Conference Relax NG Schema Registration. . . . 22 4.6.4. <user> and Its <user> Sub-elements . . . . .41 9.2. Conference Namespace Registration. . . . . 22 4.6.4.1. <display-text> . . . . . . .41 9.3. Conference Object Identifier Registration. . . . . . . .41 9.4. Conference User Identifier Registration. . . 23 4.6.4.2. <associated-aors> . . . . . .42 10. Acknowledgements. . . . . . . . . . 23 4.6.4.3. <provide-anonymity> . . . . . . . . . . . . .42 11. References. . 24 4.6.4.4. <roles> . . . . . . . . . . . . . . . . . . . . . 24 4.6.4.5. <languages> . . .42 11.1. Normative References. . . . . . . . . . . . . . . . 24 Novo, et al. Expires May 3, 2008 [Page 2] Internet-Draft Data Model Schema October 2007 4.6.4.6. <cascaded-focus> . . .42 11.2. Informative References. . . . . . . . . . . . . . 24 4.6.4.7. <allow-refer-users-dynamically> . . . .42 Appendix A. Appendix A. Non-Normative. . . . . 24 4.6.4.8. <allow-invite-users-dynamically> . . . . . . . . . 24 4.6.4.9. <allow-remove-users-dynamically> . . . . . . . . . 25 4.6.4.10. <endpoint> . . . . . . . . . . . . . . . . . . . . 25 4.7. <sidebars-by-ref> . . . . . . . . . . . . . . . . . . . . 26 4.8. <sidebars-by-val> . . . . . . . . . . . . . . . . . . . . 26 5. RELAX NG Schemain. . . . . . . . . . . . . . . . . . . . . . . 26 6. XMLSyntaxSchema Extensibility . . . . . . . . . . . . . . . . . . . 33 7. XML Example . . . .43 Authors' Addresses. . . . . . . . . . . . . . . . . . . . . 33 8. Security Considerations . . .66 Intellectual Property and Copyright Statements. . . . . . . . . .68 Novo, et al. Expires October 19, 2007 [Page 3] Internet-Draft Data Model Schema April 2007 1. Introduction Conference objects are a fundamental concept in Centralized conferencing, as described in the XCON Conferencing Framework [4]. A conference object contains data that represents a conference during each of its various stages (e.g., reserved, started, running, ended, etc.). Conference Objects are instantiations of the conference information data model defined in this document. Consequently, conference objects follow the XML format defined in this document. A conference object contains the core information of a conference (i.e., capabilities, membership, roles, call control signaling, media, etc.) and specifies who, and in which way, can manipulate that information. Figure 1 shows logical functional elements of a conference server as defined by the XCON Conferencing Framework [4]. They are a Conference Control Server, a Floor Control Server, a number of Foci, and a Notification Service. A conference control protocol provides the interface between a conference and media control client, and the conference control server. A floor control protocol (e.g., BFCP [5]) provides the interface between a floor control client and the floor control server. A call signaling protocol (e.g., SIP, H.323, PSTN, etc.) provides the interface between a call signaling client and a Focus. A notification protocol (e.g., SIP-based event notifications [6]) provides the interface between the conferencing client and the Notification Service. Within a conference, the conference control server, floor control server, and focus can modify the information in the conference object. Novo, et al. Expires October 19, 2007 [Page 4] Internet-Draft Data Model Schema April 2007 ................................................................Conferencing Server. .+---------------------------------------------------+. .| C o n f e r e n c e o b j e c t |. 41 8.1. Authentication .+-+--------------------------------------------------+|. .| C o n f e r e n c e o b j e c t ||. .+-+---------------------------------------------------+||. .| C o n f e r e n c e o b j e c t |||. .| +--------------------------------------------------+|||. .| | Conference Information Data Model ||||. .| | +----------------------------------------------+ ||||. .| | | Conference description (times, duration) | ||||. .| | +----------------------------------------------+ ||||. .| | +----------------------------------------------+ ||||. .| | | Host information | ||||. 41 8.2. Confidentiality .| | +----------------------------------------------+ ||||. .| | +----------------------------------------------+ ||||. .| | | Conference state | ||||. .| | +----------------------------------------------+ ||||. .| | +----------------------------------------------+ ||||. .| | | Floor information | ||||. .| | +----------------------------------------------+ ||||. .| | +----------------------------------------------+ ||||. .| | | Membership (users, roles, capacity) | ||||. .| | +----------------------------------------------+ ||||. .| | +----------------------------------------------+ ||||41 8.3. Integrity . .| | | Sidebars, Etc. | ||||. .| | +----------------------------------------------+ ||||. .| | +----------------------------------------------+ ||||. .| | | Etc. | ||||. .| | +----------------------------------------------+ |||+. .| +--------------------------------------------------+|+. .+----^------------------^-------------^--------|------+. .| | | |. .+------v-------+ +--------v-----+ +-----v-+ +----v-------+. .| Conference | | Floor | | | | |. .| Control | | Control | |Foci | |Notification|. .| Server | | Server | | | |Service |42 9. IANA Considerations . .+-----^--------+ +---^----------+ +-^-----+ +------------+.........|..............|..............|..........|............. |Conference |Binary Floor |Call |Notification |Control |Control |Signaling |Protocol |Protocol |Protocol |Protocol | ........v..............v..............v..........v..............C o n f e r e n c i n g C l i e n t................................................................ Figure 1:. . . . . . . . . . . . . . . . 42 9.1. ConferenceServer Architecture Novo, et al. Expires October 19, 2007 [Page 5] Internet-Draft Data ModelRelax NG SchemaApril 2007 The Session Initiation Protocol (SIP) Event Package forRegistration . . . . . . . . . 42 9.2. ConferenceState, specified in RFC 4575 [1], already defines a data model for conferences. However, that model is SIP specific and lacks elements related to some of the functionality defined by the XCON conferencing framework [4] (e.g., floor control). The data model defined in this document extends the one definedNamespace Registration . . . . . . . . . . . . 42 9.3. Conference Object Identifier Registration . . . . . . . . 42 9.4. Conference User Identifier Registration . . . . . . . . . 43 10. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 43 11. References . . . . . . . . . . . . . . . . . . . . . . . . . . 43 11.1. Normative References . . . . . . . . . . . . . . . . . . . 43 11.2. Informative References . . . . . . . . . . . . . . . . . . 43 Appendix A. Appendix A. Non-Normative RELAX NG Schema inRFC 4575 [1]. The resultXML Syntax . . . . . . . . . . . . . . . . . . . . . . . 44 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 63 Intellectual Property and Copyright Statements . . . . . . . . . . 65 Novo, et al. Expires May 3, 2008 [Page 3] Internet-Draft Data Model Schema October 2007 1. Introduction There is a core datamodel that supports more call signaling protocols besides SIP andset of conference information thatcovers all the functionality definedis utilized in any conference, independent of theXCON conferencing framework [4]. 2. Terminology 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 RFC 2119 [2].specific conference media. Thisdocument usescore data set called theterminology'conference information data model' is defined inthe XCON Conferencing Framework [4], the SIP conferencing framework [7] and the BFCP (Binary Floor Control Protocol) specification [5]. Readers ofthis documentare supposed to be familiar with the terminology used in those documents. 3. Overviewusing an Extensible Markup Language (XML)- based. The conference information data model defined in this document is logically represented by theresult of extending the data model definedconference object. Conference objects are a fundamental concept inRFC 4575 [1] with new elements, which carry information suchCentralized Conferencing, asnon-SIP URIs or floor-control-related parameters. Thisdescribed in the Centralized Conferencing Framework [4]. A conference object contains datamodel can be used bythat represents a conferenceservers providing different typesduring each ofbasic conferences. It is expected that this data modelits various stages (e.g., created/creation, reserved/ reservation, active/activation, completed/completion). A conference object can befurther extended with new elements in the future in order to implement advanced features. 3.1. Data Model Structuremanipulated using a conference control protocol at a conference server. The conference object represents a particular instantiation of a conference informationin thisdatamodel is structured inmodel. Consequently, conference objects follow thefollowing manner. AllXML format defined in this document. A conference object contains the core informationrelated toof a conferenceis contained(i.e., capabilities, membership, call control signaling, media, etc.) and specifies who, and in which way that information can be manipulated. Figure 1 shows the logical functional elements of a<conference-info> element. The <conference-info> element containsconference server as defined by thefollowing child elements: o The <conference-description> element describesCentralized Conferencing Framework [4]. They are a Conference Control Server, a Floor Control Server, a number of Foci, and a Notification Service. A conference control protocol provides the interface between a conference control client and the conference control server. A floor control protocol (e.g., BFCP [5]) provides the interface between a floor control client and the floor control server. A call signaling protocol (e.g., SIP, H.323, Q.931, ISUP, etc.) provides theconference asinterface between awhole. It has, for instance, information aboutcall signaling client and a Focus. A notification protocol (e.g., SIP-based event notifications [6]) provides theURI ofinterface between theconference, maximum users allowed inconferencing client and the Notification Service. Within a conference,media available intheconference, orconference control server, floor control server, and focus can modify thetimeinformation in the conferencewill start.object. Novo, et al. Expires May 3, 2008 [Page 4] Internet-Draft Data Model Schema October 2007 ............................................................... . Conferencing Server . . +---------------------------------------------------+ . . | C o n f e r e n c e o b j e c t | . . +-+--------------------------------------------------+| . . | C o n f e r e n c e o b j e c t || . . +-+---------------------------------------------------+|| . . | C o n f e r e n c e o b j e c t ||| . . | +--------------------------------------------------+||| . . | | Conference Information Data Model |||| . . | | +----------------------------------------------+ |||| . . | | | Conference description (times, duration) | |||| . . | | +----------------------------------------------+ |||| . . | | +----------------------------------------------+ |||| . . | | | Host information | |||| . . | | +----------------------------------------------+ |||| . . | | +----------------------------------------------+ |||| . . | | | Conference state | |||| . . | | +----------------------------------------------+ |||| . . | | +----------------------------------------------+ |||| . . | | | Floor information | |||| . . | | +----------------------------------------------+ |||| . . | | +----------------------------------------------+ |||| . . | | | Membership (users, capacity) | |||| . . | | +----------------------------------------------+ |||| . . | | +----------------------------------------------+ |||| . . | | | Sidebars, Etc. | |||| . . | | +----------------------------------------------+ |||| . . | | +----------------------------------------------+ |||| . . | | | Etc. | |||| . . | | +----------------------------------------------+ |||+ . . | +--------------------------------------------------+|+ . . +----^------------------^-------------^--------|------+ . . | | | | . . +------v-------+ +--------v-----+ +-----v-+ +----v-------+ . . | Conference | | Floor | | | | | . . | Control | | Control | |Foci | |Notification| . . | Server | | Server | | | |Service | . . +-----^--------+ +---^----------+ +-^-----+ +------------+ . ........|..............|..............|..........|............. |Conference |Binary Floor |Call |Notification |Control |Control |Signaling |Protocol |Protocol |Protocol |Protocol | ........v..............v..............v..........v............. . C oThe <host-info> element contains information about the entity hosting the conference (e.g., its URI).n f e r e n c i n g C l i e n t . ............................................................... Figure 1: Conference Server Architecture Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page6]5] Internet-Draft Data Model SchemaAprilOctober 2007oThe<conference-state> element informs the subscribers about the changesSession Initiation Protocol (SIP) Event Package for Conference State, specified inthe overall conference information. o The <floor-information> element contains information about the statusRFC4575 [1], already defines a data format for conferences. However, that model is SIP specific and lacks elements related to some of thedifferent floors in the conference. o The <users> element describesfunctionality defined by themembership information as a whole. The <users> element containsCentralized Conferencing Framework [4] (e.g., floor control). The data model defined in this document constitutes asetsuperset of<user> child elements, each describing a single participant intheconference. o Ifdata format defined in RFC4575 [1]. The result is aparticipantdata format that supports more call signaling protocols besides SIP and that covers all the functionality defined in themain conference joins a sidebar, a new element is createdCentralized Conferencing Framework [4]. 2. Terminology 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 RFC 2119 [2]. This document uses theconference referenced fromterminology defined in the<sidebars-by-ref> element or under one ofCentralized Conferencing Framework [4], the<sidebars-by-val> elements. 3.2. Role Definitions This section defines five logical roles for a Conference System to represent participants within a Conference Object. In hierarchical order they are: "administrator", "creator", "moderator", "participant",SIPPING conferencing framework [7] and"observer". A setthe BFCP (Binary Floor Control Protocol) specification [5]. Readers ofsemantics associatedthis document should be familiar witheach rolethe terminology used in those documents. 3. Overview The data model specified in this document isout ofthescoperesult ofthis document. A Conference System MAY choose not to support a particular role. As well, additional roles may beextending the data format defined inthe future, as necessary,RFC4575 [1] withtheir corresponding schema extensions. These five roles have an intrinsic hierarchical order within a specific conference. By hierarchical order, it is implied that the "administrator" by default SHOULD have higher privileges than a "creator", which by default SHOULD have higher privileges than a "moderator"new elements. Examples of such extensions include scheduling elements, media control elements, floor control elements, non-SIP URIs, andso on. For example, the "administrator" SHOULD have the ability to make changesaddition of localization extensions toalltext elements. This data model can be used by conferencevariables during instantiation and full lifecycleservers providing different types ofthe Conference Object. The "creator"basic conferences. It is expected that this data model can be further extended with new elements in the'owner' of thefuture in order to implement additional advanced features. 3.1. Data Model Format A conference object document is an XML [8] document that MUST be well formed andhas various privileges whichSHOULDallow them to modify the conference variables up tobe valid. Conference object documents MUST be based on XML 1.0 and SHOULD be encoded using UTF-8. 3.2. Data Model Namespace This specification defines a new namespace specification for identifying thetimeelements defined in theconferencedata model. This namespace isinstantiated.as follows: Novo, et al. Expires May 3, 2008 [Page 6] Internet-Draft Data Model Schema October 2007 urn:ietf:params:xml:ns:xcon-conference-info 3.3. The"moderator" is a logical entity that will manage the conference.Conference Object Identifier The"participant" is a logical entity with generic privileges that willconference object identifier (XCON-URI) can beattendingviewed as aconference. The "observer" iskey to accessing alogical entity whichspecific conference object. It canonly receive media streams frombe used, for instance, by theconference. All Conference Systems MUST have a role defined as "participant". Each user participating inconference control protocol to access, manipulate and delete a conferenceinstanceobject. A conference object identifier isan entity that can assume one or more roles. Any entity can be allocatedprovided toan appropriate logical role.the conferencing client by the conference notification service or through out-of-band mechanisms (e.g. E-Mail). Arole can also be assumed in conjunctionconferencing system may maintain a relationship between the conference object identifiers and the identifiers associated with each of the complementary centralized conferencing protocols (e.g., call signaling protocols, BFCP, etc.). To facilitate theusers identity withinmaintenance of these relationships, theConference Systemconference object identifier acts as aresulttop level identifier within the conferencing system for the purpose ofan identity assertion transaction onidentifying theConference System. If no roles are definedinterfaces foran entity, they SHOULD by default bethese other protocols. This implicit binding provides a"participant" but local policy MAY define an alternative.structured mapping of the various protocols with the associated conference object Identifier. Figure 2 illustrates the relationship between the identifiers used for the protocols and the general conference object identifier (XCON-URI). +--------------------------+ | Conference | | Object | | Identifier | +--------------------------+ | xcon:Ji092i@example.com | +------+-------------------+ | | | +-----------------+---------------+ | | +-----------+-----------+ +----------+---------+ | CSP Conference IDs | |BFCP 'Conference ID'| +-----------------------+ +--------------------+ |h323:Ji092i@example.com| | Ji092i | |tel:+44(0)2920930033 | +----------+---------+ |sip:Ji092i@example.com | | +-----------------------+ +-------|--------+ | BFCP 'Floor ID'| +----------------+ | 543 | | 09cnJk | +----------------+ Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page 7] Internet-Draft Data Model SchemaAprilOctober 20073.2.1. Role in a Floor Floor control in centralized conferencing is described in the Binary Floor Control Protocol (BFCP) [5]. Floors can be specified in theFigure 2: ConferenceSystem or created dynamically. Users can be added or deleted from a floor whenObject Mapping In Figure 2, the conferenceis active. A floor chair is a logical entity that manages a floor (grants, denies, or revokes a floor). The floor chair is usuallyobject identifier acts as the top level key in the identification process. The call signaling protocols have an"administrator", "moderator", or "creator" role. A floor participant is a logical entity that requests floors, and possibly information about them from a floor control server. They are usually in a "participant" or even a "moderator" role [5]. Users in aassociated conferenceMAY assume different roles in different floors. They MAY also assume different rolesuser identifier, often represented in thesame floor, asform of URIs. The binary floortransactions are processed. 3.2.2. Changing Roles Users can change roles during a conference. This can be donecontrol protocol, as defined intwo ways: First,[5], defines theuser can join'conference ID' identifier which represents anewconference instance within floorincontrol. When created within the conferencing system, the 'conference ID' has adifferent role. Second, an "administrator" or "creator" can dynamically change that user's role. This can be accomplished before1:1 mapping to the unique conferenceis instantiated, or duringobject Identifier(XCON-URI). Operations associated with theconference, using an appropriateconference controlprotocol. A logical entity whose role has been changed will typically have access toprotocols are directly associated with themedia streamsconference object, thus the primary identifier associated withthat role. 4. Data Model Definition Athese protocols is the conference objectdocumentidentifier(XCON-URI). The mappings between additional protocols/interface isan XML [8] documentnot strictly 1:1 and does allow for multiple occurrences. For example, multiple call signaling protocols will each have a representation thatMUSTis implicitly linked to the top level conference object identifier e.g. H323 and SIP URIs that represent a conference instance. It should bewell formednoted that a conferencing system is free to structure such relationships as required andSHOULDthis information is just included as a guideline that can bevalid. Conference objectused. Further elements can be added to the tree representation in Figure 2 to enable a complete representation of a conference instance within a conferencing system. 3.4. Data Model Structure The information in this data modeldocuments MUST be based on XML 1.0 and SHOULD be encoded using UTF-8. Ais structured in the following manner. All the information related to a conferenceobject document begins withis contained in a <conference-info> element. The <conference-info> element contains therootfollowing child elements: o The <conference-description> elementtag <conference-info>, which is defineddescribes the conference as a whole. It has, for instance, information about the URI of the conference, maximum users allowed in[1].the conference, media available in the conference, or the time the conference will start. o The<conference-info><host-info> elementhas an 'entity' attribute thatcontainsa conference object identifier (XCON-URI) that identifiesinformation about the entity hosting the conferencebeing described in(e.g., its URI). o The <conference-state> element informs thedocument. A conferencing system may maintain a relationship betweensubscribers about the changes in the overall conferenceobject identifiers andinformation. o The <floor-information> element contains information about theidentifiers associated with eachstatus of thecomplimentary centralized conferencing protocols (e.g., call signaling protocols, BFCP, etc.). This implicit binding providesdifferent floors in the conference. o The <users> element describes the membership information as astructured mappingwhole. The <users> element contains a set of <user> child elements, each describing a single participant in thevariousconference. Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page 8] Internet-Draft Data Model SchemaAprilOctober 2007protocols witho If a participant in theassociatedmain conferenceobject Identifier. Figure 2 illustrates the relationship between the identifiers used for the protocols within the framework [4] and the general XCON-URI. +--------------------------+ | Conference | | Object | | Identifier | +--------------------------+ | xcon:Ji092i@example.com | +------+-------------------+ | | | +-----------------+---------------+ | | +-----------+-----------+ +-------+-------+ | CSP Conference IDs | | BFCP 'confid' | +-----------------------+ +---------------+ |h323:Ji092i@example.com| | Ji092i | |tel:+44(0)2920930033 | +-------+-------+ |sip:Ji092i@example.com | | +-----------------------+ +-------|-------+ | BFCP 'floorid | +---------------+ | UEK78d | | 09cnJk | +---------------+ Figure 2: Conference Object Mapping Further elements can be added to the tree representation in Figure 2 to enablejoins acomplete representation ofsidebar, a new element is created in the conferenceinstance within a conferencing system. The <conference-info>referenced from the <sidebars-by-ref> elementcontainsor under one of the<conference-description>, <host-info>, <conference-state>, <floor-information>, <users>, <sidebars-by-ref>,<sidebars-by-val>childelements.All these elements, except <floor-information>,Note that some of the elements described above such <conference- info>, <conference-description>, <sidebars-by-ref>, or <sidebars-by- val> are not defined in the data model but are defined in the data format of RFC 4575 [1].A conference document MUST at least includeWe describe them here because they are part of the<conference- description>, <host-info>, <conference-state>, and <users> child elements.basic structure of the data model. 4. Data Model Definition The following non-normative diagram shows the structure of conference object documents. The operator "!" preceding an element indicates that the element is mandatory in the data model. The operator "*"Novo, et al. Expires October 19, 2007 [Page 9] Internet-Draft Data Model Schema April 2007following an element indicates that the element is introduced and defined in this document. That is, elements without a "*" have already been defined in RFC 4575 [1]. !<conference-info> | |--!<conference-description> | |--<display-text> | |--<subject> ||--<free-text>*|--<free-text> | |--<keywords> | |--<allow-sidebars>* | |--<conference-time>* | | |--<entry>* | | | |--<base>* | | | |--<mixing-start-offset>* | | | |--<mixing-end-offset>* | | | |--<can-join-after-offset>* | | | |--<must-join-before-offset>* | | | |--<request-user>* | | | |--<notify-end-of-conference>* | | | |--<allowed-extend-mixing-end-offset>* | | ... | |--<conf-uris> | ||--<entry>*|--<entry> | | | |--<uri> | | | |--<display-text> | | | |--<purpose> | ||--<H323>* | | | |--<H.323-alias>* | | | |--<H.323-URI>* | | |--<PSTN-ISDN>* | | | |--<phone number>* | |... | |--<service-uris> | ||--<entry>*|--<entry> Novo, et al. Expires May 3, 2008 [Page 9] Internet-Draft Data Model Schema October 2007 | | | |--<uri> | | | |--<display-text> | | | |--<purpose> | ||--<H323>* | | | |--<H.323-alias>* | | | |--<H.323-URI>* | | |--<PSTN-ISDN>* | | | |--<phone number>* | |... | |--<maximum-user-count> | | ... ||--!<available-media> Novo, et al. Expires October 19, 2007 [Page 10] Internet-Draft Data Model Schema April 2007|--<available-media> | | |--!<entry> | | | |--<type> | | | |--<display-text> | | | |--<status> | | | |--<mixing-mode>* | | ||--<mix-level>* | | ||--<codecs>* | | | | |--<entry>* | | | | |--<entry>* | | | | ... | | | |--<controls>* | | | | |--<mute>* | | | | |--<gain>* | | | | ... | | |--<entry> | | | |--<type> | | | |--<display-text> | | | |--<status> | | | |--<mixing-mode>* | | ||--<mix-level>* | | ||--<codecs>* | | | | |--<entry>* | | | | |--<entry>* | | | | ... | | | |--<controls>* | | | | |--<pause-video>* | | | | |--<video-layout>* | | | | ... | | ... | |--<host-info> | |--<display-text> | |--<web-page> ||--!<uris>|--<uris> | ||--!<entry>|--<entry> | | ||--!<uri>|--<uri> | | | |--<display-text> || |--<H323>* | | | |--<H.323-alias>* | | | |--<H.323-URI>* | | |--<PSTN-ISDN>* | | | |--<phone number>* |... |--<conference-state> | |--<allow-conference-event-subscription>* | |--<user-count> ||--!<active>|--<active> | |--<locked> Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page11]10] Internet-Draft Data Model SchemaAprilOctober 2007 | |--<floor-information>* | |--<conference-ID>* | |--<allow-floor-events>* | |--<floor-request-handling>* | |--<conference-floor-policy>* | | |--<floor>* | | ||--<media-types>*|--!<media-label>* | | ||--<algorithm>*|--!<algorithm>* | | | |--<max-floor-users>* | | ||--<chair-id>* | | | |--<chair-id>*|--<moderator-id>* | | | ... | | ... | |--!<users> | |--<join-handling>* | |--<user-admission-policy>* | |--<allowed-users-list>* | | |--<target>* | | |-- ... | | | | ||--!<user>|--<user> | | |--<display-text> | | |--<associated-aors> | | |--<provide-anonymity>* | | |--<roles> | | | | | | | ... | | |--<languages> | | |--<cascaded-focus> | | |--<allow-refer-users-dynamically>* | | |--<allow-invite-users-dynamically>* | | |--<allow-remove-users-dynamically>* | | |--!<endpoint> | | | |--<display-text> | | | |--<referred> | | | |--<status> | | | |--<joining-method> | | | |--<joining-info> | | | |--<disconnection-method> | | | |--<disconnection-info> | | ||--!<media>|--<media> | | | | |--<type> | | | | |--<display-text> | | | | |--<label> | | | | |--<src-id> | | | | |--<status> Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page12]11] Internet-Draft Data Model SchemaAprilOctober 2007 | | | ||--<status> | | | ||--<to-mixer>* | | | | | |--<floor>* | | | | | |--<controls>* | | | | | | |--<mute>* | | | | | | |--<gain>* | | | | | | ... | | | | |--<from-mixer>* | | | | | |--<floor>* | | | | | |--<controls>* | | | | | | |--<pause-video>* | | | | | | ... | | | | ... | | | |--<call-info> | | | | |--<sip> | | | | | |--<display-text> | | | | | |--<call-id> | | | | | |--<from-tag> | | | | | |--<to-tag> | ... ... |--<sidebars-by-ref> | |--<entry> | | |-- <user> | | |-- <display-text> | |--<entry> | | |-- <user> | | |-- <display-text> | ... |--<sidebars-by-val> | |--<entry> | | | | | ... | |--<entry> | | | | ... ... Figure 3: Non-normative diagram The following sections describe these elements in detail. The full Relax NG schema is provided Section 5. 4.1. <conference-info> A conference object document begins with the root element tag <conference-info>, which is defined in RFC4575 [1]. The <conference- info> attributes are described in RFC4575 [1]. Notice that the <conference-info> element does not have the attributes 'state' and 'version' defined in RFC4575[1] for this element because this Novo, et al. Expires May 3, 2008 [Page 12] Internet-Draft Data Model Schema October 2007 attribute only applies to notifications mechanism. RFC4575 [1] defines as well an 'entity' attribute that contains the conference object identifier (XCON-URI) that identifies the conference being described in the document. Thefollowing sections describe<conference-info> element contains the <conference-description>, <host-info>, <conference-state>, <floor-information>, <users>, <sidebars-by-ref>, and <sidebars-by-val> child elements. All theseelementselements, except <floor-information>, are defined indetail. The full Relax NG schema is provided Section 5. 4.1.[1]. A conference document MUST at least include the <conference- description> and <users> child elements. 4.2. <conference-description> The <conference-description> element, which is defined in RFC4575 [1], describes the conference as a whole. ItSHOULDshould have an extra attribute'xml:lang''lang' to specify the language used in the contents of thiselement as defined in Section 2.12 of [8].element. It is comprised of <display-text>, <subject>, <free-text>, <keywords>, <allow-sidebars>, <conference-time>, <conf-uris>, <service-uris>, <maximum-user-count>, and <available-media>. The following sections describe these elements in more detail. Other child elements MAY be defined in the future to extend the <conference-description> element. 4.2.1. <display-text> The <display-text> element is described in section 5.3 of RFC 4575 [1]. 4.2.2. <subject> The <subject> element is described in section 5.3 of RFC 4575 [1]. 4.2.3. <free-text> The <free-text> element is described in section 5.3 of RFC 4575 [1]. 4.2.4. <keywords> The <keywords> element is described in section 5.3 of RFC 4575 [1]. 4.2.5. <allow-sidebars> The <allow-sidebars> element represents a boolean action. If set to TRUE, the conference is allowed to create sidebar conferences. Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page 13] Internet-Draft Data Model SchemaAprilOctober 2007and <available-media>.4.2.6. <conference-time> The<display-text>, <subject>, <free-text><conference-time> element contains the information related to conference time and<keywords>duration of a conference. The <conference-time> element contains one or more <entry> elements each defining the time information specifying a single conference occurrence. Every <entry> element contains the following child elements: o <base>: The <base> child element specifies the iCalendar object of the conference. The iCalendar object components are definedin [1]. They are used to describe the conference's content.in RFC 2445 [3]. o <mixing-start-offset>: The <mixing-start-offset> child element<allow-sidebars> describesspecifies when thecapabilities ofconference media mixing starts before theconference.conference starts. The<conference-time><mixing-start-offset> child elementcontains information related toexpresses the offset as signed integers representing seconds before/after the iCalendar DTSTART field [3]. If the <mixing- start-offset> element is not present, it indicates that the conferencetimemedia mixing starts immediately. The <mixing-start- offset> has the mandatory 'required-participant' attribute. This attribute has one of 4 values: "none", "administrator", "moderator", andduration"participant". This attribute allows a privileged user to define when media mixing starts based on the latter of theconference. The <conf-uris>mixing start time, and<service-uris> are used to describetheconference-related identifiers. The <maximum-user-count> child element indicatestime thenumber of users that can be invitedfirst participant, administrator, or moderator arrives. If the value is set to "none'", mixing starts according to theconference.mixing start time. o <mixing-end-offset>: The<available-media><mixing-end-offset> child elementis used to describethat specifies the time a conference mediacharacteristics ofmixing stops after theconference.conference stops. Thefollowing sections describe these elements in more detail. Other<mixing-end-offset> childelements MAY be defined inelement expresses thefuture to extendoffset as signed integers representing seconds before/after the<conference-description> element. 4.1.1. <conference-time> The <conference-time>iCalendar DTEND field [3]. If the <mixing-end-offset> elementcontainsis not present, it indicates that theinformation related toconferencetime and duration of a conference.occurrence is not bounded. The<conference-time> element contains one or more <entry><mixing-end-offset> elementseach definingboth have the mandatory 'required-participant' attribute. This attribute has one of 4 values: "none", "administrator", "moderator", and "participant". This attribute allows a privileged user to define when media mixing ends based on the earlier of the <mixing-end-offset>, and the timeinformation specifying a singlethe last participant, or moderator leaves. If the value is set to "none", mixing stops according to the <mixing-end- offset>. If the conferenceoccurrence. Every <entry> element contains a <mixing-start-offset> child elementpolicy was modified so thatspecifies whenlast privileged user is now a normal conferencemedia mixing starts beforeparticipant, and the conferencestarts, <mixing-end-offset> child elementrequires a privileged user to continue; thatspecifiesconference MUST terminate. o <can-join-after-offset>: An administrator can indicate the time when users can join a conferencemedia mixing stopsby populating the <can-join- after-offset> element. Novo, et al. Expires May 3, 2008 [Page 14] Internet-Draft Data Model Schema October 2007 o <must-join-before-offset>: An administrator can define the time after which new users are not allowed to join the conferencestops. The <mixing-end-offset> childanymore. This is done by populating the <must-join-before-offset> elementexpressesexpressing the offset as signed integers representing seconds before/afterDTENDDTSTART field.The <mixing- start-offset> childo <request-user>: It is possible to define the time when users or resources on the <allowed-users-list> are requested to join the conference by using the <request-users> element. This element expresses the offset as signed integers representing seconds before/after DTSTART field.If the <mixing- start-offset>o <notify-end-of-conference>: The <notify-end-of-conference> elementis not present, it indicates thatdefines in seconds when the system has to send a notification when the end of the conferencemedia mixing starts immediately.is approaching. If the<mixing-end- offset><notify-end-of- conference> element is not present, it indicates that the system does not notify the users when the end of the conferenceoccurrenceisnot bounded. <mixing-start-offset> and <mixing-end- offset> elements both haveapproaching. The <notify-end-of-conference> child element expresses the offset as signed integers representing seconds after DTSTART field. o <allowed-extend-mixing-end-offset>: The <allowed-extend-mixing- end-offset> refers to the possibility to extend the conference. It has a boolean value. 4.2.7. <conf-uris> The <conf-uris> contains the identifiers to be used in order to access themandatory 'require-participant' attribute. This attribute has oneconference by different signaling means. The <conf-uris> element is described in section 5.3.1 of4 values: "none", "administrator", "moderator", and "participant". For <mixing-start- offset>, this attribute allows a privileged userRFC 4575[1]. Future extensions to this schema may definewhen media mixing starts based onnew values and register them with IANA. 4.2.8. <service-uris> The <service-uris> describes auxiliary services available for thelatterconference. The <service-uris> element is described in section 5.3.2 ofthe mixing start time,RFC4575[1]. Future extensions to this schema may define new values and register them with IANA. 4.2.9. <maximum-user-count> The <maximum-user-count> contains thetime the first participant, administrator, or moderator arrives. Ifoverall number of users allowed to join the conference. Note that this value is setto "none'", mixing starts according toby an administrator and can reflect any local policies such as network consumption, CPU processing power, and licensing rules. 4.2.10. <available-media> The <available-media> has themixing start time. For <mixing-end-offset>, this'label' attribute that is the media stream identifier assigned by the conferencing server. The attributeallows aNovo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page14]15] Internet-Draft Data Model SchemaAprilOctober 2007privileged user to define when media mixing ends based on the earlier'label' is described in RFC 4575 [1], section 5.3.4. The <available- media> element contains a sequence of <entry> child elements. Each <entry> element contains the<mixing-end-offset>, and the time the last participant, or moderator leaves. If the valuefollowing child elements: o The <type> element isset to "none", mixing stops according to the <mixing-end-offset>. If the conference policy was modified so that last privileged userdescribed in section 5.3.4 of RFC 4575 [1]. o The <display-text> element is described in section 5.3.4 of RFC 4575 [1]. o The <status> element isnow a normal conference participant, and the conference requires a privileged user to continue; that conference MUST terminate. An administrator can indicate the time when users can joindescribed in section 5.3.4 of RFC 4575 [1]. o The child element <mixing-mode> describes aconferencedefault policy bypopulatingwhich the<can-join-after-offset> element. Similarly, an administrator can definemixer will build thetime after which new users are not allowed to joinoutgoing stream from theconference anymore. Thisincoming streams. Notice that this policy isdone by populatingdifferent than the<must-join-before-offset> element expressingpolicy describing theoffset as signed integers representing seconds before/after DTSTART field.floors for each media. The<base><mixing-mode> child elementspecifiesMUST contain one and only one of theiCalendar object"Moderator- controlled", "FCFS", and "Automatic" values indicating the default algorithm to use with every media stream. The "Moderator- controlled" value indicates that the moderator of theconference.conference, controls the media stream policy. TheiCalendar object components are defined in [3]."FCFS" value indicates a 'first-come-first-served' policy. o The<entry><codecs> elementalso containsspecifies the<request-user> child element.allowed codecs in the conference. Itis possible to definehas an attribute 'decision' that specifies if thetime when usersfocus decides the common codec automatically orresources onneeds the<allowed-users-list> is requested to joinapproval of theconference by usingmoderator of the<request-users> element. Thisconference ("automatic", "moderator- controlled"). The <codecs> elementexpressescontains <entry> elements. A <entry> element can have theoffset as signed integers representing seconds before/after DTSTART field.attribute 'name' and 'policy'. The<notify-end-of-conference> element defines in seconds when'name' attribute identifies a codec. The list of possible codecs accepted as a 'name' attribute is defined by the IANA registry for RTP Payload Types. The possible values of thesystem has to send a notification whenattribute 'name' are theendvalues of theconference is approaching. If'subtype' column of the<notify-end-of-conference>RTP Payload Format media types per RFC4855[9] defined in IANA [10]. The 'policy' attribute contains the policy for that codec (allowed, or disallowed). o The <controls> element contains the basic audio and video global control elements for a conference. It isnot present, it indicatesexpected that for thesystem does not notify the users when the endmajority of the basic conferences, these controls are sufficient. If the conference server wants to support more advanced controls, then it isapproaching. The <notify-end-of- conference> child element expresses the offset as signed integers representing seconds before/after DTSTART field. The <allowed- extend-mixing-end-offset> refersrecommended that an extension to thepossibility to extenddata model be used. In theconference. It has two values: "allowed", "denied". 4.1.2. <conf-uris> The <conf-uris> contains<controls> element theidentifiers toschema is extensible, hence new control types can beusedadded inorder to accesstheconference by different signaling means. It contains a sequence of child elements: <entry>, <H.323>, and <PSTN-ISDN>.future. So moderator controls that affect all media output would go under the <available-media> element. The<entry>following controls elements are defined for <controls>: * The <mute> elementrefers to the SIP protocol. It keeps the same name thatisdefinedused in[1] to maintain backwards compatibilityconjunction withthis RFC. The <entry> element containsan audio stream to cease transmission of associated media. That means that for the<uri>, <display-text>,entire duration where mute is applicable, all current and<purpose> which are described in [1]. The currently defined <purpose> values to be used withfuture participants of the<conf-uris> are: o participation: Accessing a URI with this <purpose>conference are muted and willbringnot receive any audio. It has a "boolean" value. If this control is not specified, access to theparty intocontrol is not available to theconferenceNovo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page15]16] Internet-Draft Data Model SchemaAprilOctober 2007o streaming: Accessing a URIclient. * The <pause-video> element is used in conjunction with a video stream to cease transmission of associated media. It has a "boolean" value. If this<purpose> will commence streamingcontrol is not specified, theconference, butaccess to the control is notallow active participationavailable to the client. * The<H.323><gain> elementincludes either a <H.323-alias> or a <H.323-URI> child elements. The <PSTN-ISDN> has an attribute 'PIN code'is used in conjunction with a media output stream to indicate thePIN codeamount of amplification of an audio stream. It has an "int" number value. This control has two attributes that defines theconference if usedminimum anda 'purpose' attribute that describesmaximum amplification levels: 'min' and 'max'. If this control is not specified, access to theuser which phone number to use. The <PSTN-ISDN> element may include one or more <phone number> child elements. 4.1.3. <service-uris> The <service-uris> describes auxiliary servicescontrol is not availableforto theconference. It contains a sequence of child elements: <entry>, <H.323>, and <PSTN-ISDN>.client. * The<entry> child<video-layout> elementcontains <uri>, <display-text>, and <purpose>. The purpose will beis used in conjunction with a video stream todescribespecify how theservice. The currently defined <purpose> values tovideo streams (of participants) are viewed by each participant. Only one layout type can beused withspecified for each output stream. If there are fewer participants than panels in the<service-uris> are: o web-page: Indicatesspecified layout, then blanking (black screen) MAY be mixed into theweb page containingstream on the behalf of the missing input streams. If unspecified, the <video-layout> default type SHOULD be "single-view". The <layout> types are as follows, although any number of custom layouts may be specified in future extensions: + single-view: Only one stream is presented by theadditional information aboutfocus to all participants in one panel. + dual-view: This dual view option will present theconference o recording: Indicatesvideo side-by-side in 2 panels and not alter thelink at whichaspect ratio of therecorded conference context can be retrieved o event: Indicatesstreams. This will require theURI at which a subscriptionfocus to introduce blanking on parts of theconference event package may be requested. This would typically beoverall image as viewed by theconference URI ofparticipants. + dual-view-crop: This side-by-side layout option instructs themain conference Future extensionsfocus tothis schema may define new values and register them with IANA. These elements are described in [1]. <H.323>, and <PSTN-ISDN> child elements are described in the <conf-uris> section. 4.1.4. <maximum-user-count> The <maximum-user-count> containsalter theoverall numberaspect ratio ofusers allowed to jointheconference. Notestreams (alter- aspect-ratio=TRUE) so thatthis valueblanking isset by an administrator and can reflect any local policies such as network consumption, CPU processing power, and licensing rules. 4.1.5. <available-media>not necessary. The<available-media> has the 'label' attribute that isfocus handles themedia stream identifier assigned bycropping of theconferencing server.streams. + dual-view-2x1: Thiselement contains a sequence of <entry> child elements of conference-medium- type. Each <entry> element containslayout option instructs the<type>, <display-text>, <status>, <mixing-mode>, <mix-level>, <controls> and <codecs> child elements. The attribute 'label'focus to place one stream above the other, in essence with two rows and one column. In this option the<type>, <display-text>,aspect ratio is not altered and<status> elements are describedblanking is introduced. + dual-view-2x1-crop: This layout option also instructs the focus to place one stream above the other, in[1]. The <codecs> element specifiesessence with two rows and one column. In this option theallowed codecs inaspect ratio is altered and theconference. It has an attribute 'decision' that specifies ifvideo streams are cropped. + quad-view: Four equal-sized panels in a 2x2 layout is presented by the focusdecides the common codec automatically or needsto all participants. Typically theapprovalaspect ratio of themoderator ofstreams are maintained (alter-aspect- ratio= FALSE). + multiple-3x3: Nine equal-sized panels in a 3x3 layout is presented by theconference ("automatic", "moderator-controlled"). The <codecs> element contains <entry> elements. A <entry> element can havefocus to all participants. Typically the aspect ratio of the streams are preserved. Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page16]17] Internet-Draft Data Model SchemaAprilOctober 2007attribute 'name' and 'policy'. The 'name' attribute identifies a codec, and the 'decision' attribute contains the policy for that codec (allowed, or disallowed). The child elements <mixing-mode> and <mix-level> describe+ multiple-4x4: Sixteen equal-sized panels in adefault policy by which the mixer will build the outgoing stream from the incoming streams. Notice that this policy4x4 layout isdifferent than the policy describingpresented by thefloors for each media. The <mix-level> child element describesfocus to all participants. Typically thenumberaspect ratio ofparticipants in audio media streams orthenumber of sub-windows in video mediastreams(for instance,are preserved. + multiple-5x1: This option refers to avalue5x1 layout where one panel will occupy 4/9 of"4" inthe<mix-level> element formixed videostreams implies a 2x2 layout). The <mixing-mode> child element MUST contain one and only one ofstream while the"Moderator-controlled", "FCFS", and "Automatic" values indicatingothers will each occupy 1/9 of thedefault algorithm to be use with every mediastream.The next section explainsTypically the<controls> child element. 4.1.5.1. <controls>aspect ratio of the streams is preserved. + automatic: This option allows the focus to add panels as streams are added. 4.3. <host-info> The<controls><host-info> element contains information about the entity hosting thebasic audio and video global controls for aconference.ItThis information isexpected that for the majority of the basic conferences, these controls are sufficient. If theset before conferenceserver wants to support more advanced controls, then itactivation, and isrecommended that an extension of the data model be used. Inrarely changed during the<controls>conference lifetime. The <host-info> elementthe schema is extensible, hence new control types can be addedand its child elements are described inthe future. Similarly, controls that applyRFC4575[1], section 5.4. Future extensions toa specific user would appear under the <users>/<user>/<endpoint> element. So moderator controls that affect all media output would go underthe<available-media> element. 4.1.5.1.1. mute<host-info> element may define new values. 4.4. <conference-state> The'mute' control<conference-state> isusedintroduced inconjunction with an audio stream to cease transmission of associated media. It hasRFC4575 [1]. The <conference-state> element contains the <allow-conference-event- subscription>, <user-count>, <active>, and <locked> child elements. 4.4.1. <allow-conference-event-subscription> The <allow-conference-event-subscription> element represents a"boolean" value.boolean action. Ifthis control is not specified, accessset to TRUE, thecontrolfocus isnot availableinstructed to allow theclient and media SHOULD NOT be transportedsubscription to conference state events, such as RFC4575 'SIP Event Package for Conference State' [1]. If set to FALSE, theassociated media stream. 4.1.5.1.2. pause-video The 'pause-video' control is used in conjunction with a video streamsubscription tocease transmission of associated media. It has a "boolean" value.conference state events would be rejected. If thiscontrol is not specified, access to the controlelement isnot available toundefined it has a default value of TRUE, causing theclient and media SHOULD NOTsubscription to conference state events to betransported for the associated media stream.accepted. 4.4.2. <user-count> The <user-count> child element is explained in RFC 4575 [1], section 5.5.1. 4.4.3. <active> The <active> child element is explained in RFC 4575 [1], section 5.5.2. Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page17]18] Internet-Draft Data Model SchemaAprilOctober 20074.1.5.1.3. gain4.4.4. <locked> The'gain' control<locked> child element isusedexplained inconjunction with a media output stream to indicate the amount of amplification of an audio stream. It has a "int" number value. If this control is not specified, access to the control is not available to the client. 4.1.5.1.4. video-layoutRFC 4575 [1], section 5.5.3. 4.5. <floor-information> The'video-layout' control is used in conjunction with a video stream to specify how the video streams (participants) are viewed by each participant. Only one layout type can be specified for each output stream. If there are fewer participants than panels in<floor-information> element contains thespecified layout, then blanking (black screen)<conference-ID>, <allow- floor-events>, <floor-request-handling>, and <conference-floor- policy> child elements. Other elements from different namespaces MAY bemixed into the stream onpresent for thebehalfpurposes of extensibility. The absence of this element from an XML document indicates that themissing input streams. If unspecified, the <video- layout> default type SHOULD be "single-view".conference does not have a floor. 4.5.1. <conference-ID> The<layout> types are as follows: single-view: Only one stream<conference-ID> ispresented by the focus to all participants in one panel. dual-view: This dual view option will present the video side-by-sidea 32-bit BFCP conference identifier defined in2 panels and not alter the aspect ratio of the streams. This will require the focus to introduce blanking on parts ofRFC4582 [5] section 5.1. that identifies theoverall image as viewed byBFCP conference theparticipants. dual-view-crop:message belongs to. Thisside-by-side layout option instructsidentifier represents a conference instance within floor control. When created within thefocus to alterconferencing system, theaspect ratio of'conference-ID' has a 1:1 mapping to thestreams (alter-aspect-ratio=TRUE) so that blanking is not necessary.unique conference object Identifier (XCON-URI). 4.5.2. <allow-floor-events> Thefocus handles<allow-floor-events> element represents a boolean action. If set to TRUE, thecropping offocus is instructed to accept thestreams. dual-view-2x1: This layout option instructssubscription to floor control events. If set to FALSE, the focus is instructed toplace one stream abovereject theother, in essence with two rows and one column. Insubscription. If thisoption the aspect ratio is not altered and blankingelement isintroduced. dual-view-2x1-crop: This layout option also instructsundefined, it has a default value of FALSE, causing thefocussubscription toplace one stream above the other, in essence withfloor control events to be rejected. There are tworowsmethods which a conference participant subscribes himself to a floor control event. One method is using an offer/ answer exchange mechanism (RFC3264 [11]) using SIP INVITE andone column. In this optionBFCP parameters in theaspect ratioSDP (RFC4583 [12]). The other method isaltereda general authorization mechanism described in section 9 of RFC4582 [5] andthe video streams are cropped. quad-view: Four equal-sized panelsina 2x2 layout is presentedRFC5018 [13]. Future documentation may define additional connection mechanisms. 4.5.3. <floor-request-handling> The <floor-request-handling> element defines the actions used by the conference focus toall participants. Typically the aspect ratio ofcontrol floor requests. This element defines thestreams are maintained (alter-aspect-ratio= FALSE). multiple-3x3: Nine equal-sized panels in a 3x3 layout is presented byaction that the focus is toall participants. Typically the aspect ratio of thetake when processing a particular request to a floor within a conference. This element defines values of: Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page18]19] Internet-Draft Data Model SchemaAprilOctober 2007streams are preserved. multiple-4x4: Sixteen equal-sized panels in a 4x4 layout is presented byo "block": This action instructs the focus toall participants. Typicallydeny theaspect ratio offloor request. This action is thestreams are preserved. multiple-5x1:default action taken in the absence of any other actions. o "confirm": Thisoption refersaction instructs the focus toa 5x1 layout where one panel will occupy 4/9 ofallow themixed video stream whilerequest. The focus then uses theothers will each occupy 1/9 ofdefined floor algorithm to further allow or deny thestream. Typicallyfloor. The algorithms used are outside theaspect ratioscope of this document. Note that this section discusses floor control information, therefore, thestreamsvalue "block" in a <floor-request-handling> element ispreserved. automatic: This option allowsnot related with thefocus to add panels as streams are added up to a limit of "panels". 4.2. <host-info>"block" value in the <join-handling> element (see Section 4.6). 4.5.4. <conference-floor-policy> The<host-info><conference-floor-policy> elementcontainsis mandatory. One or more <floor> elements can appear in the <conference-floor-policy> element. Each <floor> element has the following child elements: o <media-label>: Every floor is identified for one or more mandatory <media-label> element. If the <available-media> informationaboutis included in theentity hostingconference document, the value of this element MUST be equal to the 'label' value of the corresponding media stream <entry> in the <available-media> container. The number of those elements indicates how many floors the conference can have. A floor can be used for one or more media types; o <algorithm>: A floor can be controlled using many algorithms; theconference. This information ismandatory <algorithm> element MUST be setbeforeto any of theconference activation, and is rarely changed during"moderator-controlled", "FCFS" or "random" values indicating theconference lifetime.algorithm. The<host-info> element contains"Moderator-controlled" value indicates that the<display-text>, <web-page> and <uris> child elements.moderator of the conference controls the floor. The<display-text> and <web-page> child elements are explained in [1]."FCFS" value states for 'first-come-first-served' floor control. o <max-floor-users>: The<uris> child element contains a sequence of<max-floor-users> childelements: <entry>, <H.323>, and <PSTN-ISDN>. The <entry>elementrefers to the SIP protocol. It keeps the same name that is definedin[1] to maintain backwards compatibility with this RFC. Future extensions tothe<uris><floor> elementmay define new values. 4.3. <conference-state>is optional and, if present, dictates the maximum number of users who can have the floor at one time. o <moderator-id>: The<conference-state> element andoptional <moderator-id> indicates the<user-count>, <active>, and <locked> child elements are explained in section 5.5'User ID' of[1].the moderator. The<allow-conference-event-subscription> element represents'User ID' is aboolean action. IfBFCP identifier defined in RFC4582 [5] section 5.1. It MUST be setto TRUE,if thefocuselement <algorithm> isinstructed to allow the subscription to conference state events, such as the SIP Event Package for Conference State [1]. Ifset toFALSE, the subscription"Moderator-controlled" value. Note that RFC4582 [5] refers toconference state events would be rejected. If this element is undefined it has a default value of TRUE, causingthesubscription to conference state events to be accepted. 4.4. <floor-information>moderator role as a 'floor chair'. 4.6. <users> The<floor-information><users> elementhas the <conference-ID>, <allow- floor-events>, <floor-request-handling>,is described in RFC4575 [1] and<conference-floor- policy> child elements. Other elements from different namespaces MAY be present forcontains thepurposes of extensibility. This element has its own XML namespace. The absence of<join-handling>, <user-admission-policy>, and <allowed-users-list> defined in thisnamespacedocument andits<user> child elementsfrom an XML document indicatesdefined in RFC4575[1]. Notice that theconference<users> element does not havea floor.the Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page19]20] Internet-Draft Data Model SchemaAprilOctober 2007The <conference-ID> is used by a floor control server to provide a client with a conference ID. The <allow-floor-events> element represents a boolean action. If set to TRUE, the focus is instructed to accept the subscription to floor control events. If set to FALSE, the focus is instructed to reject the subscription. Ifattribute 'state' defined in RFC4575[1] for this elementis undefined, it has a default value of FALSE, causing the subscription to floor control eventsbecause this attribute only applies to notifications mechanism. The following sections describe these elements in more detail. Other child elements and attributes can berejected.used to extend <users> in the future. 4.6.1. <join-handling> The<floor-request-handling><join-handling> element defines the actions used by the conference focus to controlfloor requests.conference participation. This element defines the action that the focus is to take when processing a particular request toa floor withinjoin a conference. This element defines values of: o "block": This action instructs the focus to deny access to thefloor request.conference. This action is the default action taken in the absence of any other actions. o "confirm": This action instructs the focus toallow the request. The focus then uses the defined floor algorithm to further allow or deny the floor. The algorithms used are outside the scope of this document. Note that placing a value of "block" for this element does not guarantee that a participant is blocked from joiningplace theconference. Any other rule that might evaluate to TRUE for thisparticipantthat carried an action whose value was higher than "block" would automatically grant confirm/allow permission to that participant. The <conference-floor-policy> element is mandatory and contains the required boolean attribute that indicates if the floor is moderator controlled or not. One or more <floor> elements can appear inon a pending list (e.g., by parking the<conference-floor-policy> element. Every floor is defined usingcall on a music-on-hold server), awaiting moderator input for further actions. o "allow": This action instructs the'label' attribute. Iffocus to accept the<available-media> information is included inconference join request and grant access to the conferencedocument,within thevalueinstructions specified in the transformations of thisattribute MUST be equal torule. o "authenticate": This action instructs the'label' valuefocus that the user has to provide a combination of username/password. o "directed-operator": This action instructs thecorresponding media stream <entry> infocus to direct the<available-media> container.user to an operator. 4.6.2. <user-admission-policy> Thenumber of those elements indicates how many floors<user-admission-policy> is an element that lets an organizer (or a participant with appropriate rights) choose a policy for the conferencecan have.that controls how users are allowed into the conference. The list of possible values are: o "closedAuthenticated": Afloor can'closedAuthenticated' policy requires each conference participant to beused for one or more media types;in themandatory <media-types> element can contain zero or more ofallowed users list (listed under the<video>, <audio>, <application>, <data> ,<control>, <message>, and <text> elements indicating<allowed-users-list> XML element) with each participant being sufficiently (up to local policy) authenticated. Conference join requests for users not in themediaallowed users list or participants not authenticated should be rejected unless a <join-handling> action of 'confirm' is selected in which case thefloor. One type of media can only appear once. Other media types can be defined by extensions. A floor canuser is placed on a pending list as indicated earlier. o "openAuthenticated": An 'openAuthenticated' policy requires each conferencing participant to becontrolled using many algorithms; the mandatory <algorithm> element MUST contain one and only one ofsufficiently authenticated (as before) but does not restrict which participants can join the<moderator- controlled>, <FCFS>, and <random> elements indicatingconference. Typically this implies that anyone capable of authenticating with thealgorithm. The <max-floor-users> child element inconferencing system may join the<floor> element isconference. Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page20]21] Internet-Draft Data Model SchemaAprilOctober 2007optional and, if present, dictateso "anonymous": An 'anonymous' policy allows any join requests in and is themaximum numberleast restrictive policy. 4.6.3. <allowed-users-list> The <allowed-users-list> child element contains a list ofusersuser URIs, PSTN phone numbers, roles, or domains (*@example.com) that the focus uses to determine who canhave the floor at one time. The optional <chair-id> indicates the BFCP UserID ofjoin themoderator. It MUSTconference, who can beset ifinvited to join a conference, or who theattribute moderator-controlled is setfocus needs toTRUE. 4.5. <users>"refer to" the conference. The<users><allowed-users-list> elementcontains the <join-handling>, <user-admission- policy>, <allowed-users-list>, and <user>includes zero or more <target> child elements.The <join-handling> element defines the actions used by the conference focus to control conference participation.This child elementdefinesincludes theaction thatmandatory 'uri' attribute and thefocusmandatory 'method' attribute. The same 'uri' attribute with different method values can appear in the list more than once. The 'method' attribute isto take when processing a particular request to joinaconference. This element defines values of:list with the following values: o"block": This action instructs"dial-in": The value "dial-in" is used by the focus todeny access todetermine who can join the conference.This action is the default action taken in the absenceo "dial-out": The value "dial-out" contains a list ofany other actions.resources that the focus will initiate a session with. o"confirm": This action instructs"refer": The value "refer" is used by the focus toplacedetermine theparticipant on a pending list (e.g.,resources that the focus needs to "refer to" the conference. In SIP, this is achieved byparkingthecall onfocus sending amusic-on-hold server), awaiting moderator input for further actions. o "allow": This action instructsREFER request to those potential participants. In a different paradigm, this could also mean that the focus sends an SMS or an email toaccepttheconference join request and grant access toreferred user. This list can be updated during the conferencewithinlifetime so it can be used for mid-conference refers as well. The "refer" value differs from theinstructions specified"dial-out" inthe transformations of this rule. o "IVR": This action instructs the focusthat theuser hasresources on the "refer" value are expected toprovideinitiate thePIN code. o "directed-operator": This action instructssession establishment toward the focusto direct the user to an operator. Notethemselves. It is also envisioned thatplacingdifferent users will have different access rights to those lists and therefore avalue of block for thisseparation between the two is needed. 4.6.4. <user> and Its <user> Sub-elements The elementdoes not guarantee that<user> is described in RFC5475[1] and describes a single participantis blocked from joiningin the conference.Any other ruleThe <user> element has an attribute 'entity'. Notice thatmight evaluate to TRUEthe <user> element does not have the attribute 'state' defined in RFC4575[1] for thisparticipant that carried an action whose value was higher than "block" would automatically grant confirm/allow permissionelement because this attribute only applies to notifications mechanism. o The attribute 'entity' contains a unique conference user identifier (XCON_USERID). Other user identifiers can be associated with this conference user identifier and enable the conferencing system to correlate and map these multiple authenticated user identities tothat participant. The <user-admission-policy> is an element that lets an organizer (or a participant with appropriate rights) chooseapolicy for the conference that controls how users are allowed intosingle global user identifier. Novo, et al. Expires May 3, 2008 [Page 22] Internet-Draft Data Model Schema October 2007 Figure 4 illustrates an example using theconference. A 'closedAuthenticated' policy requires eachconferenceparticipant to beuser identifier inthe allowed users list (listed under the <allowed-users- list> XML element)association witheach participant being sufficiently (up to local policy) authenticated. Conference join requests for users not intheallowed users list or participants not authenticateduser identity defined for BFCP, SIP, and H323 user identity. It should berejected unlessnoted that a<join-handling> action of 'confirm'conferencing system isselected in which case the userfree to structure such relationships as required and this information isplaced on a pending listjust included asindicated earlier. An 'openAuthenticated' policy requires each conferencing participant toa guideline that can besufficiently authenticated (as before) but does not restrictused. +--------------+ | Conference | | User | | Identifier | +--------------+ | John | +------+-------+ | | | +---------------------+---------------------+ | | | +-------+--------+ +-------+-------+ +--------+-------+ | BFCP User ID | | SIP User ID | | H323 User ID | +----------------+ +---------------+ +----------------+ | HK37ihdaj | | 123674 | | 928373 | +----------------+ +---------------+ +----------------+ Figure 4: Conference Object Mapping The element <user> element contains the <display-text>, <associated- aors>, <provide-anonymity>, <roles>, <languages>, <cascaded-focus>, <allow-refer-users-dynamically>, <allow-invite-users-dynamically>, <allow-remove-users-dynamically>, and <endpoint>. The following sections describe these elements in more detail. 4.6.4.1. <display-text> The <display-text> child element is explained in RFC 4575 [1], section 5.6.1. 4.6.4.2. <associated-aors> The <associated-aors> child element is explained in RFC 4575 [1], section 5.6.2. Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page21]23] Internet-Draft Data Model SchemaAprilOctober 2007which participants can join4.6.4.3. <provide-anonymity> The <provide-anonymity> element provides anonymity to theconference. Typicallyuser. In thisimplies that anyone capablecase, the focus provides to the rest ofauthenticating withtheconferencing system may joinparticipants an anonymous identity for that user, for example anonymousX. This element only affects theconference. An 'anonymous' policy allows any join requests in andway the user information is provided to theleast restrictive in policies.other participants. Thefollowing sections describereal information about theremaining elementsuser is still stored inmore detail. Other child elementsthe data model. This can beused to extend <conference- description> inachieved by using thefuture. 4.5.1. <allowed-users-list> The <allowed-users-list> child element contains<provide-anonymity> element. It is alist of user URIs, PSTN phone numbers, roles, or domains (*@example.com) that the focus uses to determine who can join the conference, who can be invitedboolean transformation. If set tojoin a conference, or whoTRUE, thefocus needs to "refer to"conference participants will see an anonymous identity for theconference.user. 4.6.4.4. <roles> The<allowed-users-list> element includes zero or more <target> child elements. This<roles> child elementincludes the mandatory 'uri' attribute and the mandatory 'method' attribute. The same 'uri' attribute with different method values can appearis explained inthe list more than once.RFC 4575 [1], section 5.6.3. 4.6.4.5. <languages> The'method' attribute<languages> child element isa list with the following values: "dial-in", "dial-out", and "refer".explained in RFC 4575 [1], section 5.6.4. 4.6.4.6. <cascaded-focus> Thevalue "dial-in"<cascaded-focus> child element isused by the focus to determine who can join the conference.explained in RFC 4575 [1], section 5.6.5. 4.6.4.7. <allow-refer-users-dynamically> Thevalue "refer"<allow-refer-users-dynamically> element represents a boolean action. If set to TRUE, a participant isused byallowed to instruct the focus todeterminerefer a user to theresources thatconference without modifying thefocus needs<allowed-users-list> (in SIP terms, a participant is allowed to send a REFER request to"refer to"theconference. In SIP, this is achieved byfocus which results in the focus sending a REFER request tothose potential participants. In a different paradigm, this could also mean thatthefocus sends an SMS or an emailuser the referrer wishes to join thereferred user. This list can be updated duringconference). If set to FALSE, theconference lifetime sorefer request is rejected. If this element is undefined itcan be used for mid- conference refers as well. The "refer"has a valuediffers from the "dial-out" in thatof FALSE, causing the"dial-out" containsrefer to be rejected. 4.6.4.8. <allow-invite-users-dynamically> The <allow-invite-users-dynamically> element represents alist of resources thatboolean action. If set to TRUE, a participant is allowed to instruct the focuswill initiateto invite asession with. The resources on the "refer" value, on the other hand, are expecteduser toinitiatethesession establishment towardconference without modifying thefocus themselves. It<allowed-users-list> list (in SIP terms, a participant isalso envisioned that difference users will have different access rightsallowed tothose lists and thereforesend aseparation betweenREFER request to thetwo is needed. 4.5.2. <user> The element <user> describes a single participantfocus which results in theconference. The following elements of <user> are defined in [1], section 5.6: <display-text>, <associated-aors>, <roles>, <languages>, <cascaded- focus>, and <endpoint>. <user> has two attributes: 'entity' and 'state'. The attribute 'state' is defined in [1], section 5.6. The attribute 'entity' contains a unique conference user identifier. Other user identifiers can be associated with this conferencefocus sending an INVITE request to the user the referrer wishes to join the conference). If set to FALSE, the refer request is rejected. If Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page22]24] Internet-Draft Data Model SchemaAprilOctober 2007identifier and enablethis element is undefined it has a value of FALSE, causing theconferencing systemrefer tocorrelate and map these multiple authenticated user identitiesbe rejected. 4.6.4.9. <allow-remove-users-dynamically> The <allow-remove-users-dynamically> element represents a boolean action. If set to TRUE, a participant is allowed to instruct the focus to remove asingle globaluseridentifier. Figure 4 illustrates an example usingfrom the conferenceuser identifier in association withwithout modifying theuser identity defined for BFCP, SIP, and H323 user identity. It should be noted thatruleset (in SIP terms, aconferencing systemparticipant isfreeallowed tostructure such relationships as required and this information is just included assend aguideline that can be used. +--------------+ | Conference | | User | | Identifier | +--------------+ | John | +------+-------+ | | | +---------------------+---------------------+ | | | +-------+--------+ +-------+-------+ +--------+-------+ | BFCP User ID | | SIP User ID | | H323 User ID | +----------------+ +---------------+ +----------------+ | HK37ihdaj | | 123674 | | 928373 | +----------------+ +---------------+ +----------------+ Figure 4: Conference Object Mapping The <provide-anonymity> element provides anonymityREFER request to theuser. In this case, thefocusprovides to the rest ofwhich results in theparticipantsfocus sending ananonymous identity for that user, for example anonymousX. This element only affects the way the user information is shownBYE request to theoher participants. The real information about theuseris still stored inthedata model. This can be achieved by usingreferrer wishes to leave the<provide-anonymity> element. It is a boolean transformation.conference). If set toTRUE, the conference participants will see an anonymous identity forFALSE, theuser whose identityrefer request is rejected. If this element ispresent inundefined it has a value of FALSE, causing theconditions.refer to be rejected. 4.6.4.10. <endpoint> The <endpoint> child element is defined in RFC4575[1]. It can provide the desired level of detail about the user's devices and their signaling sessions taking part in the conference and has the following child elements defined inRFC 4575RFC4575 [1]: <display-text>, <referred>, <status>, <joining-method>, <joining-info>, <disconnection-method>, <disconnection-info>, <media>, and<call-info>. The<call- info>. Notice that the <endpoint> element does not have the attribute 'state' defined in RFC4575[1] for this element because this attribute only applies to notifications mechanism. Besides the <endpoint>/<media> child elements defined in RFC 4575[1], the <endpoint>/<media> element has two other child elements:<to-mixer>,<to- mixer>, and <from-mixer> described in theNovo, et al. Expires October 19, 2007 [Page 23] Internet-Draft Data Model Schema April 2007followingsection. 4.5.2.1.list: o <from-mixer>,<to-mixer> Similar to the controls defined in the <available-media> element,<to-mixer>: These are controls that apply to aparticular user appear at this place inuser's media stream being sent from thedata structure.mixer to the participants endpoint or to the mixer from the participants endpoint. The<to-mixer><to- mixer> element details properties associated with the incoming streams to themixer.mixer (streams sent to the mixer from the participant). The <from-mixer> element details properties associated with the outgoing streams from themixer.mixer (sent from the mixer to the participant). Both of these elements have the attribute 'name'. The 'name' attribute has the values "VideoIn", "VideoOut", "AudioOut", and "AudioIn". The "VideoOut" and "AudioOut" media streams detail properties associated with the outgoing video and audio from the mixer. The "VideoIn" and "AudioIn" media stream details properties associated with the incoming video and audio to the mixer. More values can be defined in the future. Each of these elements have the <floor> and <controls> childelements. 4.5.2.1.1. <floor>elements: Novo, et al. Expires May 3, 2008 [Page 25] Internet-Draft Data Model Schema October 2007 * The <floor> element describes a floor that joins this participant in the conference. If a participant, for instance, needs to talk in the conference, it first needs to get the floor from the chair of the conference. The <floor> element has a "Boolean" value. A value of FALSE indicates that this user does not hold the floor in this moment. If this control is not specified, this user SHOULD NOT specify the floor option.4.5.3.* Controls that apply to a specific user would appear under the <controls> element. 4.7. <sidebars-by-ref> The <sidebars-by-ref> element contains a set of <entry> child elements.Each <entry> childThis elementcontains a <user> childis described in RFC4575 [1], 5.9.1. Notice that the <sidebars-by-ref> elementwith a sidebar unique conference user identifier and a <display-text> child element. 4.5.4.does not have the attribute 'state' defined in RFC4575[1] for this element because this attribute only applies to notifications mechanism. 4.8. <sidebars-by-val> The <sidebars-by-val> element contains a set of <entry> child elements each containing information about a single sidebar.By using this element, the server can include a full or partial description of each sidebar (as a sub-conference)This element is described in RFC4575 [1], 5.9.2. Notice that thebody of<sidebars-by-val> element does not have themain conference document. Novo, et al. Expires October 19, 2007 [Page 24] Internet-Draft Data Model Schema April 2007attribute 'state' defined in RFC4575[1] for this element because this attribute only applies to notifications mechanism. 5. RELAX NG Schema In accordance with theXCON frameworkCentralized Conferencing Framework document [4], the Conference Object is a logical representation of a conference instance. The conference information schema contains core information that is utilized in any conference. It also contains the variable information part of the Conference Object. This specification defines some document fragments in RELAX NGformat.format [14]. namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0" namespace local = "" namespacens1ns2 ="urn:ietf:params:xml:ns:conference-info-urn""urn:ietf:params:xml:ns:conference-info" default namespacens2ns1 ="urn:ietf:params:xml:ns:conference-schema""urn:ietf:params:xml:ns:xcon-conference-info" start = element conference-info { conference-type } # CONFERENCE TYPE conference-type = Novo, et al. Expires May 3, 2008 [Page 26] Internet-Draft Data Model Schema October 2007 attribute entity { text },attribute version { xsd:unsignedInt }?, attribute state { state-type }?,anyAttribute, conference-description-type, element host-info {host-typeconference-info-urn* }?, element conference-state { conference-state-type }?, element floor-information { floor-information-type }?, element users { users-type }, element sidebars-by-ref { sidebars-by-ref-type }?, element sidebars-by-val { sidebars-by-val-type }?, anyElement* # CONFERENCE DESCRIPTION TYPE conference-description-type = element conference-description { attributexml:langlang { xsd:language }?,attribute state { state-type }?,anyAttribute, element display-text { text }?, element subject { text }?, element free-text { text }?, element keywords { list { xsd:string* } }?, element allow-sidebars { xsd:boolean }?, element conference-time { conferencetime-type }?, element conf-uris {uris-typeconference-info-urn* }?, element service-uris {uris-typeconference-info-urn* }?, element maximum-user-count { xsd:int }?, element available-media { conference-media-type }?, anyElement*Novo, et al. Expires October 19, 2007 [Page 25] Internet-Draft Data Model Schema April 2007} # CONFERENCE TIME conferencetime-type = anyAttribute, element entry { element base { text }?, element mixing-start-offset { xsd:dateTime { pattern = ".+T.+Z.*" }, attribute required-participant { single-role-type }, anyAttribute }?, element mixing-end-offset { xsd:dateTime { pattern = ".+T.+Z.*" }, attribute required-participant { single-role-type }, anyAttribute }?, element can-join-after-offset { xsd:dateTime { pattern = ".+T.+Z.*" } }?, element must-join-before-offset { Novo, et al. Expires May 3, 2008 [Page 27] Internet-Draft Data Model Schema October 2007 xsd:dateTime { pattern = ".+T.+Z.*" } }?, element notify-end-of-conference { xsd:int }?, element allowed-extend-mixing-end-offset {allowed-extend-mixing-valuesxsd:boolean }?, anyElement* }*, anyElement* #ALLOWED EXTEND MIXING VALUES allowed-extend-mixing-values = xsd:string "allowed" | xsd:string "denied" # URIS TYPE uris-type = attribute state { state-type }?, (element entry { uri-type }* & element H323 { H323-type }* & element PSTN-ISDN { PSTN-type }*), anyElement* # SIP TYPE uri-type = (element uri { xsd:anyURI }, element display-text { text }?, element purpose { text }?, anyElement*)* # H323 TYPE H323-type = element H.323-alias { text }?, element H.323-URI { xsd:anyURI }?, Novo, et al. Expires October 19, 2007 [Page 26] Internet-Draft Data Model Schema April 2007 anyElement* # PSTN TYPE PSTN-type = attribute PIN-code { xsd:unsignedInt }, attribute purpose { xsd:unsignedInt }, (element phone-number { xsd:unsignedInt }, anyElement*)+ #CONFERENCE MEDIA TYPE conference-media-type =attribute state { state-type }?,anyAttribute, element entry { conference-medium-type }*, anyElement* # CONFERENCE MEDIUM TYPE conference-medium-type = attribute label { text }, anyAttribute, element display-text { text }?, element type { text }?, element status { media-status-type }?, element mixing-mode { mix-mode-type }?, elementmix-level { xsd:unsignedInt }?, elementcodecs { codecs-type }?, element controls { controls-type }?, anyElement* # CONTROLS TYPE controls-type =attribute state { state-type }?,anyAttribute, element control { control-type }*, anyElement* # MIX MODE TYPE mix-mode-type = xsd:string "moderator-controlled" | xsd:string "FCFS" | xsd:string "automatic" # CODECS TYPE codecs-type = attribute decision { decision-type }, anyAttribute, element codec { codec-type }*, anyElement* # CODEC TYPE codec-type = attribute name { text }, attribute policy { policy-type}}, anyAttribute # DECISION TYPE decision-type = xsd:string "automatic" | xsd:string "moderator-controlled" # POLICY TYPEpolicy-type = xsd:string "allowed" | xsd:string "disallowed" # CONTROL TYPENovo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page27]28] Internet-Draft Data Model SchemaAprilOctober 2007 policy-type = xsd:string "allowed" | xsd:string "disallowed" # CONTROL TYPE control-type =elementanyAttribute, (element mute { xsd:boolean } | element pause-video { xsd:boolean } | element gain { xsd:int { minInclusive = "-127" maxInclusive = "127" } } | element video-layout { xsd:string "single-view" | xsd:string "dual-view" | xsd:string "dual-view-crop" | xsd:string "dual-view-2x1" | xsd:string "dual-view-2x1-crop" | xsd:string "quad-view" | xsd:string "multiple-3x3" | xsd:string "multiple-4x4" | xsd:string "multiple-5x1" | xsd:string "automatic" } |anyElement* # HOST TYPE host-type = (element display-text { text }, element web-page { xsd:anyURI }, element uris { uris-type }, anyElement*)*anyElement*) # CONFERENCE STATE TYPE conference-state-type = anyAttribute, element allow-conference-event-subscription { xsd:boolean }?, element user-count { xsd:unsignedInt }?, element active { xsd:boolean }?, element locked { xsd:boolean }?, anyElement* # FLOOR INFORMATION TYPE floor-information-type = anyAttribute, (element conference-ID { xsd:unsignedInt }, element allow-floor-events { xsd:boolean }, element floor-request-handling { floor-request-type }, element conference-floor-policy { Conference-floor-policy }, anyElement*)* # FLOOR REQUEST TYPE floor-request-type = xsd:string "block" | xsd:string "confirm" # CONFERENCE FLOOR POLICY Conference-floor-policy = anyAttribute, element floor {attribute moderator-controlled { xsd:boolean }, attribute label { text },anyAttribute,(element media-types { Novo, et al. Expires October 19, 2007 [Page 28] Internet-Draft Data Model Schema April 2007 xsd:string "video" | xsd:string "audio" | xsd:string "application" | xsd:string "data" | xsd:string "control" | xsd:string "message" | xsd:string "text" },element media-label { xsd:nonNegativeInteger }+, (element algorithm { xsd:string "moderator-controlled" Novo, et al. Expires May 3, 2008 [Page 29] Internet-Draft Data Model Schema October 2007 | xsd:string "FCFS" | xsd:string "random" }, element max-floor-users { xsd:nonNegativeInteger }, elementchair-idmoderator-id {xsd:anyURItext }, anyElement*)* }+ # USERS TYPE users-type =attribute state { state-type }?,anyAttribute, element join-handling { join-handling-type }?, element user-admission-policy { user-admission-policy-type }?, element user-must-be-specified { xsd:boolean }?, element allowed-users-list { UserList }?, element user { user-type }*, anyElement* # USERS ADMISSION POLICY user-admission-policy-type = xsd:string "closedAuthenticated" | xsd:string "openAuthenticated" | xsd:string "anonymous" # JOIN HANDLING TYPE join-handling-type = xsd:string "block" | xsd:string"allow""confirm" | xsd:string"confirm""allow" | xsd:string"IVR""authenticate" | xsd:string "directed-operator" # USERLIST UserList = anyAttribute, element target { target-type }*, anyElement* # TARGET TYPE target-type = attribute uri { xsd:anyURI }, attribute method { method-type}}, anyAttribute # METHOD TYPE method-type =Novo, et al. Expires October 19, 2007 [Page 29] Internet-Draft Data Model Schema April 2007xsd:string "dial-in" | xsd:string "dial-out" | xsd:string "refer" # USER TYPE user-type = attribute entity { xsd:anyURI },attribute state { state-type }?,anyAttribute, element display-text { text }?, element associated-aors {uris-typeconference-info-urn* }?, element provide-anonymity { xsd:boolean }?, Novo, et al. Expires May 3, 2008 [Page 30] Internet-Draft Data Model Schema October 2007 element roles {roles-typetext }?, element languages { list { xsd:language } }?, element cascaded-focus { xsd:anyURI }?, element allow-refer-users-dynamically { xsd:boolean }?, element allow-invite-users-dynamically { xsd:boolean }?, element allow-remove-users-dynamically { xsd:boolean }?, element endpoint { endpoint-type }*, anyElement* # ENDPOINT TYPE endpoint-type = attribute entity { text },attribute state { state-type }?,anyAttribute, element display-text { text }?, element referred { conference-info-urn* }?, element status { endpoint-status-type }?, element joining-method { joining-type }?, element joining-info { conference-info-urn* }?, element disconnection-method { disconnection-type }?, element disconnection-info { conference-info-urn* }?, element media { media-type }*, element call-info { conference-info-urn* }?, anyElement* # MEDIA TYPE media-type = attribute id { xsd:int },attribute state { state-type }?,anyAttribute, element display-text { text }?, element type { text }?, element label { text }?, element src-id { text }?, element status { media-status-type }?, element to-mixer { mixer-type }?, element from-mixer { mixer-type }?, anyElement* # MIXER TYPE mixer-type =attribute state { state-type }?, Novo, et al. Expires October 19, 2007 [Page 30] Internet-Draft Data Model Schema April 2007anyAttribute, (element floor { xsd:boolean }, element controls { controls-type })?, anyElement* # SIDEBARS-BY-REF TYPE sidebars-by-ref-type =attribute state { state-type }?,anyAttribute, element entry {uri-typeconference-info-urn* }*, anyElement* # SIDEBARS-BY-VAL TYPE Novo, et al. Expires May 3, 2008 [Page 31] Internet-Draft Data Model Schema October 2007 sidebars-by-val-type =attribute state { state-type }?,anyAttribute, element entry { conference-type }*, anyElement* #ROLES_TYPE roles-type = element entry { single-role-type }*, anyElement* #SINGLE ROLE TYPE single-role-type = xsd:string "administrator" | xsd:string"creator" | xsd:string"moderator" | xsd:string "participant" | xsd:string"observer""none" # ********************************* # EXTENSIBILITY OF THE SCHEMA # ********************************* # EXTENSIBILITY ELEMENTS anyElement = element * { (attribute * { text } | text | anyElement)* } # EXTENSIBILITY ATTRIBUTES anyAttribute = attribute * - (entity |version | state | xml:langlang | required-participant |PIN-code | purpose | role | type | min | max Novo, et al. Expires October 19, 2007 [Page 31] Internet-Draft Data Model Schema April 2007 |label | decision | name | policy |moderator-controlled |uri | method | id |domain |local:* |ns2:*)ns1:*) { text }* # ************************************************************* # TYPES DEFINED IN THE EVENT PACKAGE FOR CONFERENCE STATE # - RFC4575 - # ************************************************************* # WILDCARD FOR EVENT-PACKAGE NAMESPACE conference-info-urn = elementns1:** - (ns2:* | local:*) { mixed { (attribute * { text } | conference-info-urn)* }# DEFINITION OF STATE TYPE state-type = "full" | "partial" | "deleted"} Novo, et al. Expires May 3, 2008 [Page 32] Internet-Draft Data Model Schema October 2007 # DEFINITION OF ENDPOINT STATUS TYPE media-status-type = "recvonly" | "sendonly" | "sendrecv" | "inactive" # ENDPOINT STATUS TYPE endpoint-status-type = "pending" | "dialing-out" | "dialing-in" | "alerting" | "on-hold" | "connected" | "muted-via-focus" | "disconnecting" | "disconnected" # JOINING TYPE joining-type = "dialed-in" | "dialed-out" | "focus-owner" # DISCONNECTION TYPE disconnection-type = "departed" | "booted" | "failed" | "busy" 6. XML Schema Extensibility The Conference Information Data Model defined in this document is meant to be extensible toward specific application domains. Such extensions are accomplished by defining elements, child elements andNovo, et al. Expires October 19, 2007 [Page 32] Internet-Draft Data Model Schema April 2007attributes that are specific to the desired application domain. The IETF MAY extend the data model schema with extension elements from the same namespace, but other instances are free to extend it from other thanurn:ietf:params:xml:ns:conference-schema.urn:ietf:params:xml:ns:xcon-conference-info. Elements or attributes from unknown namespaces MUST be ignored. 7. XML Example The following is an example of a conference information document. The conference starts on October 17, 2007, at 10:30 AM in New York City and finishes the same day at 12:30 PM every week. In this example, there are currently 3 participants in a conference, one administrator, one moderator, and one participant. Note that sidebars are allowed in this conference and there is one sidebar in the conference. Also note that there is one floor moderator for the audio and a different floor moderator for the video. <?xml version="1.0" encoding="UTF-8"?> <conference-infoxmlns="urn:ietf:params:xml:ns:conference-schema" entity="conference123@example.com" state="full">xmlns="urn:ietf:params:xml:ns:xcon-conference-info" entity="conference123@example.com"> <!-- CONFERENCE DESCRIPTION Novo, et al. Expires May 3, 2008 [Page 33] Internet-Draft Data Model Schema October 2007 --> <conference-descriptionxml:lang="en-us">lang="en-us"> <display-text>Discussion of Formula-1 racing</display-text> <subject> Sports:Formula-1</subject> <free-text>This is a conference example</free-text> <keywords>Formula-1, cars</keywords> <webpage>http://www.example.com/users/formula-1</webpage><security-level>low</security-level><allow-sidebars>true</allow-sidebars><conference-stage>running</conference-stage><!-- CONFERENCE TIME --> <conference-time> <entry> <base>BEGIN:VCALENDAR PRODID:-//LlamaSpinner Inc.//NONSGML CamelCall//EN VERSION:2.0 BEGIN:VEVENT DTSTAMP:20061103T140728Z UID:20061103T140728Z-345FDA-carol@example.com ORGANIZER:MAILTO:carol@example.com DTSTART:20071017T143000ZNovo, et al. Expires October 19, 2007 [Page 33] Internet-Draft Data Model Schema April 2007RRULE:FREQ=WEEKLY DTEND:20071217T163000Z END:VEVENT END:VCALENDAR</base> <mixing-start-offset required-participant="moderator" > 2007-10-17T14:29:00Z</mixing-start-offset> <mixing-end-offset required-participant="participant" > 2007-10-17T16:31:00Z</mixing-end-offset> <must-join-before-offset > 2007-10-17T15:30:00Z</must-join-before-offset> </entry> </conference-time> <!-- CONFERENCE UNIQUE IDENTIFIERS --><conf-uris state="full"> <SIP><conf-uris> <entry> <uri>tel:+3585671234</uri> <display-text>Conference Bridge</display-text> <purpose>participation</purpose></SIP> <SIP> <uri>http://www.example.comlive.ram</uri></entry> <entry> <uri>http://www.example.com/live.ram</uri> <purpose>streaming</purpose></SIP></entry> </conf-uris> Novo, et al. Expires May 3, 2008 [Page 34] Internet-Draft Data Model Schema October 2007 <!-- SERVICE URIS --><service-uris state="full"> <SIP><service-uris> <entry> <uri>http://www.example.com/formula1/</uri> <purpose>web-page</purpose></SIP></entry> </service-uris> <!-- MAXIMUM USER COUNT --> <maximum-user-count> <entry role="administrator">2</entry> <entry role="moderator">5</entry> <entry role="participant">150</entry> </maximum-user-count> <!-- AVAILABLE MEDIA --> <available-media> <entry label="10234">Novo, et al. Expires October 19, 2007 [Page 34] Internet-Draft Data Model Schema April 2007<display-text>main audio</display-text> <type>audio</type> <status>sendrecv</status> <mixing-mode>automatic</mixing-mode> <mix-level>3</mix-level> <codecs decision="automatic"> <codec name="PCMU" policy="allowed"/> </codecs> </entry> <entry label="10235"> <display-text>main video</display-text> <type>video</type> <status>sendrecv</status> <mixing-mode>automatic</mixing-mode> <mix-level>4</mix-level> <codecs decision="automatic"> <codec name="H.263" policy="allowed"/> </codecs> </entry> </available-media> </conference-description> <!-- HOST INFO --> <host-info> <display-text>Formula1</display-text> Novo, et al. Expires May 3, 2008 [Page 35] Internet-Draft Data Model Schema October 2007 <web-page>http://www.example.com/formula1/</web-page><uris state="full"> <SIP><uris> <entry> <uri>sip:alice@example.com</uri></SIP> <SIP></entry> <entry> <uri>sip:carol@example.com</uri></SIP></entry> </uris> </host-info> <!-- CONFERENCE STATE --> <conference-state> <allow-conference-state>true</allow-conference-state> <user-count>3</user-count> <active>true</active> <locked>false</locked> </conference-state> <!-- FLOOR INFORMATION -->Novo, et al. Expires October 19, 2007 [Page 35] Internet-Draft Data Model Schema April 2007<floor-information> <conference-ID>567</conference-ID> <allow-floor-events>true</allow-floor-events> <floor-request-handling>confirm</floor-request-handling> <conference-floor-policy><floor moderator-controlled="true" label="10234"> <media-types>audio</media-types> <algorithm>moderator-controlled</algorithm> <max-floor-users>1</max-floor-users> <chair-id>sip:alice@example.com</chair-id> </floor> <floor moderator-controlled="true" label="10235"> <media-types>video</media-types><floor> <media-label>10234</media-label> <media-label>10235</media-label> <algorithm>moderator-controlled</algorithm> <max-floor-users>1</max-floor-users><chair-id>sip:carol@example.com</chair-id><moderator-id>234</moderator-id> </floor> </conference-floor-policy> </floor-information> <!-- USERS --><users state="full"><users> <join-handling>allow</join-handling> <user-admission-policy >openAuthenticated</user-admission-policy> <!-- ALLOWED USERS LIST --> <allowed-users-list> <target uri="sip:bob@example.com" method="dial-out"/> Novo, et al. Expires May 3, 2008 [Page 36] Internet-Draft Data Model Schema October 2007 <target uri="sip:alice@example.com" method="dial-out"/> <target uri="sip:carol@example.com" method="dial-out"/> <target uri="sip:john@example.com" method="refer"/> </allowed-users-list> <!-- USER BOB --> <userentity="bob534" state="partial">entity="bob534"> <display-text>Bob Hoskins</display-text><associated-aors state="full"><associated-aors> <SIP> <uri>mailto:bob@example.com</uri> <display-text>email</display-text> </SIP> </associated-aors> <provide-anonymity>false</provide-anonymity> <roles> <entry>participant</entry> </roles>Novo, et al. Expires October 19, 2007 [Page 36] Internet-Draft Data Model Schema April 2007<languages>en</languages><sphere value="work"/><allow-refer-users-dynamically >false</allow-refer-users-dynamically> <allow-invite-users-dynamically >false</allow-invite-users-dynamically> <allow-remove-users-dynamically >false</allow-remove-users-dynamically> <!-- ENDPOINTS --> <endpointentity="sip:bob@example.com" state="full">entity="sip:bob@example.com"> <display-text>Bob's Laptop</display-text> <referred> <when>2006-10-17T14:00:00Z</when> <reason>expert required</reason> <by>sip:alice@example.com</by> </referred> <status>connected</status> <joining-method>dialed-out</joining-method> <joining-info> <when>2006-10-17T14:00:00Z</when> <reason>invitation</reason> <by>sip:alice@example.com</by> </joining-info> <!-- MEDIA --> <media id="1"> Novo, et al. Expires May 3, 2008 [Page 37] Internet-Draft Data Model Schema October 2007 <label>10235</label> <src-id>432424</src-id> </media> <!-- CALL INFO --> <call-info> <sip> <display-text>full info</display-text> <call-id>hsjh8980vhsb78</call-id> <from-tag>vav738dvbs</from-tag> <to-tag>8954jgjg8432</to-tag> </sip> </call-info> </endpoint> </user> <!--Novo, et al. Expires October 19, 2007 [Page 37] Internet-Draft Data Model Schema April 2007USER ALICE --> <userentity="alice334" state="full">entity="alice334"> <display-text>Alice Kay</display-text><associated-aors state="full"><associated-aors> <SIP> <uri>mailto:alice@example.com</uri> <display-text>email</display-text> </SIP> </associated-aors> <provide-anonymity>false</provide-anonymity> <roles> <entry>moderator</entry> </roles> <languages>en</languages><sphere value="work"/><allow-refer-users-dynamically >true</allow-refer-users-dynamically> <allow-invite-users-dynamically >true</allow-invite-users-dynamically> <allow-remove-users-dynamically >true</allow-remove-users-dynamically> <!-- ENDPOINTS --> <endpointentity="sip:alice@example.com" state="full">entity="sip:alice@example.com"> <display-text>Alice's Desktop</display-text> <status>connected</status> <joining-method>dialed-in</joining-method> <joining-info> Novo, et al. Expires May 3, 2008 [Page 38] Internet-Draft Data Model Schema October 2007 <when>2006-10-17T13:35:08Z</when> <reason>invitation</reason> <by>sip:conference@example.com</by> </joining-info> <!-- MEDIA --> <media id="1"> <label>10235</label> <src-id>432424</src-id> <status>sendrecv</status> </media> <media id="2"> <label>10234</label> <src-id>532535</src-id> <status>sendrecv</status> </media>Novo, et al. Expires October 19, 2007 [Page 38] Internet-Draft Data Model Schema April 2007<!-- CALL INFO --> <call-info> <sip> <display-text>full info</display-text> <call-id>truy45469123478</call-id> <from-tag>asd456cbgt</from-tag> <to-tag>3456jgjg1234</to-tag> </sip> </call-info> </endpoint> </user> <!-- USER CAROL --> <userentity="carol233" state="full">entity="carol233"> <display-text>Carol More</display-text><associated-aors state="full"><associated-aors> <SIP> <uri>mailto:carol@example.com</uri> <display-text>email</display-text> </SIP> </associated-aors> <provide-anonymity>false</provide-anonymity> <roles> <entry>administrator</entry> </roles> <languages>en</languages><sphere value="work"/><allow-refer-users-dynamically Novo, et al. Expires May 3, 2008 [Page 39] Internet-Draft Data Model Schema October 2007 >true</allow-refer-users-dynamically> <allow-invite-users-dynamically >true</allow-invite-users-dynamically> <allow-remove-users-dynamically >true</allow-remove-users-dynamically> <!-- ENDPOINTS --> <endpointentity="sip:carol@example.com" state="full">entity="sip:carol@example.com"> <display-text>Carol's Computer</display-text> <status>connected</status> <joining-method>dialed-in</joining-method> <joining-info> <when>2006-10-17T13:30:05Z</when> <reason>invitation</reason> <by>sip:conference@example.com</by>Novo, et al. Expires October 19, 2007 [Page 39] Internet-Draft Data Model Schema April 2007</joining-info> <!-- MEDIA --> <media id="1"> <label>10235</label> <src-id>432424</src-id> <status>sendrecv</status> </media> <media id="2"> <label>10234</label> <src-id>532535</src-id> <status>sendrecv</status> </media> <!-- CALL INFO --> <call-info> <sip> <display-text>full info</display-text> <call-id>wevb12562321894</call-id> <from-tag>asw456wedf</from-tag> <to-tag>2365dfrt3497</to-tag> </sip> </call-info> </endpoint> </user> </users> <!-- SIDEBARS BY REFERENCE --><sidebars-by-ref state="full"><sidebars-by-ref> Novo, et al. Expires May 3, 2008 [Page 40] Internet-Draft Data Model Schema October 2007 <entry><uri>sips:conference123;grid=40</uri><uri>conf223</uri> <display-text>private with Bob</display-text> </entry> </sidebars-by-ref> <!-- SIDEBARS BY VALUE --> <sidebars-by-val> <entryentity="conference123;grid=40">entity="conf223"> <users> <user entity="bob534"/> <user entity="carol233"/> </users> </entry> </sidebars-by-val>Novo, et al. Expires October 19, 2007 [Page 40] Internet-Draft Data Model Schema April 2007</conference-info> Note that due to RFC formatting conventions, this documents splits lines whose content would exceed 72 characters. Two backslash characters mark where line folding has taken place. These backslashes would not appear in the actual XML data model. 8. Security Considerations There are numerous security considerations for this document. This section considers them. 8.1. Authentication A malicious user can manipulate parts of the Conference Information Data Model privileges document giving themselves andothers privileges to manipulateothers privileges to manipulate the document. It is very important that only authorized clients are able to manipulate the Conference Information Data Model document. The security considerations for authentication (section 10.1) described in the centralized conferencing framework [1] applies to this document. The focus must ensure that only authorized entities are able to manipulate the data to access the information. 8.2. Confidentiality Participants of a conference may not want to reveal some private information to other users. The Conference Information Data Model contains sensitive data which should not be analyzed or given to anyone. Confidentiality is provided through encryption. Strong end- Novo, et al. Expires May 3, 2008 [Page 41] Internet-Draft Data Model Schema October 2007 to-end authentication and encryption can be done using public keys, and end-to-end encryption can be done using private keys. It is RECOMMENDED that the protocols that manipulated the conference information datamodel.model use a strong encryption for conference information protection. 8.3. Integrity It isveryimportant that the Conference Information Data Model can only be accessed or modified by those authorizedclients are able to manipulateusers. Without integrity, the Conference Information Data Modeldocument. Any conference control protocol MUST provide authentication, confidentiality and integrity.could be modified, fooling the user into believing incorrect information. Measures taken to ensure integrity include maintaining rigorous authentication practices. 9. IANA Considerations 9.1. Conference Relax NG Schema Registration URI:urn:ietf:params:xml:ns:conference-schemaurn:ietf:params:xml:ns:xcon-conference-info Relax NG Schema: The Relax NG schema to be registered is contained in Section4.5. Its first line is namespace a = "http://relaxng.org/ns/compatibility/annotations/1.0" and its last line is disconnection-type = "departed" | "booted" | "failed" | "busy" 9.2. Conference Namespace Registration URI:urn:ietf:params:xml:ns:conference-schemaurn:ietf:params:xml:ns:xcon-conference-info 9.3. Conference Object Identifier Registration XCON_URI = "xcon" ":" [conf-object-id "@"]hostport ; hostport as defined in RFC3261host [ ":" port ] conf-object-id = 1*( unreserved / "+" / "=" / "/" );host, port, and unreservedasare defined inRFC3986RFC3986[15] Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page41]42] Internet-Draft Data Model SchemaAprilOctober 2007 9.4. Conference User Identifier Registration XCON_USERID = "xcon_userid" ":" conf-object-id conf-object-id = 1*( unreserved / "+" / "=" / "/" );unreservedasis defined inRFC3986RFC3986[15] 10. Acknowledgements This document is really a distillation of many ideas discussed over a long period of time. These ideas were contributed by many different drafts in the XCON working group and the SIPPING working group. We would like to thank Orit Levin, Adam Roach, Mary Barnes, Chris Boulton, Umesh Chandra, Hisham Khartabil, Petri Koskelainen, Aki Niemi,andJariUrpilainenUrpilainen, Rohan Mahy, and Henning Schulzrinne for their comments. Also,Wewe would like to thank Mary Barnes, and Chris Boulton for letting us use the conference and user identifier information of their xcon drafts. Last but not least, I would like to express my gratitude to all those reviewers for their invaluable contribution: Simon Pietro Romano, Lorenzo Miniero, Tobia Castaldi, Miguel Garcia, Mary Barnes, Srivatsa Srinivasan, Avshalom Houri, and Ben Campbell. 11. References 11.1. Normative References [1] Rosenberg, J., Schulzrinne, H., and O. Levin, "A Session Initiation Protocol (SIP) Event Package for Conference State", RFC 4575, August 2006. [2] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [3] Dawson, F. and Stenerson, D., "Internet Calendaring and Scheduling Core Object Specification (iCalendar)", RFC 2445, November 1998. 11.2. Informative References [4] Barnes, M., "A Frameworkand Data Modelfor Centralized Conferencing",draft-ietf-xcon-framework-07draft-ietf-xcon-framework-09 (work in progress),JanuaryAugust 2007. Novo, et al. Expires May 3, 2008 [Page 43] Internet-Draft Data Model Schema October 2007 [5] Camarillo, G., Ott, J., and K. Drage, "The Binary Floor Control Protocol (BFCP)", RFC 4582, November 2006. [6] Roach, A., "Session Initiation Protocol (SIP)-Specific EventNovo, et al. Expires October 19, 2007 [Page 42] Internet-Draft Data Model Schema April 2007Notification", RFC 3265, June 2002. [7] Rosenberg, J., "A Framework for Conferencing with the Session Initiation Protocol (SIP)", RFC 4353, February 2006. [8] Paoli, J., Maler, E., Sperberg-McQueen, C.,Bray, T.,andE. Maler,T. Bray, "Extensible Markup Language (XML) 1.0 (Second Edition)", World Wide Web Consortium FirstEdition REC-xml-20001006, October 2000, <http://www.w3.org/TR/2000/REC-xml-20001006>. [9] Casner, S., "Media Type Registration of RTP Payload Formats", RFC 4855, February 2007. [10] "IANA registry for RTP Payload Types" "http://www.iana.org/assignments/rtp-parameters". [11] Rosenberg, J. and H. Schulzrinne, "An Offer/Answer Model with Session Description Protocol (SDP)", RFC 3264, June 2002. [12] Camarillo, G., "Session Description Protocol (SDP) Format for Binary Floor Control Protocol (BFCP) Streams", RFC 4583, November 2006. [13] Camarillo, G., "Connection Establishment in the Binary Floor Control Protocol (BFCP)", RFC 5018, September 2007. [14] "RELAX NG Home Page" "http://relaxng.org/". [15] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, January 2005. Appendix A. Appendix A. Non-Normative RELAX NG Schema in XML Syntax <?xml version="1.0" encoding="UTF-8"?> <grammarns="urn:ietf:params:xml:ns:conference-schema"ns="urn:ietf:params:xml:ns:xcon-conference-info" xmlns="http://relaxng.org/ns/structure/1.0" xmlns:a="http://relaxng.org/ns/compatibility/annotations/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes"> <start> <element name="conference-info"> <ref name="conference-type"/> </element> Novo, et al. Expires May 3, 2008 [Page 44] Internet-Draft Data Model Schema October 2007 </start> <!-- CONFERENCE TYPE --> <define name="conference-type"> <attribute name="entity"> <text/> </attribute><optional> <attribute name="version"> <data type="unsignedInt"/> </attribute> </optional> <optional> <attribute name="state"><refname="state-type"/> </attribute> </optional>name="anyAttribute"/> <ref name="conference-description-type"/> <optional> <element name="host-info"> <zeroOrMore> <refname="host-type"/>name="conference-info-urn"/> </zeroOrMore> </element> </optional> <optional> <element name="conference-state">Novo, et al. Expires October 19, 2007 [Page 43] Internet-Draft Data Model Schema April 2007<ref name="conference-state-type"/> </element> </optional> <optional> <element name="floor-information"> <ref name="floor-information-type"/> </element> </optional> <element name="users"> <ref name="users-type"/> </element> <optional> <element name="sidebars-by-ref"> <ref name="sidebars-by-ref-type"/> </element> </optional> <optional> <element name="sidebars-by-val"> <ref name="sidebars-by-val-type"/> </element> </optional> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- CONFERENCE DESCRIPTION TYPE --> <define name="conference-description-type"> Novo, et al. Expires May 3, 2008 [Page 45] Internet-Draft Data Model Schema October 2007 <element name="conference-description"> <optional> <attributename="xml:lang">name="lang"> <data type="language"/> </attribute> </optional><optional> <attribute name="state"><refname="state-type"/> </attribute> </optional>name="anyAttribute"/> <optional> <element name="display-text"> <text/> </element> </optional> <optional> <element name="subject"> <text/>Novo, et al. Expires October 19, 2007 [Page 44] Internet-Draft Data Model Schema April 2007</element> </optional> <optional> <element name="free-text"> <text/> </element> </optional> <optional> <element name="keywords"> <list> <zeroOrMore> <data type="string"/> </zeroOrMore> </list> </element> </optional> <optional> <element name="allow-sidebars"> <data type="boolean"/> </element> </optional> <optional> <element name="conference-time"> <ref name="conferencetime-type"/> </element> </optional> <optional> <element name="conf-uris"> <zeroOrMore> <refname="uris-type"/>name="conference-info-urn"/> </zeroOrMore> </element> </optional> Novo, et al. Expires May 3, 2008 [Page 46] Internet-Draft Data Model Schema October 2007 <optional> <element name="service-uris"> <zeroOrMore> <refname="uris-type"/>name="conference-info-urn"/> </zeroOrMore> </element> </optional> <optional> <element name="maximum-user-count"> <data type="int"/> </element> </optional> <optional> <element name="available-media"> <ref name="conference-media-type"/> </element> </optional> <zeroOrMore> <ref name="anyElement"/>Novo, et al. Expires October 19, 2007 [Page 45] Internet-Draft Data Model Schema April 2007</zeroOrMore> </element> </define> <!-- CONFERENCE TIME --> <define name="conferencetime-type"> <ref name="anyAttribute"/> <zeroOrMore> <element name="entry"> <optional> <element name="base"> <text/> </element> </optional> <optional> <element name="mixing-start-offset"> <data type="dateTime"> <param name="pattern">.+T.+Z.*</param> </data> <attribute name="required-participant"> <ref name="single-role-type"/> </attribute> <ref name="anyAttribute"/> </element> </optional> <optional> <element name="mixing-end-offset"> <data type="dateTime"> Novo, et al. Expires May 3, 2008 [Page 47] Internet-Draft Data Model Schema October 2007 <param name="pattern">.+T.+Z.*</param> </data> <attribute name="required-participant"> <ref name="single-role-type"/> </attribute> <ref name="anyAttribute"/> </element> </optional> <optional> <element name="can-join-after-offset"> <data type="dateTime"> <param name="pattern">.+T.+Z.*</param> </data> </element> </optional> <optional> <element name="must-join-before-offset"> <data type="dateTime"> <param name="pattern">.+T.+Z.*</param> </data>Novo, et al. Expires October 19, 2007 [Page 46] Internet-Draft Data Model Schema April 2007</element> </optional> <optional> <element name="notify-end-of-conference"> <data type="int"/> </element> </optional> <optional> <element name="allowed-extend-mixing-end-offset"><ref name="allowed-extend-mixing-values"/><data type="boolean"/> </element> </optional> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </element> </zeroOrMore> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!--ALLOWED EXTEND MIXING VALUES --> <define name="allowed-extend-mixing-values"> <choice> <value type="string">allowed</value> <value type="string">denied</value> </choice> </define> <!-- URISCONFERENCE MEDIA TYPE --> <definename="uris-type"> <optional> <attribute name="state"> <ref name="state-type"/> </attribute> </optional> <interleave> <zeroOrMore> <element name="entry"> <ref name="uri-type"/> </element> </zeroOrMore> <zeroOrMore> <element name="H323"> <ref name="H323-type"/> Novo, et al. Expires October 19, 2007 [Page 47] Internet-Draft Data Model Schema April 2007 </element> </zeroOrMore> <zeroOrMore> <element name="PSTN-ISDN"> <ref name="PSTN-type"/> </element> </zeroOrMore> </interleave> <zeroOrMore>name="conference-media-type"> <refname="anyElement"/> </zeroOrMore> </define> <!-- SIP TYPE --> <define name="uri-type"> <zeroOrMore> <element name="uri"> <data type="anyURI"/> </element> <optional> <element name="display-text"> <text/> </element> </optional> <optional> <element name="purpose"> <text/> </element> </optional>name="anyAttribute"/> <zeroOrMore><ref name="anyElement"/> </zeroOrMore> </zeroOrMore> </define> <!-- H323 TYPE --> <define name="H323-type"> <optional> <element name="H.323-alias"> <text/> </element> </optional> <optional> <element name="H.323-URI"> <data type="anyURI"/> </element>Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page 48] Internet-Draft Data Model SchemaAprilOctober 2007</optional> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- PSTN TYPE --> <define name="PSTN-type"> <attribute name="PIN-code"> <data type="unsignedInt"/> </attribute> <attribute name="purpose"> <data type="unsignedInt"/> </attribute> <oneOrMore> <element name="phone-number"> <data type="unsignedInt"/> </element> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </oneOrMore> </define> <!-- CONFERENCE MEDIA TYPE --> <define name="conference-media-type"> <optional> <attribute name="state"> <ref name="state-type"/> </attribute> </optional> <zeroOrMore><element name="entry"> <ref name="conference-medium-type"/> </element> </zeroOrMore> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- CONFERENCE MEDIUM TYPE --> <define name="conference-medium-type"> <attribute name="label">Novo, et al. Expires October 19, 2007 [Page 49] Internet-Draft Data Model Schema April 2007<text/> </attribute> <ref name="anyAttribute"/> <optional> <element name="display-text"> <text/> </element> </optional> <optional> <element name="type"> <text/> </element> </optional> <optional> <element name="status"> <ref name="media-status-type"/> </element> </optional> <optional> <element name="mixing-mode"> <ref name="mix-mode-type"/> </element> </optional> <optional> <elementname="mix-level"> <data type="unsignedInt"/> </element> </optional> <optional> <elementname="codecs"> <ref name="codecs-type"/> </element> </optional> <optional> <element name="controls"> <ref name="controls-type"/> </element> </optional> <zeroOrMore> <ref name="anyElement"/></zeroOrMore> </define> <!-- CONTROLS TYPE --> <define name="controls-type"> <optional> <attribute name="state"> <ref name="state-type"/>Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page50]49] Internet-Draft Data Model SchemaAprilOctober 2007</attribute> </optional></zeroOrMore> </define> <!-- CONTROLS TYPE --> <define name="controls-type"> <ref name="anyAttribute"/> <zeroOrMore> <element name="control"> <ref name="control-type"/> </element> </zeroOrMore> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- MIX MODE TYPE --> <define name="mix-mode-type"> <choice> <value type="string">moderator-controlled</value> <value type="string">FCFS</value> <value type="string">automatic</value> </choice> </define> <!-- CODECS TYPE --> <define name="codecs-type"> <attribute name="decision"> <ref name="decision-type"/> </attribute> <ref name="anyAttribute"/> <zeroOrMore> <element name="codec"> <ref name="codec-type"/> </element> </zeroOrMore> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- CODEC TYPE --> <define name="codec-type"> <attribute name="name"><text/> </attribute> <attribute name="policy"> <ref name="policy-type"/> </attribute> </define>Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page51]50] Internet-Draft Data Model SchemaAprilOctober 2007 <text/> </attribute> <attribute name="policy"> <ref name="policy-type"/> </attribute> <ref name="anyAttribute"/> </define> <!-- DECISION TYPE --> <define name="decision-type"> <choice> <value type="string">automatic</value> <value type="string">moderator-controlled</value> </choice> </define> <!-- POLICY TYPE --> <define name="policy-type"> <choice> <value type="string">allowed</value> <value type="string">disallowed</value> </choice> </define> <!-- CONTROL TYPE --> <define name="control-type"> <ref name="anyAttribute"/> <choice> <element name="mute"> <data type="boolean"/> </element> <element name="pause-video"> <data type="boolean"/> </element> <element name="gain"> <data type="int"> <param name="minInclusive">-127</param> <param name="maxInclusive">127</param> </data> </element> <element name="video-layout"> <choice> <value type="string">single-view</value> <value type="string">dual-view</value> <value type="string">dual-view-crop</value> Novo, et al. Expires May 3, 2008 [Page 51] Internet-Draft Data Model Schema October 2007 <value type="string">dual-view-2x1</value> <value type="string">dual-view-2x1-crop</value> <value type="string">quad-view</value> <value type="string">multiple-3x3</value> <value type="string">multiple-4x4</value> <value type="string">multiple-5x1</value> <value type="string">automatic</value> </choice>Novo, et al. Expires October 19, 2007 [Page 52] Internet-Draft Data Model Schema April 2007</element> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </choice> </define> <!--HOST TYPE --> <define name="host-type"> <zeroOrMore> <element name="display-text"> <text/> </element> <element name="web-page"> <data type="anyURI"/> </element> <element name="uris"> <ref name="uris-type"/> </element> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </zeroOrMore> </define> <!--CONFERENCE STATE TYPE --> <define name="conference-state-type"> <ref name="anyAttribute"/> <optional> <element name="allow-conference-event-subscription"> <data type="boolean"/> </element> </optional> <optional> <element name="user-count"> <data type="unsignedInt"/> </element> </optional> <optional> <element name="active"> <data type="boolean"/> </element> </optional> <optional> <element name="locked"> <data type="boolean"/> </element>Novo, et al. Expires October 19, 2007 [Page 53] Internet-Draft Data Model Schema April 2007</optional> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- FLOOR INFORMATION TYPE --> <define name="floor-information-type"> <ref name="anyAttribute"/> Novo, et al. Expires May 3, 2008 [Page 52] Internet-Draft Data Model Schema October 2007 <zeroOrMore> <element name="conference-ID"> <data type="unsignedInt"/> </element> <element name="allow-floor-events"> <data type="boolean"/> </element> <element name="floor-request-handling"> <ref name="floor-request-type"/> </element> <element name="conference-floor-policy"> <ref name="Conference-floor-policy"/> </element> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </zeroOrMore> </define> <!-- FLOOR REQUEST TYPE --> <define name="floor-request-type"> <choice> <value type="string">block</value> <value type="string">confirm</value> </choice> </define> <!-- CONFERENCE FLOOR POLICY --> <define name="Conference-floor-policy"> <ref name="anyAttribute"/> <oneOrMore> <element name="floor"><attribute name="moderator-controlled"> <data type="boolean"/> </attribute> <attribute name="label"> <text/> </attribute> Novo, et al. Expires October 19, 2007 [Page 54] Internet-Draft Data Model Schema April 2007<ref name="anyAttribute"/><zeroOrMore><oneOrMore> <elementname="media-types"> <choice> <value type="string">video</value> <value type="string">audio</value> <value type="string">application</value> <value type="string">data</value> <value type="string">control</value> <value type="string">message</value> <value type="string">text</value> </choice>name="media-label"> <data type="nonNegativeInteger"/> </element> </oneOrMore> <zeroOrMore> <element name="algorithm"> <choice> <value type="string">moderator-controlled</value> <value type="string">FCFS</value> <value type="string">random</value> </choice> </element> Novo, et al. Expires May 3, 2008 [Page 53] Internet-Draft Data Model Schema October 2007 <element name="max-floor-users"> <data type="nonNegativeInteger"/> </element> <elementname="chair-id"> <data type="anyURI"/>name="moderator-id"> <text/> </element> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </zeroOrMore> </element> </oneOrMore> </define> <!-- USERS TYPE --> <define name="users-type"><optional> <attribute name="state"><refname="state-type"/> </attribute> </optional>name="anyAttribute"/> <optional> <element name="join-handling"> <ref name="join-handling-type"/> </element> </optional> <optional>Novo, et al. Expires October 19, 2007 [Page 55] Internet-Draft Data Model Schema April 2007<element name="user-admission-policy"> <ref name="user-admission-policy-type"/> </element> </optional> <optional> <element name="user-must-be-specified"> <data type="boolean"/> </element> </optional> <optional> <element name="allowed-users-list"> <ref name="UserList"/> </element> </optional> <zeroOrMore> <element name="user"> <ref name="user-type"/> </element> </zeroOrMore> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- Novo, et al. Expires May 3, 2008 [Page 54] Internet-Draft Data Model Schema October 2007 USERS ADMISSION POLICY --> <define name="user-admission-policy-type"> <choice> <value type="string">closedAuthenticated</value> <value type="string">openAuthenticated</value> <value type="string">anonymous</value> </choice> </define> <!-- JOIN HANDLING TYPE --> <define name="join-handling-type"> <choice> <value type="string">block</value> <valuetype="string">allow</value> <valuetype="string">confirm</value> <valuetype="string">IVR</value>type="string">allow</value> <value type="string">authenticate</value> <value type="string">directed-operator</value> </choice> </define> <!-- USERLIST -->Novo, et al. Expires October 19, 2007 [Page 56] Internet-Draft Data Model Schema April 2007<define name="UserList"> <ref name="anyAttribute"/> <zeroOrMore> <element name="target"> <ref name="target-type"/> </element> </zeroOrMore> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- TARGET TYPE --> <define name="target-type"> <attribute name="uri"> <data type="anyURI"/> </attribute> <attribute name="method"> <ref name="method-type"/> </attribute> <ref name="anyAttribute"/> </define> <!-- Novo, et al. Expires May 3, 2008 [Page 55] Internet-Draft Data Model Schema October 2007 METHOD TYPE --> <define name="method-type"> <choice> <value type="string">dial-in</value> <value type="string">dial-out</value> <value type="string">refer</value> </choice> </define> <!-- USER TYPE --> <define name="user-type"> <attribute name="entity"> <data type="anyURI"/> </attribute><optional> <attribute name="state"><refname="state-type"/> </attribute> </optional>name="anyAttribute"/> <optional> <element name="display-text"> <text/> </element> </optional>Novo, et al. Expires October 19, 2007 [Page 57] Internet-Draft Data Model Schema April 2007<optional> <element name="associated-aors"> <zeroOrMore> <refname="uris-type"/>name="conference-info-urn"/> </zeroOrMore> </element> </optional> <optional> <element name="provide-anonymity"> <data type="boolean"/> </element> </optional> <optional> <element name="roles"><ref name="roles-type"/><text/> </element> </optional> <optional> <element name="languages"> <list> <data type="language"/> </list> </element> </optional> <optional> <element name="cascaded-focus"> Novo, et al. Expires May 3, 2008 [Page 56] Internet-Draft Data Model Schema October 2007 <data type="anyURI"/> </element> </optional> <optional> <element name="allow-refer-users-dynamically"> <data type="boolean"/> </element> </optional> <optional> <element name="allow-invite-users-dynamically"> <data type="boolean"/> </element> </optional> <optional> <element name="allow-remove-users-dynamically"> <data type="boolean"/> </element> </optional> <zeroOrMore> <element name="endpoint"> <ref name="endpoint-type"/> </element> </zeroOrMore> <zeroOrMore>Novo, et al. Expires October 19, 2007 [Page 58] Internet-Draft Data Model Schema April 2007<ref name="anyElement"/> </zeroOrMore> </define> <!-- ENDPOINT TYPE --> <define name="endpoint-type"> <attribute name="entity"> <text/> </attribute><optional> <attribute name="state"><refname="state-type"/> </attribute> </optional>name="anyAttribute"/> <optional> <element name="display-text"> <text/> </element> </optional> <optional> <element name="referred"> <zeroOrMore> <ref name="conference-info-urn"/> </zeroOrMore> </element> </optional> <optional> Novo, et al. Expires May 3, 2008 [Page 57] Internet-Draft Data Model Schema October 2007 <element name="status"> <ref name="endpoint-status-type"/> </element> </optional> <optional> <element name="joining-method"> <ref name="joining-type"/> </element> </optional> <optional> <element name="joining-info"> <zeroOrMore> <ref name="conference-info-urn"/> </zeroOrMore> </element> </optional> <optional> <element name="disconnection-method"> <ref name="disconnection-type"/> </element>Novo, et al. Expires October 19, 2007 [Page 59] Internet-Draft Data Model Schema April 2007</optional> <optional> <element name="disconnection-info"> <zeroOrMore> <ref name="conference-info-urn"/> </zeroOrMore> </element> </optional> <zeroOrMore> <element name="media"> <ref name="media-type"/> </element> </zeroOrMore> <optional> <element name="call-info"> <zeroOrMore> <ref name="conference-info-urn"/> </zeroOrMore> </element> </optional> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- MEDIA TYPE --> <define name="media-type"> Novo, et al. Expires May 3, 2008 [Page 58] Internet-Draft Data Model Schema October 2007 <attribute name="id"> <data type="int"/> </attribute><optional> <attribute name="state"> <ref name="state-type"/> </attribute> </optional><ref name="anyAttribute"/> <optional> <element name="display-text"> <text/> </element> </optional> <optional> <element name="type"> <text/> </element> </optional> <optional>Novo, et al. Expires October 19, 2007 [Page 60] Internet-Draft Data Model Schema April 2007<element name="label"> <text/> </element> </optional> <optional> <element name="src-id"> <text/> </element> </optional> <optional> <element name="status"> <ref name="media-status-type"/> </element> </optional> <optional> <element name="to-mixer"> <ref name="mixer-type"/> </element> </optional> <optional> <element name="from-mixer"> <ref name="mixer-type"/> </element> </optional> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- MIXER TYPE --> <define name="mixer-type"><optional> <attribute name="state"><refname="state-type"/> </attribute> </optional>name="anyAttribute"/> Novo, et al. Expires May 3, 2008 [Page 59] Internet-Draft Data Model Schema October 2007 <optional> <element name="floor"> <data type="boolean"/> </element> <element name="controls"> <ref name="controls-type"/> </element> </optional> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore>Novo, et al. Expires October 19, 2007 [Page 61] Internet-Draft Data Model Schema April 2007</define> <!-- SIDEBARS-BY-REF TYPE --> <define name="sidebars-by-ref-type"><optional> <attribute name="state"><refname="state-type"/> </attribute> </optional>name="anyAttribute"/> <zeroOrMore> <element name="entry"> <zeroOrMore> <refname="uri-type"/>name="conference-info-urn"/> </zeroOrMore> </element> </zeroOrMore> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!-- SIDEBARS-BY-VAL TYPE --> <define name="sidebars-by-val-type"><optional> <attribute name="state"><refname="state-type"/> </attribute> </optional>name="anyAttribute"/> <zeroOrMore> <element name="entry"> <ref name="conference-type"/> </element> </zeroOrMore> <zeroOrMore> <ref name="anyElement"/> </zeroOrMore> </define> <!--ROLES_TYPESINGLE ROLE TYPE --> <definename="roles-type"> <zeroOrMore> <element name="entry"> <ref name="single-role-type"/> </element> </zeroOrMore> <zeroOrMore> <ref name="anyElement"/>name="single-role-type"> <choice> <value type="string">administrator</value> Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page62]60] Internet-Draft Data Model SchemaAprilOctober 2007</zeroOrMore> </define> <!-- SINGLE ROLE TYPE --> <define name="single-role-type"> <choice> <value type="string">administrator</value> <value type="string">creator</value><value type="string">moderator</value> <value type="string">participant</value> <valuetype="string">observer</value>type="string">none</value> </choice> </define> <!-- ********************************* EXTENSIBILITY OF THE SCHEMA ********************************* --> <!-- EXTENSIBILITY ELEMENTS --> <define name="anyElement"> <element> <anyName/> <zeroOrMore> <choice> <attribute> <anyName/> </attribute> <text/> <ref name="anyElement"/> </choice> </zeroOrMore> </element> </define> <!-- EXTENSIBILITY ATTRIBUTES --> <define name="anyAttribute"> <zeroOrMore> <attribute> <anyName> <except> <name ns="">entity</name> <namens="">version</name> <name ns="">state</name> <name ns="">xml:lang</name> Novo, et al. Expires October 19, 2007 [Page 63] Internet-Draft Data Model Schema April 2007ns="">lang</name> <name ns="">required-participant</name> <namens="">PIN-code</name> <name ns="">purpose</name> <name ns="">role</name> <name ns="">type</name> <name ns="">min</name> <name ns="">max</name> <namens="">label</name> <name ns="">decision</name> <name ns="">name</name> <name ns="">policy</name> <namens="">moderator-controlled</name> <namens="">uri</name> <name ns="">method</name> <name ns="">id</name><name ns="">domain</name><nsName ns=""/> <nsNamens="urn:ietf:params:xml:ns:conference-schema"/>ns="urn:ietf:params:xml:ns:xcon-conference-info"/> </except> Novo, et al. Expires May 3, 2008 [Page 61] Internet-Draft Data Model Schema October 2007 </anyName> <text/> </attribute> </zeroOrMore> </define> <!-- ************************************************************* TYPES DEFINED IN THE EVENT PACKAGE FOR CONFERENCE STATE - RFC4575 - ************************************************************* --> <!-- WILDCARD FOR EVENT-PACKAGE NAMESPACE --> <define name="conference-info-urn"> <element> <anyName> <except> <nsName ns="urn:ietf:params:xml:ns:conference-info"/> <nsNamens="urn:ietf:params:xml:ns:conference-info-urn"/>ns=""/> </except> </anyName> <mixed> <zeroOrMore> <choice> <attribute> <anyName/> </attribute> <ref name="conference-info-urn"/> </choice> </zeroOrMore> </mixed> </element> </define> <!-- DEFINITION OFSTATE TYPE --> Novo, et al. Expires October 19, 2007 [Page 64] Internet-Draft Data Model Schema April 2007 <define name="state-type"> <choice> <value>full</value> <value>partial</value> <value>deleted</value> </choice> </define> <!-- DEFINITION OFENDPOINT STATUS TYPE --> <define name="media-status-type"> <choice> <value>recvonly</value> <value>sendonly</value> <value>sendrecv</value> <value>inactive</value> </choice> </define> <!-- ENDPOINT STATUS TYPE Novo, et al. Expires May 3, 2008 [Page 62] Internet-Draft Data Model Schema October 2007 --> <define name="endpoint-status-type"> <choice> <value>pending</value> <value>dialing-out</value> <value>dialing-in</value> <value>alerting</value> <value>on-hold</value> <value>connected</value> <value>muted-via-focus</value> <value>disconnecting</value> <value>disconnected</value> </choice> </define> <!-- JOINING TYPE --> <define name="joining-type"> <choice> <value>dialed-in</value> <value>dialed-out</value> <value>focus-owner</value> </choice> </define> <!-- DISCONNECTION TYPE --> <define name="disconnection-type"> <choice> <value>departed</value> <value>booted</value> <value>failed</value> <value>busy</value> </choice> </define> </grammar> Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page65]63] Internet-Draft Data Model SchemaAprilOctober 2007<choice> <value>departed</value> <value>booted</value> <value>failed</value> <value>busy</value> </choice> </define> </grammar>Authors' Addresses Oscar Novo Ericsson Hirsalantie 11 Jorvas 02420 Finland Email: Oscar.Novo@ericsson.com Gonzalo Camarillo Ericsson Hirsalantie 11 Jorvas 02420 Finland Email: Gonzalo.Camarillo@ericsson.com David P. Morgan Fidelity Investments 82 Devonshire St, MZ V3C Boston, MA 02109-3614 USA Email: Dave.Morgan@fmr.comNovo, et al. Expires October 19, 2007 [Page 66] Internet-Draft Data Model Schema April 2007Roni Even Polycom 94 Derech Em Hamoshavot Petach Tikva 49130 Israel Email: roni.even@polycom.co.il Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page67]64] Internet-Draft Data Model SchemaAprilOctober 2007 Full Copyright Statement Copyright (C) The IETF Trust (2007). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Intellectual Property The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org. Acknowledgment Funding for the RFC Editor function is provided by the IETF Administrative Support Activity (IASA). Novo, et al. ExpiresOctober 19, 2007May 3, 2008 [Page68]65] ----