BMC Helix Remedyforce

本文档介绍了如何将 BMC Helix Remedyforce 与 Google Security Operations 集成。

使用场景

  1. 执行突发事件提取
  2. 执行分类操作（更新/创建/删除记录）

如何配置 OAuth 身份验证

有时，使用用户名 + 密码的基本身份验证方法无法正常运行。如果账号启用了 MFA，就可能会出现这种情况。在这些情况下，您需要配置 OAuth 身份验证。

步骤：

  1. 依次前往“设置”->“应用管理器”。
  2. 按“New Connected App”（新建关联的应用）按钮。
  3. 提供“Connected App Name”（关联的应用名称）、“API Name”（API 名称）、“Contact Email”（联系邮箱）。
  4. “Enable OAuth Settings”（启用 OAuth 设置）应设为 true。
  5. 将“Callback URL”（回调网址）设置为“https://localhost”。
  6. 添加“full”和“refresh_token”范围。两者都是访问 API 所必需的。
  7. 保存应用。
  8. 打开应用配置，然后复制“使用方密钥”和“使用方密文”。 在集成配置中，“使用方密钥”是“客户端 ID”，“使用方 Secret”是“客户端 Secret”。
  9. 前往“获取 OAuth 授权代码”操作。“重定向网址”是“回调网址”。
  10. 执行操作。在 JSON 结果中，您将获得一个授权网址。您需要将其复制并粘贴到浏览器中。最后，您将被重定向，并且您的网址将如下所示： “https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D”。 您需要复制“code=”后面的所有内容，并确保执行网址解码。%3D 是“=”字符。
  11. 前往“获取 OAuth 刷新令牌”操作。“重定向网址”是“回调网址”，“授权代码”是上一个请求中的“代码”。
  12. 如果一切操作正确，您将在 JSON 结果中看到“refresh_token”。
  13. 将此刷新令牌复制到集成配置中，然后执行测试运行。

在 Google Security Operations 中配置 BMC Helix Remedyforce 集成

有关如何在 Google SecOps 中配置集成的详细说明，请参阅配置集成。

集成参数

使用以下参数配置集成：

参数显示名称 类型 默认值 为必填项 说明
API 根 字符串 https://.my.salesforce.com 是 BMC Helix Remedyforce 实例的 API 根。
用户名 字符串 不适用 否 BMC Helix Remedyforce 用户名。
密码 密码 不适用 否 BMC Helix Remedyforce 密码。
客户端 ID 字符串 不适用 否 所连接应用的 BMC Helix Remedyforce 客户端 ID。此参数是 OAuth 身份验证所必需的。注意：此参数的优先级高于“用户名 + 密码”身份验证。
客户端密钥 密码 不适用 否 关联应用的 BMC Helix Remedyforce 客户端密钥。此参数是 OAuth 身份验证所必需的。注意：此参数的优先级高于“用户名 + 密码”身份验证。
刷新令牌 密码 不适用 否 OAuth 授权的刷新令牌。
验证 SSL 复选框 勾选 是 如果启用，系统会验证与 BMC Helix Remedyforce 服务器连接的 SSL 证书是否有效。
登录 API 根地址 字符串 https://login.salesforce.com 是 用于在 BMC Helix Remedyforce 中进行身份验证的 API 根。

操作

Create Record

说明

在 BMC Helix Remedyforce 中创建记录。

参数

参数显示名称 类型 默认值 为必填项 说明
记录类型 字符串 不适用 是 指定需要创建的记录的类型。如果您不知道有哪些类型的记录，请执行“列出记录类型”操作。
记录载荷 JSON

{

"field":"value"

}

 是 指定一个包含所有所需字段和值的 JSON 对象。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
JSON 结果
{
    "id": "0015e000005dVbKAAU",
    "success": true,
    "errors": []
}
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

该操作不应失败，也不应停止 playbook 执行：
if 201 (is_success = true): "Successfully created {record type} record in BMC Helix Remedyforce.".

