Processing Silent Invitations

Applies to: SharePoint Workspace 2010 | Visual Studio 2008

An application can send and reply to invitations to Groove 2007-compatible workspaces. By specifying that the user should not be alerted to the invitation, the application can minimize the possibility of the user responding directly to the invitation.

A Groove Web Services application can send and accept invitations to Groove 2007-compatible workspaces. The application must be running on both the system of the workspace member sending the application and on the system of the user receiving the invitation.

An application can send an invitation to a user in two ways:

  1. Create an invitation using the GrooveMembers.Create2 operation.

  2. Create an invitation file by using the GrooveSpaces.CreateInvitationFile2 operation. This file must then be sent to the user by using E-mail or another mechanism, and then the user must execute the file.

If the invitation is to be processed by the same or another application, the application creating the invitation should identify the application to process the invitation with the ApplicationURI parameter. It should also set the Silent parameter to true so that alerts are not displayed to the user.

An application can respond to an invitation using two methods:

  1. By reading or polling for invitations at set intervals by calling the GrooveMessages.ReadInvitations operation.

  2. By creating a subscription for invitation message events.

Polling for new invitations is simpler than creating a subscription, but creating a subscription can be a more reliable way to respond to invitations quickly.

Note

When you call ReadInvitations, SharePoint Workspace sends an internal message to the user who created the invitation. This allows SharePoint Workspace to report that the invited user has opened the invitation. If you open the same invitation multiple names, a new message is sent each time the message is opened. To avoid opening invitations multiple times, specify a false value in the ReadInvitationsReadAll parameter.

The GrooveMessages.AcceptInvitation operation accepts the invitation. This operation does not delete the invitation message. Your application should not delete the invitation until after the workspace has been completely delivered. After your application determines that the new workspace has been delivered, it can delete the invitation message with the GrooveMessages.Delete operation.

See Also

Concepts

Accessing Workspaces Exclusively Through Web Services