集成 ServiceNow

与 ServiceNow 集成以提交和监控请求,并从任何设备、内部网或信使采取措施。

使用以下过程启用 ServiceNow 集成。确保满足必备条件、启用 API 访问并为专用用户分配角色。完成此过程后,您的现有审核日志记录级别将持续存在,包括使用 Citrix 微应用执行的任何操作。

此集成使您能够:

  • 在“Workspace 体验”中创建任务。该解决方案根据当前登录的用户向 API 请求添加一个“opened_in”参数。如果您在服务操作参数设置中明确定义了“opened_in”参数,则会替换默认值
  • 批准微应用中的请求。解决方案将 user_name 设置的句子“批准状态”添加到注释字段,以确定执行批准的人员
  • 从微应用创建新的服务目录请求。该解决方案将“requested_in”参数添加到基于当前登录用户的 API 请求中

有关现成的 ServiceNow 微应用的完整列表,请参阅使用 ServiceNow 微应用

检查必备项

这些必备条件假定您管理组织的 ServiceNow 实例以设置集成。此 ServiceNow 管理员帐户必须具有完整的数据访问权限。如果您选择使用单独的 ServiceNow 帐户进行微应用集成,则需要手动添加受限表的读取权限,例如 sys_journal_field。具体而言,管理员需要访问以下表,因为它们包含有关 ServiceNow 数据结构的信息:

  • 系统对象
  • 系统字典
  • 系统选择

此外,Workspace 用户需要为完成服务操作分配适当的角色。正确的角色取决于您的 ServiceNow 配置。

您必须具有以下详细信息才能在 Citrix Workspace 微应用中添加集成:

  • 实例 URL
  • 用户名
  • 密码

对于 OAuth 2.0:

  • 客户端 ID
  • 客户端密钥

注意: 建议您始终使用 OAuth 2.0 作为您的服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。

  • 获取新的 oauth2 client_id 和 client_secret 并定义客户端应用程序的范围。

  • 将 Citrix Gateway 配置为支持 ServiceNow 的单点登录,以便用户在登录后自动重新登录,而无需再次输入凭据。请按照 ServiceNow 单点登录配置 中的说明进行操作。有关配置 SSO 的详细信息,请参阅Citrix Gateway 服务

为所需表启用 API 访问

默认情况下,大多数 ServiceNow 表都可以通过 Web 服务进行访问。要确认是否可以通过 Web 服务访问要与 Workspace 同步的表,请执行以下操作:

  1. 登录到 ServiceNow。
  2. 选择系统定义 > 表
  3. 选择要确认的表名旁边的信息图标。选择打开记录。选择应用程序访问选项卡,并确保“允许通过 Web 服务访问此表”复选框已启用。
  4. 如有必要,选中该复选框,然后单击更新以保存您的设置。

添加回调 URL

向您的实例配置添加自定义 URL,以授予对私有数据的访问权限并启用OAuth 身份验证的用户操作。该部分 {yourmicroappserverurl} 由租户部分、区域部分和环境部分组成:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com

  1. 以管理员身份登录到 ServiceNow。
  2. 导航到系统 OAuth > 应用程序注册表,然后选择新建
  3. 选择为外部客户端创建 OAuth API 端点
  4. 在以逗号分隔的“重定向 URL”字段中输入此集成的以下授权 重定向 URL

    • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.servicenow.ServiceNowService/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

    确保未选择所需的 PKCE

  5. 单击 Submit(提交)。

筛选查询

大多数 ServiceNow 实体支持筛选。表 API GET 方法的系统查询 URL 参数允许过滤。选择预定义查询或编写自己的自定义查询。有关详细信息,请参阅ServiceNow REST API 参考和产品文档

注意:

如果查询或查询的任何部分无效,则忽略无效部分,如 ServiceNow 文档中指定的那样。

示例:

//仅活动对象:
active=true

//最近 2 天内更新:
sys_updated_onONLast%20day@javascript:gs.daysAgoStart(1)@javascript:gs.daysAgoEnd(0)

//在过去 3 小时内更新:
sys_updated_onONLast%20hour@javascript:gs.hoursAgoStart(2)@javascript:gs.hoursAgoEnd(0)

// 最近 4 个月更新:
sys_updated_onONLast%20month@javascript:gs.monthsAgoStart(3)@javascript:gs.monthsAgoEnd(0)

将集成添加到 Citrix Workspace 微应用

将 ServiceNow 集成添加到 Citrix Workspace 微应用以连接到您的应用程序。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。

