将 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

案例墙

结果类型	说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果数据可用（is_success = true）：“已成功在 AppSheet 的表 "{table}" 中添加新记录。 操作应失败并停止 playbook 执行： 如果报告了致命错误（例如凭据错误、未连接到服务器等）：“Error executing action "Add Record"（执行操作“添加记录”时出错）。原因：{0}''.format(error.Stacktrace) 如果响应中没有数据：“执行操作‘添加记录’时出错。原因：提供的载荷无效。请检查表名称的拼写和记录的 JSON 对象结构。 如果响应中包含“消息”：“执行操作‘添加记录’时出错。原因：{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 执行： 如果报告了致命错误（例如凭据错误、无法连接到服务器、其他错误）：“Error executing action "Delete Record"”（执行“删除记录”操作时出错）。原因：{0}''.format(error.Stacktrace) 如果响应中没有数据：“执行操作‘删除记录’时出错。原因：提供的载荷无效。请检查表名称的拼写和记录的 JSON 对象结构。 如果响应中包含“消息”：“执行操作‘删除记录’时出错。原因：{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". 原因：{0}''.format(error.Stacktrace)	常规
“案例墙”表格	名称：Available Tables 列： ID 名称	常规

Ping

测试与 AppSheet 的连接。

参数

无。

运行于

此操作不会在实体上运行。

操作结果

脚本结果

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

案例墙

结果类型	说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果成功：“Successfully connected to the AppSheet server with the provided connection parameters!”（已使用提供的连接参数成功连接到 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 执行： 如果报告了致命错误（例如凭据错误、未连接到服务器、其他错误）：“执行操作‘搜索记录’时出错。原因：{0}''.format(error.Stacktrace) 如果响应中包含“消息”：“执行操作‘搜索记录’时出错。原因：{0}''.format(Message)	常规
“案例墙”表格	名称：记录	常规

更新记录

更新 AppSheet 中表格内的记录。

参数

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

运行于

此操作不会在实体上运行。

操作结果

脚本结果

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

案例墙

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

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