操作应失败并停止执行 playbook：
如果发生严重错误，例如凭据错误、无法连接到服务器等：“执行‘创建记录’操作时出错。Reason: {0}''.format(error.Stacktrace)

如果为 400：“执行‘创建记录’操作时出错。原因：{message}。

如果未找到记录类型：执行“创建记录”操作时出错。原因：在 BMC Helix Remedyforce 中找不到 {Record Type}。请使用“列出记录类型”操作获取可用记录类型的列表。

如果 JSON 载荷无效：“执行‘创建记录’操作时出错。原因：在“记录载荷”参数中提供了无效的 JSON 载荷。请检查结构。

 常规

删除记录

说明

删除 BMC Helix Remedyforce 中的记录。

参数

参数显示名称 类型 默认值 为必填项 说明
记录类型 字符串 不适用 是 指定需要删除的记录的类型。如果您不知道有哪些类型的记录，请执行“列出记录类型”操作。
记录 ID 字符串 不适用 是 指定需要删除的记录的 ID。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

该操作不应失败，也不应停止 playbook 执行：
如果为 204 (is_success = true)：“已成功删除 BMC Helix Remedyforce 中 ID 为 {record id} 的 {Record Type} 记录。

如果为 404 (is_success=true)：“BMC Helix Remedyforce 中不存在 ID 为 {record id} 的 {Record Type} 记录。

操作应失败并停止 playbook 执行：

如果发生严重错误，例如凭据错误、无法连接到服务器等：“执行‘删除记录’操作时出错。Reason: {0}''.format(error.Stacktrace)

如果未找到记录类型：执行“删除记录”操作时出错。原因：在 BMC Helix Remedyforce 中找不到 {Record Type}。请使用“列出记录类型”操作获取可用记录类型的列表。

 常规

执行自定义查询

说明

在 BMC Helix Remedyforce 中执行自定义 SOQL 查询。

参数

参数显示名称 类型 默认值 为必填项 说明
SOQL 查询 字符串 不适用 是 指定应执行的查询。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
JSON 结果
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "OwnerId": "00G5e000001mqf7EAA",
    "IsDeleted": false,
    "Name": "00000002",
    "CreatedDate": "2021-05-10T19:00:26.000+0000",
    "CreatedById": "0055e000001zFloAAE",
    "LastModifiedDate": "2021-05-10T19:00:26.000+0000",
    "LastModifiedById": "0055e000001zFloAAE",
    "SystemModstamp": "2021-05-10T19:00:26.000+0000",
    "LastActivityDate": null,
    "LastViewedDate": "2021-05-14T10:26:38.000+0000",
    "LastReferencedDate": "2021-05-14T10:26:38.000+0000",
    "BMCServiceDesk__ACApprovalStatus__c": null,
    "BMCServiceDesk__ACSeverity__c": null,
    "BMCServiceDesk__Actual_Outage_Time_Hours__c": 0.0,
    "BMCServiceDesk__Additional_email_information__c": null,
    "BMCServiceDesk__AllTaskCloseController__c": false,
    "BMCServiceDesk__Approved__c": false,
    "BMCServiceDesk__BLANK__c": null,
    "BMCServiceDesk__Category_ID__c": "Hardware",
    "BMCServiceDesk__RecurringParentRecordId__c": null,
    "BMCServiceDesk__RequestDetailCloneId__c": null,
    "BMCServiceDesk__VIP_Client__c": "-",
    "BMCServiceDesk__WorkflowController__c": null,
    "BMCServiceDesk__actualDuration__c": null,
    "BMCServiceDesk__actualOutageDuration__c": null,
    "BMCServiceDesk__call__c": 1.0,
    "BMCServiceDesk__clientEmail__c": "bmcremedyforcetrial@example.com",
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

该操作不应失败，也不应停止 playbook 执行：
如果至少找到一个 (is_success = true)：“已成功返回 BMC Helix Remedyforce 中查询‘{query}’的结果。

如果未找到任何内容(is_success=true)：“在 BMC Helix Remedyforce 中未找到与查询‘{query}’相符的结果”

