连接到 ServiceNow

概念信息

ACCESSDATA 命令

ServiceNow 是 IT 管理解决方案的云提供商。使用 ServiceNow 数据连接器导入您的组织的 ServiceNow 数据。

说明

您不能独立于 Analytics 使用此连接器。您可以使用 Windows ODBC 数据源管理器为连接器驱动程序配置一个 DSN，但是您必须从 Analytics 内部而不是从连接器的 Windows DSN 配置对话框中测试 DSN 连接。

开始之前

要连接到 ServiceNow，您必须收集以下信息：

  • 进行连接的用户账户，包括用户名和密码
  • 要从中检索表的实例
  • 当您向 ServiceNow 的 OAuth 授权服务器注册您的应用程序时被分配的客户端 ID 和客户端密钥 OAuth 凭据。

    提示

    有关注册应用程序并获取 OAuth 凭据的详细信息，请在 ServiceNow 文档中搜索“设置 OAuth”。

有关收集连接必备信息的帮助，请联系ServiceNow您组织中的管理员。如果您的管理员不能帮助您，您或者您的管理员应该联系ServiceNow支持人员。

创建 ServiceNow 连接

  1. 从 Analytics 主菜单中选择导入 > 数据库和应用程序。
  2. 从新建连接选项卡中，在 ACL 连接器部分中，选择ServiceNow。

    提示

    您可以通过在过滤连接框中输入搜索字符串来过滤可用连接器的列表。连接器按字母顺序排列。

  3. 在数据连接设置面板中，输入连接设置，然后在面板底部单击保存并连接。

    您可以接受默认的连接名称，也可以输入一个新的名称。

ServiceNow的连接被保存到现有连接选项卡。将来，您可以从已保存的连接重新连接到ServiceNow。

一旦连接被建立，“数据访问”窗口将打开到暂存区域，并且您可以开始导入数据。要获得与从 ServiceNow 导入数据有关的帮助，请参阅 使用 数据访问窗口。

连接设置

基本设置

设置 描述 示例
用户 用于向 ServiceNow 进行认证的用户账户。 admin_1
密码

用于认证用户的密码。

  
实例

要从中检索表的 ServiceNow 实例。

 staging16387
OAuth 客户端 ID

当您向 ServiceNow 的 OAuth 授权服务器注册您的应用时被分配的客户端 ID。

OAuth 要求您注册您的应用。在注册过程中，您将收到客户端 ID（有时也叫做使用者密钥）和客户端密钥。您必须指定两者以进行连接。

 356a825803610300ef0662490d237522
OAuth 客户端秘钥

当您向 ServiceNow 的 OAuth 授权服务器注册您的应用时被分配的客户端密钥。

OAuth 要求您注册您的应用。在注册过程中，您将收到客户端 ID 和客户端密钥（有时也叫做使用者密钥）。您必须指定两者以进行连接。

 secretTest

高级设置

设置 描述 示例
将日期时间转换为 GMT

在导入过程中将日期时间域转换至 GMT 时区。如果为假，则该日期时间值被转换为运行 Analytics 的计算机的操作系统时区。

说明

如果您选择此选项，则您使用 ON (=) 运算符向日期时间域应用的任何过滤器都要求您在为过滤器条件输入日期时间值时使用 'Z' 格式说明符：2017-01-01 12:38:54Z。

 true
密钥大小限制

主键列的最大长度。将大小设置为 0 会使键长度恢复到原始长度。

此属性使连接器覆盖所有主键列的报告长度。

 255
映射到 Long Varchar

控制一个列是否被作为 SQL_LONGVARCHAR 返回。

使用此设置可映射任何大于指定大小的列，以便使它们被报告为 SQL_LONGVARCHAR 而不是 SQL_VARCHAR。

 -1
映射到 WVarchar

控制字符串类型是否映射到 SQL_WVARCHAR 而不是 SQL_VARCHAR。它在默认情况下被设置。

必须将字符串列映射到 SQL_WVARCHAR 以适应各种国际字符集，因此 MapToWVarchar 默认情况下被设置为真。您可以将其设置为假以改而使用 SQL_VARCHAR。

 true
伪列

指示是否将伪列作为列包括在表中。

此设置在 Entity Framework 中特别有用，它不允许您为伪列设置值，除非该列是表列。

此连接设置的值的格式为 "Table1=Column1, Table1=Column2, Table2=Column3"。您可以使用“*”字符包括所有表和所有列。

 MyTable=*
SSL 服务器证书

要在使用 TLS/SSL 连接时从服务器接受的证书。您可以指定下列任一选项：

  • 完整的 PEM 证书
  • 包含证书的本地文件的路径
  • 公钥
  • MD5 指纹（还可以用空格或冒号分隔十六进制值）
  • SHA1 指纹（还可以用空格或冒号分隔十六进制值）

如果使用 TLS/SSL 连接，则此属性可被用来指定要从服务器接受的 TLS/SSL 证书。不被该计算机信任的任何其他证书都将被拒绝。

 C:\cert.cer
代理认证方案

