Contact Complex Type

Applies to: SharePoint Workspace 2010 | Visual Studio 2008

The Contact type specifies information about a contact.

Syntax

<Contact>
  <URI/>
  <Name/> 
  <Awareness/>
  <TimeWentIdle/>
  <VCard/>
  <Type/>
</Contact>

Complex Type Elements

Element

Data type

Description

URI

xs:anyURI

The Identity URL for the contact.

The usage of this element depends on the context:

  • Read operation: value provided by operation.

  • Events: value provided by events.

Name

xs:string

The contact's name. This element is optional.

The usage of this element depends on the context:

  • Read operation: value provided by operation.

  • Events: value provided by events.

Awareness

xs:string

The contact's current online status. The string values returned in this element include "Offline" and "Online". You should compare the Awareness element's value ignoring any case differences because there may be variations of the letters that are lower- or upper-case in the returned strings, such as "Online" and "OnLine". This element is optional.

The usage of this element depends on the context:

  • Read operation: value provided by operation. Read returns a meaningful value for personal contacts if there is a subscription open to contact events. If there is no subscription, Read returns "Offline" for personal contacts. Read does not return a meaningful value for contacts other than personal contacts.

  • Events: value provided by events.

TimeWentIdle

xs:dateTime

The date-time when the contact last was online and actively using the SharePoint Workspace user interface. A user using a Web Services SOAP client and not the SharePoint Workspace user interface will be reported as idle. If the contact is offline or is not idle, this element is omitted.

The usage of this element depends on the context:

  • Read operation: value provided by operation if the contact is idle. Read returns a meaningful value for personal contacts if there is a subscription open to contact events. If there is no subscription, Read does not return TimeWentIdle. Read does not return TimeWentIdle for contacts other than personal contacts.

  • Events: value provided by events if the contact is idle.

VCard

xs:anyURI

The URI that provides the HTTP Post URL for the GrooveVCard Web Service for this contact.

The usage of this element depends on the context:

  • Read operation: value provided by operation.

  • Events: value provided by events.

Type

xs:string

String that specifies the kind of contact: "urn:groove.net:Core.PersonalContact" for the Contacts list and "urn:groove.net:Core.TelespaceMember" for contacts in the user's workspaces. This element is optional.

The usage of this element depends on the context:

  • Read operation: value provided by operation.

  • Events: value provided by events.

See Also

Reference

GrooveContacts Web Service