Share via

2.2.2.7.3 services

  • Article

The services category is used to specify presence capabilities. The services category has the list of individual service elements. Each service element MUST correspond to a URI. For details about how a services category instance is computed, see section 3.8.5.2.

The following examples illustrate the format of a services category instance.

<services xmlns="http://schemas.microsoft.com/2006/09/sip/service">
  <service uri="sip:bob@contoso.com">
    <capabilities>
        <text render="true" capture="true" publish="false" 
              preferredEndpointId="2cd4f7ca-b1d1-5eda-8d79-79ee4298414d" 
              deviceAvailability="3500" />
        <gifInk render="true" capture="false" publish="false" 
                preferredEndpointId="2cd4f7ca-b1d1-5eda-8d79-79ee4298414d" 
                deviceAvailability="3500" />
        <isfInk render="true" capture="false" publish="false" 
                preferredEndpointId="2cd4f7ca-b1d1-5eda-8d79-79ee4298414d" 
                deviceAvailability="3500" />
        <breakthrough render="false" capture="false" publish="true"
                preferredEndpointId="2cd4f7ca-b1d1-5eda-8d79-79ee4298414d" 
                deviceAvailability="3500" />
        <applicationSharing render="true" capture="true" publish="false"
                preferredEndpointId="2cd4f7ca-b1d1-5eda-8d79-79ee4298414d" 
                deviceAvailability="3500" />    </capabilities>
  </service>
  <service uri="tel:+11234567890;ext=67890">
    <capabilities>
       <remoteCallControl render="false" capture="false" publish="true" 
                          preferredEndpointId="a8f9a3a8-ee61-56d7-b306-c67b08fb28d8" 
                          deviceAvailability="3500" />
    </capabilities>
  </service>
  <service uri="bob@exchange.contoso.com">
    <capabilities>
      <calendar render="false" capture="false" publish="true" 
                version="655616" 
                preferredEndpointId="2cd4f7ca-b1d1-5eda-8d79-79ee4298414d"
                deviceAvailability="3500" />
    </capabilities>
  </service>
</services>
 
<services xmlns="http://schemas.microsoft.com/2006/09/sip/service">
  <service uri="sip:bob@contoso.com">
    <capabilities>
      <text render="true" capture="true" deviceAvailability="3500" />
      <gifInk render="true" capture="false" deviceAvailability="3500" />
      <isfInk render="true" capture="false"  deviceAvailability="3500" />
    </capabilities>
  </service>
</services>

Elements and attributes are defined in this section. For the full XML schema, see section 7.

