将 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 中配置集成，请参阅配置集成。

如有需要，您可以在后续阶段进行更改。配置集成实例后，您可以在 playbook 中使用该实例。如需详细了解如何配置和支持多个实例，请参阅支持多个实例。

操作

如需详细了解操作，请参阅 在工作桌上响应待处理的操作和在案例中运行手动操作。

添加记录

在 AppSheet 中向表格添加记录。

参数

参数名称	类型	默认值	为必填项	说明
表名称	字符串	不适用	是	指定要向其中添加新记录的表的名称。
记录 JSON 对象	JSON		是	指定需要添加的记录的 JSON 对象。

运行时间

此操作不会对实体执行。

操作结果

脚本结果

脚本结果名称	值选项	示例
is_success	True/False	is_success=False

案例墙

结果类型	说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果数据可用 (is_success = true)：“已成功在 AppSheet 的‘{table}’表中添加新记录。 操作应失败并停止 playbook 执行： 如果报告了严重错误（例如凭据错误、无法连接到服务器等），则会显示以下消息：“Error executing action "Add Record". Reason: {0}''.format(error.Stacktrace) 如果响应中没有数据：“执行‘添加记录’操作时出错。原因：提供的载荷无效。请检查表名称的拼写和记录的 JSON 对象的结构。 如果响应中的“Message”为：“Error executing action "Add Record". 原因：{0}”。format(Message) JSON 对象无效：执行“添加记录”操作时出错。原因：提供的 JSON 对象无效。请检查结构。	常规

删除记录

删除 AppSheet 表格中的记录。

参数

参数名称	类型	默认值	为必填项	说明
表名称	字符串	不适用	是	指定要删除记录的表的名称。
记录 JSON 对象	JSON		是	指定需要删除的记录的 JSON 对象。您只需提供记录的唯一标识符键。

运行时间

此操作不会对实体执行。

操作结果

脚本结果

脚本结果名称	值选项	示例
is_success	True/False	is_success=False

案例墙

结果类型	说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果数据可用 (is_success = true)：“已成功删除 AppSheet 中表‘{table}’内的记录。 如果状态代码为 200，但 rowNumber 为 null (is_success=true)：提供的记录在 AppSheet 的表“{table}”中不存在。 操作应失败并停止 playbook 执行： 如果报告了严重错误（例如凭据错误、无法连接到服务器等）：“执行‘删除记录’操作时出错。Reason: {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"
        }
    ]
}

案例墙

结果类型	说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果找到结果 (is_success = true)：“已成功在 AppSheet 中找到符合所提供条件的表。 如果未找到结果 (is_success = true)：“在 AppSheet 中未找到符合所提供条件的表。 操作应失败并停止 playbook 执行： 如果报告了严重错误（例如凭据错误、无法连接到服务器等），则会显示以下消息：“Error executing action "List Tables". Reason: {0}''.format(error.Stacktrace)	常规
案例墙表格	名称：Available Tables 列： ID 名称	常规

Ping

测试与 AppSheet 的连接。

参数

无。

运行时间

此操作不会对实体执行。

操作结果

脚本结果

脚本结果名称	值选项	示例
is_success	True/False	is_success=False

案例墙

结果类型	说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果成功：“已使用提供的连接参数成功连接到 AppSheet 服务器！” 操作应失败并停止 playbook 执行： 如果未成功：“Failed to connect to the AppSheet server! 错误为 {0}”。format(exception.stacktrace)	常规

搜索记录

在 AppSheet 中搜索表中的记录。

参数

参数名称	类型	默认值	为必填项	说明
表名称	字符串	不适用	是	指定要检索其详细信息的表的名称。
选择器查询	字符串	不适用	否	指定选择器查询，该查询将用于限制结果。如果未提供任何内容，操作将返回所有记录。

运行时间

此操作不会对实体执行。

操作结果

脚本结果

脚本结果名称	值选项	示例
is_success	True/False	is_success=False

案例墙

结果类型	说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果数据可用 (is_success = true)：“已成功从 AppSheet 中的‘{table}’表检索到符合所提供条件的记录。 如果没有可用数据 (is_success=false)：在 AppSheet 的“{table}”表中，未找到符合所提供条件的记录。 操作应失败并停止 playbook 执行： 如果报告了严重错误，例如凭据错误、无法连接到服务器等：“执行‘搜索记录’操作时出错。Reason: {0}''.format(error.Stacktrace) 如果响应中的“Message”为：“Error executing action "Search Records". 原因：{0}”。format(Message)	常规
案例墙表格	名称：Records	常规

更新记录

更新 AppSheet 表中的记录。

参数

参数名称	类型	默认值	为必填项	说明
表名称	字符串	不适用	是	指定要更新记录的表的名称。
记录 JSON 对象	JSON		是	指定需要更新的记录的 JSON 对象。您需要提供唯一标识符键和要更新的字段。

运行时间

此操作不会对实体执行。

操作结果

脚本结果

脚本结果名称	值选项	示例
is_success	True/False	is_success=False

案例墙

结果类型	说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果数据可用 (is_success = true)：“已成功更新 AppSheet 中‘{table}’表内的记录。 操作应失败并停止 playbook 执行： 如果发生严重错误，例如凭证错误、无法连接到服务器等：“执行‘更新记录’操作时出错。Reason: {0}''.format(error.Stacktrace) 如果响应中没有数据：“执行‘更新记录’操作时出错。原因：提供的载荷无效。请检查表名称的拼写和记录的 JSON 对象的结构。 如果响应中的“Message”为：“Error executing action "Update Record". 原因：{0}”。format(Message) 执行“更新记录”操作时出错。原因：提供的 JSON 对象无效。请检查结构。	常规

需要更多帮助？获得社区成员和 Google SecOps 专业人士的解答。