本頁面由 Cloud Translation API 翻譯而成。

BMC Remedy ITSM

整合版本：4.0

在 Google Security Operations 中設定 BMC Remedy ITSM 整合

如需在 Google SecOps 中設定整合功能的詳細操作說明，請參閱「設定整合功能」。

整合參數

請使用下列參數設定整合：

參數顯示名稱	類型	預設值	為必填項目	說明
API 根層級	字串	https://{IP}:{port}	是	BMC Remedy ITSM 執行個體的 API 根目錄。
使用者名稱	字串	不適用	否	BMC Remedy ITSM 使用者名稱。
密碼	密碼	不適用	否	BMC Remedy ITSM 密碼。
驗證 SSL	核取方塊	已勾選	是	如果已啟用，請確認連線至 BMC Remedy ITSM 伺服器的 SSL 憑證是否有效。

應用實例

執行分類處理動作 (更新/建立/刪除記錄)

動作

乒乓

說明

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

執行時間

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功：「Successfully connected to the BMC Remedy ITSM server with the provided connection parameters!」(已使用提供的連線參數，成功連線至 BMC Remedy ITSM 伺服器！) 動作應會失敗並停止執行應對手冊：如果未成功：「Failed to connect to the BMC Remedy ITSM server! Error is {0}".format(exception.stacktrace)	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果成功：「Successfully connected to the BMC Remedy ITSM server with the provided connection parameters!」(已使用提供的連線參數，成功連線至 BMC Remedy ITSM 伺服器！)

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

如果未成功：「Failed to connect to the BMC Remedy ITSM server! Error is {0}".format(exception.stacktrace)

一般

取得記錄詳細資料

說明

從 BMC Remedy ITSM 取得記錄的詳細資訊。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
記錄類型	字串	不適用	是	指定要擷取詳細資料的記錄類型。
記錄 ID	CSV	不適用	是	指定要傳回詳細資料的記錄 ID。
要傳回的欄位	CSV	不適用	否	指定要傳回的欄位。如果提供的欄位無效，動作就會失敗。如未提供任何內容，動作會傳回所有欄位。

參數顯示名稱

類型

預設值

為必填項目

說明

記錄類型

字串

不適用

是

指定要擷取詳細資料的記錄類型。

記錄 ID

CSV

不適用

是

指定要傳回詳細資料的記錄 ID。

要傳回的欄位

CSV

不適用

否

指定要傳回的欄位。

如果提供的欄位無效，動作就會失敗。如未提供任何內容，動作會傳回所有欄位。

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

[
    {
        "Request ID": "X|X",
        "Submitter": "Remedy Application Service"
    },
    {
        "Request ID": "X|X",
        "Submitter": "Remedy Application Service"
    },
    {
        "Request ID": "X|X",
        "Submitter": "Remedy Application Service"
    }
]

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果至少有一個 ID 的資料可用 (is_success=true)：「Successfully returned details regarding record type {Record Type} in BMC Remedy ITSM for the following ids: {record ids}」(已成功傳回 BMC Remedy ITSM 中下列 ID 的記錄類型「{Record Type}」詳細資料：{record ids})。如果至少有一個 ID 沒有資料 (is_success=true)：「Action wasn't able to find details regarding record type {Record Type} in BMC Remedy ITSM for the following ids: {record ids}」。如果所有資料都無法使用 (is_success=false)：「找不到任何記錄」。動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『取得記錄詳細資料』動作時發生錯誤。原因：{0}''.format(error.Stacktrace) 如果為 400：「Error executing action "Get Record Details". 原因：{0}''.format(messageText)	一般
案件總覽表格	表格名稱：記錄「{記錄 ID}」詳細資料資料表資料欄：鍵值	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果至少有一個 ID 的資料可用 (is_success=true)：「Successfully returned details regarding record type {Record Type} in BMC Remedy ITSM for the following ids: {record ids}」(已成功傳回 BMC Remedy ITSM 中下列 ID 的記錄類型「{Record Type}」詳細資料：{record ids})。

如果至少有一個 ID 沒有資料 (is_success=true)：「Action wasn't able to find details regarding record type {Record Type} in BMC Remedy ITSM for the following ids: {record ids}」。

如果所有資料都無法使用 (is_success=false)：「找不到任何記錄」。

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

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『取得記錄詳細資料』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

