GrooveSpaces.Read2 Operation
Applies to: SharePoint Workspace 2010 | Visual Studio 2008
In this article
HTTP Post URL
Input Message Header
Input Message Parameters
Output Message Header
Return Value
The Read2 operation reads the Groove 2007-compatible workspaces for the identity. 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. This operation does not return any information about SharePoint workspaces. The Read2 operation returns the Space2 complex type, which provides access to advanced features not available through the Space complex type returned by the Read operation. These features include workspace visibility, alert level, download options, member awareness visibility, and Groove File Sharing folder path information.
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
<Read2Result>
<!-- Array of --> <Space2 />
</Read2Result>
Element |
Data type |
Description |
|---|---|---|
Read2Result |
Array of Space2 |
Describes the workspace. The Read2Result array can contain zero or more Space2 elements. |
Remarks
If you are reading 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.
The Read2 operation returns information about both visible and invisible workspaces. In contrast, the Read operation returns information only about visible workspaces.
Note
This operation is available only on systems where Groove Web Services Version 2.1 is available. See Testing for Groove Web Services Version 2.1 for more information.
See Also
Reference
GrooveSpaces.ReadSpace Operation
GrooveSpaces.ReadSpace2 Operation