操作应失败并停止 Playbook 执行：
如果发生严重错误，例如凭据错误、无法连接到服务器等：“执行操作‘执行自定义查询’时出错。Reason: {0}''.format(error.Stacktrace)

 常规
案例墙 名称：结果 常规

执行简单查询

说明

在 BMC Helix Remedyforce 中根据参数执行 SOQL 查询。

参数

参数显示名称 类型 默认值 为必填项 说明
记录类型 字符串 不适用 是 指定应查询哪种记录类型。
Where 过滤条件 字符串 不适用 否 为需要执行的查询指定 WHERE 过滤条件。注意：您无需提供时间过滤条件、限制和排序。此外，您无需在载荷中提供 WHERE 字符串。
时间范围 DDL

过去 1 小时

可能的值：

过去 1 小时

过去 6 小时

过去 24 小时

上周

上个月

自定义

 否 指定结果的时间范围。如果选择“自定义”，您还需要提供“开始时间”。
开始时间 字符串 不适用 否 指定结果的开始时间。如果为“时间范围”参数选择了“自定义”，则此参数是必需的。格式：ISO 8601
结束时间 字符串 不适用 否 指定结果的结束时间。格式：ISO 8601。如果未提供任何内容，并且为“时间范围”参数选择了“自定义”，则此参数将使用当前时间。
要返回的字段 CSV 不适用 否 指定要返回的字段。如果未提供任何内容，操作将返回所有字段。
排序字段 字符串 CreatedDate 否 指定应使用哪个参数进行排序。
排列顺序 DDL

升序

可能的值：

升序

降序

 否 指定排序顺序。
返回的结果数上限 整数 50 否 指定要返回的结果数量。默认值：50。最大值为 200。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
JSON 结果
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "OwnerId": "00G5e000001mqf7EAA",
    "IsDeleted": false,
    "Name": "00000002",
    "CreatedDate": "2021-05-10T19:00:26.000+0000",
    "CreatedById": "0055e000001zFloAAE",
    "LastModifiedDate": "2021-05-10T19:00:26.000+0000",
    "LastModifiedById": "0055e000001zFloAAE",
    "SystemModstamp": "2021-05-10T19:00:26.000+0000",
    "LastActivityDate": null,
    "LastViewedDate": "2021-05-14T10:26:38.000+0000",
    "LastReferencedDate": "2021-05-14T10:26:38.000+0000",
    "BMCServiceDesk__ACApprovalStatus__c": null,
    "BMCServiceDesk__ACSeverity__c": null,
    "BMCServiceDesk__Actual_Outage_Time_Hours__c": 0.0,
    "BMCServiceDesk__Additional_email_information__c": null,
    "BMCServiceDesk__AllTaskCloseController__c": false,
    "BMCServiceDesk__Approved__c": false,
    "BMCServiceDesk__BLANK__c": null,
    "BMCServiceDesk__Category_ID__c": "Hardware",
    "BMCServiceDesk__RecurringParentRecordId__c": null,
    "BMCServiceDesk__RequestDetailCloneId__c": null,
    "BMCServiceDesk__VIP_Client__c": "-",
    "BMCServiceDesk__WorkflowController__c": null,
    "BMCServiceDesk__actualDuration__c": null,
    "BMCServiceDesk__actualOutageDuration__c": null,
    "BMCServiceDesk__call__c": 1.0,
    "BMCServiceDesk__clientEmail__c": "bmcremedyforcetrial@example.com",
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

该操作不应失败，也不应停止 playbook 执行：
如果至少找到一个 (is_success = true)：“已成功返回 BMC Helix Remedyforce 中查询‘{query}’的结果。

如果未找到任何内容(is_success=true)：“在 BMC Helix Remedyforce 中未找到与查询‘{query}’相符的结果”

操作应失败并停止 playbook 执行：
如果发生严重错误，例如凭据错误、无法连接到服务器等：“执行‘执行简单查询’操作时出错。Reason: {0}''.format(error.Stacktrace)

 常规
