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 Workflow 包以及任意 Adobe Workfront 自动化和集成包 Workfront Ultimate Workfront Prime 和 Select 包，且需额外购买 Workfront Fusion。 |
| Adobe Workfront 许可证 |
标准 工作版或更高版本 |
| Adobe Workfront Fusion 许可证 |
基于操作：不需要 Workfront Fusion 许可证 基于连接器（旧版）：Workfront Fusion for Work Automation and Integration |
| 产品 | 如果您的组织使用的 Workfront Select 或 Prime 包不包含 Workfront 自动化和集成，则必须单独购买 Adobe Workfront Fusion。 |
有关此表中信息的更多详细说明，请参阅文档中的访问权限要求。
有关 Adobe Workfront Fusion 许可证的详细信息，请参阅 Adobe Workfront Fusion 许可证。
先决条件
- 要使用 Dropbox 模块，您必须拥有一个 Dropbox 帐户。
- 要使用Dropbox连接器，您必须首先在Dropbox中创建应用程序。
有关更多信息，请在Dropbox开发人员指南中搜索“创建应用程序”。 - 创建应用程序时，请使用以下重定向URI：
https://app.workfrontfusion.com/oauth/cb/dropbox - Dropbox必须批准用户数超过50的应用程序。
有关更多信息，请在Dropbox开发人员指南中搜索“生产批准”。
Dropbox API信息
Dropbox连接器使用以下对象：
创建与 Dropbox 的连接
要为您的 Dropbox 模块创建连接：
-
在任意模块中，单击“连接”框旁边的添加。
-
填写以下字段：
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标头 -
单击 继续 以保存连接并返回模块。## Dropbox模块及其字段
Dropbox 模块及其字段
在您配置 Dropbox 模块时，Workfront Fusion 会显示以下字段。 除这些字段外，根据您的应用程序或服务访问权限级别，可能会显示更多 Dropbox 字段。 模块中的加粗标题表示必填字段。
如果您看到字段或功能上方的映射按钮，可使用它为该字段设置变量和函数。 有关详细信息，请参阅将信息从一个模块映射到另一个模块。
触发器模块
监视文件
修改指定文件夹中的文件时，此触发器类型模块会返回文件详细信息。
用于获取Dropbox文件和文件夹的模块
下载文件
此操作模块从文件夹下载文件。
指定文件及其位置。
模块会返回文件的ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
获取文件夹元数据
此操作模块可检索共享文件夹的详细信息。
指定文件夹的ID。
该模块会返回文件夹ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
列出文件夹中的所有文件/子文件夹
此操作模块列出特定文件夹中的文件或文件夹。
指定文件夹的ID。
该模块返回文件或文件夹的ID以及任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
列出文件修订
此操作模块可检索特定文件的所有文件修订版本（版本历史记录）。
指定文件的ID。
该模块会返回与记录关联的所有标准字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
搜索文件/文件夹
此搜索模块在Dropbox中查找与您指定的搜索查询匹配的对象中的记录。
您可以在场景后续的模块中映射这些信息。
用于创建和编辑Dropbox文件和文件夹的模块
创建文件夹
此操作模块将创建新文件夹。
指定文件夹的路径和名称。
该模块会返回文件夹ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
创建/覆盖文本文件
此操作模块创建DOC文件，或覆盖现有文件的内容。
指定源文件和文件夹。
在配置此模块时，会显示以下字段。
创建/更新共享链接
此操作模块创建指向文件的公共链接。
指定文件以及有关链接的信息。
模块会返回链接的ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
删除文件/文件夹
此操作模块删除文件或文件夹。
指定文件或文件夹。
该模块会返回记录的 ID 及其关联字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
移动文件/文件夹
此操作模块会将文件或文件夹移动到其他位置。
您可以指定文件或文件夹，以及移动它的方法和位置。
该模块会返回文件或文件夹的ID以及任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
重命名文件/文件夹
此操作模块将重命名文件或文件夹。
指定文件或文件夹以及新名称。
该模块会返回文件或文件夹的ID以及任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
还原文件
此操作模块恢复文件的先前版本。
指定所需的文件和修订版本号。
模块会返回版本ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
上传文件
此操作模块将文件上传到文件夹。
您可以指定信息，例如文件的位置、要上传的文件以及文件的可选新名称。
模块会返回文件的ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
其他模块
进行API调用
此操作模块允许您向 Dropbox API 发起自定义的已经过身份认证的调用。 通过这种方式，您可以构建其他 Dropbox 模块无法实现的数据流自动化。
在配置此模块时，会显示以下字段。
https://api.dropboxapi.com的路径。 例如， /2/files/list_folder以标准 JSON 对象的形式添加 API 调用的正文内容。
注意：
在 JSON 中使用 if 等条件语句时，需将引号置于条件语句外部。
示例：
以下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
- 将
www替换为dl。 - 删除
?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")}}