【MS-WOPI与移动端融合】：实现无缝文档体验的秘诀

3.2.6 Timer Events.............................................................................................. 28 3.2.7 Other Local Events...................................................................................... 28 3.3 WOPI Protocol Server Details............................................................................. 28 3.3.1 Abstract Data Model.................................................................................... 29 3.3.2 Timers ...................................................................................................... 29 3.3.3 Initialization............................................................................................... 29 3.3.4 Higher-Layer Triggered Events ..................................................................... 29 3.3.5 Message Processing Events and Sequencing Rules .......................................... 29 3.3.5.1 HTTP://server/<...>/wopi*/files/<id> ..................................................... 29 3.3.5.1.1 AddActivities................................................................................... 31 3.3.5.1.1.1 Request Body ............................................................................ 31 3.3.5.1.1.2 Response Body .......................................................................... 31 3.3.5.1.1.3 Processing Details...................................................................... 32 3.3.5.1.2 CheckFileInfo .................................................................................. 32 3.3.5.1.2.1 Request Body ............................................................................ 32 3.3.5.1.2.2 Response Body .......................................................................... 32 3.3.5.1.2.3 Processing Details...................................................................... 41 3.3.5.1.3 CheckPolicy .................................................................................... 41 3.3.5.1.3.1 Request Body ............................................................................ 41 3.3.5.1.3.2 Response Body .......................................................................... 41 3.3.5.1.3.3 Processing Details...................................................................... 42 3.3.5.1.4 CheckUserAccess............................................................................. 42 3.3.5.1.4.1 Request Body ............................................................................ 42 3.3.5.1.4.2 Response Body .......................................................................... 43 3.3.5.1.4.3 Processing Details...................................................................... 43 3.3.5.1.5 DeleteFile ....................................................................................... 43 3.3.5.1.5.1 Request Body ............................................................................ 44 3.3.5.1.5.2 Response Body .......................................................................... 44 3.3.5.1.5.3 Processing Details...................................................................... 44 3.3.5.1.6 ExecuteCellStorageRelativeRequest ................................................... 44 3.3.5.1.6.1 Request Body ............................................................................ 45 3.3.5.1.6.2 Response Body .......................................................................... 45 3.3.5.1.6.3 Processing Details...................................................................... 45 3.3.5.1.7 ExecuteCellStorageRequest .............................................................. 45 3.3.5.1.7.1 Request Body ............................................................................ 46 3.3.5.1.7.2 Response Body .......................................................................... 46 3.3.5.1.7.3 Processing Details...................................................................... 46 3.3.5.1.8 GetActivities ................................................................................... 46 3.3.5.1.8.1 Request Body ............................................................................ 46 3.3.5.1.8.2 Response Body .......................................................................... 47 3.3.5.1.8.3 Processing Details...................................................................... 47 3.3.5.1.9 GetFileUserValue ............................................................................. 47 3.3.5.1.9.1 Request Body ............................................................................ 48 3.3.5.1.9.2 Response Body .......................................................................... 48 3.3.5.1.9.3 Processing Details...................................................................... 48 **WOPI 协议概述** WOPI（Web Application Open Platform Interface）协议是微软制定的一种标准，用于连接在线协作编辑应用（如Office Online）与后端存储服务，实现文档的访问、编辑、同步等功能。该协议定义了服务器端（WOPI 服务器）与客户端（通常是Web应用程序）之间的接口规范，确保在不同平台上的无缝协作。 **主要概念** 1. **Timer Events**：定时事件是WOPI协议中的一种机制，允许客户端设定定时任务，如定期检查文件状态或执行某些操作，确保应用程序的实时性和响应性。 2. **Other Local Events**：其他本地事件指的是除了定时事件之外，由用户交互或应用程序内部触发的事件，这些事件可能会影响文件的状态或需要与服务器进行通信。 3. **Abstract Data Model**：抽象数据模型是WOPI协议中的核心概念，它定义了文件和其相关元数据在系统中的表示方式，为客户端和服务器间的通信提供统一的数据结构。 4. **Timers**：计时器是WOPI协议中的一个重要组件，它们负责管理和执行预设的任务，如自动保存、同步更新等。 5. **Initialization**：初始化过程是客户端与服务器建立连接的第一步，包括验证身份、获取文件信息等步骤，确保安全且有效的通信。 6. **Higher-Layer Triggered Events**：高层触发事件是用户操作或系统状态改变时触发的事件，如打开文件、保存文件、撤销操作等，这些事件需要服务器的参与和处理。 **消息处理与序列规则** 7. **Message Processing Events and Sequencing Rules**：消息处理事件和序列规则规定了客户端和服务器间消息的传递顺序和处理逻辑，确保请求的正确处理和响应的及时返回。 - `HTTP://server/<...>/wopi*/files/<id>`：这是WOPI协议的基本URL格式，用于访问特定ID的文件。其中，`<...>`表示可能的额外路径信息，`<id>`是文件的唯一标识。 - **AddActivities**：添加活动请求，用于记录用户的操作历史。请求体包含活动详情，响应体返回操作结果。 - **CheckFileInfo**：检查文件信息请求，获取文件的元数据，如文件大小、修改日期等。请求体通常为空，响应体包含文件信息。 - **CheckPolicy**：检查策略请求，验证当前用户是否有权访问或操作文件。请求体可能包含用户信息，响应体返回权限信息。 - **CheckUserAccess**：检查用户访问权限请求，确认用户对文件的访问级别。请求体可能包含用户信息，响应体返回访问权限级别。 - **DeleteFile**：删除文件请求，根据请求体的参数，服务器将删除指定的文件。响应体返回操作结果。 - **ExecuteCellStorageRelativeRequest** 和 **ExecuteCellStorageRequest**：执行单元格存储相对请求和绝对请求，主要用于处理像Excel这样的表格数据，允许客户端执行复杂的计算和数据操作。 - **GetActivities**：获取活动请求，用于获取文件的用户活动历史。请求体可能包含活动筛选条件，响应体返回活动列表。 - **GetFileUserValue**：获取文件用户值请求，用于获取特定用户与文件相关的自定义数据。请求体可能包含用户信息，响应体返回用户数据。 **知识产权声明** - 微软开放规格文档的知识产权声明指出，虽然文档受到微软的版权保护，但开发者可以自由复制、分发和使用文档中的技术来开发实现，并在实现文档中使用代码样本。 - 微软不主张这些文档中描述的技术涉及任何商业秘密，并且某些技术可能受微软的开放规格承诺或社区承诺的专利保护，提供了一定程度的专利许可保障。 WOPI协议为构建基于Web的协作应用提供了标准化的接口，通过详尽的事件处理和数据模型，确保了文件操作的高效和安全。开发者可以依据这些规范实现与微软Office Online或其他支持WOPI的应用的集成。