案例墙 名称：结果 常规

获取记录详情

说明

从 BMC Helix Remedyforce 获取有关记录的详细信息。

参数

参数显示名称 类型 默认值 为必填项 说明
记录类型 字符串 不适用 是 指定要检索其详细信息的记录类型。如果您不知道有哪些类型的记录，请执行“列出记录类型”操作。
记录 ID CSV 不适用 是 指定要返回其详细信息的记录的 ID。
要返回的字段 CSV 不适用 否 指定要返回的字段。如果未找到任何提供的字段，操作将失败。如果未提供任何内容，操作将返回所有字段。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
JSON 结果
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "OwnerId": "00G5e000001mqf7EAA",
    "IsDeleted": false,
    "Name": "00000002",
    "CreatedDate": "2021-05-10T19:00:26.000+0000",
    "CreatedById": "0055e000001zFloAAE",
    "LastModifiedDate": "2021-05-10T19:00:26.000+0000",
    "LastModifiedById": "0055e000001zFloAAE",
    "BMCServiceDesk__Total_Duration__c": 0.0,
    "BMCServiceDesk__Incorrect_category__c": false,
    "Client_VIP__c": false,
    "BMCServiceDesk__Incorrect_owner__c": false,
    "BMCServiceDesk__LockedRecordTimestamp__c": null,
    "BMCServiceDesk__Queue__c": "Incident Queue",
    "BMCServiceDesk__Reassigned_Count__c": null,
    "BMCServiceDesk__isServiceRequest__c": false,
    "BMCServiceDesk__Approval_Status__c": null,
    "Alternate_Contact_Name__c": null,
    "Alternate_Contact_Number__c": null,
    "Client_Phone__c": null,
    "External_Ticket_Ref__c": null,
    "Affected_Application__c": null,
    "Affected_Hardware__c": null,
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

操作不应失败，也不应停止 playbook 执行：
如果至少有一个 ID 有可用数据(is_success = true)：“已成功返回以下 ID 的记录类型 {Record Type} 的详细信息：{record ids}”。

如果至少有一个 ID 没有可用数据 (is_success=true)：“Action 无法找到以下 ID 的记录类型 {Record Type} 的详细信息：{record ids}”。

如果所有数据都不可用 (is_success=false)：未找到任何记录。

操作应失败并停止 playbook 执行：
如果出现严重错误，例如凭据错误、无法连接到服务器等：“执行操作‘获取记录详细信息’时出错。Reason: {0}''.format(error.Stacktrace)

如果未找到记录类型：执行“获取记录详情”操作时出错。原因：在 BMC Helix Remedyforce 中找不到 {Record Type}。请使用“列出记录类型”操作获取可用记录类型的列表。

如果未找到“要返回的字段”中提供的任何字段：“执行‘获取记录详情’操作时出错。原因：未找到任何提供的字段。请检查拼写。''

 常规
案例墙表格

名称：记录 {record Id} 详细信息

列：

键

值

 常规

获取 OAuth 授权代码

说明

在 BMC Helix Remedyforce 中生成 OAuth 授权代码。如需了解详情，请参阅文档门户。

参数

参数显示名称 类型 默认值 为必填项 说明
重定向网址 字符串 https://localhost 是 指定创建“连接器应用”时使用的重定向网址。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

操作不应失败，也不应停止 playbook 执行：

"Successfully generated Authorization code URL in BMC Helix Remedyforce. 请将其复制并粘贴到浏览器中。然后，从网址中复制“code”部分。此授权代码用于“获取 OAuth 刷新令牌”操作。

 常规
链接

名称：授权代码链接
网址：{生成的链接}

获取 OAuth 刷新令牌

说明

生成集成配置所需的刷新令牌。 您可以使用“获取 OAuth 授权代码”生成授权代码。如需了解详情，请参阅文档门户。

参数