请按照以下步骤进行操作:

  1. 从概览页面中,选择开始

    此时将打开“管理集成”页面。

  2. 选择添加新集成,然后选择从 Citrix 提供的模板中添加新集成
  3. 选择 ServiceNow 磁贴。
  4. 输入集成的名称。

    ServiceNow 连接器参数、URL、用户名、密码、身份验证方法、连接数

  5. 输入作为必备条件收集的连接器参数
    • 输入您的 URL
    • 输入用户名密码
    • 选择身份验证方法。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。
    • 对于 Oauth 2.0,输入您在必备条件过程中收集的 OAuth 客户端 IDOAuth 客户端密钥
    • 输入 ServiceNow 连接数量的数量。此值确定数据同步启动的字符串数。

      注意: 默认连接数为三个。打开更多连接可减少数据同步的时间,但会增加 微应用服务器上的负载,并会影响其性能。如果您需要,我们建议不超过 10。

    • 如果您希望拥有已关闭请求的列表(例如,或设置为 active = false 的其他数据),请选择下载非活动数据的单选按钮。
  6. 选择添加

微应用集成页面将打开,其中包含您添加的集成及其微应用。在这里,您可以添加另一个集成,继续设置现成的微应用,或者为此集成创建一个新的微应用。

现在,您可以设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到 微应用平台,因此我们建议您使用页面筛选第一次数据同步的实体,以加快同步速度。

有关详细信息,请参阅“配置集成”文章中的验证所需的实体设置数据同步

有关 API 端点和表实体的更多详细信息,请参阅ServiceNow 连接器规格

使用 ServiceNow 微应用

现有的应用程序集成带有现成的微应用。从这些微应用开始,并根据您的需求定制它们。

ServiceNow 微应用

我们基于 Java 的 ServiceNow 集成附带了以下预配置的开箱即用微应用:

审批: 搜索和查看待定审批,并批准或拒绝它们。

通知或页面 用例工作流
新批准请求通知 当将新的批准请求分配给用户时,他们会收到可以批准或拒绝的可操作通知。
批准请求详细信息页面 提供待定批准的可操作视图,以及他们可以批准或拒绝的详细信息。
“待定请求”页 允许用户搜索分配给他们的待定批准。

更改请求: 搜索更改请求、查看更改详细信息、添加注释并更新更新。

通知或页面 用例工作流
更改请求已分配通知 将现有变更请求分配给用户时,用户会收到通知。
更改请求受理人更改通知 当更改请求的受理人更改时,打开请求的用户将收到通知。
更改请求状态更改通知 当更改请求的状态被修改时,打开请求的用户将收到通知。
新的变更请求已分配通知 当向用户分配新的更改请求时,用户将收到通知。
“更改请求详细信息”页面 提供包含详细信息的变更请求的只读视图。
“注释更改请求表单”页 提供对变更请求进行评论的表单。
“我的打开更改请求”页面 允许用户搜索分配给他们的打开的更改请求。
“更新更改请求表单”页 提供用于更新变更请求的表单。

事件: 搜索事件、查看事件详细信息、添加注释并更新事件。

通知或页面 用例工作流
事件分配通知 当将现有事件分配给用户时,用户会收到通知。
事件受理人变更通知 当事件的受理人更改时,打开事件的用户将收到通知。
事件状态更改通知 当事件状态被修改时,打开事件的用户将收到通知。
新事件分配通知 当将新事件分配给用户时,用户会收到通知。
“注释事件表单”页 提供对事件进行评论的表单。
事件详细信息页面 提供具有详细信息的事件的只读视图。
“我的未开放事件”页面 允许用户搜索分配给他们的打开事件。
“更新事件表单”页 提供用于更新事件的表单。

问题: 搜索问题,查看其详细信息,添加注释并更新它们。

通知或页面 用例工作流
新问题分配通知 当将新问题分配给用户时,他们会收到通知。
问题已分配通知 当问题的受让人发生变化时,受让人会收到通知。
问题受理人更改通知 当问题的受让人被更改时,打开问题的用户会收到通知。
问题状态更改通知 当问题的状态被修改时,打开问题的用户会收到通知。
“注释问题表单”页 提供对问题进行评论的表单。
“我的打开问题”页面 允许用户搜索分配给他们的未决问题。
“问题详细信息”页面 提供具有详细信息的问题的只读视图。
“更新问题表单”页 提供用于更新问题的表单。

提交目录请求: 选择物料并提交新的目录请求。

通知或页面 用例工作流
“选择项目”页 允许用户搜索目录并选择可用项目。
“提交目录请求”页面 提供用于提交目录请求的表单。

提交变更请求: 提交新的变更请求。

通知或页面 用例工作流
“提交更改请求”页 提供用于提交变更请求的表单。

提交委托: 提交新委托。

通知或页面 用例工作流
“提交委托”页 提供用于提交新委托的表单。

提交事件: 提交新事件。

通知或页面 用例工作流
“提交事件”页 提供用于提交新事件的表单。

提交问题: 提交新问题。

通知或页面 用例工作流
“提交问题”页面 提供用于提交新问题的表单。