Dropbox模块

在Adobe Workfront Fusion方案中,您可以自动执行使用Dropbox或Dropbox Business的工作流,还可以将其连接到多个第三方应用程序和服务。这样,您就可以自动执行Dropbox中的文件和文件夹等活动。

有关创建方案的说明,请参阅创建方案:文章索引下的文章。

有关模块的信息,请参阅模块:文章索引下的文章。

访问要求

展开以查看本文中各项功能的访问要求。

您必须具有以下权限才能使用本文中的功能:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront包 任何
Adobe Workfront许可证

新增:标准

当前:工作或更高

Adobe Workfront Fusion许可证**

当前:无Workfront Fusion许可证要求。

旧版:Workfront Fusion for Work Automation and Integration

产品

新增:

  • 选择或Prime Workfront包:您的组织必须购买Adobe Workfront Fusion。
  • Ultimate Workfront包:其中包含Workfront Fusion。

当前:您的组织必须购买Adobe Workfront Fusion。

有关此表中信息的更多详细信息,请参阅文档🔗中的访问要求。

有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion 许可证

先决条件

  • 要使用Dropbox模块,您必须具有Dropbox帐户。
IMPORTANT
Dropbox必须批准用户数超过50的应用程序。
有关更多信息,请在Dropbox开发人员指南中搜索“生产批准”。

Dropbox API信息

Dropbox连接器使用以下对象:

基本URL
https://api.dropboxapi.com/2
API版本
2
API标记
  • Dropbox

    v5.3.9

  • Dropbox业务

    v1.0.12

创建与Dropbox的连接

要为您的Dropbox模块创建连接:

  1. 在任意模块中,单击“连接”框旁边的​ 添加

  2. 填写以下字段:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    连接名称 输入此连接的名称。
    环境 选择此连接是用于生产环境还是非生产环境。
    类型 选择您是要连接到服务帐户还是个人帐户。
    客户端ID 输入您的Dropbox 客户端ID。
    客户端密钥 输入您的Dropbox 客户端密钥。
    帐户类型 选择您是连接到个人Dropbox帐户还是企业(Dropbox Business)帐户。
    排除dropbox-api-path-root标头 启用此选项以排除具有应用程序文件夹访问权限的Dropbox应用程序的dropbox-api-path-root标头
  3. 单击​ 继续 ​保存连接并返回模块。## Dropbox模块及其字段

Dropbox模块及其字段

配置Dropbox模块时,Workfront Fusion显示下面列出的字段。 除此以外,可能还会显示其他Dropbox字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅将信息从一个模块映射到另一个模块

映射切换

触发器模块

监视文件

修改指定文件夹中的文件时,此触发器类型模块会返回文件详细信息。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
文件夹
选择要监视更改的文件夹。
Watch also subfolders
启用此选项还可以监视所选文件夹中用于修改文件的子文件夹。
限制
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

用于获取Dropbox文件和文件夹的模块

下载文件

此操作模块从文件夹下载文件。

指定文件及其位置。

模块会返回文件的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

NOTE
此模块在向后续模块提供文件时非常有用。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
选择文件的方法
选择是要映射文件路径还是手动选择文件。
文件路径/文件

文件路径

输入或映射目标路径到文件。

文件

从菜单中选择文件。

获取文件夹元数据

此操作模块可检索共享文件夹的详细信息。

指定文件夹的ID。

该模块会返回文件夹ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
共享文件夹ID
输入或映射要检索其详细信息的文件夹的ID。

列出文件夹中的所有文件/子文件夹

此操作模块列出特定文件夹中的文件或文件夹。

指定文件夹的ID。

该模块返回文件或文件夹的ID以及任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
列表
选择是要检索文件或文件夹。
仅显示可下载的文件
启用此选项可仅返回可下载的文件。 某些类型的文件(如Google Docs)不可下载。
文件夹
输入或映射要从中检索文件或文件夹的文件夹。
限制
输入或映射每个方案执行周期中您希望模块列出的最大记录数。

列出文件修订