如果為 400：「Error executing action "Get Record Details". 原因：{0}''.format(messageText)

一般

案件總覽表格

表格名稱：記錄「{記錄 ID}」詳細資料

資料表資料欄：

一般

更新記錄

說明

更新 BMC Remedy ITSM 中的記錄。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
記錄類型	字串	不適用	是	指定要更新的記錄類型。
記錄 ID	字串	不適用	是	指定需要更新的記錄 ID。
要更新的欄位	JSON	{ "field":"value" }	是	指定 JSON 物件，其中包含所有需要更新的必要欄位和值。

參數顯示名稱

類型

預設值

為必填項目

說明

記錄類型

字串

不適用

是

指定要更新的記錄類型。

記錄 ID

字串

不適用

是

指定需要更新的記錄 ID。

要更新的欄位

JSON

{

"field":"value"

}

是

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

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果系統回報 204 狀態碼 (is_success=true)：「Successfully updated {record type} record with {record id} in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功更新 {record id} 的 {record type} 記錄)。動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『更新記錄』動作時發生錯誤。原因：{0}''.format(error.Stacktrace) 如果系統回報 404、400 或 500 狀態碼：「Error executing action "Update Record". 原因：{messageText}{messageAppendedText}。如果提供的 JSON 酬載無效：「執行『更新記錄』動作時發生錯誤。原因：參數「Fields To Update」(要更新的欄位) 中提供的 JSON 酬載無效。請檢查結構。	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果系統回報 204 狀態碼 (is_success=true)：

「Successfully updated {record type} record with {record id} in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功更新 {record id} 的 {record type} 記錄)。

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

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『更新記錄』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

如果系統回報 404、400 或 500 狀態碼：「Error executing action "Update Record". 原因：{messageText}{messageAppendedText}。

如果提供的 JSON 酬載無效：「執行『更新記錄』動作時發生錯誤。原因：參數「Fields To Update」(要更新的欄位) 中提供的 JSON 酬載無效。請檢查結構。

一般

刪除記錄

說明

刪除 BMC Remedy ITSM 中的記錄。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
記錄類型	字串	不適用	是	指定要刪除的記錄類型。
記錄 ID	字串	不適用	是	指定要刪除的記錄 ID。

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果回報 204 狀態碼 (is_success=true)：「Successfully deleted {Record Type} record with ID {record id} in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功刪除 ID 為 {record id} 的「{Record Type}」記錄)。如果系統回報 404 狀態碼，且訊息編號為 302 (is_success=true)：「ID 為 {record id} 的『{Record Type}』記錄不存在於 BMC Remedy ITSM 中。」動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Delete Record". 原因：{0}''.format(error.Stacktrace) 如果系統回報 404 狀態碼，且訊息號碼不是 302 (is_success=false)：「Error executing action "Delete Record". 原因：{messageText}」	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果回報 204 狀態碼 (is_success=true)：「Successfully deleted {Record Type} record with ID {record id} in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功刪除 ID 為 {record id} 的「{Record Type}」記錄)。

如果系統回報 404 狀態碼，且訊息編號為 302 (is_success=true)：「ID 為 {record id} 的『{Record Type}』記錄不存在於 BMC Remedy ITSM 中。」

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

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Delete Record". 原因：{0}''.format(error.Stacktrace)

如果系統回報 404 狀態碼，且訊息號碼不是 302 (is_success=false)：「Error executing action "Delete Record". 原因：{messageText}」

一般

建立記錄

說明

在 BMC Remedy ITSM 中建立記錄。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
記錄類型	字串	不適用	是	指定要建立的記錄類型。
記錄酬載	JSON	{ "field":"value" }	是	指定包含所有必要欄位和值的 JSON 物件。

參數顯示名稱

類型

預設值

為必填項目

說明

記錄類型

字串

不適用

是

指定要建立的記錄類型。

記錄酬載

JSON

{

"field":"value"

}

