Contact Complex Type

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 Groove 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 since 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 Groove user interface. A user using a Web Services SOAP client and not the Groove 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 Groove Contacts list and "urn:groove.net:Core.TelespaceMember" for contacts in your 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