参数显示名称 类型 默认值 为必填项 说明
重定向网址 字符串 https://localhost 是 指定创建“连接器应用”时使用的重定向网址。
授权代码 字符串 不适用 是 指定“获取 OAuth 授权代码”操作中的授权代码。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
JSON 结果
{
    "access_token": "00D090000083B1p!ARkAQHJhzO.oDwNuldyoWlNDlLV9805VyWlZmcBvMF7qetVGpQWXi6pND0riSCiFs4fnrxmuVjBv.Io..ooN_JAIlGdGT_Gk",
    "signature": "6+xAwCccuYI0ivDbXtZzlguynNuKGRHaj+HpyZXM6ms=",
    "scope": "refresh_token api full",
    "instance_url": "https://202107220535170700.my.salesforce.com",
    "id": "https://login.salesforce.com/id/00D090000083B1pEAE/00509000007hMVJAA2",
    "token_type": "Bearer",
    "issued_at": "1626958668640"
}
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

该操作不应失败，也不应停止 playbook 执行：
如果为 200 (is_success = true)：“已在 BMC Helix Remedyforce 中成功生成刷新令牌。”

操作应失败并停止执行 playbook：
如果发生严重错误，例如凭证错误、无法连接到服务器等：“执行操作‘获取 OAuth 刷新令牌’时出错。Reason: {0}''.format(error.Stacktrace)

如果状态代码不是 200：“执行‘获取 OAuth 刷新令牌’操作时出错。Reason: {0}''.format(error_description)

 常规

列出记录类型

说明

列出 BMC Helix Remedyforce 中的可用记录类型。

参数

参数显示名称 类型 默认值 为必填项 说明
过滤逻辑 DDL

等于

DDL

等于

包含

 否 指定应应用哪种过滤逻辑。
过滤值 字符串 不适用 否 指定应在过滤条件中使用哪个值。如果选择“等于”，操作将尝试在记录类型中查找完全匹配项；如果选择“包含”，操作将尝试查找包含该子字符串的记录类型。如果此参数中未提供任何内容，则不会应用过滤条件。
要返回的记录类型数上限 整数 50 否 指定要返回的记录类型数量。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

该操作不应失败，也不应停止 playbook 执行：
如果至少找到一个 (is_success = true)：“已成功根据 BMC Helix Remedyforce 中提供的条件列出可用的记录类型。

如果未找到任何内容(is_success=true)：“在 BMC Helix Remedyforce 中，未找到与所提供条件相符的记录类型”

操作应失败并停止 playbook 执行：
如果出现严重错误，例如凭据错误、无法连接到服务器等：“执行操作‘列出记录类型’时出错。Reason: {0}''.format(error.Stacktrace)

 常规
案例墙

名称：Available Record Types

列：

名称

标签

自定义

 常规

Ping

说明

使用 Google SecOps Content Hub 页面中的集成配置页面上提供的参数，测试与 BMC Helix Remedyforce 的连接。

运行时间

此操作不会对实体执行。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

该操作不应失败，也不应停止 playbook 执行：
如果成功：“已使用提供的连接参数成功连接到 BMC Helix Remedyforce 服务器！”

该操作应失败并停止 playbook 执行：
if not successful: "Failed to connect to the BMC Helix Remedyforce server! 错误为 {0}”。format(exception.stacktrace)

 常规

更新记录

说明

更新 BMC Helix Remedyforce 中的记录。

参数

参数显示名称 类型 默认值 为必填项 说明
记录类型 字符串 不适用 是 指定需要更新的记录类型。如果您不知道有哪些类型的记录，请执行“列出记录类型”操作。
记录 ID 字符串 不适用 是 指定需要更新的记录的 ID。
要更新的字段 JSON

{

"field":"value"

}

 是 指定一个 JSON 对象，其中包含需要更新的所有字段和值。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

该操作不应失败，也不应停止 playbook 执行：
如果为 204 (is_success = true)：“已在 BMC Helix Remedyforce 中成功更新 ID 为 {record id} 的 {record type} 记录。”

操作应失败并停止执行 playbook：
如果发生严重错误，例如凭据错误、无法连接到服务器等：“执行‘更新记录’操作时出错。Reason: {0}''.format(error.Stacktrace)

