Please refer to the errata for this document, which may include some normative corrections.
The English version of this specification is the only normative version. Non-normative translations may also be available.
Copyright © 2004 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark, document use, and software licensing rules apply.
This document describes CC/PP (Composite Capabilities/Preference Profiles) structure and vocabularies. A CC/PP profile is a description of device capabilities and user preferences. This is often referred to as a device's delivery context and can be used to guide the adaptation of content presented to that device.
The Resource Description Framework (RDF) is used to create profiles that describe user agent capabilities and preferences. The structure of a profile is discussed. Topics include:
CC/PP vocabulary is identifiers (URIs) used to refer to specific capabilities and preferences, and covers:
This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at http://www.w3.org/TR/.
This document is a Recommendation of the W3C. It has been reviewed by W3C Members and other interested parties, and has been endorsed by the Director as a W3C Recommendation. It is a stable document and may be used as reference material or cited as a normative reference from another document.
W3C's role in making the Recommendation is to draw attention to the specification and to promote its widespread deployment. This enhances the functionality and interoperability of the Web. A test suite for has been developed, along with an implementation report.
This document has been produced by the W3C Device Independence Working Group as part of the Device Independence Activity within the W3C Interaction Domain. Continued status of the work is reported on the Device Independence Working Group Home Page (Member-only link).
The public is invited to send comments or reports errors to the editors at www-mobile@w3.org, the public forum for discussion of W3C's work on Mobile Web Access. An archive is available at http://lists.w3.org/Archives/Public/www-mobile/.
Patent disclosures relevant to this specification may be found on the CC/PP Working Group's patent disclosure page in conformance with W3C policy.
This document describes CC/PP (Composite Capabilities/Preference Profiles) structure and vocabularies. A CC/PP profile is a description of device capabilities and user preferences that can be used to guide the adaptation of content presented to that device. Here profile does not refer to a subset of a particular specification, for example the CSS Mobile profile, but refers to the document(s) exchanged between devices that describe the capabilities of a device.
As the number and variety of devices connected to the Internet grows,
there is a corresponding increase in the need to deliver content that is
tailored to the capabilities of different devices. Some limited techniques,
such as HTTP 'accept' headers and HTML 'alt='
attributes, already exist. As part of a framework for content adaptation and
contextualization, a general purpose profile format is required that can
describe the capabilities of a user agent and preferences of its user. CC/PP
is designed to be such a format.
CC/PP is based on RDF, the Resource Description Framework, which was designed by the W3C as a general purpose metadata description language. RDF provides the framework with the basic tools for both vocabulary extensibility, via XML namespaces [XMLNAMESPACES], and interoperability. There is a specification that describes how to encode RDF using XML [RDF], and another that defines an RDF schema description language using RDF [RDFSCHEMA]. RDF was designed to describe the metadata or machine understandable properties of the Web. RDF is a natural choice for the CC/PP framework since user agent profiles are metadata intended primarily for communication between user agents and resource data providers. For an introduction to RDF, see [RDFPRIMER]. Note that the [RDFPRIMER] document describes a more recent revision of the RDF specifications than the ones on which this specification is based.
A CC/PP profile contains a number of CC/PP attribute names and associated values that are used by a server to determine the most appropriate form of a resource to deliver to a client. It is structured to allow a client to describe its capabilities by reference to a standard profile, accessible to an origin server or other sender of resource data, and a smaller set of features that are in addition to or different than the standard profile. A set of CC/PP attribute names, permissible values and associated meanings constitute a CC/PP vocabulary.
Some information contained in a profile may be sensitive, and adequate trust and security mechanisms must be deployed to protect users' privacy. As a part of a wider application, CC/PP cannot fully cover such issues, but is intended to be used in conjunction with appropriate mechanisms. This topic is covered in Appendix F, (CC/PP applications).
It is anticipated that different applications will use different vocabularies; indeed this is needed if application-specific properties are to be represented within the CC/PP framework. But for different applications to work together, some common vocabulary, or a method to convert between different vocabularies, is needed. (XML namespaces can ensure that different applications' names do not clash, but does not provide a common basis for exchanging information between different applications.) Any vocabulary that relates to the structure of a CC/PP profile must follow this specification. The appendices introduce a simple CC/PP attribute vocabulary that may be used to improve cross-application exchange of capability information, partly based on some earlier IETF work.
CC/PP is designed to be broadly compatible with the earlier UAProf specification [UAPROF] from the WAP Forum. That is, we have attempted to accomodate existing UAProf profiles.
CC/PP is compatible with IETF media feature sets (CONNEG) [RFC2533] in the sense that all media feature tags and values can be expressed in CC/PP. However, not all CC/PP profiles can be expressed as media feature tags and values, and CC/PP does not attempt to express relationships between attributes.
Although the examples and use to date have been focused on device capabilities, CC/PP can also convey information about user preferences that, used sensibly, should be allow web servers to improve the accessibility of web sites. A fuller discussion of web site accessibility can be found in the Web Content Accessibility Guidelines [WAI].
CC/PP Structure and Vocabularies (abbreviated to CC/PP in the rest of this document) defines a client profile data format, and a framework for incorporating application- and operating environment-specific features. It does not define how the profile is transferred, nor does it specify what CC/PP attributes must be generated or recognized. CC/PP is designed for use as part of a wider application framework. As such, the specification of CC/PP elements that must be supported and those which may be omitted is a matter for a specific application.
There are few protocol assumptions built into the design of CC/PP. Although it is intended to be largely protocol independent, particular consideration has been given to use of CC/PP with HTTP for retrieving Web resources. Appendix F contains some further discussion of CC/PP applications.
This document describes a number of features of CC/PP. Some features form part of the essential structure of CC/PP, for which conformance is REQUIRED (see section 5). Others are features whose use is RECOMMENDED or OPTIONAL. There is also discussion of how new vocabularies should be introduced, directed to CC/PP application designers rather than implementers.
The architecture section does not describe specific features, but indicates general principles that underlie the design of CC/PP. It is not normative but does contain information that should be understood for proper implementation of CC/PP.
The section on CC/PP structure covers two main areas:
The section on CC/PP attribute vocabularies describes some general features of CC/PP attributes and their values. Support for the described formats for simple attribute values is RECOMMENDED -- the actual syntax for any simple CC/PP value is defined by the corresponding attribute specification; such specifications may reference the information provided here. Support for the structured CC/PP attribute formats described, where relevant, is REQUIRED.
Support is not required for any specific vocabulary, but application designers are strongly encouraged to re-use existing vocabularies where possible.
CC/PP applications are not required to support features described in the
appendices, but any new attribute vocabularies defined MUST be based on RDF
classes and properties defined by the RDF schema in Appendix B (new CC/PP attributes are instances of
ccpp:Attribute, new component classes are subclasses of
ccpp:Component, etc.).
NOTE: The reason for requiring new vocabularies to be based on the CC/PP schema is so that schema-aware applications can include CC/PP profile data along with other RDF data. Having new vocabulary terms based on the CC/PP schema means that they are clearly identifiable as part of a CC/PP profile when RDF data from multiple sources is combined. This requirement does not affect stand-alone CC/PP profile processors, but the real value of using RDF here will be in the longer term, allowing data from multiple sources (e.g. document, security and privacy related information) to be combined and processed by more general purpose handlers.
The remainder of this section covers terminology, conventions and notations used in this document.
Section 2, CC/PP architecture, provides an overview of the CC/PP profile structure and use of XML namespaces.
Section 3, CC/PP structure, describes the structure of a CC/PP profile, and introduces the RDF elements that are used to create the essential CC/PP elements.
Section 4, Attribute vocabularies, describes how attributes are used in a CC/PP profile, and presents the recommended structure of CC/PP elements used to describe specific features.
The appendices contain additional supporting material that is not essential to construct a valid CC/PP profile, but which provides additional background information useful for understanding CC/PP, its relationship with RDF, or defining attribute vocabularies for specific applications.
See CC/PP terminology and abbreviations in Appendix A of this document.
The term "CC/PP attribute" is used here to refer to a specific capability or characteristic of a client (or other system) that appears in a CC/PP profile. The term "feature" refers to a client capability or characteristic that may or may not be the basis of a CC/PP attribute. The term "attribute name" is used to indicate an RDF property name used to identify a CC/PP attribute.
The key words "MUST", "MUST NOT", "SHOULD", "SHOULD NOT", "MAY", "MAY NOT", "REQUIRED", "RECOMMENDED" and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 [RFC2119].
The underlying structure of RDF is a directed labeled graph. For communication between computer systems, RDF uses a serialization in XML to represent these graphs. This XML notation is rather bulky and difficult for human discourse, so a more visual notation is used here for describing RDF graph structures:
[Subject-resource] --propertyName--> [Object-resource] Indicates a graph edge labeled 'propertyName' from an RDF resource named 'Subject-resource' to another RDF resource named 'Object-resource'. [Subject-resource] --propertyName--> "Property value" Indicates a graph edge labeled 'propertyName' from an RDF resource named 'Subject-resource' to a literal string containing the indicated value. [Subject-resource] --propertyName--> { "Val1", "Val2", ... }
This is a shorthand for a property whose value is an rdf:Bag resource containing the indicated values (see section 4.1.2.1). [<Subject-type>] --propertyName--> [<Object-type>] Names in angle brackets are used to indicate an RDF resource of the indicated type (i.e. having the indicated rdf:Type property value), without indicating a specific name for the resource. This is useful for showing the RDF classes that may be linked by a property. [Subject-resource] --propertyName--> [Object-resource]
|
-------------------------------
|
+--property1--> (val1)
+--property2--> (val2)
:
(etc.)
Property arcs can be chained, and multiple arcs drawn from a subject resource. |
Here are some XML examples of the RDF graph structures described above:
<?xml version="1.0"?>
<!-- Any RDF graph is an RDF element
-->
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns="http://www.example.com/schema#">
<!-- [Subject-resource] -propertyName-> [Object-resource]
-->
<rdf:Description
rdf:about="http://www.example.com/profile#Subject-resource">
<propertyName>
<rdf:Description
rdf:about="http://www.example.com/profile#Object-resource" />
</propertyName>
</rdf:Description>
<!-- [Subject-resource] -propertyName-> [Object-resource]
- (Alternative format)
-->
<rdf:Description
rdf:about="http://www.example.com/profile#Subject-resource">
<propertyName
rdf:resource="http://www.example.com/schema#Object-resource" />
</rdf:Description>
<!-- [Subject-resource] -propertyName-> "property value"
-->
<rdf:Description
rdf:about="http://www.example.com/profile#Subject-resource">
<propertyName>property value</propertyName>
</rdf:Description>
<!-- [Subject-resource] -propertyName-> { "Val1", "Val2", ... }
-->
<rdf:Description
rdf:about="http://www.example.com/profile#Subject-resource">
<propertyName>
<rdf:Description>
<rdf:type
rdf:resource="http://www.w3.org/1999/02/22-rdf-syntax-ns#Bag" />
<rdf:li>Val1</rdf:li>
<rdf:li>Val1</rdf:li>
<!-- ...etc... -->
</rdf:Description>
</propertyName>
</rdf:Description>
<!-- [Subject-resource] -propertyName-> { "Val1", "Val2", ... }
- (Alternative format)
-->
<rdf:Description
rdf:about="http://www.example.com/profile#Subject-resource">
<propertyName>
<rdf:Bag>
<rdf:li>Val1</rdf:li>
<rdf:li>Val1</rdf:li>
<!-- ...etc... -->
</rdf:Bag>
</propertyName>
</rdf:Description>
<!-- [<Subject-type>] -propertyName-> [<Object-type>]
-->
<rdf:Description>
<rdf:type
rdf:resource="http://www.example.com/schema#Subject-type" />
<propertyName>
<rdf:Description>
<rdf:type
rdf:resource="http://www.example.com/schema#Object-type" />
</rdf:Description>
</propertyName>
</rdf:Description>
<!-- [Subject-resource] -propertyName-> [Object-resource]
- |
- +-property1-> (val1)
- +-property2-> (val2)
- :
-->
<rdf:Description
rdf:about="http://www.example.com/profile#Subject-resource">
<propertyName>
<rdf:Description
rdf:about="http://www.example.com/profile#Object-resource" >
<property1>val1</property1>
<property2>val2</property2>
<!-- ...etc... -->
</rdf:Description>
</propertyName>
</rdf:Description>
</rdf:RDF>
|
This section is not normative, but provides an overview of the features of CC/PP.
A CC/PP profile is broadly constructed as a 2-level hierarchy:
The initial branches of the CC/PP profile tree describe major components of the client. Examples of major components are:
A simple, graphical representation of the bottom of a CC/PP tree based on
three components (TerminalHardware,
TerminalSoftware and TerminalBrowser) would be:
[example:MyProfile] | +--ccpp:component-->[example:TerminalHardware] +--ccpp:component-->[example:TerminalSoftware] +--ccpp:component-->[example:TerminalBrowser] |
The corresponding XML might look like this:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ccpp="http://www.w3.org/2002/11/08-ccpp-schema#"
xmlns:example="http://www.example.com/schema#">
<rdf:Description rdf:about="http://www.example.com/profile#MyProfile">
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalHardware">
<!-- TerminalHardware properties here -->
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalSoftware">
<!-- TerminalSoftware properties here -->
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalBrowser">
<!-- TerminalBrowser properties here -->
</rdf:Description>
</ccpp:component>
</rdf:Description>
</rdf:RDF>
|
A CC/PP profile describes client capabilities and preferences in terms of a number of "CC/PP attributes" for each component.
The description of each component is a sub-tree whose branches are the capabilities or preferences associated with that component. Though RDF makes modeling a wide range of data structures possible, including arbitrary graphs, complex data models are usually best avoided for profile attribute values. A capability can often be described using a small number of CC/PP attributes, each having a simple, atomic value. Where more complex values are needed, these can be constructed as RDF subgraphs. One useful case for complex attribute values is to represent alternative values; e.g. a browser may support multiple versions of HTML. A hypothetical profile might look like this:
[ex:MyProfile]
|
+--ccpp:component-->[ex:TerminalHardware]
| |
| +--rdf:type----> [ex:HardwarePlatform]
| +--ex:displayWidth--> "320"
| +--ex:displayHeight--> "200"
|
+--ccpp:component-->[ex:TerminalSoftware]
| |
| +--rdf:type----> [ex:SoftwarePlatform]
| +--ex:name-----> "EPOC"
| +--ex:version--> "2.0"
| +--ex:vendor---> "Symbian"
|
+--ccpp:component-->[ex:TerminalBrowser]
|
+--rdf:type----> [ex:BrowserUA]
+--ex:name-----> "Mozilla"
+--ex:version--> "5.0"
+--ex:vendor---> "Symbian"
+--ex:htmlVersionsSupported--> [ ]
|
----------------------------
|
+--rdf:type---> [rdf:Bag]
+--rdf:_1-----> "3.2"
+--rdf:_2-----> "4.0"
|
The corresponding XML might look like this:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ccpp="http://www.w3.org/2002/11/08-ccpp-schema#"
xmlns:ex="http://www.example.com/schema#">
<rdf:Description
rdf:about="http://www.example.com/profile#MyProfile">
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalHardware">
<rdf:type
rdf:resource="http://www.example.com/schema#HardwarePlatform" />
<ex:displayWidth>320</ex:displayWidth>
<ex:displayHeight>200</ex:displayHeight>
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalSoftware">
<rdf:type
rdf:resource="http://www.example.com/schema#SoftwarePlatform" />
<ex:name>EPOC</ex:name>
<ex:version>2.0</ex:version>
<ex:vendor>Symbian</ex:vendor>
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalBrowser">
<rdf:type
rdf:resource="http://www.example.com/schema#BrowserUA" />
<ex:name>Mozilla</ex:name>
<ex:version>5.0</ex:version>
<ex:vendor>Symbian</ex:vendor>
<ex:htmlVersionsSupported>
<rdf:Bag>
<rdf:li>3.2</rdf:li>
<rdf:li>4.0</rdf:li>
</rdf:Bag>
</ex:htmlVersionsSupported>
</rdf:Description>
</ccpp:component>
</rdf:Description>
</rdf:RDF>
|
The attributes of a component can be included directly, as in the previous example, or may be specified by reference to a default profile, which may be stored separately and accessed using its specified URI.
This use of an externally defined default profile is somewhat similar to the idea of dynamic inheritance. It makes possible some important optimizations. As a separate document, it can reside at a separate location and it can be separately cached. This is particularly useful in wireless environments such as cellular networks, where the profiles may be large and the client link slow and expensive. Using default values, only a small part of the overall profile is sent over the wireless network.
Default values for a component of a CC/PP profile are indicated by a
ccpp:defaults arc from the component concerned to a
component that describes the default values.
[ex:MyProfile]
|
+--ccpp:component--> [ex:TerminalHardware]
| |
| +--rdf:type-------> [ex:HardwarePlatform]
| +--ccpp:defaults--> [ex:HWDefault]
|
+--ccpp:component--> [ex:TerminalSoftware]
| |
| +--rdf:type-------> [ex:SoftwarePlatform]
| +--ccpp:defaults--> [ex:SWDefault]
|
+--ccpp:component--> [ex:TerminalBrowser]
|
+--rdf:type-------> [ex:BrowserUA]
+--ccpp:defaults--> [ex:UADefault]
[ex:HWDefault]
|
+--rdf:type----> [ex:HardwarePlatform]
+--ex:displayWidth--> "320"
+--ex:displayHeight--> "200"
[ex:SWDefault]
|
+--rdf:type----> [ex:SoftwarePlatform]
+--ex:name-----> "EPOC"
+--ex:version--> "2.0"
+--ex:vendor---> "Symbian"
[ex:UADefault]
|
+--rdf:type----> [ex:BrowserUA]
+--ex:name-----> "Mozilla"
+--ex:version--> "5.0"
+--ex:vendor---> "Symbian"
+--ex:htmlVersionsSupported--> [ ]
|
+--rdf:type---> [rdf:Bag]
+--rdf:_1-----> "3.2"
+--rdf:_2-----> "4.0"
|
The corresponding XML might look like this:
Device profile referencing defaults:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ccpp="http://www.w3.org/2002/11/08-ccpp-schema#"
xmlns:ex="http://www.example.com/schema#">
<rdf:Description
rdf:about="http://www.example.com/profile#MyProfile">
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalHardware">
<rdf:type
rdf:resource="http://www.example.com/schema#HardwarePlatform" />
<ccpp:defaults
rdf:resource="http://www.example.com/hardwareProfile#HWDefault" />
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalSoftware">
<rdf:type
rdf:resource="http://www.example.com/schema#SoftwarePlatform" />
<ccpp:defaults
rdf:resource="http://www.example.com/softwareProfile#SWDefault" />
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalBrowser">
<rdf:type
rdf:resource="http://www.example.com/schema#BrowserUA" />
<ccpp:defaults
rdf:resource="http://www.example.com/terminalProfile#UADefault" />
</rdf:Description>
</ccpp:component>
</rdf:Description>
</rdf:RDF>
Defaults for HardwarePlatform:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ex="http://www.example.com/schema#">
<rdf:Description
rdf:about="http://www.example.com/hardwareProfile#HWDefault">
<rdf:type
rdf:resource="http://www.example.com/schema#HardwarePlatform" />
<ex:displayWidth>320</ex:displayWidth>
<ex:displayHeight>200</ex:displayHeight>
</rdf:Description>
</rdf:RDF>
Defaults for SoftwarePlatform:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ex="http://www.example.com/schema#">
<rdf:Description
rdf:about="http://www.example.com/softwareProfile#SWDefault">
<rdf:type
rdf:resource="http://www.example.com/schema#SoftwarePlatform" />
<ex:name>EPOC</ex:name>
<ex:version>2.0</ex:version>
<ex:vendor>Symbian</ex:vendor>
</rdf:Description>
</rdf:RDF>
Defaults for BrowserUA:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ex="http://www.example.com/schema#">
<rdf:Description
rdf:about="http://www.example.com/terminalProfile#UADefault">
<rdf:type
rdf:resource="http://www.example.com/schema#BrowserUA" />
<ex:name>Mozilla</ex:name>
<ex:version>5.0</ex:version>
<ex:vendor>Symbian</ex:vendor>
<ex:htmlVersionsSupported>
<rdf:Bag>
<rdf:li>3.2</rdf:li>
<rdf:li>4.0</rdf:li>
</rdf:Bag>
</ex:htmlVersionsSupported>
</rdf:Description>
</rdf:RDF>
|
If a given attribute value is applied directly to a component resource,
and also appears on a resource referenced by the
ccpp:defaults property, the directly applied
value takes precedence:
[ex:MyProfile]
|
+--ccpp:component--> [ex:TerminalHardware]
|
+--rdf:type--------> [ex:HardwarePlatform]
+--ccpp:defaults---> [ex:HWDefault]
+--ex:memoryMb-------> "32"
[ex:HWDefault]
|
+--rdf:type----> [ex:HardwarePlatform]
+--ex:displayWidth--> "320"
+--ex:displayHeight--> "200"
+--ex:memoryMb---> "16"
|
In this example, the default component indicates 16 Mb of memory, but this
value is overridden by the memoryMb property applied directly to
the profile component. Thus, in this profile, the memoryMb
attribute has a value of 32.
The corresponding XML might look like this:
Device profile referencing defaults:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ccpp="http://www.w3.org/2002/11/08-ccpp-schema#"
xmlns:ex="http://www.example.com/schema#">
<rdf:Description
rdf:about="http://www.example.com/profile#MyProfile">
<ccpp:component>
<rdf:Description
rdf:about="http://www.example.com/profile#TerminalHardware">
<rdf:type
rdf:resource="http://www.example.com/schema#HardwarePlatform" />
<ccpp:defaults
rdf:resource="http://www.example.com/hardwareProfile#HWDefault" />
<ex:memoryMb>32</ex:memoryMb>
</rdf:Description>
</ccpp:component>
</rdf:Description>
</rdf:RDF>
Defaults for HardwarePlatform:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ex="http://www.example.com/schema#">
<rdf:Description
rdf:about="http://www.example.com/hardwareProfile#HWDefault">
<rdf:type
rdf:resource="http://www.example.com/schema#HardwarePlatform" />
<ex:displayWidth>320</ex:displayWidth>
<ex:displayHeight>200</ex:displayHeight>
<ex:memoryMb>16</ex:memoryMb>
</rdf:Description>
</rdf:RDF>
|
A resource indicated by a default property may appear in a separate
document, in which case an absolute URI reference should be specified for the
default resource. In such cases, the URI part of the default resource
identifier (i.e. not including the fragment identifier part) is used to
retrieve an RDF document containing the default resource description. Thus,
if the default resource is named
http://example.com/DeviceProfile#HardwarePlatform, the URI
http://example.com/DeviceProfile is used to retrieve an RDF
document, and a resource within that document having the local identifier
#HardwarePlatform is taken as the default resource. (Such a
resource might be defined within the target document using
"about='http://example.com/DeviceProfile#HardwarePlatform'" or
"ID='HardwarePlatform'". See also section 3.5.)
NOTE: Individual applications may allow relative URIs to be used. Those that do should specify exactly how the corresponding RDF document is located.
CC/PP is extended primarily through the introduction of new attribute vocabularies.
Any application or operational environment that uses CC/PP may define its own vocabulary, but wider interoperability is enhanced if vocabularies are defined that can be used more generally; e.g. a standard extension vocabulary for imaging devices, or voice messaging devices, or wireless access devices, etc. Accordingly, this specification defines a small core vocabulary of features that are applicable to range of print and display agents whose use, where appropriate, is strongly recommended. This core vocabulary is based on IETF specification RFC2534 [RFC2534], and serves as an example of how CC/PP attribute vocabularies may be defined. Another such example is the WAP Forum UAProf specification [UAPROF].
Any CC/PP expression can use terms drawn from an arbitrary number of different vocabularies, so there is no restriction caused by re-using terms from an existing vocabulary rather then defining new names to identify the same information. Each vocabulary is associated with an XML namespace, as are the names that describe the underlying RDF and CC/PP structures.
XML namespaces [XMLNAMESPACES] define a notation for associating convenient name forms with arbitrary URIs. The RDF graph syntax does not specifically employ namespaces, but XML serializations of an RDF graph do. We also use namespace prefixes when presenting RDF in the graph notation described above.
The CC/PP framework uses the XML namespace mechanism to create identifying URIs for RDF core elements, CC/PP structural elements and CC/PP attribute vocabularies. Consider the following namespace declaration example:
<?xml version="1.0"?>
<RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ccpp="http://www.w3.org/2002/11/08-ccpp-schema#"
xmlns:prf="http://www.wapforum.org/profiles/UAPROF/ccppschema-20010430#">
|
The first namespace declaration is for RDF usage. The second declaration
names the CC/PP core structural vocabulary, which includes
"component", "defaults" and other properties that
are intrinsic to the CC/PP framework. The third namespace declaration names a
component CC/PP properties vocabulary.
NOTE: Remember that the namespace prefixes are quite arbitrary: applications MUST NOT assume that the prefix
rdf:refers to the RDF vocabulary, or thatccpp:refers to the intrinsic CC/PP vocabulary, etc. It is the URI to which a namespace prefix is bound that matters.
NOTE: Although namespace names are identified by URI references, there is no requirement that a schema be available at that URI. In the above example, the UAProf namespace name is "
http://www.wapforum.org/UAPROF/ccppschema-20000405#" yet there is no schema at that URI. It is generally preferred practice that a corresponding schema exists at the URL used to identify a namespace, but this is not a requirement and CC/PP applications MUST NOT assume that such a schema will exist.
The use of multiple component property vocabularies is allowed and encouraged. Different user communities and application domains (WAP Forum, ETSI, MExE, IETF CONNEG, etc.) may define their own property vocabularies. This is an important mechanism for providing support for the needs of those communities.
The following namespaces are introduced by the CC/PP framework:
http://www.w3.org/2002/11/08-ccpp-schema#
Normative RDF schema defining class declarations for CC/PP, and core structural properties (listed in Appendix B.3).http://www.w3.org/2002/11/08-ccpp-client#
Example but non-normative vocabulary for describing simple client capabilities, with particular relevance to print and display clients (listed in Appendix C).
NOTE: To retrieve these schemas it is necessary for your browser to add the header
Accept:text/xmlin the request. Browsers that do not add this accept header or use the headerAccept:*/*or variants thereof will receive a HTML page that notes these are namespaces reserved for the CC/PP Schemas.
The general structure of a CC/PP client profile is a two-level tree: components and attributes, with provision for each component to reference an externally defined set of default attribute values.
A CC/PP profile contains one or more components, and each
component contains one or more attributes. Each component is represented by a
resource of type ccpp:Component (or some RDFS subclass
thereof), and related to the client profile resource by a
ccpp:component property. Here, the
ccpp namespace is
http://www.w3.org/2002/11/08-ccpp-schema#. For compatibility with UAProf, the
namespace used to qualify component MAY be a UAProf
namespace.
The object of a ccpp:Component resource MAY have an
rdf:type property (or equivalent RDF structure)
indicating what kind of client component it describes. The example in figure
2-2b is of a profile with an explicit indication of component subtype.
However, CC/PP processors MUST be able to handle profiles that do not contain
component type indicators. As long as the CC/PP attributes used are all
specific to a given component type, a processor will have sufficient
information to interpret them properly. No more than one instance of a
component type should be present for any given profile resource.
If a CC/PP profile uses any attribute that can appear on different
component types, then the type of any component on which such an attribute
appears MUST be indicated by an rdf:type property, or
equivalent RDF. A CC/PP processor MUST be able to use this type information
to disambiguate application of any attribute used.
CC/PP profiles are constructed using RDF [RDF]. The RDF data model represents CC/PP attributes as named properties linking a subject resource to an associated object resource or RDF literal value.
To describe client capabilities and preferences, the client being described is a resource whose features are described by labeled graph edges from that resource to corresponding object values. The graph edge labels identify the client feature (CC/PP attribute) being described, and the corresponding object values are the feature values.
[Client component resource] --attributeName--> (Attribute-value) |
CC/PP attribute labels are represented by XML name values (per XML specification [XML], section 2.3), which may include a namespace prefix (i.e. a qualified name, per XML namespaces [XMLNAMESPACES], section 3). When combined with the corresponding namespace or default namespace declaration, each label MUST be mapped to a URI. Thus, CC/PP attribute names are URIs, with XML namespace syntax used to avoid some of the RDF expressions becoming too cumbersome.
Attribute values may be of simple or structured data types.
Simple data types are discussed in the section 4.1.1. Each basic data type may support a range of tests that can be used in the process of determining the suitability of different resource variants for presentation by a client; e.g. equality, compatibility, less-than, greater-than, etc.
Structured data types are supported through the use of specific RDF properties that join simple RDF literal values into composites. Specific CC/PP semantics for RDF properties used in this way are discussed in the section 4.1.2.
Each component of a client profile may indicate a single separate resource that in turn indicates a subordinate collection of default attribute values. This collection of default values can be a separate RDF document that is named via a URI, or can appear in the same document as the client profile (though, in practice, there is probably little value in defaults in the same document). If an attribute in the collection of defaults is also present in the main part of the client profile, the non-default value takes precedence. The intent is that a hardware vendor or system supplier may provide default values that are common to a number of systems in a place easily accessible to an origin server, and then use the client profile to specify variations from the common profile. The owner of the product or system operator may be able to add or change options, such as additional memory, that add new capabilities or change the values of some original capabilities.
Default values are referenced by the property
ccpp:defaults. This name conforms to the
name format recommendations of the RDF model and syntax specification [RDF], Appendix C.1. However, for compatibility with earlier
versions of CC/PP used with UAProf, CC/PP processors SHOULD recognize the
property name ccpp:Defaults (i.e. with capital "D") as
equivalent. Here, the ccpp namespace is
http://www.w3.org/2002/11/08-ccpp-schema#. For compatibility with UAProf, the
namespace used to qualify defaults or Defaults MAY
be a UAProf namespace.
Defaults can be encoded inline or as separate documents referred to via URI. Defaults can not be encoded both inline and as a separate document. It is the responsibility of any server interpreting a CC/PP to combine profiles with any externally referenced defaults in such a way as to be able to correctly interpret the profile. A profile with defaults in the same document is logically equivalent to a profile with the same non-default data and referenced external document(s) containing the default values. Here is a simple profile graph using default values:
[ex:MyProfile]
|
+--ccpp:component--> [ex:TerminalHardware]
| |
| +--rdf:type-------> [ex:HardwarePlatform]
| +--ccpp:defaults--> [ex:HWDefault]
| +--ex:displayWidth--> "640"
| +--ex:displayHeight-> "400"
|
+--ccpp:component--> [ex:TerminalSoftware]
| |
| +--rdf:type-------> [ex:SoftwarePlatform]
| +--ccpp:defaults--> [ex:SWDefault]
|
+--ccpp:component--> [ex:TerminalBrowser]
|
------------
|
+--rdf:type-------> [ex:BrowserUA]
+--ccpp:defaults--> [ex:UADefault]
+--ex:htmlVersionsSupported--> { "2.0", "3.2", "4.0" }
[ex:HWDefault]
|
+--rdf:type----> [ex:HardwarePlatform]
+--ex:cpu------> "PPC"
+--ex:displayWidth--> "320"
+--ex:displayHeight--> "200"
[ex:SWDefault]
|
+--rdf:type----> [ex:SoftwarePlatform]
+--ex:name-----> "EPOC"
+--ex:version--> "2.0"
+--ex:vendor---> "Symbian"
[ex:UADefault]
|
+--rdf:type----> [ex:BrowserUA]
+--ex:name-----> "Mozilla"
+--ex:version--> "5.0"
+--ex:vendor---> "Symbian"
+--ex:htmlVersionsSupported--> { "3.2", "4.0" }
|
If a component referenced by ccpp:defaults contains an
attribute that is not present on the referencing profile component, then the
effect is as if the attribute value in the default component is applied
directly to the profile component. For example the profile in Figure 3-2a
should be interpreted as describing the same capabilities as shown in Figure
3-2b.
[ex:MyProfile]
|
+--ccpp:component--> [ex:TerminalHardware]
| |
| +--rdf:type-------> [ex:HardwarePlatform]
| +--ex:displayWidth--> "640"
| +--ex:displayHeight-> "400"
| +--ex:cpu------> "PPC"
|
+--ccpp:component--> [ex:TerminalSoftware]
| |
| +--rdf:type-------> [ex:SoftwarePlatform]
| +--ex:name-----> "EPOC"
| +--ex:version--> "2.0"
| +--ex:vendor---> "Symbian"
|
+--ccpp:component--> [ex:TerminalBrowser]
|
------------
|
+--rdf:type-------> [ex:BrowserUA]
+--ex:htmlVersionsSupported--> { "2.0", "3.2", "4.0" }
+--ex:name-----> "Mozilla"
+--ex:version--> "5.0"
+--ex:vendor---> "Symbian"
|
And here is the corresponding XML serialization, with the default resource descriptions coded inline in the client profile description. Note that this example uses a default namespace for RDF elements, but still must use explicit namespace prefixes for RDF attributes.
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ccpp="http://www.w3.org/2002/11/08-ccpp-schema#"
xmlns:prf="http://example.com/Schema#">
<rdf:Description rdf:about="http://example.com/MyProfile">
<ccpp:component>
<rdf:Description rdf:about="http://example.com/TerminalHardware">
<rdf:type rdf:resource="http://example.com/Schema#HardwarePlatform"/>
<ccpp:defaults>
<rdf:Description rdf:about="http://example.com/HWDefault">
<rdf:type rdf:resource="http://example.com/Schema#HardwarePlatform"/>
<prf:cpu>PPC</prf:cpu>
<prf:displayWidth>320</prf:displayWidth>
<prf:displayHeight>200</prf:displayHeight>
</rdf:Description>
</ccpp:defaults>
<prf:displayHeight>640</prf:displayHeight>
<prf:displayWidth>400</prf:displayWidth>
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description rdf:about="http://example.com/TerminalSoftware">
<rdf:type rdf:resource="http://example.com/Schema#SoftwarePlatform" />
<ccpp:defaults>
<rdf:Description rdf:about="http://example.com/SWDefault">
<rdf:type rdf:resource="http://example.com/Schema#SoftwarePlatform"/>
<prf:name>EPOC</prf:name>
<prf:vendor>Symbian</prf:vendor>
<prf:version>2.0</prf:version>
</rdf:Description>
</ccpp:defaults>
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description rdf:about="http://example.com/Browser">
<rdf:type rdf:resource="http://example.com/Schema#BrowserUA" />
<ccpp:defaults>
<rdf:Description rdf:about="http://example.com/UADefault">
<rdf:type rdf:resource="http://example.com/Schema#BrowserUA"/>
<prf:name>Mozilla</prf:name>
<prf:vendor>Symbian</prf:vendor>
<prf:version>5.0</prf:version>
<prf:htmlVersionsSupported>
<rdf:Bag>
<rdf:li>3.2</rdf:li>
<rdf:li>4.0</rdf:li>
</rdf:Bag>
</prf:htmlVersionsSupported>
</rdf:Description>
</ccpp:defaults>
<prf:htmlVersionsSupported>
<rdf:Bag>
<rdf:li>2.0</rdf:li>
<rdf:li>3.2</rdf:li>
<rdf:li>4.0</rdf:li>
</rdf:Bag>
</prf:htmlVersionsSupported>
</rdf:Description>
</ccpp:component>
</rdf:Description>
</rdf:RDF>
|
Inline defaults are logically equivalent to defaults contained in an external referenced document, and such external documents would be a normal way of providing default values. The following is the XML serialization of the same profile with references to externally defined defaults:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ccpp="http://www.w3.org/2002/11/08-ccpp-schema#"
xmlns:prf="http://example.com/Schema#">
<rdf:Description rdf:about="http://example.com/MyProfile">
<ccpp:component>
<rdf:Description rdf:about="http://example.com/TerminalHardware">
<rdf:type rdf:resource="http://example.com/Schema#HardwarePlatform"/>
<ccpp:defaults rdf:resource="http://example.com/HWDefault"/>
<prf:displayWidth>640</prf:displayWidth>
<prf:displayHeight>400</prf:displayHeight>
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description rdf:about="http://example.com/TerminalSoftware">
<rdf:type rdf:resource="http://example.com/Schema#SoftwarePlatform" />
<ccpp:defaults rdf:resource="http://example.com/SWDefault"/>
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description rdf:about="http://example.com/Browser">
<rdf:type rdf:resource="http://example.com/Schema#BrowserUA" />
<ccpp:defaults rdf:resource="http://example.com/UADefault"/>
<prf:htmlVersionsSupported>
<rdf:Bag>
<rdf:li>2.0</rdf:li>
<rdf:li>3.2</rdf:li>
<rdf:li>4.0</rdf:li>
</rdf:Bag>
</prf:htmlVersionsSupported>
</rdf:Description>
</ccpp:component>
</rdf:Description>
</rdf:RDF>
|
Each external defaults resource is a separate RDF document referenced by a URI.
NOTE: A default document uses a
<rdf:Description>element as its root node. The<rdf:Description>is named using anrdf:aboutwhose value is a URI. This URI MUST correspond to the value of therdf:resourceXML attribute in the<ccpp:defaults>element in the referencing document. (The default component does not need to be identified when it occurs inline, as in the first example above.) In the examples of default documents below, the URLs of the external default values documents are used. However the default resource URI does not have to be the document URL, as long as the URI is uniquely identified, the same URI is used in both the source document and the external default values document, and there is some way for the processing software to locate and retrieve the document containing the default resource.
Examples of default documents referenced by the previous example are as follows:
Document: http://example.com/HWDefault
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:prf="http://example.com/Schema#">
<rdf:Description rdf:about="http://example.com/HWDefault">
<rdf:type rdf:resource="http://example.com/Schema#HardwarePlatform"/>
<prf:cpu>PPC</prf:cpu>
<prf:displayWidth>320</prf:displayWidth>
<prf:displayHeight>200</prf:displayHeight>
</rdf:Description>
</rdf:RDF>
|
Document: http://example.com/SWDefault
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:prf="http://example.com/Schema#">
<rdf:Description rdf:about="http://example.com/SWDefault">
<rdf:type rdf:resource="http://example.com/Schema#SoftwarePlatform"/>
<prf:name>EPOC</prf:name>
<prf:vendor>Symbian</prf:vendor>
<prf:version>2.0</prf:version>
</rdf:Description>
</rdf:RDF>
|
Document: http://example.com/UADefault
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:prf="http://example.com/Schema#">
<rdf:Description rdf:about="http://example.com/UADefault">
<rdf:type rdf:resource="http://example.com/Schema#BrowserUA"/>
<prf:name>Mozilla</prf:name>
<prf:vendor>Symbian</prf:vendor>
<prf:version>5.0</prf:version>
<prf:htmlVersionsSupported>
<rdf:Bag>
<rdf:li>3.2</rdf:li>
<rdf:li>4.0</rdf:li>
</rdf:Bag>
</prf:htmlVersionsSupported>
</rdf:Description>
</rdf:RDF>
|
CC/PP uses namespaces to distinguish the vocabulary associated with the
structure (e.g. ccpp:component) from vocabularies
associated with applications (e.g. TerminalHardware, display).
In this example we use the namespace
"http://www.wapforum.org/profiles/UAPROF/ccppschema-20010430#",
associated with prefix "prf:", to describe properties that are
not defined in the CC/PP or RDF namespaces:
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:ccpp="http://www.w3.org/2002/11/08-ccpp-schema#"
xmlns:prf="http://www.wapforum.org/profiles/UAPROF/ccppschema-20010430#">
<rdf:Description rdf:about="http://example.com/MyProfile">
<ccpp:component>
<rdf:Description rdf:about="http://example.com/TerminalHardware">
<rdf:type rdf:resource="http://www.wapforum.org/profiles/UAPROF/ccppschema-20010430#HardwarePlatform" />
<prf:CPU>PPC</prf:CPU>
<prf:ScreenSize>320x200</prf:ScreenSize>
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description rdf:about="http://example.com/TerminalSoftware">
<rdf:type rdf:resource="http://www.wapforum.org/profiles/UAPROF/ccppschema-20010430#SoftwarePlatform" />
<prf:OSName>EPOC</prf:OSName>
<prf:OSVendor>Symbian</prf:OSVendor>
<prf:OSVersion>2.0</prf:OSVersion>
</rdf:Description>
</ccpp:component>
<ccpp:component>
<rdf:Description rdf:about="http://example.com/Browser">
<rdf:type rdf:resource="http://www.wapforum.org/profiles/UAPROF/ccppschema-20010430#BrowserUA" />
<prf:BrowserName>Mozilla</prf:BrowserName>
<prf:BrowserVersion>5.0</prf:BrowserVersion>
<prf:HtmlVersion>
<rdf:Bag>
<rdf:li>3.2</rdf:li>
<rdf:li>4.0</rdf:li>
</rdf:Bag>
</prf:HtmlVersion>
</rdf:Description>
</ccpp:component>
</rdf:Description>
</rdf:RDF>
|
All RDF resources that relate to the overall structure of CC/PP are
defined in the ccpp: namespace, and have
associated schema properties that allow them to be distinguished from
attribute vocabulary or other RDF statements by a schema-aware processor.
This specification uses "rdf:about" to specify the URIs of
resources in examples. This was a deliberate choice to ensure that such URIs
are absolutely and unambiguously specified. This is also different to UAProf,
which uses both "rdf:about" and "rdf:ID".
CC/PP allows "rdf:ID" attributes or "rdf:about"
attributes. However, the values of "rdf:ID" attributes represent
URIs which are relative to the base URI of the document [RDFFRAGMENT]. When a document is moved to another location on
the web the meaning of the value of an "rdf:ID" attribute
changes. The meaning is undefined when the RDF is contained in a document
with no base URI, e.g. when encapsulated in a message. The RDFCore WG have a
Working Draft [RDFXML] that proposes that RDF should
support "xml:base" attributes. If this addition to RDF achieves
recommendation status, then it would be appropriate to use
"rdf:ID" attributes in conjunction with an
"xml:base" attribute instead of "rdf:about"
attributes. For now we recommend that CC/PP profiles SHOULD use
"rdf:about" and that the URIs of resources are fully
specified.
The component resources in a profile are instances of components
identified in the corresponding schema, which in turn MUST be subclasses of
ccpp:Component. They may usefully be
identified as such, by means of the rdf:type
property whose value matches the name of the component type in the schema.
(Sometimes this type indication MUST be present: see section 3.1, Components.)
The RDF statements that make up an RDF graph do not necessarily occur in a single document. For CC/PP, the profile delivered may contain references to RDF subgraphs that are transferred separately, or are retrieved from designated Web resources.
When an external sub-graph is referenced in this way, the effect is equivalent to taking the sets of RDF statement "triples" described by the referencing document and the referenced document, and constructing a new document that describes the union of these sets. (NOTE: implementations are not required to actually construct such a document, just to interpret the RDF statements as they would from a single document.)
This composition of multiple RDF documents presumes that the content of
the referenced document is trusted to accurately represent the capabilities
that are presented to the sender of some resource data. Accordingly, such
composition is restricted to documents describing resources referenced by
properties whose intended interpretation embodies such a notion of trust;
viz. ccpp:defaults.
This section describes the basic data types and data structuring options that are available for the values associated with a CCPP attribute.
All CC/PP attributes should be defined with values that can be treated as one of the simple or complex data types discussed later. Support for the described formats for attribute values is RECOMMENDED; this specification does not prohibit the use of other valid RDF forms, but provides no guidance for their interpretation. (See also section 1.1 and Appendix F.)
All simple CC/PP attribute values are represented as RDF plain literal values. In RDF/XML these may appear as character sequences either in XML elements or as XML attributes.
The acceptable plain literal values for an attribute may be constrained to the lexical space associated with a specific application data type. This section introduces some specific data types that may be associated with simple CC/PP attributes.
Base CC/PP usage defined here leaves any further interpretation of the values used to the processing application. Future versions of CC/PP may introduce additional structures that provide for standardized matching of client profiles with other resource metadata. To allow such developments, and to ease interworking with IETF media feature descriptions, it is RECOMMENDED that any simple attribute values should be defined in terms of one of the data types described below.
All attribute values are ultimately sequences of UCS (Unicode) characters. It is assumed that character coding issues in specific serializations of the RDF data are defined by the enclosing XML representation.
NOTE: Attribute comparison is beyond the scope of this document, as are specific mechanisms for determining the simple type corresponding to a given attribute value. Applications are presumed to know how to deal with any CC/PP attribute that they handle.
Where given, formal syntax expressions use the notation presented in Section 6 of the XML specification [XML].
The data type of a CC/PP attribute value may be defined to be a case sensitive text string.
The RDF literal value is constrained to the lexical space defined in the "string" XML schema datatype [XMLSCHEMA-2]. Any 'lang' tag is ignored.
In general, such values may be compared for equality or inequality. When comparing text values, every character must match exactly for equality to be declared.
Some examples:
The data type of a CC/PP attribute value may be defined to be an integer number.
The RDF literal value is constrained to the lexical space defined in the "int" XML schema datatype [XMLSCHEMA-2]. Any 'lang' tag is ignored.
Integer numbers may be positive, zero or negative. They are represented by a string containing a sequence of decimal digits, optionally preceded by a '+' or '-' sign. Leading zeros are permitted and are ignored. The number value is always interpreted as decimal (radix 10). It is RECOMMENDED that implementations generate and support integer values in the range -2147483648 to +2147483647, or -(2^31) to (2^31-1); i.e. integers whose absolute value can be expressed as a 31-bit unsigned binary number.
Signed-integer ::= ( '+' | '-' )? Unsigned-integer Unsigned-integer ::= Digit (Digit)* |
Some examples:
NOTE: The choice of RECOMMENDED number range support was based on support from Java and other programming languages widely used for the Web.
The data type of a CC/PP attribute value may be defined to be a rational number.
In other words, the RDF literal value is constrained to the lexical space defined below. Any 'lang' tag is ignored.
A rational number is expressed as a ratio of two integer numbers. Two positive integers are separated by a '/', and optionally preceded by a '+' or '-' sign.
It is RECOMMENDED that implementations generate and support numerators of a rational number (the first number, before the '/') in the range 0 to 2147483647 (2^31-1), and denominators (after the '/') in the range 1 to 2147483647.
Rational-number ::= Signed-integer ( '/' Unsigned-integer )? |
If the denominator is omitted, a value '1' is assumed; i.e. treat value as an Integer.
Some examples:
NOTE: The rational number schema described above may be defined in XML-Schema [XMLSCHEMA-0] as follows:
Figure 4-4: Possible XML-Schema for rational numbers <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.w3.org/TR/2003/WD-CCPP-struct-vocab-20030728/"> <xs:simpleType name="rational"> <xs:annotation> <xs:documentation> The canonical lexical representation of any value will be the form of the value reduced to its lowest common denominator, and with '1' in the denominator if applicable. </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:pattern value="[-+]?[0-9]+(/0*[1-9][0-9]*)?"/> </xs:restriction> </xs:simpleType> </xs:schema>Note that while the pattern above provides a lexical definition, it does so imperfectly: it strictly disallows any whitespace at all. Further, the simple type definition above does not define a numeric value space; ordering, equality, and implied support for arithmetic operations are not defined as some users of the type might expect -- processors need only recognize the definition as a string. Because of these deficiencies, use of rational numbers as defined here may be harmful to interoperability. (The XML-Schema Working Group may define a workable rational data type in the future.)
A profile MUST NOT have multiple occurrences of a single attribute within a single component. CC/PP attributes that need to have multiple values should use sets or sequences. Other complex CC/PP attribute values may be represented by arbitrary RDF resources. A definition of the interpretation of such values is beyond the scope of this specification.
Set values are useful for representing certain types of device characteristics; e.g. the range of typefaces that can be supported by a client, or the HTML versions supported by a browser.
A set is represented as an 'rdf:Bag', with each member of the set corresponding to a property of that resource named 'rdf:_1', 'rdf:_2', etc. This construct is described in section 3 of the RDF Model and Syntax specification [RDF].
[(Client-resource)]
+--(attributeName)--> [<rdf:Bag>]
+--rdf:_1--> (set-member-value-1)
+--rdf:_2--> (set-member-value-2)
:
+--rdf:_n--> (set-member-value-n)
|
NOTE: The 'rdf:Bag' construct does not require that every contained value be unique. A set cannot contain duplicate values, so every property of an 'rdf:Bag' used to represent a set must have a distinct value.
There is a clear distinction drawn between an attribute that has a single value, and an attribute whose value is a set with zero, one or more elements:
[(Client-resource)] +--(attributeName)--> [<rdf:Bag>] --rdf:_1--> (set-member-value) |
Compare the above attribute value, which is a set containing one element, with the following, which is a simple value:
[(Client-resource)] +--(attributeName)--> (attribute-value) |
Sequence values are useful for a range of client features that may be ordered or ranked in some way; e.g. a list of preferences in some order of preference. This specification does not define the significance of the ordering of values. A vocabulary that defines a sequence-valued CC/PP attribute should also define the significance of the ordering of within the sequence.
A sequence is represented as an 'rdf:Seq', with each member of the set corresponding to a property of that resource named 'rdf:_1', 'rdf:_2', etc. This construct is described in section 3 of the RDF Model and Syntax specification [RDF].
[(Client-resource)]
+--(attributeName)--> [<rdf:Seq>]
+--rdf:_1--> (sequence-value-1)
+--rdf:_2--> (sequence-value-2)
:
+--rdf:_n--> (sequence-value-n)
|
There is a clear distinction drawn between an attribute that has a single value, and an attribute whose value is a sequence with zero, one or more elements:
[(Client-resource)] +--(attributeName)--> [<rdf:Seq>] --rdf:_1--> (sequence-value) |
Compare the above attribute value, which is a sequence containing one element, with the simple value as shown in figure 4-6 above.
CC/PP attribute names are in the form of a URI. Any CC/PP vocabulary is associated with an XML namespace, which combines a base URI with a local XML element name (or XML attribute name) to yield a URI corresponding to an attribute name. E.g. the namespace URI:
http://www.w3.org/2002/11/08-ccpp-client#
and the core vocabulary name:
type
are combined to yield the attribute name URI reference:
http://www.w3.org/2002/11/08-ccpp-client#type
Anyone can define and publish a CC/PP vocabulary extension (assuming administrative control or allocation of a URI for an XML namespace). For such a vocabulary to be useful, it must be interpreted in the same way by communicating entities. Thus, use of an existing extension vocabulary is encouraged wherever possible; failing this, publication of a new vocabulary definition containing detailed descriptions of the new CC/PP attributes.
Many extension vocabularies will be drawn from existing applications and protocols; e.g. WAP UAProf, IETF media feature registrations, etc. Appendix E surveys some possible sources of additional CC/PP vocabularies.
Attribute names are defined, and associated with an XML namespace, using an RDF schema.
Appendix B to this document contains an RDF schema describing terms for use in CC/PP profiles. Appendix C contains an example Schema describing a CC/PP vocabulary. Appendix D contains recommendations for creating a new vocabulary.
A CC/PP processor is not required to understand and process RDF Schema definitions; it merely needs to understand enough about the CC/PP profile structure and vocabulary used to perform its job. (A schema-aware processor may be able to handle CC/PP profiles in other ways, or in combination with other RDF information, but such behavior is beyond the scope of this specification.)
This section explains how to make a valid claim that a product conforms to this specification. Anyone may make a claim (e.g., vendors about their own products, third parties about those products, journalists about products, etc.). Claims may be published anywhere (e.g., on the Web or in product documentation). Claimants are solely responsible for their claims. If the subject of the claim (e.g., the software) changes after the date of the claim, the claimant is responsible for updating the claim. Claimants are expected to modify or retract a claim if it may be demonstrated that the claim is not valid. Claimants are encouraged to conform to the most recent specification available.
There are three classes of products of CC/PP:
Documents may exist as resources accessible via a URL, or may be transmitted as data in a message. A document is CC/PP conformant when it meets the following criteria:
A producer is CC/PP conformant when any CC/PP profile document generated by the producer is a CC/PP conformant document.
A consumer is CC/PP conformant when the consumer accepts any CC/PP conformant document and extracts CC/PP information. Schema-aware processing is not required, and therefore, support for the RDF Schema in Appendix B by CC/PP consumers is OPTIONAL (see section 4.3).
There are two categories of conformance for CC/PP consumers:
NOTE: A consumer implementation may be configurable to act as either a conformant consumer or a conformant validating consumer at different times.
A conformance claim is valid if it is well formed and meets the appropriate conformance criteria for the applicable product class as given above.
A conformance claim is well-formed if it includes the following information:
This document is a distillation of many discussions of the W3C CC/PP Working Group, with final amendments introduced by the W3C Device Independence Working Group. The following were CC/PP Working Group members for some or most of the period of preparation of this specification, and its predecessors:
During the period when the CC/PP WG was developing the specification, useful revisions and clarifications were suggested by Yuichi Koike, Stuart Williams, Sean Palmer and Toni Penttinen. Special thanks are due to Aaron Swartz for a very thorough and revealing review of the first last call draft.
Following the handing over of the work to the DI WG, special thanks are also due to David Ezell (XML Schema WG), Brian McBride (RDF Core WG), Masayasu Ishikawa (HTML WG), and Lynne Rosenthal (QA WG) for their help in completing the specification.
The following members of the DI WG also provided assistance in completing the specification: Stephane Boyera, Roger Gimson, Kazuhiro Kitagawa, Andreas Schade.
Also see WAP-248-UAProf Version 20-Oct-2001 available at http://www.wapforum.org/what/technical.htm
This appendix is INFORMATIVE.
| CC/PP | Composite Capabilities/Preferences Profile |
|---|---|
| CC/PPex | CC/PP Exchange Protocol |
| CONNEG | Content Negotiation Working Group in the IETF |
| ER | Entity-Relationship |
| HTML | HyperText Markup Language |
| HTTP | HyperText Transfer Protocol |
| HTTPex | HTTP Extension Framework |
| IANA | Internet Assigned Numbers Authority |
| IETF | Internet Engineering Task Force |
| IOTP | Internet Open Trading Protocol |
| LDAP | Lightweight Directory Access Protocol |
| OTA | Over The Air, i.e. in the radio network |
| RDF | Resource Description Framework |
| RFC | Request For Comments |
| TBD | To Be Determined |
| TCP/IP | Transmission Control Protocol/Internet Protocol |
| UAProf | WAP User Agent Profile |
| W3C | World Wide Web Consortium |
| WAP | Wireless Application Protocol |
| WBXML | WAP Binary XML |
| WML | Wireless Markup Language |
| WSP | Wireless Session Protocol |
| XHTML | Extensible HyperText Markup Language |
| XSL | Extensible Stylesheet Language |
| XML | Extensible Markup Language |
This appendix is NORMATIVE, but support by CC/PP processors is OPTIONAL.
rdfs:Resource
ccpp:Profile {Profile deliverable to origin server}
ccpp:Component
rdfs:Literal
ccpp:string {A text value of a CC/PP attribute}
ccpp:integer {An integer value of a CC/PP attribute}
ccpp:rational {A rational number CC/PP attribute value}
rdf:Bag {A set value for a CC/PP attribute}
rdf:Seq {A sequence value for a CC/PP attribute}
rdf:Property
ccpp:Property {A property applied to a CCPP:Resource}
ccpp:Structure {A structural property in a CC/PP profile}
ccpp:Attribute {A property denoting a CC/PP attribute}
|
ccpp:component Domain=ccpp:Profile, Range=ccpp:Component ccpp:defaults Domain=ccpp:Component, Range=ccpp:Component |
(Schema URI: http://www.w3.org/2002/11/08-ccpp-schema)
<?xml version='1.0'?>
<!DOCTYPE rdf:RDF [
<!ENTITY ns-rdf 'http://www.w3.org/1999/02/22-rdf-syntax-ns#'>
<!ENTITY ns-rdfs 'http://www.w3.org/2000/01/rdf-schema#'>
<!ENTITY ns-ccpp 'http://www.w3.org/2002/11/08-ccpp-schema#'>
]>
<rdf:RDF
xmlns:rdf = '&ns-rdf;'
xmlns:rdfs = '&ns-rdfs;'
xmlns:ccpp = '&ns-ccpp;'>
<!-- CC/PP class definitions -->
<rdfs:Class rdf:about='&ns-ccpp;Profile'>
<rdfs:label xml:lang="en">CC/PP Profile</rdfs:label>
<rdfs:subClassOf rdf:resource='&ns-rdfs;Resource'/>
<rdfs:comment xml:lang="en">
This class is any complete profile that can be delivered to an
origin server or other system that generates content for a client.
</rdfs:comment>
</rdfs:Class>
<rdfs:Class rdf:about='&ns-ccpp;Component'>
<rdfs:label xml:lang="en">CC/PP profile component</rdfs:label>
<rdfs:subClassOf rdf:resource='&ns-rdfs;Resource'/>
<rdfs:comment xml:lang="en">
A base class for any collection of CC/PP attribute values.
A CC/PP client profile consists of one or more components,
typically using a derived class that indicates the use of the
component (e.g. prf:HardwarePlatform, prf:SoftwarePlatform).
</rdfs:comment>
</rdfs:Class>
<rdfs:Class rdf:about='&ns-ccpp;string'>
<rdfs:label xml:lang="en">Text value</rdfs:label>
<rdfs:subClassOf rdf:resource='&ns-rdfs;Literal'/>
<rdfs:comment xml:lang="en">
This is the class of RDF Literals that represent CC/PP
attribute string values.
</rdfs:comment>
<rdfs:seeAlso rdf:resource=
'http://www.w3.org/TR/xmlschema-2/#string'/>
</rdfs:Class>
<rdfs:Class rdf:about='&ns-ccpp;integer'>
<rdfs:label xml:lang="en">Integer value</rdfs:label>
<rdfs:subClassOf rdf:resource='&ns-rdfs;Literal'/>
<rdfs:comment xml:lang="en">
This is the class of RDF Literals that represent CC/PP
attribute integer number values.
</rdfs:comment>
<rdfs:seeAlso rdf:resource=
'http://www.w3.org/TR/xmlschema-2/#integer'/>
</rdfs:Class>
<rdfs:Class rdf:about='&ns-ccpp;rational'>
<rdfs:label xml:lang="en">Rational value</rdfs:label>
<rdfs:subClassOf rdf:resource='&ns-rdfs;Litera |