是

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

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
    "values": {
        "Work Log ID": "X",
        "Submitter": "Admin",
        "Submit Date": "2022-01-06T10:42:43.000+0000",
        "Assigned To": null,
        "Last Modified By": "Admin",
        "Last Modified Date": "2022-01-06T10:42:43.000+0000",
        "Status": "Enabled",
        "Short Description": ".",
        "Status History": null,
        "Assignee Groups": null
    }
}

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果系統回報 201 狀態碼 (is_success=true)：「Successfully created {record type} record in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功建立 {record type} 記錄)。動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『建立記錄』動作時發生錯誤。Reason: {0}''.format(error.Stacktrace)" 如果系統回報 400 狀態碼，且訊息編號為 307：「Error executing action "Create Record". 原因：下列欄位為必填欄位：{csv of messageAppendedText}。如果系統回報 400 狀態碼，且訊息編號不是 307：「Error executing action "Create Record"」。原因：{messageText}：{messageAppendedText}。」如果提供的 JSON 酬載無效：「Error executing action "Create Record". 原因：參數「Record Payload」中提供的 JSON 酬載無效。請檢查結構。」	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果系統回報 201 狀態碼 (is_success=true)：「Successfully created {record type} record in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功建立 {record type} 記錄)。

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

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『建立記錄』動作時發生錯誤。Reason: {0}''.format(error.Stacktrace)"

如果系統回報 400 狀態碼，且訊息編號為 307：「Error executing action "Create Record". 原因：下列欄位為必填欄位：{csv of messageAppendedText}。

如果系統回報 400 狀態碼，且訊息編號不是 307：「Error executing action "Create Record"」。原因：{messageText}：{messageAppendedText}。」

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

一般

等待記錄欄位更新

說明

等待 BMC Remedy ITSM 更新記錄欄位。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
記錄類型	字串	不適用	是	指定要等待更新的記錄類型。
記錄 ID	字串	不適用	是	指定需要更新的記錄 ID。
要檢查的欄位	JSON	{ "field":"value" }	是	指定包含所有必要欄位和值的 JSON 物件。
逾時即失敗	核取方塊	已勾選	是	如果啟用這項功能，但並非所有欄位都已更新，系統就會導致動作失敗。

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
    "values": {
        "Work Log ID": "X",
        "Submitter": "Admin",
        "Submit Date": "2022-01-06T10:42:43.000+0000",
        "Assigned To": null,
        "Last Modified By": "Admin",
        "Last Modified Date": "2022-01-06T10:42:43.000+0000",
        "Status": "Enabled",
        "Short Description": ".",
        "Status History": null,
        "Assignee Groups": null
    }
}

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果狀態碼為 200 (is_success=true)：「BMC Remedy ITSM 中已更新 ID 為 {record id} 的『{record type}』記錄。」如果其中一個欄位未更新，且「Fail If Timeout」參數未啟用 (is_success=false)：「The following fields were not updated for {record type} record with ID {record id} in BMC Remedy ITSM: {fields that were not updated}」(BMC Remedy ITSM 中 ID 為 {record id} 的 {record type} 記錄未更新下列欄位：{fields that were not updated}) 非同步訊息：「Waiting for the following fields to be updated for {record type} record with ID {record id} in BMC Remedy ITSM: {fields that were not updated}」(等待更新 BMC Remedy ITSM 中 ID 為 {record id} 的 {record type} 記錄的下列欄位：{fields that were not updated}) 動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行動作『等待欄位更新』時發生錯誤。原因：{0}''.format(error.Stacktrace) 如果找不到部分欄位：「執行動作『等待欄位更新』時發生錯誤。原因：記錄結構中找不到下列欄位：{fields that were not found}。如果系統回報 404 狀態碼：「Error executing action "Wait For Record Fields Update". 原因：{messageText}。」如果其中一個欄位未更新，且「Fail If Timeout」參數已啟用 (is_success=false)：「Error executing action "Wait For Fields Update"」。原因：在 BMC Remedy ITSM 中，ID 為 {record id} 的「{record type}」記錄未更新下列欄位：{fields that were not updated}。如果提供的 JSON 酬載無效：「Error executing action "Wait For Fields Update". 原因：參數「Fields To Check」中提供的 JSON 酬載無效。請檢查結構。	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果狀態碼為 200 (is_success=true)：「BMC Remedy ITSM 中已更新 ID 為 {record id} 的『{record type}』記錄。」

