跳到主要内容

CheckFileInfo

GET /wopi/files/(file_id)

必须为所有 WOPI 操作实施 CheckFileInfo 操作。此操作返回有关文件的信息、用户对该文件的权限以及有关 WOPI 主机对该文件所具有的功能的一般信息。此外,某些 CheckFileInfo 属性可能会影响 WOPI 客户端的外观和行为。

参数

名称类型描述
file_idstringID of a file 必须是 URL 安全的文件 ID。

查询参数

名称类型描述
access_tokenstring访问令牌主机将用它来确定请求是否被授权。

请求标头

名称类型是否必填描述
X-WOPI-SessionContextstring可选的会话上下文(如果在初始 WOPI 操作 URL 上提供)。

必需的响应属性

请注意,任何响应字符串值的默认值都是空字符串。

名称类型示例描述
BaseFileNamestring"Example File Name.docx"不带路径的文件名,显示在用户界面 (UI) 中并确定文件扩展名。
Versionstring"Khirz6zTPdfd7"基于服务器文件版本架构的文件的当前版本。每次编辑和保存文档时,都必须更改版本。给定文件的版本号不得重复。

面包屑导航属性

名称类型示例描述
BreadcrumbBrandNamestring"Example Brand Name"主机的品牌名称。
BreadcrumbBrandUrlstringhttps://example.com/url-to-breadcrumb-brand-page.com当用户单击显示 BreadcrumbBrandName 的 UI 时,WOPI 客户端导航到的网页的 URL。
BreadcrumbDocNamestring"Example Breadcrumb File Name.docx"WOPI 客户端向用户显示的文件名。如果未指定此参数,则使用 BaseFileName 参数。
BreadcrumbFolderNamestring"Example Folder Name"包含文件的容器的名称。
BreadcrumbFolderUrlstringhttps://example.com/url-to-breadcrumb-brand-folder当用户单击显示 BreadcrumbFolderName 的 UI 时,WOPI 客户端导航到的网页的 URL。

PostMessage 属性

名称类型示例描述
ClosePostMessagebooleantrue指定主机是否希望在在线办公软件中的 Close UI 激活时接收 UI_Close PostMessage。
EditModePostMessagebooleantrue指定主机是否希望在在线办公软件中的 Edit UI 激活时接收 UI_Edit PostMessage。如果此属性未设置为 true,则在线办公软件会在 Edit UI 激活时将内部 iframe URL 导航到编辑操作 URL。
EditNotificationPostMessagebooleantrue指定主机是否希望接收 Edit_Notification PostMessage。
FileSharingPostMessagebooleantrue指定当在线办公软件中的 Share UI 激活时,主机是否期望接收 UI_Sharing PostMessage。
FileVersionPostMessagebooleantrue指定当在线办公软件中的 Previous Versions UI 激活时,主机是否期望接收 UI_FileVersions PostMessage。
PostMessageOriginstringhttps://exampledomain.comhost page 正在向其发送和接收 PostMessage 的域。在线办公软件仅向此域发送传出的 PostMessage,并且仅监听来自此域的 PostMessage。

文件 URL 属性

名称类型示例描述
CloseUrlstringhttps://example.com/url-to-close-page.com当应用程序关闭或发生不可恢复的错误时,WOPI 客户端应导航到的网页的 URI。
FileSharingUrlstringhttps://example.com/url-to-sharing-page.com允许用户共享文件的位置的 URI。
FileVersionUrlstringhttps://example.com/url-to-previous-version-page.com指向允许用户查看文件版本历史记录的位置的 URI。
HostEditUrlstringhttps://example.com/url-to-host-page.com指向加载编辑 WOPI 操作的主机页面的 URI。

其他杂项属性

名称类型示例描述
CopyPasteRestrictionsstring"BlockAll"指定 WOPI 客户端是否应禁用应用程序内的复制和粘贴功能。默认情况下,所有复制和粘贴功能均已启用,即该设置无效。可能的属性值:

- BlockAll - 应用程序中的复制和粘贴功能完全禁用;

- CurrentDocumentOnly - 复制和粘贴功能已启用,但只能在应用程序中当前打开的文件中复制和粘贴内容。
DisablePrintbooleantrue指定 WOPI 客户端是否应禁用所有打印功能。
FileExtensionstring".docx"文件扩展名必须以“。”开头。如果提供,WOPI 客户端将使用此值作为文件扩展名。否则,将从 BaseFileName 解析扩展名。
FileNameMaxLengthinteger20WOPI 主机支持的文件名的最大长度,不包括文件扩展名。默认值为 250。请注意,如果省略该属性或将其明确设置为 0,WOPI 客户端将使用此默认值。
LastModifiedTimestring"2009-06-15T13:45:30.0000000Z"上次修改文件的时间。此时间必须始终为 UTC 时间,并且必须采用 ISO 8601 往返格式。此属性可以指定为 Version 属性的替代。

用户元数据属性

名称类型示例描述
IsAnonymousUserbooleantrue指定用户是否通过主机进行身份验证。对于未经身份验证的用户,主机应始终将其设置为 true,以便客户端知道用户是匿名用户。
UserFriendlyNamestring"John Smith"用户的名称,适合在 UI 中显示。
UserIdstring"uid-1"唯一标识当前访问文件的用户的值。

用户权限属性

名称类型示例描述
ReadOnlybooleantrue指定当前用户是否无法更改文件。
UserCanNotWriteRelativebooleanfalse指定用户是否具有在 WOPI 服务器上创建新文件的足够权限。true 值表示此用户在当前文件上执行 PutRelativeFile 将失败。默认情况下,此参数为 false,并执行 PutRelativeFile 操作。
UserCanRenamebooleantrue指定用户是否有权重命名当前文件。
UserCanReviewbooleantrue指定用户是否有权查看当前文件。
UserCanWritebooleantrue指定用户是否有权更改文件。

WOPI 主机功能属性

名称类型示例描述
SupportsLocksbooleantrue指定主机是否支持 LockUnlockRefreshLock 操作。
SupportsRenamebooleantrue指定 WOPI 服务器是否支持重命名权限。
SupportsReviewingbooleantrue指定主机是否支持查看权限。
SupportsUpdatebooleantrue指定主机是否支持 PutFilePutRelativeFile 操作。

Nextcloud/Collabora/Seafile properties

名称类型示例描述
EnableInsertRemoteImagebooleantrue指定是否启用调用 UI_InsertGraphic 消息的菜单项和工具栏项。此属性用于显示用户界面元素(例如,对话框),允许用户从集成中选择图像。该集成应该提供一个可下载一次的临时 URL,并通过 Action_InsertGraphic 消息将其返回,并将 Values 设置为临时 URL。
HidePrintOptionbooleanfalse指定 WOPI 服务器是否隐藏 UI 中文件菜单栏的打印选项。