此操作模块可检索特定文件的所有文件修订版本(版本历史记录)。
指定文件的ID。

该模块会返回与记录关联的任何标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
选择文件的方法
选择是要映射文件路径还是手动选择文件。
文件路径/文件

文件路径

输入或映射目标路径到文件。

文件

从菜单中选择文件。

限制
输入或映射每个方案执行周期中您希望模块列出的最大记录数。

搜索文件/文件夹

此搜索模块在Dropbox中查找与您指定的搜索查询匹配的对象中的记录。

您可以在场景的后续模块中映射此信息。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
搜索
输入搜索词。
文件夹
选择要搜索的文件夹。 如果未选择文件夹,此模块将搜索整个Dropbox帐户。
文件状态
选择要包含在搜索中的文件状态。
文件类别
选择要包含在搜索中的文件类别。
文件扩展名
对于要包含在搜索中的每个文件扩展名,单击 添加项 并输入或映射文件扩展名。
限制
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

用于创建和编辑Dropbox文件和文件夹的模块

创建文件夹

此操作模块将创建新文件夹。

指定文件夹的路径和名称。

该模块会返回文件夹ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
文件夹名称
输入新文件夹的名称。
文件夹

输入或映射要创建新文件夹的路径。

注意:

如果您使用Dropbox Business帐户(包含团队空间),则必须删除斜杠/,或者不要单击 单击此处选择文件夹 以在根目录中创建团队文件夹。

如果未删除斜杠,则会返回错误[409] path/malformed_path/..

自动重命名
启用此选项可重命名新文件夹(如果目标位置中已存在同名文件夹)。

创建/覆盖文本文件

此操作模块创建DOC文件,或覆盖现有文件的内容。

指定源文件和文件夹。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
选择至

选择是要创建或覆盖DOC文件。

  • 创建 选择要创建文件的文件夹。

  • 覆盖

    选择要如何选择要覆盖的文件,然后映射文件路径或选择文件。

Source File

从上一个模块中选择源文件,或映射源文件的内容。

如果要创建文件,请选择

创建/更新共享链接

此操作模块创建指向文件的公共链接。

指定文件以及有关链接的信息。

模块会返回链接的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
选择文件的方法
选择是要映射还是输入文件路径,或者手动选择文件。
文件路径/文件

文件路径

输入或映射目标文件的路径。

文件

选择目标文件。

请求的可见性

选择链接是公共链接、团队链接还是密码受限链接。

注意:

团队仅适用于Dropbox商业帐户。 密码访问仅适用于Dropbox Pro或Dropbox商业帐户。

链接的到期日期
输入链接到期且无法再访问的日期和时间。 如果此字段留空,链接将不会过期。 有关支持的日期和时间格式的列表,请参阅类型强制
Link的访问级别

设置链接收件人的权限。

  • 查看器

    使用该链接的用户可以查看和评论内容。

  • 编辑器

    使用该链接的用户可以编辑、查看和评论内容。 此访问级别仅适用于基于云的文档。

  • Max

    使用该链接的用户将获得您可以设置该链接的最大访问级别。

删除文件/文件夹

此操作模块删除文件或文件夹。

指定文件或文件夹。

该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
选择文件的方法
选择是要映射还是输入文件路径,或者手动选择文件。
文件或文件夹路径 / 文件或文件夹

文件/文件夹路径

输入目标路径或将目标路径映射到文件或文件夹。

文件/文件夹

从菜单中选择文件或文件夹。

移动文件/文件夹

此操作模块会将文件或文件夹移动到其他位置。

您可以指定文件或文件夹,以及移动它的方法和位置。

该模块会返回文件或文件夹的ID以及任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
选择文件/文件夹的方法
选择是要映射还是输入文件或文件夹路径,或者手动选择文件或文件夹。
文件/文件夹路径 /

文件/文件夹路径

输入目标路径或将目标路径映射到文件或文件夹。

文件/文件夹

选择是要移动文件或文件夹,然后选择文件或文件夹。