如果其中一個欄位未更新，且「Fail If Timeout」參數未啟用 (is_success=false)：「The following fields were not updated for {record type} record with ID {record id} in BMC Remedy ITSM: {fields that were not updated}」(BMC Remedy ITSM 中 ID 為 {record id} 的 {record type} 記錄未更新下列欄位：{fields that were not updated})

非同步訊息：「Waiting for the following fields to be updated for {record type} record with ID {record id} in BMC Remedy ITSM: {fields that were not updated}」(等待更新 BMC Remedy ITSM 中 ID 為 {record id} 的 {record type} 記錄的下列欄位：{fields that were not updated})

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

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行動作『等待欄位更新』時發生錯誤。原因：{0}''.format(error.Stacktrace)

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

如果系統回報 404 狀態碼：「Error executing action "Wait For Record Fields Update". 原因：{messageText}。」

如果其中一個欄位未更新，且「Fail If Timeout」參數已啟用 (is_success=false)：「Error executing action "Wait For Fields Update"」。原因：在 BMC Remedy ITSM 中，ID 為 {record id} 的「{record type}」記錄未更新下列欄位：{fields that were not updated}。

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

一般

取得事件詳細資料

說明

從 BMC Remedy ITSM 取得事件的詳細資訊。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
事件 ID	CSV	不適用	是	指定要傳回詳細資料的事件 ID。
要傳回的欄位	CSV	不適用	否	指定要傳回的欄位。如果提供的欄位無效，動作就會失敗。如果未提供任何內容，動作會傳回所有欄位。
擷取工作記事	核取方塊	已勾選	否	如果啟用，動作會傳回與事件相關的工作筆記。
要傳回的工作筆記數量上限	整數	50	否	指定要傳回的工作附註數量。如未提供任何內容，動作會傳回 50 則工作附註。

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
        "Work Log ID": "X",
        "Submitter": "Admin",
        "Submit Date": "2022-01-06T10:42:43.000+0000",
        "Assigned To": null,
        "Last Modified By": "Admin",
        "Last Modified Date": "2022-01-06T10:42:43.000+0000",
        "Status": "Enabled",
        "Short Description": ".",
        "Status History": null,
        "Assignee Groups": "",
        "Worknotes": [
            {
                "Submitter": "X",
                "Detailed Description": "asdasd",
                "Work Log Type": "X",
                "Work Log Submit Date": "2022-01-06T11:21:56.000+0000"
            },
            {
                "Submitter": "X",
                "Detailed Description": "Work Log Entry from Bob.",
                "Work Log Type": "X",
                "Work Log Submit Date": "2008-11-07T00:30:41.000+0000"
            }
        ]
}

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果至少有一個 ID 的資料可用 (is_success=true)：「Successfully returned details regarding incidents in BMC Remedy ITSM for the following ids: {record ids}.」(已成功傳回下列 ID 的 BMC Remedy ITSM 事件詳細資料：{記錄 ID})。如果至少有一個 ID 沒有資料 (is_success=true)：「Action wasn't able to find details regarding incidents in BMC Remedy ITSM for the following ids: {record ids}.」(動作無法在 BMC Remedy ITSM 中找到下列 ID 的事件詳細資料：{記錄 ID}) 如果所有 ID 都沒有可用資料 (is_success=false)：「No incidents were found.」動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Get Incidents Details". 原因：{0}''.format(error.Stacktrace) 如果系統回報 400 狀態碼：「Error executing action "Get Incidents Details". 原因：{0}''.format(messageText)	一般
案件總覽表格	表格名稱：事件詳細資料資料表資料欄：鍵值	一般
案件總覽表格	資料表名稱：事件 {事件編號} 工作筆記資料表資料欄：提交者文字時間	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果至少有一個 ID 的資料可用 (is_success=true)：「Successfully returned details regarding incidents in BMC Remedy ITSM for the following ids: {record ids}.」(已成功傳回下列 ID 的 BMC Remedy ITSM 事件詳細資料：{記錄 ID})。

如果至少有一個 ID 沒有資料 (is_success=true)：「Action wasn't able to find details regarding incidents in BMC Remedy ITSM for the following ids: {record ids}.」(動作無法在 BMC Remedy ITSM 中找到下列 ID 的事件詳細資料：{記錄 ID})

如果所有 ID 都沒有可用資料 (is_success=false)：「No incidents were found.」

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

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Get Incidents Details". 原因：{0}''.format(error.Stacktrace)

