GrooveSpaces.CreateFromGSAByRef2 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 CreateFromGSAByRef2 operation creates a new Groove 2007-compatible workspace from a Groove workspace template or archive, with advanced options not available with the CreateFromGSA operation. These options include workspace visibility, alert level, download options, member awareness visibility, and Groove File Sharing folder path information. The workspace template or archive is specified as a reference to a local file.
HTTP Post URL
The HTTP Post URL targets the service for the identity; this URL 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
<Space2 />
<URI />
<Passphrase />
Element |
Data type |
Description |
---|---|---|
Space2 |
Specifies the name, description, visibility, download settings, awareness settings, and unread alert settings of the created workspace. |
|
URI |
xs:anyURI |
Specifies a file on the file system that contains the workspace template or archive, for example, "C:\temp\newspace.gsa". |
Passphrase |
xs:string |
Must specify the pass phrase that was used when the GSA file was created. If this parameter is an empty string, the operation attempts to open the GSA file without a password. |
Output Message Header
GrooveResponseHeader specifies the Response key.
Return Value
<CreateFromGSAByRef2Result />
Element |
Data type |
Description |
---|---|---|
CreateFromGSAByRef2Result |
xs:anyURI |
Provides a target URI for the ReadSpace operation for the newly created workspace. |
Remarks
A workspace template typically does not contain tool data. This differs from a workspace archive, which typically does contain tool data. Note that the Forms tool internal data that defines the design of the Forms tool is always included in both workspace templates and archives.
Note
This operation is available only for templates and archives of Groove 2007-compatible workspaces. If the URI element specifies a template or archive for a 2010 workspace, the operation returns a SOAP exception. This operation is only available 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.CreateFromGSA Operation
GrooveSpaces.CreateGrooveFileSharingSpace Operation
GrooveSpaces.ExportAsArchive Operation