用来向 ProxyServer 代理进行认证的认证类型。

此值指定用来向由 ProxyServer 和 ProxyPort 指定的 HTTP 代理进行认证的认证类型。

说明

连接器默认情况下将使用系统代理设置，而无需进一步的配置；如果您想要连接到另一代理，则除了设置 ProxyServer 和 ProxyPort 以外，您还需要将 ProxyAutoDetect 设置为假。要进行认证，请设置 ProxyAuthScheme，并且根据需要设置 ProxyUser 和 ProxyPassword。

认证类型可以是下列类型之一：

  • BASIC驱动程序执行 HTTP 基本认证
  • DIGEST驱动程序执行 HTTP 摘要认证。
  • NEGOTIATE驱动程序基于适用于认证的协议检索 NTLM 或 Kerberos 令牌
  • PROPRIETARY驱动程序不生成 NTLM 或 Kerberos 令牌。您必须在 HTTP 请求的授权标头中提供此令牌
 BASIC
代理自动检测 指示是否使用系统代理设置。将 ProxyAutoDetect 设置为假可使用自定义代理设置。这将优先于其他代理设置。 true
代理用户

要用来向 ProxyServer 代理进行认证的用户名。

ProxyUser 和 ProxyPassword 选项被用来连接 ProxyServer 中指定的 HTTP 代理以及向其进行认证。

您可以在 ProxyAuthScheme 中选择可用的认证类型之一。如果您使用 HTTP 认证，请将此属性设置为 HTTP 代理所识别的用户的用户名。如果您使用 Windows 或 Kerberos 认证，请将此属性设置为采用下列格式之一的用户名：

  • 用户@域
  • 域\用户
 john_doe@example.com
代理密码

要用来向 ProxyServer 代理进行认证的密码。

此属性被用来向支持 NTLM (Windows)、Kerberos 或 HTTP 认证的 HTTP 代理服务器进行认证。要指定 HTTP 代理，您可以设置 ProxyServer 和 ProxyPort。要指定认证类型，请设置 ProxyAuthScheme。

如果您使用 HTTP 认证，请另外将 ProxyUser 和 ProxyPassword 设置为 HTTP 代理。

如果您使用 NTLM 认证，请将 ProxyUser 和 ProxyPassword 设置为您的 Windows 密码。您还可能需要使用它们来完成 Kerberos 认证

  
代理服务器

要通过其路由 HTTP 流量的代理的主机名或 IP 地址。

要通过其路由 HTTP 流量的代理的主机名或 IP 地址。驱动程序可使用 HTTP、Windows (NTLM) 或 Kerberos 认证类型向 HTTP 代理进行认证。

默认情况下，驱动程序使用系统代理。如果您需要使用其他代理，请将 ProxyAutoDetect 设置为假。

 206,174,193,115
代理端口 运行 ProxyServer 代理的 TCP 端口。 80
代理 SSL 类型

要在连接到 ProxyServer 代理时使用的 SSL 类型：

  • AUTO如果 URL 是 HTTPS URL，则连接器将使用 TUNNEL 选项。如果 URL 是 HTTP URL，则连接器将使用 NEVER 选项（默认选项）
  • ALWAYS连接始终支持 SSL
  • NEVER连接不支持 SSL
  • TUNNEL连接经过隧道代理：代理服务器打开到远程主机的连接，并且通过代理传输流量
 AUTO

数据连接器更新

当您升级 Analytics 或机器人代理时，应该使用一个 Analytics 数据连接器（ACCESSDATA 命令）测试用于导入数据的脚本。

由第三方数据源或 ODBC 驱动程序供应商进行的更改可能要求更新一个或多个数据连接器。脚本化数据连接可能需要更新以便继续正确工作。

  • 重新运行导入更新连接的最轻松方式是使用 Analytics 升级版本中的数据访问窗口手动执行导入。从日志复制 ACCESSDATA 命令并使用它更新您的脚本。

    说明

    在连接到数据源并重新运行导入之前，请清除连接器缓存以冲刷现有的表名称集。

    在 数据访问窗口 的现有连接选项卡中，在连接器名称旁边选择 > 清除缓存。

  • 更新域规范您还可能需要更新脚本主体中的域规范以匹配数据源或 ODBC 驱动程序中的表架构更改。可能的更改包括域名称、域数据类型、域和记录长度。
  • 检查任何过滤的结果您还应该检查您在数据导入过程中应用的任何过滤的结果。确认导入过滤是否正确地包含和排除了记录。

ServiceNow 数据连接器更改

下面列出了对 ServiceNow 数据连接器进行的具体更改。

Analytics 版本 改变

14.2

ServiceNow 日期域现在被映射到 ServiceNow 数据连接器中的日期数据类型，其格式为 YYYY-MM-DD，并且长度为 10 个字符。

以前，ServiceNow 日期域被映射到 ServiceNow 数据连接器中的日期时间数据类型，其格式为 YYYY-MM-DD hh:mm:ss，长度为 19 个字符。导入的数据的时间部分为空，并被表示为 00:00:00。