Export (0) Print
Expand All

3.1.1 Abstract Data Model

This protocol uses a sharing message, as defined in [MS-OXSHRMSG], to establish folder sharing. The GetSharingMetadata operation, as specified in section 3.1.4.4, gets the EncryptedSharedFolderDataType complex type elements, as specified in section 2.2.4.7, that are required to populate the SharingMessage element in the XML sharing message, as specified in [MS-OXSHRMSG] section 2.1.11.

This protocol requires two clients: a publishing client that is sharing information on behalf of a user, and a subscribing client that is accessing the shared information. To establish the relationship, the two clients perform the following actions.

Publisher actions:

  • Call the GetSharingMetadata operation to get an opaque authentication token that identifies the sharing invitation.

  • Construct a Sharing Message Attachment XML document, as specified in [MS-OXSHRMSG], from the response from the GetSharingMetadata operation. The EncryptedSharedFolderDataCollection element of the GetSharingMetaDataResponse element, as specified in section 3.1.4.4.2.2, is inserted into the Sharing Message Attachment XML document as the EncryptedSharedFolderDataCollection element of the ProviderType element, as specified in [MS-OXSHRMSG] section 2.1.8.

  • Use the GetFolder operation, as specified in [MS-OXWSFOLD] section 3.1.4.6, to get the permission list for the shared folder.

  • Use the UpdateFolder operation, as specified in [MS-OXWSFOLD] section 3.1.4.8, to add the new subscriber to the permission list.

  • Send the Sharing Message Attachment XML document to the subscriber as an attachment on an e-mail message. The attachment requires the following headers:

    • Content-Type: application/x-sharing-metadata-xml;

    • Content-Disposition: attachment; filename="sharing_metadata.xml"

Subscriber actions:

  • Call the CreateItem operation, as specified in [MS-OXWSCORE] section 3.1.4.2, with an AcceptSharingInvitationType element, as specified in [MS-OXWSCDATA] section 2.2.4.3.

  • Get the local sharing folder identifier by calling the GetSharingFolder operation, as specified in section 3.1.4.3. The local sharing folder is created by the previous call to the CreateItem operation.

Start synchronizing the local sharing folder on the server by calling the RefreshSharingFolder operation, as specified in section 3.1.4.5, with the local sharing folder identifier that is returned by the GetSharingFolder operation.

Show:
© 2015 Microsoft