BMC Helix Remedyforce

整合版本：11.0

應用實例

  1. 擷取事件
  2. 執行分類處理動作 (更新/建立/刪除記錄)

如何設定 OAuth 驗證

有時使用使用者名稱 + 密碼的基本驗證方法無法運作。如果帳戶已啟用多重驗證，就可能發生這種情況。在這種情況下，您必須設定 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. 前往「Get OAuth Authorization Code」(取得 OAuth 授權碼) 動作。「重新導向網址」為「回呼網址」。
  10. 執行動作。JSON 結果中會包含授權網址。您需要複製並貼到瀏覽器中。最後，您會遭到重新導向，網址會如下所示： 「https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D」。 您必須複製「code=」後的所有內容，並確保執行網址解碼。%3D 是「=」字元。
  11. 前往「Get OAuth Refresh Token」動作。「重新導向網址」是「回呼網址」，「授權碼」是先前要求中的「code」。
  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 根目錄。

動作

建立記錄

說明

在 BMC Helix Remedyforce 中建立記錄。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
記錄類型 字串 不適用 是 指定要建立的記錄類型。如果不確定有哪些記錄類型，請執行「列出記錄類型」動作。
記錄酬載 JSON

{

"field":"value"

}

 是 指定包含所有必要欄位和值的 JSON 物件。

執行時間

動作不會在實體上執行，也沒有強制輸入參數。

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "id": "0015e000005dVbKAAU",
    "success": true,
    "errors": []
}
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不應失敗，也不應停止劇本執行：
if 201 (is_success = true)：「Successfully created {record type} record in BMC Helix Remedyforce.」(已在 BMC Helix Remedyforce 中成功建立 {record type} 記錄)。

動作應會失敗並停止執行劇本：
如果發生重大錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Create Record". 原因：{0}''.format(error.Stacktrace)

如果為 400：「Error executing action "Create Record". 原因：{message}。

如果找不到記錄類型：執行「建立記錄」動作時發生錯誤。原因：BMC Helix Remedyforce 中找不到「{Record Type}」。請使用「列出記錄類型」動作，取得可用記錄類型清單。

如果 JSON 酬載無效：「Error executing action "Create Record". 原因：參數「Record Payload」中提供的 JSON 酬載無效。請檢查結構。

 一般

刪除記錄

說明

在 BMC Helix Remedyforce 中刪除記錄。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
記錄類型 字串 不適用 是 指定要刪除的記錄類型。如果不確定有哪些記錄類型，請執行「列出記錄類型」動作。
記錄 ID 字串 不適用 是 指定需要刪除的記錄 ID。

執行時間

動作不會在實體上執行，也沒有強制輸入參數。

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項
is_success is_success=False
is_success is_success=True
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不得失敗或停止劇本執行：
如果 204 (is_success = true)：「Successfully deleted {Record Type} record with ID {record id} in BMC Helix Remedyforce.

如果 404 (is_success=true)：「ID 為 {record id} 的『{Record Type}』記錄不存在於 BMC Helix Remedyforce。

動作應會失敗並停止執行應對手冊：

如果發生重大錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『刪除記錄』動作時發生錯誤。原因：{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
}
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不應失敗或停止劇本執行：
如果找到至少一個 (is_success = true)：「Successfully returned results for the query "{query}" in BMC Helix Remedyforce.

如果找不到任何內容(is_success=true)：「在 BMC Helix Remedyforce 中找不到與查詢『{query}』相符的結果」

動作應會失敗並停止執行劇本：
如果發生重大錯誤，例如認證錯誤、無法連線至伺服器或其他錯誤：「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
}
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不應失敗或停止劇本執行：
如果找到至少一個 (is_success = true)：「Successfully returned results for the query "{query}" in BMC Helix Remedyforce.

如果找不到任何內容(is_success=true)：「在 BMC Helix Remedyforce 中找不到與查詢『{query}』相符的結果」

動作應會失敗並停止執行劇本：
如果發生重大錯誤，例如認證錯誤、無法連線至伺服器等：「Error executing action "Execute Simple Query"」。原因：{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
}
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不得失敗或停止劇本執行：
如果至少有一個 ID 的資料可用(is_success = true)：「Successfully returned details regarding record type {Record Type} for the following ids: {record ids}」。

如果至少有一個 ID 沒有資料 (is_success=true)：「Action wasn't able to find details regarding record type {Record Type} for the following ids: {record ids}」(動作無法找到下列 ID 的記錄類型「{Record Type}」詳細資料：{record ids})。

如果並非所有資料都適用 (is_success=false)：系統找不到任何記錄。

