Dropbox模块

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

如果需要有关创建方案的说明,请参阅在 Adobe Workfront Fusion中创建方案。

有关模块的信息,请参阅 Adobe Workfront Fusion🔗中的模块。

访问要求

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

Adobe Workfront 计划*
Pro或更高版本
Adobe Workfront 许可证*
计划,工作
Adobe Workfront Fusion 许可证**

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

旧版许可证要求:Workfront Fusion for Work Automation and Integration

产品

当前产品要求:如果您有Select或Prime Adobe Workfront计划,则贵组织必须购买Adobe Workfront Fusion和Adobe Workfront才能使用本文中描述的功能。 Workfront Fusion包含在Ultimate Workfront计划中。

旧版产品要求:您的组织必须购买Adobe Workfront Fusion和Adobe Workfront,才能使用本文中介绍的功能。

要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。

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

先决条件

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

DropboxAPI信息

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 layout-auto html-authored no-header
    连接名称 输入此连接的名称。
    环境 选择此连接是用于生产环境还是非生产环境。
    类型 选择您是要连接到服务帐户还是个人帐户。
    客户端ID 输入您的Dropbox 客户端ID。
    客户端密钥 输入您的Dropbox 客户端密钥。
    帐户类型 选择您是要连接到个人Dropbox帐户还是企业(Dropbox企业)帐户。
  3. 单击​ 继续 ​保存连接并返回模块。## Dropbox模块及其字段

Dropbox模块及其字段

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

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

触发器模块

监视文件

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

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

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

搜索文件/文件夹

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

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

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
搜索
输入搜索词。
文件夹
选择要搜索的文件夹。 如果未选择文件夹,此模块将搜索整个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文档)不可下载。
文件夹
输入或映射要从中检索文件或文件夹的文件夹。
限制
输入或映射每个方案执行周期中您希望模块列出的最大记录数。

列出文件修订

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

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

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

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

文件路径

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

文件

从菜单中选择文件。

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

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

上载文件

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

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

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

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

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

输入或映射要添加到上面所选Dropbox文件夹的文件。

文件名

输入或映射文件名,包括文件扩展名。

文件数据

输入或映射文件数据(来自前一模块,如Google Drive >Get a File)。

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

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

创建文件夹

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

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

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

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

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

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

注意:

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

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

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

创建/覆盖文本文件

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

指定源文件和文件夹。

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

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

Connection
有关将Dropbox帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Dropbox的连接。
选择至
选择是要创建或覆盖DOC文件。
文件夹
选择要创建文件的目标位置。
Source File

输入或映射要添加到Dropbox文件夹的文件。

文件名

输入新DOC文件的文件名(不带扩展名)。

文件内容

输入DOC文件的文本内容。

创建/更新共享链接

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

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

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

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

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

文件路径

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

文件

从菜单中选择文件。

请求的可见性

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

注意: 仅团队和通过密码访问选项仅适用于具有Dropbox Pro或更高版本的用户。

链接的到期日期

输入链接到期且无法再访问的日期和时间。 如果此字段留空,链接将不会过期。 有关支持的日期和时间格式的列表,请参阅在Adobe Workfront Fusion中键入强制。

注意: Team only和Access with password选项仅适用于具有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的连接。
选择文件的方法
选择是要映射还是输入文件路径,或者手动选择文件。
文件路径 / 文件

文件路径

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

文件

从菜单中选择文件。

其他模块

进行API调用

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

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

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

输入相对路径。输入相对于https://api.dropboxapi.com的路径。 例如, /2/files/list_folder

注意:有关可用端点的列表,请参阅DropboxAPI v2文档

方法

选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅Adobe Workfront Fusion中的HTTP请求方法。

Headers
输入所需的请求标头。 Workfront Fusion自动添加授权标头。
查询字符串
输入请求查询字符串。
Body

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

注意:

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

INFO
示例: ​以下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=0

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

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

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43