GrooveSpaces.CreateFromGSAByRef2 Operation
The CreateFromGSAByRef2 operation creates a new 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 |
|
Specifies a file on the file system that contains the workspace template or archive, for example, "C:\temp\newspace.gsa". |
Passphrase |
|
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 |
|
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 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 Web Service
GrooveSpaces.Create Operation
GrooveSpaces.CreateFromGSA Operation
GrooveSpaces.CreateGrooveFileSharingSpace Operation
GrooveSpaces.ExportAsArchive Operation