動作應會失敗並停止執行劇本：
如果發生重大錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Get Record Details" (執行「取得記錄詳細資料」動作時發生錯誤)。原因：{0}''.format(error.Stacktrace)

如果找不到記錄類型：執行「取得記錄詳細資料」動作時發生錯誤。原因：BMC Helix Remedyforce 中找不到「{Record Type}」。請使用「列出記錄類型」動作，取得可用記錄類型清單。

如果系統找不到「要傳回的欄位」中提供的任何欄位：「執行『取得記錄詳細資料』動作時發生錯誤。原因：找不到任何提供的欄位。請檢查拼字。''

 一般
案件總覽表格

名稱：記錄 {record Id} 詳細資料

欄：

鍵

值

 一般

取得 OAuth 授權碼

說明

在 BMC Helix Remedyforce 中產生 OAuth 授權碼。詳情請參閱說明文件入口網站。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
重新導向網址 字串 https://localhost 是 指定建立「Connector App」時使用的重新導向網址。

執行時間

動作不會在實體上執行，也沒有強制輸入參數。

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項
is_success is_success=False
is_success is_success=True
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

「Successfully generated Authorization code URL in BMC Helix Remedyforce. 請複製並貼到瀏覽器中。然後複製網址中的「code」部分。這個授權碼會用於「取得 OAuth 更新權杖」動作。

 一般
連結

名稱：授權碼連結
網址：{generated link}

取得 OAuth 更新權杖

說明

產生整合設定所需的更新權杖。 您可以使用「取得 OAuth 授權碼」產生授權碼。詳情請參閱說明文件入口網站。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
重新導向網址 字串 https://localhost 是 指定建立「Connector App」時使用的重新導向網址。
授權碼 字串 不適用 是 指定「取得 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"
}
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不應失敗，也不應停止劇本執行：
if 200 (is_success = true): "Successfully generated refresh token in BMC Helix Remedyforce."。

動作應會失敗並停止執行劇本：
如果發生重大錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤： 「Error executing action "Get OAuth Refresh Token". 原因：{0}''.format(error.Stacktrace)

如果狀態碼不是 200：「Error executing action "Get OAuth Refresh Token". 原因：{0}''.format(error_description)

 一般

列出記錄類型

說明

列出 BMC Helix Remedyforce 提供的記錄類型。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
篩選邏輯 DDL

等於

DDL

等於

包含

 否 指定要套用哪些篩選器邏輯。
篩選條件值 字串 不適用 否 指定篩選器中應使用的值。如果選取「等於」，動作會嘗試在記錄類型中尋找完全相符的項目；如果選取「包含」，動作則會嘗試尋找包含該子字串的記錄類型。如果這個參數未提供任何內容，系統就不會套用篩選條件。
要傳回的記錄類型數量上限 整數 50 否 指定要傳回的記錄類型數量。

執行時間

動作不會在實體上執行，也沒有強制輸入參數。

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項
is_success is_success=False
is_success is_success=True
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不應失敗，也不應停止劇本執行：
如果找到至少一個 (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 中提供的條件，找不到任何記錄類型)

動作應會失敗並停止執行劇本：
如果發生重大錯誤，例如憑證有誤、無法連線至伺服器等：「Error executing action "List Record Types". 原因：{0}''.format(error.Stacktrace)

 一般
案件總覽

名稱：可用的記錄類型

欄：

名稱

標籤

自訂

 一般

乒乓

說明

使用 Google Security Operations Marketplace 分頁中整合設定頁面提供的參數，測試與 BMC Helix Remedyforce 的連線。

執行時間

這項操作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項
is_success is_success=False
is_success is_success=True
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不應失敗，也不應停止劇本執行：
如果成功：「Successfully connected to the BMC Helix Remedyforce server with the provided connection parameters!」(已使用提供的連線參數成功連線至 BMC Helix Remedyforce 伺服器！)

動作應會失敗並停止執行劇本：
如果未成功：「Failed to connect to the BMC Helix Remedyforce server! Error is {0}".format(exception.stacktrace)

 一般

更新記錄

說明

更新 BMC Helix Remedyforce 中的記錄。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
記錄類型 字串 不適用 是 指定要更新的記錄類型。如果不確定有哪些記錄類型，請執行「列出記錄類型」動作。
記錄 ID 字串 不適用 是 指定需要更新的記錄 ID。
要更新的欄位 JSON

{

"field":"value"

}

 是 指定 JSON 物件，其中包含所有必要欄位和需要更新的值。

執行時間

