1   上传文件

view.native.upload_files(folder_uid, local_files)

参数：

• folder_uid: 文件夹的 uid
• local_files: 要上传的文件的本地路径列表

2   下载文件

view.native.download_files(uids, local_folder)

参数：

• uids: 要下载的项的 uid 列表
• local_folder: 要下载到的本地目录路径

3   文件夹同步

view.native.sync(root_uid, local_folder, folder_uid=None, mode='sync')

参数：

• root_uid: 同步区的根目录 uid
• local_folder: 本地目录路径
• folder_uid: 可选，如果是单独同步同步区内的子目录，这个子目录对应的 uid
• mode: 必选，同步模式，可选值如下：
  • sync: 双向同步
  • pull: 向下同步
  • push: 向上同步

4   预览文件

view.native.view(uid, allow_cache=True)

参数:

• uid: 文件 uid
• allow_cache=True: 是否允许缓存文件

5   启动外部编辑

view.native.edit(uid, allow_cache=True)

参数:

• uid: 文件 uid
• allow_cache=True: 是否允许缓存文件

6   将文件夹映射为本地盘符

view.native.new_webfolder(folder, folder_name=None)

参数:

• folder: 文件夹对象
• folder_name: 可选，指定映射盘的名字。不指定则使用文件夹的名字。

7   下载水印 PDF

view.native.downloadpdf(uids, watermark_text='', select_dir=False, fallback_url=None)

参数:

• uids: 文件 uid 列表
• watermark_text: 可选，水印文本，没有指定则是使用站点默认的水印
• select_dir=False: 是否允许存放到自定义位置
• fallback_url=None: 用户没有安装桌面助手时，可以直接从这个地址下载

8   给 PDF 加水印

view.native.watermarkpdf(url, watermark_text, filename=None)

参数:

• url: PDF 文件的直接下载地址
• watermark_text: 水印文字
• filename=None: 可选，指定文件保存的名字

9   局域网加速下载

view.native.p2pdownload(uids, revisions, fallback_url=None)

参数:

• uids: 文件 uid 列表
• revisions: 对应 uids 参数，其中每个文件需要下载的版本
• fallback_url=None: 用户没有安装桌面助手时，通过这个链接下载

10   运行脚本

在桌面运行任意指定站点脚本，需要用户信任此站点。

view.native.call_script(script_name, args=None, kw=None)

参数:

• script_name: 脚本的名字
• args: 可选，脚本的位置参数，是一个 list
• kw: 可选，脚本的关键字参数，是一个 dict

11   同步运行脚本

用于在当前访问页面机器的桌面助手中，同步地运行一个脚本，并接收返回值。

示例:

view.native.call_script_sync(
    'zopen.x:math',
    1, 2, 3,
    operation='sum',
    onsuccess='zopen.x:receive_result'
)

zopen.x:math:

def math(*args, operation='sum'):
    if operation == 'sum':
        return sum(args)

通过指定 onsuccess 参数，运行的结果将通过浏览器被直接发送到这个脚本。在此例中， zopen.x:receive_result 将会收到一个请求，携带有两个参数，分别是:

success=true
result=6