GrooveSpaces.CreateFromGSA Operation
The CreateFromGSA operation creates a new workspace from a Groove workspace template or archive. The workspace template or archive is specified as a parameter.
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
<GSAContents />
<Name />
<Passphrase />
Element | Data type | Description |
---|---|---|
GSAContents |
|
Specifies the contents of the .gsa file containing the workspace template or archive. |
Name |
|
Specifies the name of the created workspace. |
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
<CreateFromGSAResult />
Element | Data type | Description |
---|---|---|
CreateFromGSAResult |
|
Provides a target URI for the ReadSpace operation for the newly created workspace. |
Remarks
A workspace template typically does not contain tool data in contrast with 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.
See Also
Reference
GrooveSpaces Web Service
GrooveSpaces.Create Operation
GrooveSpaces.CreateFromGSAByRef Operation
GrooveSpaces.CreateGrooveFileSharingSpace Operation