BoxConnector
访问Box文件存储服务来上传、下载或删除文件和文件夹,或从Box帐户中列出文件/文件夹信息。
典型的使用
通过上传、下载和删除文件和文件夹来管理Box上的数据集
将文件的内容(如XML或光栅)传入或传出FME中的属性
- 阅读使用下载框数据FeatureReader,或上载由。编写的数据FeatureWriter到盒子
- 检索文件和文件夹名称、路径、链接和其他信息,以便在工作区中的其他位置使用。
它是如何工作的?
BoxConnector使用您的Box帐户凭据(通过以前定义的FME web连接,或者通过从transformer设置新的FME web连接)访问文件存储服务。
根据您的操作选择,它将上传或下载文件、文件夹和属性;列出来自服务的信息;或从服务中删除项。在上传时,可以将链接属性添加到输出特性中。在列表操作中,链接和文件/文件夹信息作为属性添加。
在这个例子中,BoxConnector用于从盒子下载ESRI的地理数据库。建立一个有效的网络连接到一个盒子账号(可以直接在盒子帐户参数来完成),并浏览到地理数据库文件夹后,对象ID被检索到,并选择下载的目的地。
一个FeatureReader被添加到读取新下载的数据集。在这里,PostalAddress功能类型将在工作区中的其他地方进一步处理。
通过在工作区这里执行下载,地理数据库将被刷新一次,工作区运行的时间。
在工作空间中的该示例性部分,所述BoxConnector用于下载从Box中的光栅的垂直图像到一个属性。
从Box中读取文件,并将内容存储为一个blob属性。然后一个RasterReplacer用于将blob解释为可用的光栅格式。
这两个变压器的组合,避免了下载图片到本地存储和重新阅读。类似的技术可用于点云的文件,使用PointCloudReplacer变压器。
使用注意事项
此转换器不能用于在不同的盒位置之间直接移动或复制文件。但是,可以使用多个boxconnector来完成这些任务。
的FeatureReader可以直接访问盒(不使用BoxConnector),然而,该数据集的本地副本将不会被创建。
配置
输入端口
该变压器接受任何功能。
输出端口
此变压器的输出将根据所执行的箱形动作而变化。
- 后一个上传行动网址的文件可以保存到可共享的链接并直接下载链接的属性,以及文件的ID将保存到一个属性。
- 一个下载操作可以保存到文件夹或属性。
- 一个删除动作没有输出端口。
- 最后,列表action将为在指定路径中找到的每个文件/文件夹输出一个新特性。每个新特性都有一些属性,列出了关于对象的各种信息。
参数
盒子行动 | 要执行的操作的类型。选择包括:
|
箱账户 | 对Box帐户执行操作需要使用使用Web连接的OAuth2身份验证。要创建一个框连接,单击“框帐户”下拉框并选择“添加Web连接…”。 随后,连接将可以通过管理工具 - >选项FME ... - > Web连接。 |
其余可用参数取决于请求>框操作参数的值。每个框操作的参数如下所示。
盒子路径
删除, | 选择是否删除文件或文件夹。
|
对象ID |
在Box中的文件或文件夹的对象ID删除。如果作为web连接提供了有效的凭据,则可以浏览到某个位置。 |
箱源
对象ID |
要下载的文件/文件夹的框ID。如果作为web连接提供了有效的凭据,则可以浏览到某个位置。 |
目的地
下载为 | 选择是否将下载的数据存储在文件、文件夹或属性中。
|
下载到文件夹 | 指定的路径将存储下载文件的文件夹。有效期为下载文件或文件夹。 |
包括子文件夹 | 选择是否下载盒源的子文件夹。仅作为文件夹下载有效。 |
下载到属性 | 指定将存储下载文件的内容的属性。仅作为属性下载有效。 注意:FME会尝试将属性的内容转换为UTF-8字符串。如果失败,则该属性的内容将作为原始二进制来创建。为了确保原字节总是保留并不会转换为UTF-8,使用下载的文件来代替。 |
盒子路径
生成可分享的链接 | 指定此选项检索文件或文件夹链接属性。这将允许访问这些链接观看的内容和/或下载任何人。 |
对象ID |
在框中的文件夹ID列出的内容。如果作为web连接提供了有效的凭据,则可以浏览到某个位置。 |
输出属性
提供默认的属性名称,并且可能会被覆盖。
文件或文件夹名称 |
在“框”上指定保存对象名称的属性。 |
文件或文件夹ID |
指定要保持对箱的对象的ID属性。 |
文件或文件夹链接 |
指定要持有的链接上盒对象的属性。 |
文件大小 |
指定要坚持箱文件对象的大小属性。 |
最后修改 |
在“上”框中指定保存对象的最后修改日期的属性。 |
文件或文件夹标志 |
在“上”框中指定保存对象的类型(文件或文件夹)的属性。 |
相对路径 |
指定属性保持相对路径上框的对象。 |
源
上传 |
要上载的数据的类型。
当使用大型对象,文件比属性更适合作为数据将直接从磁盘流,而不是需要将对象完全存储在内存中的一项功能。 盒对待上传文件同名,在一个特定的文件夹,为重复,但不允许在特定文件夹的多个实例。您必须将文件上传到不同的文件夹比现有的一个。 当需要从文件夹上传内容时,最好是作为文件夹上传,而不是设置固定的路径并将多个特性发送到连接器以作为文件上传。 |
生成可共享链接 | 指定此选项以设置共享和直接下载链接属性。这将允许上传的内容被任何访问这些链接的人查看和/或下载。 |
文件上传 |
如果上传设置为文件的文件上传到箱。 |
文件夹上传 |
如果上传设置为文件夹中的文件夹上传到箱。 |
包括子文件夹 |
选择是否上载要上载的文件夹的子文件夹。 |
属性上载为文件 |
要上载的数据,如果Upload设置为attribute,则由属性提供。 |
盒目的地
文件夹ID | 在框中的路径上传的源文件。要上传到根目录,输入“/”。 |
上传文件名 | 从要上载为文件的属性中提供的数据创建的文件的名称。名称必须包含一个文件名扩展名(例如.txt、.jpg、.doc)。 |
输出属性
可分享的链接 | 指定output属性,该属性将存储一个可公开访问的临时URL,该URL链接到on框上的文件。 |
直接下载链接 | 指定output属性,该属性将存储一个链接到文件的URL。URL只能由经过身份验证的用户使用。 |
文件或文件夹Id |
指定存储刚上传的文件/文件夹的ID输出属性。 |
编辑变压器参数
使用一组菜单选项,变压器参数可以通过引用在工作区中的其它元件来分配。更先进的功能,如高级编辑,算术编辑,也是一些变压器可用。要访问这些选项的菜单,点击适用的参数旁边。欲了解更多信息,请参阅变压器参数菜单选项。
定义值
有几种方法可以定义在转换器中使用的值。最简单的方法是简单地键入一个值或字符串,其中可以包括各种类型的函数,如属性引用、数学和字符串函数以及工作区参数。有许多工具和快捷方式可以帮助构造值,通常可以从value字段附近的下拉上下文菜单中获得。
使用文本编辑器
文本编辑器提供了一种方便的方法来构造来自各种数据源(如属性、参数和常量)的文本字符串(包括正则表达式),其中直接在参数中使用结果。
使用算术编辑器
算术编辑器提供了一个方便的方法来构造从各种数据源,如属性,参数和特征函数,其中结果被直接使用的参数内的数学表达式。
有条件的值
根据通过或失败的一个或多个测试条件设置值。
内容
表达式和字符串可以包括多个功能,字符,参数,和更多 - 编辑是否直接在参数输入或构造使用一个。
参考
处理行为 |
|
功能持有 |
没有 |
依赖关系 | 箱账户 |
FME授权级别 | FME专业版及以上 |
别名 | |
历史 | 发布FME 2017.0 |
类别 |
FME知识中心
在FME知识中心是演示,入门指南,文章,FAQ,以及更多的地方。解答您的问题,向其他用户学习,并建议,投票,并在新的功能注释。
搜索所有关于盒连接器的结果在FME知识中心。
实例可以包含开放政府许可协议进行许可信息 - 温哥华