BMC Helix Remedyforce

集成版本：11.0

使用场景

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

如何配置 OAuth 身份验证

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

步骤：

  1. 依次前往“设置”>“应用管理器”。
  2. 按“New Connected App”按钮。
  3. 提供“关联的应用名称”“API 名称”和“联系人电子邮件地址”。
  4. “Enable OAuth Settings”应设置为 true。
  5. 将“回调网址”设置为“https://localhost”。
  6. 添加了“full”和“refresh_token”范围。访问 API 时需要同时提供这两者。
  7. 保存应用。
  8. 打开应用配置，然后复制“使用方密钥”和“使用方密文”。 在集成配置中，“使用方密钥”是“客户端 ID”，而“使用方密钥令牌”是“客户端密钥”。
  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 执行：
如果为 201（is_success = true）：“Successfully created {record type} record in BMC Helix Remedyforce.”。

操作应失败并停止 playbook 执行：
如果出现致命错误，例如凭据错误、无法连接到服务器等：“执行操作‘创建记录’时出错。”原因：{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）：“ID 为 {record id} 的{记录类型}记录在 BMC Helix Remedyforce 中不存在。

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

如果出现严重错误，例如凭据错误、无法连接到服务器、其他错误：“执行操作‘删除记录’时出错。原因：{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 执行：
如果出现致命错误，例如凭据错误、无法连接到服务器、其他错误：“Error executing action "Execute Custom Query".”原因：{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 执行：
如果出现致命错误，例如凭据错误、无法连接到服务器等：“执行操作‘执行简单查询’时出错。”原因：{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）：“Successfully returned details regarding record type {Record Type} for the following ids: {record ids}”（已成功返回以下 ID 的记录类型 {Record Type} 的详细信息：{record ids}）。

如果至少有一个 ID 没有数据（is_success=true）：“操作无法找到以下 ID 对应的记录类型 {Record Type} 的详细信息：{record ids}”。

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

操作应失败并停止 playbook 执行：
如果出现致命错误，例如凭据错误、无法连接到服务器等：“Error executing action "Get Record Details".”（执行“获取记录详情”操作时出错。）原因：{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 执行：

“已在 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）：“Successfully generated refresh token in BMC Helix Remedyforce.”。

如果出现致命错误（例如凭据错误、无法连接到服务器等），操作应失败并停止 playbook 执行：
“执行操作‘获取 OAuth 刷新令牌’时出错。原因：{0}''.format(error.Stacktrace)

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

 常规

列出记录类型

说明

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

参数

参数显示名称 类型 默认值 是否为必需属性 说明
过滤逻辑 DDL

等于

DDL

等于

包含

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

运行于

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

操作执行结果

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

该操作不应失败，也不应停止 playbook 执行：
如果找到至少一个（is_success = true）：“Successfully listed available record types based on the provided criteria in BMC Helix Remedyforce.

如果未找到任何内容（is_success=true）：“No record types were found based on the provided criteria in BMC Helix Remedyforce”（未在 BMC Helix Remedyforce 中找到符合所提供条件的记录类型）

操作应失败并停止 playbook 执行：
如果出现致命错误，例如凭据错误、无法连接到服务器等：“Error executing action "List Record Types". 原因：{0}''.format(error.Stacktrace)

 常规
案例墙

名称：可用的记录类型

列：

名称

标签

自定义

 常规

Ping

说明

使用 Google Security Operations Marketplace 标签页中的集成配置页面上提供的参数，测试与 BMC Helix Remedyforce 的连接。

运行于

此操作不会在实体上运行。

操作执行结果

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

操作不应失败，也不应停止 playbook 执行：
如果成功：“Successfully connected to the BMC Helix Remedyforce server with the provided connection parameters!”

操作应失败并停止 playbook 执行：
如果不成功：“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)：“Successfully updated {record type} record with {record id} in BMC Helix Remedyforce.”。

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

如果显示 404 或 400：“Error executing action "Update Record". 原因：{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)：“{record type} record with ID {record id} was updated in 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 执行：
如果出现致命错误（例如凭据错误、无法连接到服务器、其他错误）：“执行操作‘等待字段更新’时出错。”原因：{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 - 突发事件连接器

说明

从 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 突发事件、服务请求 否 事件的类型过滤条件。如果未提供任何内容，连接器将注入所有突发事件。示例：突发事件、服务请求。
回溯的小时数上限 整数 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 专业人士那里获得解答。