如果系統回報 400 狀態碼：「Error executing action "Get Incidents Details". 原因：{0}''.format(messageText)

一般

案件總覽表格

表格名稱：事件詳細資料

資料表資料欄：

一般

案件總覽表格

資料表名稱：事件 {事件編號} 工作筆記

資料表資料欄：

提交者
文字
時間

一般

更新事件

說明

在 BMC Remedy ITSM 中更新事件。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
事件 ID	字串	不適用	是	指定需要更新的事件 ID。
狀態	DDL	請選取一項可能的值包括：請選取一項新增已指派進行中待處理已解決已關閉已取消	否	指定事件的狀態。注意：如果狀態為「待處理」或「已解決」，則也必須提供「狀態原因」值。
狀態原因	字串	不適用	否	指定事件的狀態原因。
影響	DDL	請選取一項可能的值：請選取一項廣泛/普遍重大/大型中度/有限低/區域性	否	指定事件的影響。
急迫性	DDL	請選取一項可能的值包括：請選取一項重大高中低	否	指定事件的緊急程度。
說明	字串	不適用	否	指定事件說明
事件類型	DDL	請選取一項可能的值：使用者服務還原使用者服務要求基礎架構還原基礎架構事件	否	指定事件的事件類型。
指派的群組	字串	不適用	否	指定事件的指派群組。
指派對象	字串	不適用	否	指定事件的指派對象。
解析度	字串	不適用	否	指定事件的解決方式。
解決方案類別第 1 層	字串	不適用	否	指定事件的第 1 層解決類別。
解析度類別層級 2	字串	不適用	否	指定事件的第 2 層解決類別。
解決方案類別層級 3	字串	不適用	否	為事件指定第 3 層的解決類別。
解決方案產品類別第 1 層	字串	不適用	否	指定事件的第 1 層解決類別。
解決方案產品類別第 2 層	字串	不適用	否	指定事件的第 2 層解決類別。
解決方案產品類別第 3 層	字串	不適用	否	為事件指定第 3 層的解決類別。
回報來源	DDL	請選取一項可能的值：直接輸入電子郵件外部呈報傳真系統管理電話號碼語音信箱 Walk In 網頁其他 BMC Impact Manager 事件	否	指定回報的來源。
自訂欄位	JSON	不適用	否	指定 JSON 物件，其中包含所有需要更新的必要欄位和值。注意：這項參數會覆寫其他提供的參數。

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果回報 204 狀態碼 (is_success=true)：「Successfully updated incident with {record id} in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功更新事件，記錄 ID 為 {record id})。動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Update Incident". Reason: {0}''.format(error.Stacktrace" 如果系統回報 400 或 500 狀態碼：「Error executing action "Update Incident"」。原因：{messageText}{messageAppendedText}。如果找不到事件 (is_success = true)：「Error executing action "Update Incident". 原因：在 BMC Remedy ITSM 中找不到事件 {事件 ID}。請檢查拼字。」如果提供的 JSON 酬載無效：「Error executing action "Update Incident". 原因：參數「Fields To Update」(要更新的欄位) 中提供的 JSON 酬載無效。請檢查結構。」	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果回報 204 狀態碼 (is_success=true)：「Successfully updated incident with {record id} in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功更新事件，記錄 ID 為 {record id})。

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

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Update Incident". Reason: {0}''.format(error.Stacktrace"

如果系統回報 400 或 500 狀態碼：「Error executing action "Update Incident"」。原因：{messageText}{messageAppendedText}。

如果找不到事件 (is_success = true)：「Error executing action "Update Incident". 原因：在 BMC Remedy ITSM 中找不到事件 {事件 ID}。請檢查拼字。」

如果提供的 JSON 酬載無效：「Error executing action "Update Incident". 原因：參數「Fields To Update」(要更新的欄位) 中提供的 JSON 酬載無效。請檢查結構。」

一般

建立事件

說明

