整合 AppSheet 和 Google SecOps

本文說明如何將 AppSheet 與 Google Security Operations (Google SecOps) 整合。

應用實例

執行 CRUD 動作。

整合參數

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

參數名稱	類型	預設值	為必填	說明
API 根層級	字串	https://api.appsheet.com	是	AppSheet 執行個體的 API 根目錄。
應用程式 ID	字串	不適用	是	AppSheet 應用程式的 ID。
存取權杖	密碼	不適用	是	AppSheet 應用程式的存取權杖。
驗證 SSL	核取方塊	已勾選	是	如果選取，整合功能會在連線至 AppSheet 伺服器時驗證 SSL 憑證。

如要瞭解如何在 Google SecOps 中設定整合功能，請參閱「設定整合功能」。

如有需要，您可以在後續階段進行變更。設定整合執行個體後，即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作，請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。

新增記錄

在 AppSheet 的表格中新增記錄。

參數

參數名稱	類型	預設值	為必填	說明
資料表名稱	字串	不適用	是	指定要新增記錄的資料表名稱。
記錄 JSON 物件	JSON		是	指定要新增記錄的 JSON 物件。

執行日期

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

動作結果

指令碼執行結果

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

案件總覽

結果類型	說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊： 如果資料可用 (is_success = true)：「已成功在 AppSheet 的『{table}』資料表中新增記錄。 動作應失敗並停止執行應對手冊： 如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器，系統會回報其他錯誤：「執行『新增記錄』動作時發生錯誤。原因：{0}''.format(error.Stacktrace) 如果回應中沒有資料：「Error executing action "Add Record". 原因：提供的酬載無效。請檢查資料表名稱的拼字，以及記錄的 JSON 物件結構。' 如果回應中的「Message」為：「Error executing action "Add Record". Reason: {0}''.format(Message) JSON 物件無效：執行「新增記錄」動作時發生錯誤。原因：提供的 JSON 物件無效。請檢查結構體。	一般

刪除記錄

刪除 AppSheet 資料表中的記錄。

參數

參數名稱	類型	預設值	為必填	說明
資料表名稱	字串	不適用	是	指定要刪除記錄的資料表名稱。
記錄 JSON 物件	JSON		是	指定要刪除的記錄 JSON 物件。您只需要提供記錄的專屬 ID 鍵。

執行日期

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

動作結果

指令碼執行結果

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

案件總覽

結果類型	說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊： 如果資料可用 (is_success = true)：「已成功刪除 AppSheet 中『{table}』資料表的記錄。 如果狀態碼為 200，但 rowNumber 為空值 (is_success=true)：提供的記錄不存在於 AppSheet 的「{table}」資料表中。 動作應失敗並停止執行應對手冊： 如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器，系統會回報其他錯誤：「執行『刪除記錄』動作時發生錯誤。原因：{0}''.format(error.Stacktrace) 如果回應中沒有資料：「執行『刪除記錄』動作時發生錯誤。原因：提供的酬載無效。請檢查資料表名稱的拼字，以及記錄的 JSON 物件結構。 如果回應中的「Message」為：「Error executing action "Delete Record". Reason: {0}''.format(Message) 執行「刪除記錄」動作時發生錯誤。原因：提供的 JSON 物件無效。請檢查結構體。	一般

列出資料表

列出 AppSheet 應用程式中的可用資料表。

參數

參數名稱	類型	預設值	為必填	說明
篩選邏輯	DDL	等於 可能的值包括： 等於 包含	否	指定要套用的篩選器邏輯。
篩選器值	字串	不適用	否	指定篩選條件應使用的值。如果選取「等於」，動作會嘗試找出完全相符的項目；如果選取「包含」，動作會嘗試找出包含該子字串的項目。如果未在這個參數中提供任何內容，系統就不會套用篩選器。
要傳回的資料表數量上限	整數	50	否	指定要傳回的資料表數量。預設值：50。

執行日期

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

動作結果

指令碼執行結果

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

JSON 結果

{
    "Tables": [
        {
            "name": "Hash identificiation",
            "id": "Hash identificiation"
        }
    ]
}

案件總覽

結果類型	說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊： 如果找到結果 (is_success = true)：「已成功在 AppSheet 中找到符合指定條件的資料表。 如果找不到結果 (is_success = true)：「在 AppSheet 中找不到符合指定條件的資料表。 動作應失敗並停止執行應對手冊： 如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等，系統會回報：「Error executing action "List Tables". 原因：{0}''.format(error.Stacktrace)	一般
案件總覽表格	名稱：Available Tables 欄： ID 名稱	一般

乒乓

測試與 AppSheet 的連線。

參數

無

執行日期

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

動作結果

指令碼執行結果

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

案件總覽

結果類型	說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊： 如果成功：「已成功使用提供的連線參數連線至 AppSheet 伺服器！」 動作應失敗並停止執行應對手冊： 如果失敗：「無法連線至 AppSheet 伺服器！錯誤為 {0}".format(exception.stacktrace)	一般

搜尋記錄

在 AppSheet 搜尋資料表中的記錄。

參數

參數名稱	類型	預設值	為必填	說明
資料表名稱	字串	不適用	是	指定要擷取詳細資料的資料表名稱。
選取器查詢	字串	不適用	否	指定選取器查詢，用於限制結果。如未提供任何內容，動作會傳回所有記錄。

執行日期

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

動作結果

指令碼執行結果

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

案件總覽

結果類型	說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊： 如果資料可用 (is_success = true)：「已成功根據提供的條件，從 AppSheet 的『{table}』資料表擷取記錄。 如果沒有可用資料 (is_success=false)：根據提供的條件，在 AppSheet 的「{table}」資料表中找不到任何記錄。 動作應失敗並停止執行應對手冊： 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『搜尋記錄』動作時發生錯誤。原因：{0}''.format(error.Stacktrace) 如果回應中的「Message」為：「Error executing action "Search Records". Reason: {0}''.format(Message)	一般
案件總覽表格	名稱：記錄	一般

更新記錄

更新 AppSheet 資料表中的記錄。

參數

參數名稱	類型	預設值	為必填	說明
資料表名稱	字串	不適用	是	指定要更新記錄的資料表名稱。
記錄 JSON 物件	JSON		是	指定要更新的記錄 JSON 物件。您必須提供專屬 ID 鍵和要更新的欄位。

執行日期

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

動作結果

指令碼執行結果

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

案件總覽

結果類型	說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊： 如果資料可用 (is_success = true)：「已成功更新 AppSheet 中『{table}』資料表的記錄。 動作應失敗並停止執行應對手冊： 如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『更新記錄』動作時發生錯誤。原因：{0}''.format(error.Stacktrace) 如果回應中沒有資料：「執行『更新記錄』動作時發生錯誤。原因：提供的酬載無效。請檢查資料表名稱的拼字，以及記錄的 JSON 物件結構。' 如果回應中的「Message」為：「Error executing action "Update Record". Reason: {0}''.format(Message) 執行「更新記錄」動作時發生錯誤。原因：提供的 JSON 物件無效。請檢查結構體。	一般

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