如果为 404 或 400：“执行‘更新记录’操作时出错。原因：{message}。

如果未找到记录类型：执行“更新记录”操作时出错。原因：在 BMC Helix Remedyforce 中找不到 {Record Type}。请使用“列出记录类型”操作获取可用记录类型的列表。

如果 JSON 载荷无效：“执行‘更新记录’操作时出错。原因：在“要更新的字段”参数中提供了无效的 JSON 载荷。请检查结构。

 常规

等待字段更新

说明

等待 BMC Helix Remedyforce 中的字段更新。

参数

参数显示名称 类型 默认值 为必填项 说明
记录类型 字符串 不适用 是 指定您要等待更新的记录类型。如果您不知道有哪些类型的记录，请执行“列出记录类型”操作。
记录 ID 字符串 不适用 是 指定需要更新的记录的 ID。
要检查的字段 JSON

{

"field":"value"

}

 是 指定一个包含所有所需字段和值的 JSON 对象。
超时则失败 复选框 勾选 是 如果启用，则在未更新所有字段的情况下，操作将失败。

运行时间

该操作不会对实体执行，也没有强制性输入参数。

操作执行结果

脚本结果
脚本结果名称 值选项
is_success is_success=False
is_success is_success=True
JSON 结果
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "BMCServiceDesk__FKImpact__c": "a2M5e000000l1HxEAI",
    "BMCServiceDesk__FKIncident__c": null,
    "BMCServiceDesk__FKLead__c": null,
    "BMCServiceDesk__FKOpenBy__c": "0055e000001zFloAAE",
    "BMCServiceDesk__FKPriority__c": "a2h5e000000nHTnAAM",
    "BMCServiceDesk__FKRequestDefinition__c": null,
    "BMCServiceDesk__FKRequestDetail__c": null,
    "BMCServiceDesk__FKServiceOffering__c": null,
    "BMCServiceDesk__FKStatus__c": "a3w5e000000U1xcAAC",
    "BMCServiceDesk__FKTemplate__c": null,
    "BMCServiceDesk__actualOutageDuration__c": null,
    "BMCServiceDesk__call__c": 1.0,
    "Client_VIP__c": false,
    "BMCServiceDesk__Incorrect_owner__c": false,
    "BMCServiceDesk__LockedRecordTimestamp__c": null,
    "BMCServiceDesk__Queue__c": "Incident Queue",
    "BMCServiceDesk__Reassigned_Count__c": null,
    "BMCServiceDesk__isServiceRequest__c": false,
    "BMCServiceDesk__Approval_Status__c": null,
    "Alternate_Contact_Name__c": null,
    "Alternate_Contact_Number__c": null,
    "Client_Phone__c": null,
    "External_Ticket_Ref__c": null,
    "Affected_Application__c": null,
    "Affected_Hardware__c": null,
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
案例墙
结果类型 值/说明 类型（实体 \ 常规）
输出消息*

该操作不应失败，也不应停止 playbook 执行：
如果为 201 (is_success = true)：“ID 为 {record id} 的 {record type} 记录已在 BMC Helix Remedyforce 中更新。”

如果其中一个字段未更新，并且未启用“超时则失败”(is_success=false)：“BMC Helix Remedyforce 中 ID 为 {record id} 的 {record type} 记录的以下字段未更新：{fields that were not updated}”

异步消息：正在等待 BMC Helix Remedyforce 中 ID 为 {record id} 的 {record type} 记录更新以下字段：{fields that were not updated}

操作应失败并停止 playbook 执行：
如果发生严重错误，例如凭据错误、无法连接到服务器等：“执行操作‘等待字段更新’时出错。Reason: {0}''.format(error.Stacktrace)

如果未找到某些字段：“执行‘等待字段更新’操作时出错。原因：在记录结构中找不到以下字段：{fields that were not found}。