在 BMC Remedy ITSM 中建立事件。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
狀態	DDL	請選取一項可能的值包括：請選取一項新增已指派進行中待處理已解決已關閉已取消	否	指定事件的狀態。
影響	DDL	請選取一項可能的值：請選取一項廣泛/普遍重大/大型中度/有限低/區域性	否	指定事件的影響。
急迫性	DDL	請選取一項可能的值包括：請選取一項重大高中低	否	指定事件的緊急程度。
說明	字串	不適用	否	指定事件說明
公司	字串	不適用	否	指定事件的公司
客戶	字串	不適用	否	指定事件的客戶。注意：客戶名稱必須採用「{姓氏} {名字}」格式。範例：Allbrook Allen
範本名稱：	字串	不適用	否	指定事件的範本名稱。注意：這項動作會在背景嘗試尋找範本 ID。如要提高精確度，可以直接透過自訂欄位提供範本 ID。
事件類型	DDL	請選取一項可能的值：使用者服務還原使用者服務要求基礎架構還原基礎架構事件	否	指定事件的事件類型。
指派的群組	字串	不適用	否	指定事件的指派群組。
指派對象	字串	不適用	否	指定事件的指派對象。
解析度	字串	不適用	否	指定事件的解決方式。
解決方案類別第 1 層	字串	不適用	否	指定事件的第 1 層解決類別。
解析度類別層級 2	字串	不適用	否	指定事件的第 2 層解決類別。
解決方案類別層級 3	字串	不適用	否	為事件指定第 3 層的解決類別。
解決方案產品類別第 1 層	字串	不適用	否	指定事件的第 1 層解決類別。
解決方案產品類別第 2 層	字串	不適用	否	指定事件的第 2 層解決類別。
解決方案產品類別第 3 層	字串	不適用	否	為事件指定第 3 層的解決類別。
回報來源	DDL	請選取一項可能的值：直接輸入電子郵件外部呈報傳真自助式服務系統管理電話號碼語音信箱 Walk In 網頁其他 BMC Impact Manager 事件	否	指定回報的來源。
自訂欄位	JSON	不適用	否	指定 JSON 物件，其中包含建立時需要使用的所有必要欄位和值。注意：這項參數會覆寫其他提供的參數。

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
        "Request ID": "X",
        "Submitter": "X",
        "Create Date": "2022-01-06T14:05:31.000+0000",
        "Assigned To": null,
        "Last Modified By": "X",
        "Modified Date": "2022-01-06T14:05:31.000+0000",
        "Status": "X",
        "Short Description": ".",
        "Status History": {
            "New": {
                "user": "X",
                "timestamp": "2022-01-06T14:05:31.000+0000"
            },
            "In Progress": {
                "user": "X",
                "timestamp": "2022-01-06T14:05:31.000+0000"
            }
        },
        "Assignee Groups": null,
        "InstanceId": "X",
        "Vendor Assignee Groups": null,
        "Vendor Assignee Groups_parent": null,
        "Assignee Groups_parent": null,
        "Product Categorization Tier 1": null,
        "Product Categorization Tier 2": null,
        "Product Categorization Tier 3": null,
}

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果回報 201 狀態碼 (is_success=true)：「Successfully created incident with in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功建立事件。) 動作應會失敗並停止執行應對手冊： <如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『建立事件』動作時發生錯誤。Reason: {0}''.format(error.Stacktrace)" 如果系統回報 400 狀態碼，且訊息編號為 307：「Error executing action "Create Incident". 原因：下列欄位為必填欄位：{csv of messageAppendedText}。如果系統回報 400 或 500 狀態碼，且訊息編號不是 307：「Error executing action "Create Incident". 原因：{messageText} {messageAppendedText}。」如果提供的 JSON 酬載無效：「Error executing action "Create Incident". 原因：參數「Fields To Update」(要更新的欄位) 中提供的 JSON 酬載無效。請檢查結構。」如果找不到範本：「Error executing action "Create Incident". 原因：找不到名為「{template Name}」的範本。請檢查拼字，或直接透過自訂欄位提供範本 ID。	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果回報 201 狀態碼 (is_success=true)：「Successfully created incident with in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功建立事件。)

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

<如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『建立事件』動作時發生錯誤。Reason: {0}''.format(error.Stacktrace)"

如果系統回報 400 狀態碼，且訊息編號為 307：「Error executing action "Create Incident". 原因：下列欄位為必填欄位：{csv of messageAppendedText}。

如果系統回報 400 或 500 狀態碼，且訊息編號不是 307：「Error executing action "Create Incident". 原因：{messageText} {messageAppendedText}。」

