访问box文件存储服务以上载、下载或删除box帐户中的文件和文件夹或列出文件/文件夹信息。
典型用途
- 通过上载、下载和删除文件和文件夹来管理Box上的数据集
- 将文件内容（如XML或光栅）传入或传出FME中的属性
- 使用功能阅读器，或上载特写到盒子
- 从框中检索文件和文件夹名称、路径、链接和其他信息，以便在工作区的其他位置使用。
它是如何工作的？
boxconnector使用您的box帐户凭据（通过先前定义的fme web连接，或通过从转换器设置新的fme web连接）来访问文件存储服务。
根据您选择的操作，它将上载或下载文件、文件夹和属性；列出服务的信息；或者从服务中删除项目。上传时，可以将链接属性添加到输出特性中。在列表操作中，链接和文件/文件夹信息作为属性添加。
例子：下载数据集
在本例中，boxconnector用于从box下载esri地理数据库。在创建到box帐户的有效web连接（可以在box account参数中直接完成）并浏览到geodatabase文件夹后，将检索对象id，并选择下载的目标。
一个功能阅读器添加以读取新下载的数据集。在这里，postaladdress特性类型将在工作区的其他地方进一步处理。
通过在工作区中执行此处的下载，每次运行工作区时都将刷新geodatabase。
使用说明
- 此转换器不能用于在不同的文件盒位置之间直接移动或复制文件。但是，可以使用多个box连接器来完成这些任务。
- 这个功能阅读器可以直接访问box（不使用boxconnector），但是不会创建数据集的本地副本。
配置
输入端口
输入
这个转换器接受任何特性。
输出端口
输出
此变压器的输出将根据执行的盒操作而变化。
- 之后上传action，指向文件的url可以保存到sharable link和direct download link属性中，文件的id将保存到一个属性中。
- 一个下载操作可以保存到文件夹或属性。
- 一个删除操作没有输出端口。
- 最后，一个列表操作将为在指定路径中找到的每个文件/文件夹输出新功能。这些新特性中的每一个都将具有列出有关对象的各种信息的属性。
参数
请求
| 方块动作 | 要执行的操作类型。选择包括：
|
| 箱式账户 | 对box帐户执行操作需要使用web连接使用oauth2身份验证。若要创建方框连接，请单击“方框帐户”下拉框，然后选择“添加Web连接…”。 然后可以通过工具->FME选项来管理连接…->网络连接。 |
其余可用参数取决于request>box action参数的值。下面详细介绍了每个box操作的参数。
参数-删除操作
箱形路径
| 删除为 | 选择是否删除文件或文件夹。
|
对象ID |
要删除的文件或文件夹的对象ID。如果已将有效凭据作为Web连接提供，则可以浏览到某个位置。 |
参数-下载操作
盒源
对象ID |
要下载的文件/文件夹的框ID。如果已将有效凭据作为Web连接提供，则可以浏览到某个位置。 |
目的地
| 下载为 | 选择是否将下载的数据存储在文件、文件夹或属性中。
|
| 下载到文件夹 | 指定将存储下载文件的文件夹的路径。可作为文件或文件夹下载。 |
| 包括子文件夹 | 选择是否下载框源的子文件夹。仅作为文件夹下载有效。 |
| 下载到属性 | 指定将存储下载文件内容的属性。仅作为属性下载有效。 注：fme将尝试将属性的内容转换为utf-8字符串。如果失败，属性的内容将被创建为原始二进制文件。要确保始终保留原始字节，并且从不将其转换为utf-8，请改用download as file。 |
输出属性
下载路径 |
指定将存储下载项的本地路径的输出属性。可作为文件或文件夹下载。 |
参数-列表操作
箱形路径
| 生成可共享链接 | 指定此选项可检索文件或文件夹链接属性。这将允许有权访问这些链接的任何人查看和/或下载内容。 |
文件夹ID |
要列出其内容的框中的文件夹ID。如果已将有效凭据作为Web连接提供，则可以浏览到某个位置。 |
输出属性
提供了默认属性名，并且可能会被覆盖。
文件或文件夹名 |
指定在框中保存对象名称的属性。 |
文件或文件夹ID |
指定在框中保存对象ID的属性。 |
文件或文件夹链接 |
指定一个属性，以在框中保存到对象的链接。 |
文件大小 |
指定用于在框中保存文件对象大小的属性。 |
上次修改时间 |
指定属性以保存框中对象的上次修改日期。 |
文件或文件夹标志 |
指定属性以保存框中对象的类型（文件或文件夹）。 |
相对路径 |
指定属性以保持框中对象的相对路径。 |
参数-上载操作
来源
上传 |
要上载的数据类型。
在处理大型对象时，文件比属性更好，因为数据将直接从磁盘流式传输，而不需要将对象完全存储在功能部件的内存中。 Box将特定文件夹中同名的文件上载视为重复，但不允许在特定文件夹中有多个实例。必须将文件上载到与现有文件不同的文件夹。 当需要从文件夹上载内容时，最好以文件夹的形式上载，而不是设置固定路径并将多个功能发送到连接器中以作为文件上载。 |
| 生成可共享链接 | 指定此选项可设置共享和直接下载链接属性。这将允许任何有权访问这些链接的人查看和/或下载上载的内容。 |
要上载的文件 |
如果“上载”设置为“文件”，则将要上载到框中的文件。 |
要上载的文件夹 |
如果“上载”设置为“文件夹”，则“要上载到的文件夹”框。 |
包括子文件夹 |
选择是否上载要上载的文件夹的子文件夹。 |
要作为文件上载的属性 |
要上载的数据，如果upload设置为attribute，则从属性提供。 |
箱子目的地
| 文件夹ID | 要将源文件上载到的框上的路径。要上载到根目录，请输入“/”。 |
| 使用文件名上载 | 从属性中提供的数据创建的要作为文件上载的文件的名称。名称必须包含文件扩展名（例如，.txt，.jpg，.doc）。 |
输出属性
| 可共享链路 | 指定输出属性，该属性将存储指向框中的文件的临时公共访问URL。 |
| 直接下载链接 | 指定将存储链接到框中的文件的URL的输出属性。URL只能由经过身份验证的用户使用。 |
文件或文件夹ID |
指定将存储刚上载的文件/文件夹的ID的输出属性。 |
编辑变压器参数
使用一组菜单选项，可以通过引用工作区中的其他元素来指定变压器参数。一些转换器中还提供了更高级的功能，如高级编辑器和算术编辑器。要访问这些选项的菜单，请单击
在适用参数旁边。有关详细信息，请参见变压器参数菜单选项是的。
定义值
有几种方法可以定义要在变压器中使用的值。最简单的方法是简单地输入一个值或字符串，它可以包括各种类型的函数，如属性引用、数学和字符串函数以及工作区参数。有许多工具和快捷方式可以帮助构造值，通常可以从值字段旁边的下拉式上下文菜单中获得。
如何设置参数值
使用文本编辑器
文本编辑器提供了一种从各种数据源（如属性、参数和常量）构造文本字符串（包括正则表达式）的方便方法，在这些数据源中，结果直接在参数内部使用。
使用算术编辑器
算术编辑器提供了一种从各种数据源（如属性、参数和特征函数）构造数学表达式的方便方法，在这些数据源中，结果直接在参数内部使用。
条件值
根据通过或失败的一个或多个测试条件设置值。
内容
表达式和字符串可以包含许多函数、字符、参数等，无论是直接在参数中输入还是使用其中一个编辑器构造。
参考
加工行为 |
|
特征保持 |
不 |
| 依赖关系 | 箱式账户 |
| FME许可级别 | FME基础版及以上 |
| 别名 | |
| 历史 | 发布FME 2017.0 |
| 类别 |
FME社亚搏国际在线官网区
fme社区是演示亚搏国际在线官网、操作指南、文章、常见问题解答等的场所。获取问题的答案，向其他用户学习，并对新功能进行建议、投票和评论。
搜索关于boxconnector的所有结果在FME社区。亚搏国际在线官网
示例可能包含根据开放式政府许可证获得许可的信息-温哥华