Share via


state[@type='calendarState']

Specifies an enhanced presence state category instance value according to the user’s calendar.

<st:state xmlns:st="https://schemas.microsoft.com/2006/09/sip/state" 
          xmlns:ct="https://schemas.microsoft.com/2006/09/sip/commontypes"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:type="calendarState"
       manual="xs:boolean" 
       startTime="xs:dateTime" 
       majorVersion="xs:unsignedInt" 
       minorVersion="xs:unsignedInt"
       [anyAttri]="anyAttribute">
       uri="xs:anyURI"
   <st:availability>xs:unsignedInt</st:availability>
   <st:activity>st:activityType</st:activity>
   <st:endpointLocation>st:endpointLocationEnumEx</st:endpointLocation>
   <st:extension>st:extensionType</st:extension>
   <st:meetingSubject>st:LCIDType</st:meetingSubject>
   <st:meetingLocation>st:LCIDType</st:meetingLocation>
   <ct:delimiter/>
   <st:[any]>any element</st:[any]>
   <ct:end/>
   <ct:extension>
     <[any] xmlns="any.namespace"</[any]>
   </ct:extension>
</st:state>

calendarState : stateType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Description

xsi:type

Required attribute with the fixed value of "calendarState". This attribute is not explicitly defined, but permitted as one of any custom attributes (@[anyAttr]) described below.

manual

Optional attribute to specify if the publication of this state is manual (true) or not (false). The default value is false.

startTime

Optional attribute to specify the starting time of this state publication. The default value is unspecified.

uri

Optional attribute specifying the SMTP address of the user whose calendar data was used to generate this calendar state category instance value.

majorVersion

Optional attribute to specify schema-dependent major version information. The default value is unspecified.

minorVersion

Optional attribute to specify schema-dependent minor version information. The default value is unspecified.

[anyAttr]

Optional custom attribute of any name and namespace.

Child Elements

Element

Occurrence

Description

availability

0 ore 1

Availability number indicating the presence status.

activity

0 or more

An activity string and/or token describing the presence status.

endpointLocation

0 or 1

Location of the endpoint associated with this presence state

endpointLocation

0 or 1

Custom extension to the presence state

state/meetingSubject

0 or 1

Contains the meeting subject as specified in a calendar state category instance derived from the calendar data of the presentity.

state/meetingLocation

0 or 1

Contains the meeting location as specified in a calendar state category instance derived from the calendar data of the presentity.

delimiter

0 or more

A beginning marker of a schema extension to this element.

[any]

0 or more

Schema extension

end

0 or 1

The ending marker of all the schema extensions to this element.

extension

0 or 1

Application-specific custom extension.

Parent Elements

Element

Description

None

This is a top-level element as a calendar state category instance value.

Text Value

None

Remarks

stateType is the base type of the calendarState. Use stateType as the serialization type to serialize or de-serialize a calendarState category instance.

Microsoft Lync 2010 does not allow remote subscribers to receive this type of state category instances explicitly.

Example

The following XML snippet shows a calendar state category instance value.

<state xmlns="https://schemas.microsoft.com/2006/09/sip/state" 
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" manual="false"   
           uri="kdeding@exchange.microsoft.com"
           startTime="2009-11-13T20:30:00Z" xsi:type="calendarState">
      <availability>6500</availability>
      <activity token="in-a-meeting" minAvailability="6500" maxAvailability="8999"></activity>
      <meetingSubject>A MeetNow meeting</meetingSubject>
      <meetingLocation>At your desk</meetingLocation>
</state>

The above presence state category instance value describes an ongoing meeting with the subject of "A MeetNow meeting" and at the location of "At your desk".

Element Information

Namespace

https://schemas.microsoft.com/2006/09/sip/state

Schema Name

state

Validation File

state.xsd, statetypes.xsd

Can be Empty

True

See Also

Other Resources

Presence State and state Category Instances