st:activity

  • Article

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Represents the user's activity as part of the presence state.

Syntax

<st:activity token="…" maxAvailability="…" minAvailability="…"
        xmlns:st="http://schemas.microsoft.com/2009/06/sip/state">
   <st:custom>…</st:custom>
   <ct:delimiter 
   …
   <ct:end />
   <ct:extension>
   …
   </ct:extension>
</st:activity>

Attributes

Attribute

Data Type

Description

token

token

Optional string representing activity string. Possible values are "on-the-phone", "in-a-conference", "in-a-meeting", "out-of-office", or "urgent-interruptions-only".

maxAvailability

int

Maximum availability. Optional

minAvailability

int

Minimum availability. Optional

Parent Element

Element

Description

st:state

A presence state described, in part, by this element.

Child Elements

Element

Occurrence

Description

st:custom

0 or more

Holds locale-specific activity string when token is absent.

ct:delimiter

0 or more

Beginning marker of schema extensions.

ct:end

0 or 1

Ending marker of the schema extension.

ct:extension

0 or more

Custom extension to this element.

Remarks

The activity defined by the Enhanced Presence Schemas can be expressed by the token attribute value of this element or by one or more custom elements for locale-specific strings.

This element can be extended in future versions of the Enhanced Presence Schemas. The extension is enclosed by ct:delimiter element and a ct:end element in the Enhanced Presence Schemas commontypes namespace, where ct is defined as 'xmlns:ct="http://schemas.microsoft.com/2006/09/sip/commontypes"'.

An extension block can have multiple ct:end elements each of which corresponds to a version of the schema extension.

Examples

XML Example 1 of the activity Element

The following XML fragment shows a presence state with the activity string described by the token attribute.

<state xsi:type="aggregateState" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns="http://schemas.microsoft.com/2006/09/sip/state">
  <availability>3500</availability>
  <activity token="in-a-meeting" />
</state>

XML Example 2 of the activity Element

The following XML fragment shows a presence state with the activity string described by a locale-specific string.

<state xsi:type="aggregateState" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns="http://schemas.microsoft.com/2006/09/sip/state">
  <availability>3500</availability>
  <activity>
     <custom LCID="1033">at home"</custom>
  </activity>
</state>

XML Example 3 of the activity Element

The following XML fragment shows a presence state with activity described by the token attribute value and a <chore> element introduced in a later version of the schema.

<state xsi:type="aggregateState" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:ct="http://schemas.microsoft.com/2006/09/sip/commontypes"
      xmlns="http://schemas.microsoft.com/2006/09/sip/state ">
  <availability>3500</availability>
  <activity token="at home">
     <ct:delimiter/>
         <chore>cooking</chore>
     <ct:end/>
  </activity>
</state>