Share via


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

xs:base64Binary

Specifies the contents of the .gsa file containing the workspace template or archive.

Name

xs:string

Specifies the name of the created workspace.

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

<CreateFromGSAResult />
Element Data type Description

CreateFromGSAResult

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 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

Concepts

Creating Workspaces