如果提供的 JSON 酬載無效：「Error executing action "Create Incident". 原因：參數「Fields To Update」(要更新的欄位) 中提供的 JSON 酬載無效。請檢查結構。」

如果找不到範本：「Error executing action "Create Incident". 原因：找不到名為「{template Name}」的範本。請檢查拼字，或直接透過自訂欄位提供範本 ID。

一般

等待事件欄位更新

說明

等待 BMC Remedy ITSM 更新事件欄位。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
事件 ID	字串		是	指定需要更新的事件 ID。
狀態	DDL	請選取一項可能的值包括：請選取一項新增已指派進行中待處理已解決已關閉已取消	否	指定事件的預期狀態。
要檢查的欄位	JSON	{ "field":"value" }	否	指定包含所有必要欄位和值的 JSON 物件。注意：這個參數的優先順序高於「狀態」欄位。
逾時即失敗	布林值	是	是	如果啟用這項設定，但並非所有欄位都已更新，動作就會失敗。

執行時間

不適用

動作執行結果

指令碼執行結果

is_success。 可以是 True 或 False。如果至少有一個實體順利執行動作 (未傳回任何錯誤，伺服器回應為 200 OK)，則應將 is_success 設為 True。

JSON 結果

{
    "values": {
        "Work Log ID": "X",
        "Submitter": "X",
        "Submit Date": "2022-01-06T10:42:43.000+0000",
        "Assigned To": null,
        "Last Modified By": "X",
        "Last Modified Date": "2022-01-06T10:42:43.000+0000",
        "Status": "X",
        "Short Description": ".",
        "Status History": null,
        "Assignee Groups": null
    }
}

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果回報 200 狀態碼 (is_success= true)：「Incident with ID {incident id} was updated in BMC Remedy ITSM.」(ID 為 {incident id} 的事件已在 BMC Remedy ITSM 中更新)。如果其中一個欄位未更新，且「Fail If Timeout」參數未啟用 (is_success=false)：「The following fields were not updated for incident with ID {incident id} in BMC Remedy ITSM: {fields that were not updated}」(BMC Remedy ITSM 中 ID 為 {incident id} 的事件，下列欄位未更新：{fields that were not updated}) 非同步訊息："Waiting for the following fields to be updated for incident with ID {incident id} in BMC Remedy ITSM: {fields that were not updated}" 動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Wait For Incident Fields Update". 原因：{0}''.format(error.Stacktrace) 如果找不到部分欄位：「Error executing action "Wait For Incident Fields Update". 原因：事件結構中找不到下列欄位：{fields that were not found}。如果找不到事件：「Error executing action "Wait For Incident Fields Update". 原因：找不到 ID 為 {incident ID} 的事件。如果其中一個欄位未更新，且「Fail If Timeout」參數已啟用 (is_success=false)：「Error executing action "Wait For Fields Update"」。原因：BMC Remedy ITSM 中 ID 為 {incident id} 的事件未更新下列欄位：{fields that were not updated} 如果提供的 JSON 酬載無效：「Error executing action "Wait For Fields Update". 原因：參數「Fields To Check」中提供的 JSON 酬載無效。請檢查結構。」如果未提供「狀態」和「要檢查的欄位」參數：「Error executing action "Wait For Fields Update"」。原因：「狀態」或「要檢查的欄位」參數應有值。	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果回報 200 狀態碼 (is_success= true)：「Incident with ID {incident id} was updated in BMC Remedy ITSM.」(ID 為 {incident id} 的事件已在 BMC Remedy ITSM 中更新)。

如果其中一個欄位未更新，且「Fail If Timeout」參數未啟用 (is_success=false)：「The following fields were not updated for incident with ID {incident id} in BMC Remedy ITSM: {fields that were not updated}」(BMC Remedy ITSM 中 ID 為 {incident id} 的事件，下列欄位未更新：{fields that were not updated})

非同步訊息："Waiting for the following fields to be updated for incident with ID {incident id} in BMC Remedy ITSM: {fields that were not updated}"

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

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Wait For Incident Fields Update". 原因：{0}''.format(error.Stacktrace)

如果找不到部分欄位：「Error executing action "Wait For Incident Fields Update". 原因：事件結構中找不到下列欄位：{fields that were not found}。

