GrooveMembers.EnterSpace Operation

Article
10/16/2013

The EnterSpace operation marks the current user as actively using the targeted space. This raises the priority of data changes received by the current user for this workspace, and it also informs other members of the workspace that the user is currently active in the workspace.

HTTP Post URL

The HTTP Post URL targets a GrooveMembers service for a workspace. This URI is provided by the GrooveSpaces.Read operation in the Members 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

None.

Output Message Header

GrooveResponseHeader specifies the Response key.

Return Value

None.

Remarks

Marking the current user as active in a workspace raises the priority of deltas (data changes) that are directed to that workspace. A member can be active in multiple workspaces at one time. A SOAP client can mark the current user as active in workspaces that are being actively displayed in the SOAP client user interface to reduce latency in these workspaces.

When the user stops viewing a workspace in the SOAP client, the SOAP client should call the ExitSpace operation for that workspace so that the other space members awareness is accurate and to reduce latency for workspaces actively being used by the user.

The current user is the user whose Identity URL is specified in the GrooveRequestHeader.