The XML elements of a services document MUST conform to the schema defined in section 7.5.

  • services: This is the root element. This element contains the list of service elements with their capabilities. It has the following attributes:

    • majorVersion (optional): The major version of schema format.

    • minorVersion (optional): The minor version of schema format.

  • service: It has the following attribute:

    • uri (required): URI of the service.

  • capabilities: The list of capabilities, each of which SHOULD<5> be represented by a text element, voice element, video element, calendar element, remoteCallControl element, CCCP element, gifInk element, isfInk element, breakthrough element, applicationSharing element, ucs element, containerIntegrity element, contentWhiteboard element, contentPowerPoint element, contentNativeFile element, contentPoll element, or contentSharedNotes element within the capabilities element.

    • text: The instant messaging capability of an endpoint device. It has the following attributes:

      • render (optional): A Boolean value that indicates whether the endpoint device is capable of receiving instant messages (true) or not (false).

      • capture (optional): A Boolean value that indicates whether the endpoint device is capable of sending instant messages, true or false.

      • publish (optional): Ignored.

      • version (optional):<6> Ignored.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Identifier of preferred client endpoint for auto-accepting instance messages.

    • voice: The capability of an endpoint device to make voice communication. It contains the following attributes:

      • render (optional): A Boolean value that indicates whether the endpoint device is capable of receiving voice communication, true or false.

      • capture (optional): A Boolean value that indicates whether the endpoint device is capable of sending voice communication, true or false.

      • publish (optional): Ignored.

      • version (optional): Ignored.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Ignored.

    • video: The capability of an endpoint device to make video communication. It contains the following attributes:

      • render (optional): A Boolean value that indicates whether the endpoint device is capable of receiving video communication, true or false.

      • capture (optional): A Boolean value that indicates whether the endpoint device is capable of sending video communication, true or false.

      • publish (optional): Ignored.

      • version (optional): Ignored.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Ignored.

    • calendar: The capability of an endpoint device to publish calendar information to presence. It contains the following attributes:

      • render (optional):Ignored.

      • capture (optional):<7> Ignored.

      • publish (optional): A Boolean value that indicates whether the endpoint device is capable of publishing calendar information to presence, true or false.

      • version (optional): The version of the capability. Server MUST prefer the endpoint with higher version as a preferred endpoint as specified in section 3.8.5.2.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Identifier of preferred client endpoint for publishing calendar information to presence.

    • remoteCallControl: The remote call control of an endpoint device. It has the following attributes:

      • render (optional): Ignored.

      • capture(optional):<8> Ignored.

      • publish (optional): A Boolean value that indicates whether the endpoint device is capable of publishing remote call control information to presence, true or false.

      • version (optional): The version of the capability. Server MUST prefer the endpoint with higher version as a preferred endpoint as specified in section 3.8.5.2.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Identifier of preferred client endpoint for publishing remote call control information to presence.

    • CCCP: Ignored.

    • gifInk, isfInk: The ink capability, or handwriting capability on a device using a stylus, of an endpoint device.

      • render (optional): A Boolean value that indicates whether rendering of this ink capability is supported, true or false.

      • capture (optional): A Boolean value that indicates whether capturing this ink capability is supported, true or false.

      • publish (optional): Ignored.

      • version (optional):<9> Ignored.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Ignored.

    • breakthrough: The capability of an endpoint device to publish breakthrough list in the routing category instance. Refer to [MS-SIPRE] section 3.9.5.1.4 for details about the breakthrough list. It has the following attributes:

      • render (optional): Ignored.

      • capture (optional): Ignored.

      • publish (optional): A Boolean value that indicates whether the endpoint device is capable of publishing breakthrough list, true or false.

      • version (optional): Ignored.

      • deviceAvailability (optional): Ignored.

      • preferredEndpointId (optional): Identifier of preferred client endpoint for publishing breakthrough list.

    • applicationSharing: The application sharing capability of an endpoint device. It has the following attributes:

      • render (optional): A Boolean value that indicates whether the endpoint device is capable of rendering application sharing, true or false.

      • capture (optional): A Boolean value that indicates whether the endpoint device is capable of controlling or initiating application sharing with other users, true or false.

      • publish (optional): Ignored.

      • version (optional): Ignored.

      • deviceAvailability (optional):<10> The availability of the device associated with this capability.

      • preferredEndpointId (optional): Ignored.

    • ucs: The capability of an endpoint device to create contacts in the mail server for contact list entries in the server. It has the following attributes:

      • render (optional): Ignored.

      • capture (optional): Ignored.

      • publish (optional): A Boolean value that indicates whether the endpoint device is capable of creating contacts on the mail server for contact list entries.

      • version (optional): The version of the capability. Server MUST prefer the endpoint with higher version as a preferred endpoint as specified in section 3.8.5.2.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Identifier of preferred client endpoint for creating contacts on the mail server.

    • containerIntegrity: The capability of an endpoint device to create container membership according to rules defined in the publicationGrammar provision group in [MS-SIPREGE] section 2.2.2.5.4, or privacyPublicationGrammar provision group in section [MS-SIPREGE] section 2.2.2.5.10. It has the following attributes:

      • render (optional): Ignored.

      • capture (optional): Ignored.

      • publish (optional): A Boolean value that indicates whether the endpoint device is capable of creating container membership according to rules defined in the publication grammar provision groups.

      • version (optional): The version of the capability. Server MUST prefer the endpoint with higher version as a preferred endpoint as specified in section 3.8.5.2.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Identifier of preferred client endpoint for creating container membership.

    • contentWhiteboard<11>: The whiteboard content capability of an endpoint device. It has the following attributes:

      • render (optional): A Boolean value that indicates whether the endpoint device is capable of receiving whiteboard content, true or false.

      • capture (optional): A Boolean value that indicates whether the endpoint device is capable of sharing whiteboard content with other users, true or false.

      • publish (optional): Ignored.

      • version (optional): Ignored.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Ignored.

    • contentPowerPoint:<12> The PowerPoint content capability of an endpoint device. It has the following attributes:

      • render (optional): A Boolean value that indicates whether the endpoint device is capable of receiving PowerPoint content, true or false.

      • capture (optional): A Boolean value that indicates whether the endpoint device is capable of sharing PowerPoint content with other users, true or false.

      • publish (optional): Ignored.

      • version (optional): Ignored.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Ignored.

    • contentNativeFile:<13> The capability of an endpoint device to receive and share opaque binary content in a multiparty conference. It has the following attributes:

      • render (optional): A Boolean value that indicates whether the endpoint device is capable of receiving opaque binary content in a multiparty conference, true or false.

      • capture (optional): A Boolean value that indicates whether the endpoint device is capable of sharing opaque binary content in a multiparty conference with other users, true or false.

      • publish (optional): Ignored.

      • version (optional): Ignored.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Ignored.

    • contentPoll<14>: The capability of an endpoint device to participate in interactive polls. It has the following attributes:

      • render (optional): A Boolean value that indicates whether the endpoint device is capable of receiving polling data, true or false.

      • capture (optional): A Boolean value that indicates whether the endpoint device is capable of sharing polling data with other users, true or false.

      • publish (optional): Ignored.

      • version (optional): Ignored.

      • deviceAvailability (optional): The availability of the device associated with this capability.

    • preferredEndpointId (optional): Ignored.

    • contentSharedNotes<15>: The shared notes content capability of an endpoint device. It has the following attributes:

      • render (optional): A Boolean value that indicates whether the endpoint device is capable of receiving shared notes content, true or false.

      • capture (optional): A Boolean value that indicates whether the endpoint device is capable of sharing shared notes content with other users, true or false.

      • publish (optional): Ignored.

      • version (optional): Ignored.

      • deviceAvailability (optional): The availability of the device associated with this capability.

      • preferredEndpointId (optional): Ignored.