GrooveSpaces.CreateFromGSAByRef 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 CreateFromGSAByRef operation creates a new workspace from a Groove workspace template or archive. 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

<URI /> 
<Name />
<Passphrase />

Element

Data type

Description

URI

xs:anyURI

Specifies a file on the file system that contains the workspace template or archive, for example, "C:\temp\newspace.gsa".

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

<CreateFromGSAByRefResult />

Element

Data type

Description

CreateFromGSAByRefResult

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.CreateFromGSA Operation

GrooveSpaces.CreateFromGSAByRef2 Operation

GrooveSpaces.CreateGrooveFileSharingSpace Operation

GrooveSpaces.ExportAsArchive Operation

Concepts

Creating Workspaces