Sdk::OpenCloudFile

场景描述

打开云端文件函数，由工业软件调用。调用此函数后，ISCDesk客户端会打开云端文件系统。工程师在云端文件系统中选择需要打开的云端文件后，触发“EVENT_OPENCLOUDFILE_RESULT”打开云端文件事件，将云端文件相关信息连同事件一起告知工业软件，工业软件可根据此事件进行打开文件操作。

如果工程师选择的不是“.zip”格式的文件（以下统称为“单文件”），SDK会将单文件绝对路径回传至工业软件；如果工程师选择的是“.zip”格式的文件（以“天工CAD2023”软件为参照，以下统称为“装配体压缩包文件”），ISCDesk会将装配体压缩包文件解压并由SDK将解压后的文件夹（以下统称为“装配体文件夹”）的绝对路径回传至工业软件。

以打开一个检入状态的单文件为例，云端文件信息如下：

{"operate":"OpenFile","params":{"mainFile":"路径\\xxx3.txt","openType":"OpenOnly","workState":"CHECKIN","assembly":"false"},"comeBackParams":{}}

各字段说明如下：

• “mainFile”：表示文件路径；
• “openType”：表示文件打开方式，包含“打开（OpenOnly）”和“打开并检出（OpenAndCheckout）”两种打开方式；
• “workState”：表示文件的状态，包含“检入（CHECKIN）”和“已检出（CHECKOUT）”两种状态；
• “assembly”：表示文件类型，“true”代表当前文件为装配体，“false”代表当前文件为单文件。

1. 当“assembly”字段值为“false”时，“mainFile”字段表示的路径为单文件的绝对路径；当“assembly”字段值为“true”时，“mainFile”字段表示的路径为装配体文件夹的绝对路径，工业软件需要根据“mainFile”字段找到装配体文件夹，并在文件夹下自行查找与文件夹同名的文件（以下统称为“装配体文件”）进行打开操作。
2. 打云端文件时，如果文件状态为“检入”状态，且打开云端文件的方式仅为“打开”时，不支持保存文件至云端。

涉及接口

Sdk::OpenCloudFile

调用示例

invoker->OpenCloudFile();