XML Schema for User Interface Socket Description Gottfried Zimmermann, Trace Center Universal Remote Console Consortium This is the XML schema for ISO/IEC 24752-2:2007 English 2004-01-28 2007-08-18 Copyright 2007 URCC Root element Type for root element of User Interface Socket Description Due to XSD syntax limitations, this is not as restrictive as ISO/IEC 24752-2: dcterms:conformsTo is required as a minimum. ISO/IEC 24752-2 is more restrictive: schema element may occur only once; must contain type definitions in XML Schema Definition language; schema element must not have a targetNamespace attribute. Globally unique name (URI) of Socket described. Default value for sufficiency of commands in this Socket Description. Default value for completeness of commands in this Socket Description. Type for set element. Set elements may be used to create a socket-internal hierarchical structure. Sets may be nested. This schema requires specific order of children due to XSD syntax limitations. This is more restrictive than ISO/IEC 24752-2. Platform-specific binding information for the set. Type for set dependency. XPath expression indicating when the set may be presented to the user, based on state information of the Target. XPath expression indicating when the user can change the value of variables or trigger commands inside the set element. XPath expression indicating when the user can insert or remove actual indices for the set element. XPath 2.0 expression as dependency. Note that this schema cannot validate the XPath syntax used in a UI Socket Description. Type for dim attribute on sets and socket elements. Specifies a non-empty, ordered, white-space separated list of type names which denote the index spaces for the set/element. Variables are used to expose the state of a Target to a user, and to let the user change the Target state. This schema requires specific order of children due to XSD syntax limitations. This is more restrictive than ISO/IEC 24752-2. Describes the variable with DCMI properties. Platform-specific binding information for the variable. Set of values that either restrict the variable's value space (closed selection) or provide suggested values for user input (open selection). Type of the variable, may be imported. Whether the variable's value is sensitive regarding security and privacy. Whether the variable shall be presented to the user under all circumstances. Whether this variable holds the timeout duration for one or multiple user response timeouts of the Target. If true, type must be xsd:duration. If true, the variable may not be available at runtime due to various constraints. Whether the variable will never change during a session. Whether the variable comes with resources at runtime. Type for variable dependency element. XPath expression indicating when the variable may be presented to the user, based on state information of the Target. XPath expression indicating when the user can change the value of the variable. XPath expression indicating when the user can insert or remove actual indices for the variable element. XPath expression specifying how the value of the variable depends on the values of other variables. Only allowed for permanently read-only variables (those with a write dependency of "false()"). XPath expression that evaluates to a number which specifies the allowed length of the variable at runtime. Allowed only if the type of the pertaining variable is xsd:string, or derived from xsd:string. XPath expression that evaluates to a number which specifies the minimum allowed length of the variable at runtime. Allowed only if the type of the pertaining variable is xsd:string, or derived from xsd:string. XPath expression that evaluates to a number which specifies the maximum allowed length of the variable at runtime. Allowed only if the type of the pertaining variable is xsd:string, or derived from xsd:string. XPath expression that evaluates to a string which specifies a regular expression that defines a pattern for the allowed values of the variable at runtime. Allowed only if the type of the pertaining variable is xsd:string, or derived from xsd:string. XPath expression that evaluates to a value of the same type as the variable it belongs to. This value specifies the minimum value (inclusively) of the variable at runtime. Allowed only if variable has a type whose value space is totally ordered. XPath expression that evaluates to a value of the same type as the variable it belongs to. This value specifies the maximum value (inclusively) of the variable at runtime. Allowed only if variable has a type whose value space is totally ordered. XPath expression that evaluates to a value of the same type as the variable it belongs to. This value specifies the minimum value (exclusively) of the variable at runtime. Allowed only if variable has a type whose value space is totally ordered. XPath expression that evaluates to a value of the same type as the variable it belongs to. This value specifies the maximum value (exclusively) of the variable at runtime. Allowed only if variable has a type whose value space is totally ordered. Type for a set of values pertaining to a variable or command parameter. This set either restricts the variable's/parameter's value space (closed selection) or provide suggested values for user input (open selection). Selection set that does not change dynamically with the Target's state. Selection set that can change dynamically with the Target's state. Whether the set of values is closed. Reference to a type defining a static set of values. The referenced type must be derived by restriction from a simple type. Reference to socket variable of type uis:valueList or uis:csvlist, providing a list of allowed values. Constants are used to represent static information that is known prior to runtime. This schema requires specific order of children due to XSD syntax limitations. This is more restrictive than ISO/IEC 24752-2. Describes the constant with DCMI properties. Platform-specific binding information for the constant. Type of the constant, may be imported. Whether the constant shall be presented to the user under all circumstances. Whether this constant holds the timeout duration for one or multiple user response timeouts of the Target. If true, type must be xsd:duration. Type for constant dependency element. XPath expression indicating when the constant may be presented to the user, based on state information of the Target. Command elements are used to capture commands that a user may issue to a Target. This schema requires specific order of children due to XSD syntax limitations. This is more restrictive than ISO/IEC 24752-2. Describes the command with DCMI properties. Type of the command (pre-defined: uis:voidCommand, uis:basicCommand, uis:timedCommand). Whether the command shall be presented to the user under all circumstances. Whether the command is sufficiently specified. Note: No default value specified since this value, if present, will override the value of the sufficient attribute of the uiSocket element. Whether the command is completely specified. Note: No default value specified since this value, if present, will override the value of the complete attribute of the uiSocket element. If optional=”true”, the command may not be available at runtime due to various constraints. Whether the command comes with resources at runtime. Only allowed for types uis:basicCommand and uis:timedCommand. Note: The default value "false" is not specified in XSD since this would also apply to commands of type uis:voidCommand. Type for command dependency element. XPath expression indicating when the command may be presented to the user, based on state information of the Target. XPath expression indicating when the user can activate the command, based on state information of the Target. XPath expression indicating when the user can insert or remove actual indices for the command element. XPath expression that is guaranteed to evaluate to true after the command has been successfully executed. The type for command parameters. Due to XSD syntax limitations, no distinction between local and global parameters is made. Also, this type definition is far more lax than ISO/IEC 24752-2. For local parameters, id, dir, type are required; secret, sensitive are optional. For global parameters, idref, dir are required. Describes the parameter with DCMI properties. Required for local parameters, prohibited for global parameters. Reference to variable used as global parameter. Required for global parameters, prohibited for local parameters. "in" for input parameter, "out" for output parameter, "inout" for input-output parameter. Required for local parameters, prohibited for global parameters. Whether the local parameter's value is sensitive regarding security and privacy. Prohibited for global parameters. Note: Default value "false" not specified in XSD since this would also apply to global parameters. Whether this local parameter represents legally sensitive information. Prohibited for global parameters. Note: Default value "false" not specified in XSD since this would also apply to global parameters. Notifications are special states in which normal operation is suspended, such as exception states. This schema requires specific order of children due to XSD syntax limitations. This is more restrictive than ISO/IEC 24752-2. Describes the notification with DCMI properties. Platform-specific binding information for the notification. Timeout variable for the notification. Timeout constant for the notification. Category of notification ("info", "alert", "error"). Whether the notification represents legally sensitive information. If optional=”true”, the notification may not be available at runtime due to various constraints. Whether the notify element comes with resources at runtime. XPath expression indicating when the user can insert or remove actual indices for the notify element. XPath expression indicating if the user has to acknowledge the notification. XPath expression specifying when a notification is deemed to have been handled by the user. This schema requires specific order of children due to XSD syntax limitations. This is more restrictive than ISO/IEC 24752-2. Set of values that either restrict the variable's value space (closed selection) or provide suggested values for user input (open selection). Platform-specific binding information for the variable. Describes the variable with DCMI properties. Whether the variable's value is sensitive regarding security and privacy. Whether the variable shall be presented to the user under all circumstances. If true, the variable may not be available at runtime due to various constraints. Whether the variable will never change during a session. Whether the variable comes with resources at runtime. This schema requires specific order of children due to XSD syntax limitations. This is more restrictive than ISO/IEC 24752-2. Platform-specific binding information for the constant. Describes the constant with DCMI properties. Whether the constant shall be presented to the user under all circumstances. Platform-specific binding information for the User Interface Socket, any UI Socket element, or command parameters. Identifier for a particular networking platform. Valid values for dir attribute of param element. Valid values for category attribute of notify element. Item for 'valueList'. Pre-defined type - building block for the specification of types (by derivation) that provide a list of constrained string values. Pre-defined type for whitespace delimited list of strings.