GrooveSpaces.Read Operation

The Read operation reads the visible workspaces for the Groove identity. (See Accessing Workspaces Exclusively Through Web Services for information on visible and invisible workspaces.) If you specify a workspace type, the operation returns only workspaces of that type. If you do not specify a type, the operation returns information about all workspaces except for Groove File Sharing workspaces. To access both visible and invisible workspaces, use the Read2 operation.

HTTP Post URL

The HTTP Post URL targets the service for the identity. This URI is provided by the GrooveAccounts.Read2 operation in the Identity.Spaces element.

Input Message Header

GrooveRequestHeader specifies information common to all Groove Web Services, including the Groove Identity URL and the Groove Request key.

Input Message Parameters

<SpaceType />
Element Data type Description

SpaceType

xs:string

URN that specifies the workspace type. If you specify an empty string, the operation reads the generic Groove workspaces.

SpaceType URN values Description

urn:groove.net:Groove.Core.Tools.System.TelespaceTypes.Generic

Generic Groove workspace; this is the default value.

urn:groove.net:Groove.Core.Tools.System.TelespaceTypes.GFS

Groove File Sharing workspace.

Output Message Header

GrooveResponseHeader specifies the Response key.

Return Value

<ReadResult>
  <!-- Array of --> <Space />
</ReadResult>
Element Data type Description

ReadResult

Array of Space

Describes the workspace. The ReadResult array can contain zero or more Space elements.

Remarks

Note that if you are getting information about Groove File Sharing workspaces, the return value contains an empty string for the Tools element. You cannot access the GrooveTools service or a GrooveFiles service in a Groove File Sharing workspace.

See Also

Reference

GrooveSpaces Web Service
GrooveSpaces.ReadSpace Operation

Concepts

Reading Workspaces