1.3.2.1 Document Sharing Role Assignments

Protocol clients can find out who is currently sharing a document and then assign new users to share or update existing users’ sharing roles. A common usage of the protocol’s methods is as follows:

1. The protocol client requests protocol versions supported by the protocol server.

2. The protocol server responds with a set of supported protocol versions.

3. The protocol client asks the protocol server for a summary of all sharing capabilities that are provided by the server.

4. The protocol server responds with a collection of information about the server’s sharing capabilities.

5. The protocol client asks the protocol server for detailed information about a particular document.

6. The protocol server responds with detailed information about the document’s sharing attributes.

7. The protocol client asks the protocol server for detailed information about all users who currently have permissions to access the document.

8. The protocol server responds with detailed information about all users who currently have access to the document.

9. The protocol client sends a request to the protocol server to grant new users a sharing role or update existing users’ role.

10. The protocol server responds with information about any user who fails to be granted new roles or whose existing role fails to be updated.

The following diagram shows the exchange.

Figure 1: Path of information about document sharing role assignments.