如果找不到事件：「Error executing action "Wait For Incident Fields Update". 原因：找不到 ID 為 {incident ID} 的事件。

如果其中一個欄位未更新，且「Fail If Timeout」參數已啟用 (is_success=false)：「Error executing action "Wait For Fields Update"」。原因：BMC Remedy ITSM 中 ID 為 {incident id} 的事件未更新下列欄位：{fields that were not updated}

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

如果未提供「狀態」和「要檢查的欄位」參數：「Error executing action "Wait For Fields Update"」。原因：「狀態」或「要檢查的欄位」參數應有值。

一般

為事件新增工作附註

說明

在 BMC Remedy ITSM 中為事件新增工作附註。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
事件 ID	字串	不適用	是	指定要新增工作記事的事件 ID。
工作附註文字	字串	不適用	是	指定工作附註的文字。

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果至少有一個 ID 的資料可用 (is_success=true)：「Successfully added a note to incident "{incident id}" in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功為事件「{事件 ID}」新增附註。) 動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證有誤、無法連線至伺服器或其他錯誤：「執行『Add Work Note To Incident』動作時發生錯誤。Reason: {0}''.format(error.Stacktrace)" 如果找不到事件 (is_success = false)：「Error executing action "Update Incident". 原因：在 BMC Remedy ITSM 中找不到事件 {事件 ID}。請檢查拼字。」	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果至少有一個 ID 的資料可用 (is_success=true)：「Successfully added a note to incident "{incident id}" in BMC Remedy ITSM.」(已在 BMC Remedy ITSM 中成功為事件「{事件 ID}」新增附註。)

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

如果系統回報嚴重錯誤，例如憑證有誤、無法連線至伺服器或其他錯誤：「執行『Add Work Note To Incident』動作時發生錯誤。Reason: {0}''.format(error.Stacktrace)"

如果找不到事件 (is_success = false)：「Error executing action "Update Incident". 原因：在 BMC Remedy ITSM 中找不到事件 {事件 ID}。請檢查拼字。」

一般

刪除事件

說明

在 BMC Remedy ITSM 中刪除事件。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
事件 ID	字串	不適用	是	指定要刪除的事件 ID。

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型 (實體/一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果回報 204 狀態碼 (is_success = true)：「Successfully deleted incident with ID {record id} in BMC Remedy ITSM. 如果找不到事件 (is_success=true)：「Incident with ID {record id} doesn't exist in BMC Remedy ITSM.」(BMC Remedy ITSM 中不存在 ID 為 {記錄 ID} 的事件。) 動作應會失敗並停止執行應對手冊：如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Delete Incident" (執行「刪除事件」動作時發生錯誤)。Reason: {0}''.format(error.Stacktrace)"	一般

結果類型

值/說明

類型 (實體/一般)

輸出訊息*

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

如果回報 204 狀態碼 (is_success = true)：「Successfully deleted incident with ID {record id} in BMC Remedy ITSM.

如果找不到事件 (is_success=true)：「Incident with ID {record id} doesn't exist in BMC Remedy ITSM.」(BMC Remedy ITSM 中不存在 ID 為 {記錄 ID} 的事件。)

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

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Delete Incident" (執行「刪除事件」動作時發生錯誤)。Reason: {0}''.format(error.Stacktrace)"

一般

工作

依標記同步處理已結案的事件

說明

同步處理在 Google SecOps 案件教戰手冊和 Google SecOps 案件中建立的 BMC Remedy ITSM 要求。

參數

參數顯示名稱	類型	預設值	為必填項目	說明
事件表格	字串	HPD:IncidentInterface	是	指定表格名稱，系統會使用這個表格擷取事件詳細資料。
API 根層級	字串	https://{IP}:{port}	是	BMC Remedy ITSM 執行個體的 API 根目錄。
使用者名稱	字串	不適用	是	BMC Remedy ITSM 使用者名稱。
密碼	密碼	不適用	是	BMC Remedy ITSM 密碼
可倒轉的小時數上限	整數	24	否	指定要回溯同步處理狀態的小時數。
驗證 SSL	核取方塊	已勾選	是	如果已啟用，請確認連線至 BMC Remedy ITSM 伺服器的 SSL 憑證是否有效。

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