GrooveTools.Create 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 Create operation adds a tool to the workspace. You can add tools only to workspaces compatible with Groove 2007.
HTTP Post URL
The HTTP Post URL targets the GrooveTools service for a workspace. This URI is provided by the GrooveSpaces.Read operation in the Tools 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
<Tool />
Element |
Data type |
Description |
|---|---|---|
Tool |
Specifies the ComponentResourceURL of the tool template and the name of the tool. The ComponentResourceURL is provided by the ReadAvailableTools operation in the Template type. |
Output Message Header
GrooveResponseHeader specifies the Response key.
Return Value
<CreateResult />
Element |
Data type |
Description |
|---|---|---|
CreateResult |
xs:anyURI |
URI for the GrooveTools service that identifies the tool. For more information, see Remarks. |
Remarks
Note that the ReadAvailableTools operation returns the templates for all tools that are available for workspaces compatible with Groove 2007. You cannot add new tools to workspaces that are compatible with earlier versions of Groove. You can check the workspace template version returned in Space.Version by GrooveSpaces.Read before you add a tool to a workspace.
If the tool cannot be added to the workspace or if adding the tool to the workspace would require some members to upgrade their versions of Groove, the operation will fail and return a SOAP exception.
Although the Create operation returns a URI that could be used to call another GrooveTools operation, in some cases such a call would produce a SOAP exception. If you use the Create operation to add a tool to a workspace where the tool does not have a Groove Web Service associated with it, the URI returned by Create should not be used to call another operation, such as ReadTool, because the operation will fail.
See Also
Reference
GrooveTools.ReadAvailableTools Operation