“查看新 GeoJSON 文件的文件夹输入连接器”可用于从系统文件中读取并改编格式化为 GeoJSON 的事件数据。
在 GeoJSON 文件中指定多个事件数据记录时,可将其组织为
FeatureCollection
,如下图所示。GeoJSON 入站适配器将要素集合中的每个要素记录作为单独的事件数据记录进行处理。将对以下说明的 GeoJSON 进行改编以针对要处理的 GeoEvent 服务生成两个事件数据记录。
有关 GeoJSON 数据记录格式的详细信息和示例,请参阅
GeoJSON 规范
。
用法说明
-
使用此输入连接器可以从系统文件中读取格式化为 GeoJSON 的事件数据,并对其进行改编以创建事件记录以进行处理。
-
此输入连接器可将 GeoJSON 入站适配器与文件入站传输进行配对。
-
输入连接器将查看指定的系统文件夹,当文件出现在文件夹中时,将立即读取整个文件。
-
如果对文件进行更改并保存所作更改,则将重新读取整个文件的内容。
-
如果出现以下情况,则将从文件开头重新读取已查看文件夹中的所有文件:
-
更新并保存输入连接器的属性后。
-
停止并重新启动输入连接器后(或重新启动
ArcGIS GeoEvent Server
服务后)。
-
GeoJSON 要素记录应同时包含几何和属性成员。
-
GeoJSON 入站适配器不支持
根据字段构建几何
功能。
-
可以使用绝对路径或 UNC 路径来指定已注册服务器文件夹
输入文件夹数据存储
。如果使用 UNC 路径,则运行
ArcGIS GeoEvent Server
的 Windows 服务帐户需要对文件夹的读/写权限。
-
例如,对于
输入文件夹数据存储
属性,最佳做法是使用绝对路径,例如
C:\GeoEvent\input
。
-
输入目录
允许指定相对于已注册服务器文件夹的子文件夹。
-
包括子文件夹
用于指定是否应递归搜索
输入文件夹数据存储
下的文件夹。通常,可以将具有不同方案的数据组织到不同的文件夹中,然后更改
包括子文件夹
的默认值以禁用递归搜索,由此实现更直接和更简单地配置此输入连接器。
-
网络延迟可能会对
GeoEvent Server
检索大量的事件数据产生负面影响。
参数
|
参数
|
说明
|
|
名称
|
用于在 GeoEvent Manager 中引用的输入连接器的描述性名称。
|
|
输入文件夹数据存储
|
已注册的系统文件夹,在该文件夹下将找到文件。
|
|
输入目录
|
直接位于已注册的系统文件夹下的子文件夹。如果注册的系统文件夹下面的子文件夹不存在,则
输入目录
应留为空白。
|
|
输入文件过滤器
|
一种正则表达式模式,用于标识适合此输入的文件以进行合并和调整,从而创建要处理的事件数据记录。由于 GeoJSON 在技术上是通用 JSON 的子类型,因此默认值 (
.*\.json
) 用于匹配以文字后缀(
.json
)结尾的任何文件名 (
.*
)。假设您的输入文件都使用 (.geojson) 扩展名命名,则默认模式可以更改为
.*\.geojson
,以避免与更通用的 JSON 文件混淆。
虽然此属性并非必需且可以留空,但建议您指定一个模式,该模式可与任何文件的文件名匹配,只要该文件的方案与此输入已配置为使用的 GeoEvent 定义匹配,还建议排除您不希望输入合并的文件(按名称)。
|
|
默认空间参考
|
空间参考系统的熟知 ID (WKID) 或熟知文本 (WKT),其中表示的是几何的坐标。此属性不具有默认值。
|
|
包括子文件夹
|
指定是否在
输入文件夹数据存储
和
输入目录
(可选)下的子文件夹中搜索文件。默认为
是
,但是,将具有不同方案的数据组织到不同的文件夹中并将此属性更改为
否
以禁用递归搜索,可实现更简单的配置。
-
是
- 递归搜索内容将被合并且调整为创建事件数据记录的文件。
-
否
- 仅在
输入文件夹数据存储
和
输入目录
(可选)子文件夹中搜索文件。
|
|
处理后删除文件
|
指定在处理内容后是否删除已注册系统文件夹中的文件。请注意,即使无法调整文件的内容,也不会创建任何事件记录,也不会发生实时事件处理,入站传输仍将删除已成功读取内容的文件。默认为
否
。
-
是
- 文件将在处理后从注册的系统文件夹中删除。
-
否
- 处理后,文件不会从注册的系统文件夹中删除。
|
|
创建 GeoEvent 定义
|
指定是否应将新的或现有的 GeoEvent 定义用于入站事件数据。
GeoEvent Server
需要 GeoEvent 定义,以了解入站事件数据属性字段和数据类型。
-
是
- 将根据收到的第一个事件记录的模式创建新的 GeoEvent 定义。
-
否
- 不会创建新的 GeoEvent 定义。选择与入站事件数据的方案匹配的现有 GeoEvent 定义。
|
|
GeoEvent 定义名称(新)
(条件分析)
|
分配给新 GeoEvent 定义的名称。如果已存在具有指定名称的 GeoEvent 定义,则会使用现有的 GeoEvent 定义。收到的第一个数据记录将用于确定后续数据记录的预期方案,将根据第一个数据记录的方案创建新的 GeoEvent 定义。
属性在
创建 GeoEvent 定义
设置为
是
时显示,设置为
否
时隐藏。
|
|
GeoEvent 定义名称(现有)
(条件分析)
|
在调整接收数据以创建事件数据以供 GeoEvent 服务处理时使用的现有 GeoEvent 定义的名称。
属性在
创建 GeoEvent 定义
设置为
否
时显示,设置为
是
时隐藏。
|
|
预期日期格式
|
该模式用于匹配日期/时间值的预期字符串表示形式,并将它们转换为 Java 日期值。模式的格式遵循 Java SimpleDateFormat 类约定。此属性不具有默认值。
而
GeoEvent Server
更偏好以 ISO 8601 标准表示的日期/时间值,通常被识别为日期值的日期/时间值的多个字符串表示可以转换为 Java 日期值,且无需指定
预期日期格式
模式。其中包括:
-
“2019-12-31T23:59:59”- ISO 8601 标准格式
-
1577836799000 - Java 日期(时间长整型;UTC)
-
“Tue Dec 31 23:59:59 -0000 2019”- 常见的 web 服务字符串格式
-
“12/31/2019 11:59:59 PM”- 美国使用的通用格式(12 小时制)
-
“12/31/2019 23:59:59”- 美国使用的通用格式
(24 小时制)
如果收到的日期/时间值使用上述五种之一以外的约定表示,则必须指定一个
预期日期格式
以便
GeoEvent Server
了解如何调整日期/时间值。
|
|
属于文件文本
|
指定文件是基于文本还是二进制格式。默认为
是
。
-
是
- 该文件基于文本。
-
否
- 文件为二进制文件。
|
|
每批的最大行数
(条件分析)
|
每个批次或区间中从文件读取的最大行数。默认为
1000
行。如果每个事件记录包含许多属性以限制作为批处理发送到文本适配器的数据量,请减小此值。
属性在
属于文件文本
设置为
是
时显示,在设置为
否
时隐藏。
|
|
批刷新间隔(毫秒)
(条件分析)
|
从文件中读取另一批行之前要等待的毫秒数。默认值为
500
。如果预计文件大小非常大和/或需要额外的时间来处理从文件中检索的每批行,请减小此值。
属性在
属于文件文本
设置为
是
时显示,在设置为
否
时隐藏。
|
|
从文件开始处跳过的行数
(条件分析)
|
从文件开始处跳过的行数。默认值为
0
。如果要跳过特定行数(例如,指定属性字段名称或数据类型的标题行),则增加此值,因为这些行中不包含要处理的实际数据。
属性在
属于文件文本
设置为
是
时显示,在设置为
否
时隐藏。
|