GrooveLocal Web Service

Article
01/20/2015

Applies to: SharePoint Workspace 2010 | Visual Studio 2008

The GrooveLocal service provides a mechanism for a Groove Web Services application to open a specific window of the SharePoint Workspace user interface so that the local user can view information or perform some action. In addition, it provides operations to open files stored in the Groove Files tool and to send an invitation alert to a workspace member.

XML Definitions

WSDL

GrooveLocal.wsdl 2.0

with references to:

Core.xsd 2.0
Local.xsd 2.0

SOAP Operation Namespace

http://webservices.groove.net/Groove/2.0/Local/

HTTP Post URL

http://localhost:port-number/GWS/Groove/2.0/ Local/service-specific-data

Operations, Complex Types, and Events

The following sections describe the GrooveLocal operations.

Operations

Operation	Description
LaunchFile	Opens a file stored in a Groove Files tool. The file is opened by its related application.
OpenAboutGroove	Opens a window with an informational message about SharePoint Workspace.
OpenAccountSetupWizard	Opens a window with the account configuration wizard.
OpenAddContact	Opens a window that provides the user the ability to add a new personal contact.
OpenCommunicationsManager	Opens a window with the account Communications Manager.
OpenContactProperties	Opens a window with the contact information for the specified contact.
OpenCreateSpaceWizard	Opens a window with that provides the user the ability to interactively create a new workspace.
OpenLaunchbar	Opens a window with the SharePoint Workspace Launchbar that provides the user the ability to view the available workspaces.
OpenLicenses	Opens the About SharePoint Workspace window, which provides access to the Microsoft Office license agreement.
OpenMessageHistory	Opens a window with the account message history.
OpenPreferences	Opens a window with the account preferences.
OpenSpaceProperties	Opens a window with the workspace properties.
OpenToolProperties	Opens a window with the tool properties.
OpenVCardEditor	Opens a window provides the user the ability to edit the user's own identity information.
SendInstantMessage	Opens a window to send a message to the specified identity.
SendInvitation	Opens a window to invite a user to the specified workspace.
SendInvitationAlert	Sends a message that requests a workspace member to go to the workspace.
SendInvitationToChat	This operation is obsolete. Calling this operation has no effect.
SetAlertLevel	Enables or suppresses alerts for all accounts on the device.
View	Opens a window that provides access to the specified workspace, tool, or Forms tool record in the SharePoint Workspace user interface.

Complex Types

Complex type	Description
DeviceAlertLevelType	Enumerated type that specifies whether alerts should be enabled or suppressed for all accounts on the device.

Remarks

When a GrooveLocal operation opens a window, it is displayed to the user and controlled by the user. The GrooveLocal operation returns immediately after opening the window and does not wait for the user to dismiss the window. The Groove Web Services application has no mechanism to dismiss the window; the window can only be dismissed by the user.

In order for the SharePoint Workspace process to set a window to the foreground while the Groove Web Services application is running, the application must grant the SharePoint Workspace process permission to do this with the Microsoft Windows® AllowSetForegroundWindow() function.

Typically, a Groove Web Services application opens a SharePoint Workspace user interface window in response to an action by the user. For example, the user may click in the application window.

Share via