整合 AppSheet 與 Google SecOps

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

整合版本：3.0

應用實例

執行 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)：「Successfully added new record in table "{table}" in AppSheet. 動作應會失敗並停止執行應對手冊： 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Add Record". 原因：{0}''.format(error.Stacktrace) 如果回應中沒有資料：「執行『新增記錄』動作時發生錯誤。原因：提供的酬載無效。請檢查表格名稱的拼字和記錄的 JSON 物件結構。 如果回應中顯示「Message」：「Error executing action "Add Record". 原因：{0}''.format(Message) 無效的 JSON 物件：執行「新增記錄」動作時發生錯誤。原因：提供的 JSON 物件無效。請檢查結構。	一般

刪除記錄

刪除 AppSheet 資料表中的記錄。

參數

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

執行日期

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

動作結果

指令碼結果

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

案件總覽

結果類型	說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊： 如果資料可用 (is_success = true)：「Successfully deleted record in table "{table}" in AppSheet. 如果狀態碼為 200，但 rowNumber 為空值 (is_success=true)：AppSheet 中「{table}」表格內沒有提供的記錄。 動作應會失敗並停止執行應對手冊： 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『刪除記錄』動作時發生錯誤。原因：{0}''.format(error.Stacktrace) 如果回應中沒有資料：「執行『刪除記錄』動作時發生錯誤。原因：提供的酬載無效。請檢查表格名稱的拼字和記錄的 JSON 物件結構。 如果回應中包含「Message」：「Error executing action "Delete Record"」。原因：{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)：「Successfully found tables for the provided criteria in AppSheet. 如果找不到結果 (is_success = true)：「AppSheet 中找不到符合所提供條件的表格。 動作應會失敗並停止執行應對手冊： 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "List Tables". 原因：{0}''.format(error.Stacktrace)	一般
案件總覽表格	名稱：可訂席位 欄： ID 名稱	一般

乒乓

測試與 AppSheet 的連線。

參數

無

執行日期

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

動作結果

指令碼結果

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

案件總覽

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

搜尋記錄

在 AppSheet 的表格中搜尋記錄。

參數

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

執行日期

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

動作結果

指令碼結果

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

案件總覽

結果類型	說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊： 如果資料可用 (is_success = true)：「Successfully retrieved records based on the provided criteria from table "{table}" in AppSheet. 如果沒有可用資料 (is_success=false)：系統在 AppSheet 的「{table}」表格中，找不到符合所提供條件的記錄。 動作應會失敗並停止執行應對手冊： 如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「Error executing action "Search Records". 原因：{0}''.format(error.Stacktrace) 如果回應中顯示「Message」：「Error executing action "Search Records"」。原因：{0}''.format(Message)	一般
案件總覽表格	名稱：記錄	一般

更新記錄

更新 AppSheet 資料表中的記錄。

參數

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

執行日期

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

動作結果

指令碼結果

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

案件總覽

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

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