到文件夹
输入或映射文件或文件夹的目标位置。
新名称
在新位置输入文件或文件夹的新名称。
自动重命名
启用此选项以确保如果存在同名的文件或文件夹,模块会重命名新的文件或文件夹,方法是在文件或文件夹名称后添加(NUMBER)。 否则,将覆盖目标位置中的文件或文件夹。
允许所有权转让
启用此选项可允许所有者移动,即使这会导致所移动内容的所有权转移。

重命名文件/文件夹

此操作模块将重命名文件或文件夹。

指定文件或文件夹以及新名称。

该模块会返回文件或文件夹的ID以及任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
选择文件的方法
选择是要映射还是输入文件路径,或者手动选择文件。
文件/文件夹路径/文件/文件夹

文件/文件夹路径

输入目标路径或将目标路径映射到文件或文件夹。

文件/文件夹

选择是要移动文件或文件夹,然后选择文件或文件夹。

重命名
输入文件的新名称,包括文件扩展名。

还原文件

此操作模块恢复文件的先前版本。

指定所需的文件和修订版本号。

模块会返回版本ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
选择文件的方法
选择是要映射还是输入文件路径,或者手动选择文件。
文件路径 / 文件

文件路径

输入或映射目标路径到文件。

文件

从菜单中选择文件。

修订版
输入或映射要恢复的修订版本的修订号。

上载文件

此操作模块将文件上传到文件夹。

您可以指定信息,例如文件的位置、要上传的文件以及文件的可选新名称。

模块会返回文件的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
文件夹
选择要将文件上传到的Dropbox的文件夹。
Source File

从上一个模块中选择源文件,或映射源文件的名称和数据。

注意:

上传文件的最大大小为150 MB。

覆盖现有文件
启用此选项可使用新文件替换现有文件。 如果将此选项保留为禁用,则将重命名上传的文件。

其他模块

进行API调用

此操作模块允许您对Dropbox API进行经过身份验证的自定义调用。 这样,您可以创建其他Dropbox模块无法实现的数据流自动化。

配置此模块时,会显示以下字段。

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
URL
输入相对路径。输入相对于https://api.dropboxapi.com的路径。 例如, /2/files/list_folder
方法
选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅HTTP请求方法
Headers
输入所需的请求标头。 Workfront Fusion自动添加授权标头。
查询字符串
输入请求查询字符串。
Body

以标准JSON对象的形式添加API调用的正文内容。

注意:

在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

recommendation-more-help

示例:

以下API调用从Dropbox帐户的/Text files文件夹中返回前10个文件:

URL: /2/files/list_folder

正文:

{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}

在包 > 正文 >条目下的模块输出中可以找到搜索匹配项。

在本例中,我们返回了10张票证。

常见问题

无法上传或更新文件

以下可能是上传或更新文件失败的原因:

  • 上传的文件太大,超过了您的Dropbox计划允许的最大文件大小,或者您已使用所有Dropbox帐户的存储配额。 您必须从Dropbox帐户中删除现有文件或升级计划。
  • 先前选择的文件夹(文件将上载到该文件夹)不再存在。 场景将停止,您必须再次选择目标文件夹。

无法呈现通过共享链接引用的图像

Dropbox >创建共享链接返回的URL未直接链接到图像,而是链接到Dropbox页面。 要强制下载图像,请将尾部?dl=0替换为?dl=1。 要强制呈现图像(例如,在Web浏览器或Facebook Messenger中),请将&raw=1附加到URL。

如果需要获取您网站或其他Workfront Fusion模块的图像的直接或原始链接,则必须通过以下方式修改初始共享URL:

原始URL:

https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0

  1. www替换为dl
  2. 删除?dl=0

最终URL:

https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png

要自动修改URL,您可以使用replace()函数两次:

  • 将www替换为dl

    用dl 替换www

  • 要删除?dl=0

    删除DL

要一次性完成此操作,请组合以下函数:

替换两者

您也可以复制该模板并将其粘贴到字段中。 将1.url替换为URL。

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3