動作不會在實體上執行，也沒有強制輸入參數。

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項
is_success is_success=False
is_success is_success=True
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不得失敗或停止劇本執行：
if 204 (is_success = true)：「Successfully updated {record type} record with {record id} in BMC Helix Remedyforce.」。

動作應會失敗並停止執行劇本：
如果發生重大錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Update Record". 原因：{0}''.format(error.Stacktrace)

如果為 404 或 400：「Error executing action "Update Record". 原因：{message}。

如果找不到記錄類型：執行「更新記錄」動作時發生錯誤。原因：BMC Helix Remedyforce 中找不到「{Record Type}」。請使用「列出記錄類型」動作，取得可用記錄類型清單。

如果 JSON 酬載無效：「Error executing action "Update Record". 原因：參數「Fields To Update」(要更新的欄位) 中提供的 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
}
案件總覽
結果類型 值/說明 類型 (實體/一般)
輸出訊息*

動作不應失敗，也不應停止劇本執行：
如果 201 (is_success = true)：「{record type} record with ID {record id} was updated in BMC Helix Remedyforce.」(已在 BMC Helix Remedyforce 中更新 ID 為 {record id} 的 {record type} 記錄)。

如果其中一個欄位未更新，且未啟用「如果逾時則失敗」(is_success=false)：「The following fields were not updated for {record type} record with ID {record id} in BMC Helix Remedyforce: {fields that were not updated}」(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}

動作應會失敗並停止執行劇本：
如果發生重大錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Wait For Fields Update"」。原因：{0}''.format(error.Stacktrace)

如果找不到部分欄位：「執行動作『等待欄位更新』時發生錯誤。原因：記錄結構中找不到下列欄位：{fields that were not found}。

如果找不到記錄類型：執行「等待欄位更新」動作時發生錯誤。原因：BMC Helix Remedyforce 中找不到「{Record Type}」。請使用「列出記錄類型」動作，取得可用記錄類型清單。

如果其中一個欄位未更新，且已啟用「如果逾時則失敗」(is_success=false)：「Error executing action "Wait For Fields Update". 原因：BMC Helix Remedyforce 中 ID 為 {record id} 的「{record type}」記錄未更新下列欄位：{fields that were not updated}。

如果 JSON 酬載無效：「Error executing action "Wait For Fields Update". 原因：參數「Fields To Check」中提供的 JSON 酬載無效。請檢查結構。

 一般

連接器

BMC Helix Remedyforce - Incidents Connector

說明

從 BMC Helix Remedyforce 提取事件相關資訊。

在 Google SecOps 中設定 BMC Helix Remedyforce - Incidents 連接器

如需在 Google SecOps 中設定連接器的詳細操作說明，請參閱設定連接器。

連接器參數

請使用下列參數設定連接器：

參數顯示名稱 類型 預設值 為必填項目 說明
產品欄位名稱 字串 產品名稱 是 輸入來源欄位名稱，即可擷取產品欄位名稱。
事件欄位名稱 字串 BMCServiceDesk__Type__c 是 輸入來源欄位名稱，即可擷取事件欄位名稱。
環境欄位名稱 字串 "" 否

說明儲存環境名稱的欄位名稱。

如果找不到環境欄位，環境就是預設環境。
環境規則運算式模式 字串 .* 否

要對「環境欄位名稱」欄位中的值執行的 regex 模式。

預設值為 .*，可擷取所有內容並傳回未變更的值。

用於允許使用者透過規則運算式邏輯操控環境欄位。

如果 regex 模式為空值或空白，或環境值為空值，最終環境結果就是預設環境。
指令碼逾時 (秒) 整數 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 憑證是否有效。
Proxy 伺服器位址 字串 不適用 否 要使用的 Proxy 伺服器位址。
Proxy 使用者名稱 字串 不適用 否 用於驗證的 Proxy 使用者名稱。
Proxy 密碼 密碼 不適用 否 用於驗證的 Proxy 密碼。
用戶端 ID 字串 不適用 否 已連結應用程式的 BMC Helix Remedyforce 用戶端 ID。OAuth 驗證需要這個參數。注意：這個參數的優先順序高於「使用者名稱 + 密碼」驗證。
用戶端密鑰 密碼 不適用 否 已連線應用程式的 BMC Helix Remedyforce 用戶端密碼。OAuth 驗證需要這個參數。注意：這個參數的優先順序高於「使用者名稱 + 密碼」驗證。
登入 API 根層級 字串 https://login.salesforce.com 是 用於在 BMC Helix Remedyforce 中驗證的 API 根目錄。

連接器規則

Proxy 支援

連接器支援 Proxy。

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求答案。