Operations on SharePoint Files
Applies to: SharePoint Workspace 2010 | Visual Studio 2008
SharePoint Files tools in Groove 2007 workspaces are similar to Files tools but the files in the tool are synchronized with a Microsoft SharePoint® document library. You can access the files in a SharePoint Files tool using the GrooveFilesBase64 service in the same way that you access the files in a Files tool. In addition, you can use the GrooveFilesBase64SetWSSProperties operation to set the initial configuration of the SharePoint tool.
Note
You cannot use Groove Web Services to access files in a SharePoint workspace.
The SetWSSProperties operation associates the tool with a SharePoint document library and specifies the identity of the user responsible for synchronizing the tool with the SharePoint document library.
Typically, a single application does the following:
Programmatically creates the workspace or adds the tool to an existing workspace.
Calls SetWSSProperties to associate the tool with a SharePoint document library and to specify the identity of the Groove user responsible for synchronizing the tool with the document library.
Invites the specified user to the workspace.
A Groove 2007 Data Bridge system cannot be the device that performs the synchronization; therefore, you should not set the synchronizer identity to be a Groove 2007 Data Bridge identity. If the call to SetWSSProperties is made on a Groove 2007 Data Bridge system and it specifies an identity on the Groove 2007 Data Bridge system as the synchronizer, the operation returns a SOAP exception.
The identity specified as the synchronizer does not need to be a member of the workspace when this operation is called. But, to start the synchronization, the identity needs to both be a member of the workspace and have access to the SharePoint Web site. Consequently, if the SetWSSProperties operation specifies an identity who is not currently a workspace member, there should be some procedure to ensure that the specified identity is invited to the workspace and accepts the invitation.
Note
You can perform all file operations on a SharePoint tool, whether or not the tool is configured. But if you add files to the tool before it is configured, workspace members will not be able to access the files until the tool is configured.
Note
The Files tool and the SharePoint Files tool typically have different ComponentURLs and different display names for the root folders.