BoxConnector
访问Box文件存储服务上传、下载或删除文件和文件夹,或从Box帐户列出文件/文件夹信息。
典型的用途
通过上传、下载和删除文件和文件夹管理Box上的数据集
将文件的内容(例如XML或栅格)传输到FME中的属性中
- 控件读取下载的Box数据FeatureReader或上传由featurewriter.到盒子
- 从框中检索文件和文件夹名称,路径,链接和其他信息以在工作区中的其他位置使用。
它是如何工作的?
BoxConnector使用您的框帐户凭据(通过先前定义的FME Web连接,或通过从变压器设置新的FME Web连接)来访问文件存储服务。
根据您的选择,它将上传或下载文件,文件夹和属性;列出服务的信息;或从服务中删除项目。在上传时,可以将链接属性添加到输出功能。在列表操作中,链接和文件/文件夹信息作为属性添加。
在本例中,BoxConnector用于从Box下载Esri Geodatabase。创建一个有效的web连接到Box帐户(这可以在Box account参数中完成),并浏览到geodatabase文件夹,对象ID检索,并选择下载的目的地。
一个FeatureReader添加以读取新下载的数据集。这里,PostalAddress特性类型将在工作空间的其他地方进一步处理。
通过在工作区中执行下载,每次运行工作空间时都会刷新地理数据库。
在工作空间的此示例部分中,BoxConnector用于将Raster OrthoImage从框下载到属性中。
文件从框中读取,并将内容存储为Blob属性。然后一个RasterReplacer.用于将BLOB解释为可用的栅格格式。
这两个变换器的组合避免了必须将图像下载到本地存储并重新读取它。一种类似的技术可以用于点云文件,使用pointcloudreplacer.变压器。
使用说明
此转换器不能用于在不同Box位置之间直接移动或复制文件。但是,可以使用多个BoxConnectors来完成这些任务。
的FeatureReader可以直接访问Box(不使用BoxConnector),但是不会创建数据集的本地副本。
配置
输入端口
此变形器接受任何功能。
输出端口
这个变压器的输出将根据执行的框动作而变化。
- 答:上传动作时,文件的url可能被保存到共享链接和直接下载链接属性中,文件的ID将被保存到一个属性中。
- 一个下载操作可以保存到文件夹或属性。
- 一个删除操作没有输出端口。
- 最后,一个列表操作将为在指定路径中找到的每个文件/文件夹输出新特性。这些新特性中的每一个都有列出关于对象的各种信息的属性。
参数
箱操作 | 执行的操作类型。选择包括:
|
箱账户 | 对Box帐户执行操作需要使用Web连接使用OAuth2身份验证。要创建一个框连接,单击“Box Account”下拉框并选择“Add Web connection…”。 该连接可以通过Tools -> FME Options…——>网络连接。 |
剩余的参数取决于Request > Box Action参数的值。下面详细介绍了每个框动作的参数。
箱子
删除, | 选择是删除文件或文件夹。
|
对象ID |
删除框上的文件或文件夹的对象ID。如果提供了有效的凭据作为一个网络连接,您可以浏览到一个位置。 |
盒子来源
对象ID |
要下载的文件/文件夹的Box ID。如果提供了有效的凭据作为一个网络连接,您可以浏览到一个位置。 |
目的地
下载 | 选择是否将下载的数据存储在文件,文件夹或属性中。
|
下载到文件夹 | 指定将存储下载文件的文件夹的路径。有效地下载为文件或文件夹。 |
包括子文件夹 | 选择是否下载Box Source的子文件夹。仅对下载为文件夹有效。 |
下载到属性 | 指定用于存储下载文件内容的属性。仅对下载属性有效。 笔记:FME将尝试将属性的内容转换为UTF-8字符串。如果此失败,则属性的内容将被创建为原始二进制文件。为确保始终保留原始字节并从未转换为UTF-8,请使用下载作为文件。 |
箱子
生成可共享链接 | 指定此选项以检索“文件或文件夹链接”属性。这将允许访问这些链接的任何人查看和/或下载内容。 |
对象ID |
框中的文件夹ID以列出的内容。如果提供了有效的凭据作为一个网络连接,您可以浏览到一个位置。 |
输出属性
提供默认属性名称,可能会被覆盖。
文件或文件夹名称 |
指定属性以在框上保存对象的名称。 |
文件或文件夹ID |
指定属性来保存Box上对象的ID。 |
文件或文件夹链接 |
指定属性以将链接保留到框上的对象。 |
文件大小 |
指定用于保存Box上文件对象大小的属性。 |
最后修改 |
指定属性来保存Box上对象的最后修改日期。 |
文件或文件夹标志 |
指定属性以在框上保留对象的类型(文件或文件夹)。 |
来源
上传 |
上传的数据类型。
在处理大对象时,File是比Attribute更好的选择,因为数据将直接从磁盘流来,而不需要将对象完全存储在某个特性的内存中。 Box将特定文件夹中的文件上传在特定文件夹中享用相同名称,但不允许在特定文件夹中的多个实例。您必须将文件上传到与现有文件夹的其他文件夹。 当希望从文件夹上传内容时,最好将其作为文件夹上传,而不是设置固定路径并将多个特性发送到连接器以作为文件上传。 |
生成可共享链接 | 指定此选项可设置共享和直接下载链接属性。这将允许通过访问这些链接的任何人查看和/或下载上传内容。 |
文件上传 |
如果“Upload from”设置为“file”,则需要上传到“Box”中的文件。 |
文件夹上传 |
如果上传到文件夹,则要上传到框的文件夹。 |
包括子文件夹 |
选择是否上传文件夹的子文件夹以上载。 |
属性以载为文件 |
上传的数据,如果Upload设置为attribute,则从属性提供。 |
框目的地
文件夹ID. | 框上的路径将源文件上传到。要上传到根目录,请输入“/”。 |
以文件名上传 | 从属性中提供的数据创建的文件的名称以将其作为文件上传。名称必须包含文件名扩展名(例如,.txt,.jpg,.doc)。 |
输出属性
可共享链接 | 指定输出属性,该属性将存储一个链接到Box上的文件的临时公共访问URL。 |
直接下载链接 | 指定输出属性,该属性将存储链接到Box上的文件的URL。该URL只能被认证过的用户使用。 |
文件或文件夹Id |
指定将存储刚才上传的文件/文件夹ID的输出属性。 |
编辑变换器参数
使用一组菜单选项,可以通过引用工作区中的其他元素来分配转换器参数。更高级的功能,比如高级编辑器和算术编辑器,也可以在一些转换器中使用。要访问这些选项的菜单,请单击除了适用的参数。有关更多信息,请参见变换器参数菜单选项.
定义值
有几种方法可以定义在Transformer中使用的值。最简单的方法是输入一个值或字符串,它可以包含各种类型的函数,如属性引用、数学和字符串函数,以及工作空间参数。有许多工具和快捷方式可以帮助构造值,这些工具和快捷方式通常可以从值字段旁边的下拉上下文菜单中获得。
使用文本编辑器
文本编辑器提供了一种方便的方法来构建来自各种数据源的文本字符串(包括正则表达式),例如属性,参数和常量,其中结果直接在参数内使用。
使用算术编辑器
算术编辑器提供了一种方便的方法来从各种数据源(如属性、参数和特性函数)构造数学表达式,其中的结果直接在参数中使用。
条件值
根据通过或失败的一个或多个测试条件设置值。
内容
表达式和字符串可以包括许多函数、字符、参数等——无论是直接在参数中输入还是使用某个编辑器构造。
参考
处理行为 |
|
功能持有 |
没有 |
依赖性 | 箱账户 |
FME授权级别 | FME专业版及以上 |
别名 | |
历史 | FME 2017.0发布: |
类别 |
FME知识中心
FME知识中心是演示,How-TOS,文章,常见问题和更多的地方。获取您的问题的答案,从其他用户学习,并建议,投票和评论新功能。
搜索所有结果关于BoxConnector在FME知识中心。