st:availability

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.

Specifies a number representing the availability of a presence state.

Syntax

<st:availability>...</st:availability>

Attributes

None

Tag Content

Default Value Data Type Description

none

xs:unsignedInt

Contains an availability value of the presence state.

Parent Element

Element Description

st:state

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

Child Elements

None

Remarks

A presence state indicates the availability of the presentity and is a combination of the online status and willingness. A user may be online (available), offline (away) or somewhere in-between (inactive). Willingness indicates the current activity or permissions an online user can be called upon to communicate. An online user could be busy talking with someone else on the phone (busy, in a call) or do not want to be disturbed (DND).

The following table shows the possible presence state defined and used by Office Communicator 2007.

State Value Description

Available

3500

User or device is available and user is willing to communicate.

Busy

6500

User or device is Busy.

DND

9500

User should not be interrupted

Be Right Back

12500

User is not available.

Away

15500

User is not available.

Offline

18500

User or device is offline.

Unknown

 

User's or device's status is unknown.

Idle/Inactive

5000

User or device is inactive.

IdleBusy

 

User or device is idle or user is busy doing something else.

Urgent Interruptions Only

 

 

Block

 

User or device is blocked.

Examples

XML Example of the availability Element

The following code snippet indicates that a presentity is available (3500).

<st:state xsi:type="aggregatestate" 
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
          xmlns:st="http://schemas.microsoft.com/2006/09/sip/state" >
   <st:availability>3500</st:availability>
</st:state>