如果未找到记录类型：执行“等待字段更新”操作时出错。原因：在 BMC Helix Remedyforce 中找不到 {Record Type}。请使用“列出记录类型”操作获取可用记录类型的列表。

如果其中一个字段未更新，并且“超时则失败”已启用 (is_success=false)：“执行‘等待字段更新’操作时出错。原因：在 BMC Helix Remedyforce 中，未针对 ID 为 {record id} 的 {record type} 记录更新以下字段：{fields that were not updated}”

如果 JSON 载荷无效：“执行‘等待字段更新’操作时出错。原因：在“要检查的字段”参数中提供了无效的 JSON 载荷。请检查结构。

 常规

连接器

BMC Helix Remedyforce - Incidents Connector

说明

从 BMC Helix Remedyforce 中拉取突发事件的相关信息。

在 Google SecOps 中配置 BMC Helix Remedyforce - Incidents 连接器

如需详细了解如何在 Google SecOps 中配置连接器，请参阅配置连接器。

连接器参数

使用以下参数配置连接器：

参数显示名称 类型 默认值 为必填项 说明
产品字段名称 字符串 产品名称 是 输入源字段名称，以便检索产品字段名称。
事件字段名称 字符串 BMCServiceDesk__Type__c 是 输入源字段名称，以检索事件字段名称。
环境字段名称 字符串 "" 否

描述存储环境名称的字段的名称。

如果未找到环境字段，则环境为默认环境。
环境正则表达式模式 字符串 .* 否

要对“环境字段名称”字段中的值运行的正则表达式模式。

默认值为 .*，用于捕获所有值并返回未更改的值。

用于允许用户通过正则表达式逻辑操作环境字段。

如果正则表达式模式为 null 或空，或者环境值为 null，则最终环境结果为默认环境。
脚本超时（秒） 整数 180 是 运行当前脚本的 Python 进程的超时限制。
API 根 字符串 https://.my.salesforce.com 是 BMC Helix Remedyforce 实例的 API 根。
用户名 字符串 不适用 是 BMC Helix Remedyforce 用户名。
密码 密码 不适用 是 BMC Helix Remedyforce 密码。
要提取的最低优先级 整数 5 否 用于提取突发事件的最低优先级。最多：5 张。最小值：1。如果未提供任何内容，连接器将注入所有突发事件。
注入优先级为空的突发事件 复选框 勾选 否 如果启用，连接器将提取没有优先级的突发事件。以这种方式创建的 Google SecOps 提醒的优先级将设置为“信息性”
类型过滤条件 CSV Incident,Service Request 否 突发事件的类型过滤条件。如果未提供任何内容，连接器将注入所有突发事件。示例：突发事件、服务约叫。
回溯的小时数上限 整数 1 否 提取突发事件的小时数。
要提取的突发事件数上限 整数 10 否 每次连接器迭代要处理的突发事件数量。最大值为 200。
将白名单用作黑名单 复选框 勾选 是 如果启用，白名单将用作黑名单。
验证 SSL 复选框 勾选 是 如果已启用，请验证与 BMC Helix Remedyforce 服务器的连接所使用的 SSL 证书是否有效。
代理服务器地址 字符串 不适用 否 要使用的代理服务器的地址。
代理用户名 字符串 不适用 否 用于进行身份验证的代理用户名。
代理密码 密码 不适用 否 用于进行身份验证的代理密码。
客户端 ID 字符串 不适用 否 所连接应用的 BMC Helix Remedyforce 客户端 ID。此参数是 OAuth 身份验证所必需的。注意：此参数的优先级高于“用户名 + 密码”身份验证。
客户端密钥 密码 不适用 否 关联应用的 BMC Helix Remedyforce 客户端密钥。此参数是 OAuth 身份验证所必需的。注意：此参数的优先级高于“用户名 + 密码”身份验证。
登录 API 根地址 字符串 https://login.salesforce.com 是 用于在 BMC Helix Remedyforce 中进行身份验证的 API 根。

连接器规则

代理支持

连接器支持代理。

需要更多帮助？获得社区成员和 Google SecOps 专业人士的解答。