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 |
产品 |
新增:
或 当前:您的组织必须购买Adobe Workfront Fusion。 |
有关此表中信息的更多详细信息,请参阅文档🔗中的访问要求。
有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion 许可证。
先决条件
- 要使用Dropbox模块,您必须具有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模块无法实现的数据流自动化。
配置此模块时,会显示以下字段。
示例:
以下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")}}