HTTP 轮询器

ArcGIS Velocity 中的“HTTP 轮询器”数据源会将 HTTP 请求发送到指定的 URL。 由此获取在 web 浏览器中通过浏览至同一 URL 即可检索到的数据。

示例

一位 GIS 分析师希望将存储在 Web 服务器上 .csv 文件中的区域面加载到 Velocity

用法说明

使用 HTTP 轮询器数据源时,请谨记以下信息:

  • 配置源连接参数后,需要配置输入数据以定义方案和关键参数。
  • URL 参数自定义标题参数均支持分析全局变量,用于计划循环大数据分析。 默认情况下,这些全局变量将转换为新纪元时间(自 1970 年 1 月 1 日 (UTC) 以来的毫秒数)。 下面是可用分析变量及其表示的时间。
    • $analytic.AnalyticLastScheduledStartTime - 计划开始最后一次运行分析的时间。
    • $analytic.AnalyticScheduledStartTime - 计划开始当前运行分析的时间。
    • $analytic.AnalyticLastEndTime - 结束最后一次运行分析的时间。
    • $analytic.AnalyticStartTime - 当前分析运行的开始时间。 此时间与 $analytic.AnalyticScheduledStartTime 之间的差值为启动延迟。
  • 如果使用 OAuth 身份验证,则以下内容适用:
    • HTTP 轮询器源支持使用 OAuth 2.0 进行遵循客户端凭据或密码授予类型的 HTTP 端点的身份验证。 这些 OAuth 授权类型遵循的方案包括配置 HTTP 请求以获取访问令牌。 这些数据请求是通常配置为任何 HTTP 轮询器源类型的一部分的数据请求的补充。
    • 在配置访问令牌请求期间,系统将提示您从 OAuth 授权服务器的响应中识别访问令牌。
    • 当返回数据请求的配置时,必须使用 $accessToken 全局变量来定义将使用访问令牌的位置。 这通常是在带有值 Bearer $accessTokenAuthorization 自定义标题中。 $accessToken 也可用于 POST 正文、URL 参数以及 URL(例如,https://<<company.domain>>/$accessToken/<<method>>?<<url params>>)。

参数

下面是 HTTP 轮询器源的参数:

参数描述数据类型

URL

外部可访问 HTTP 端点的完整 URL。

此参数支持 $accessToken 全局变量。

字符串

HTTP 方法

指定用于 HTTP 端点的 HTTP 方法,即 GETPOST

如果选择 POST,则可以指定消息正文。

字符串

POST 正文

发送 POST HTTP 请求时要包含的消息正文。

由此可在 x-www-form-urlencoded 与其他通用文本内容类型之间提供选择。 它还用于设置 Content-type 标题。

仅当 HTTP 方法参数设置为 POST 时,此参数才适用。

此参数支持分析和 $accessToken 全局变量。

字符串

身份验证

指定用于访问 HTTP 端点的身份验证的类型。 这些选项包括基础证书OAuth

字符串

用户名

用于访问 HTTP 端点的用户名。

仅当身份验证参数设置为基础时应用此参数。

字符串

密码

用于访问 HTTP 端点的密码。

仅当身份验证参数设置为基础时应用此参数。

密码

证书 URL

用于访问 HTTP 端点的客户端证书的 URL 位置。

仅当身份验证参数设置为证书时应用此参数。

字符串

密码

客户端证书密码(如果已设置)。

仅当身份验证参数设置为证书时应用此参数。

密码

自定义标题

发送到指定 HTTP 端点的 HTTP 请求中将包含可选的自定义标题。

例如,自定义标题可用于指定第三方 API 密钥或身份验证标题。

此参数支持分析和 $accessToken 全局变量。

键值对

URL 参数

要包含在发送到指定 HTTP 端点的 HTTP 请求 URL 中的可选 URL 参数。

虽然也可以在 URL 参数中设置参数,但是在此处输入的 URL 参数将覆盖为 URL 参数提供的任何匹配参数。

在此处定义的参数将始终使用 URL 编码。

此参数支持分析和 $accessToken 全局变量。

键值对

注意事项和限制

下面是在使用 HTTP 轮询器源时的注意事项和限制:

  • 必须可以通过 Internet 从外部访问 HTTP 端点。
  • 要轮询的 HTTP 相应或文件大小不能超过 16 MB。 如果要轮询的数据或文件超过 16 MB,则不会消耗要素。
  • 使用 OAuth 身份验证时,以下内容适用:
    • 在创作过程中会发生对授权服务器和关联的数据端点的多次请求。 一些 API 对某些请求实施限速,这可能会影响源的创作。
    • 出于安全原因,在编辑身份验证参数时,必须重新配置访问令牌 POST 正文。