このページは Cloud Translation API によって翻訳されました。

AppSheet を Google SecOps と統合する

このドキュメントでは、AppSheet を Google Security Operations（Google SecOps）と統合する方法について説明します。

統合バージョン: 3.0

ユースケース

CRUD アクションを実行します。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータ名	種類	デフォルト値	必須	説明
API ルート	文字列	https://api.appsheet.com	○	AppSheet インスタンスの API ルート。
App ID	文字列	なし	はい	AppSheet アプリケーションの ID。
アクセストークン	パスワード	なし	はい	AppSheet アプリケーションのアクセストークン。
SSL を確認する	チェックボックス	オン	はい	選択すると、統合によって AppSheet サーバーに接続するときに SSL 証明書が検証されます。

Google SecOps で統合を構成する手順については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できるようになります。複数のインスタンスの構成とサポートの方法については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、デスクから保留中のアクションに対応すると手動アクションを実行するをご覧ください。

レコードの追加

AppSheet のテーブルにレコードを追加する。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
Table Name	文字列	なし	○	新しいレコードを追加するテーブルの名前を指定します。
レコードの JSON オブジェクト	JSON		○	追加する必要があるレコードの JSON オブジェクトを指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success=False

ケースウォール

結果のタイプ	説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。データが利用可能な場合（is_success = true）: AppSheet のテーブル「{table}」に新しいレコードが正常に追加されました。アクションが失敗し、ハンドブックの実行が停止します。認間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「レコードの追加」の実行エラー。理由: {0}」.format(error.Stacktrace) レスポンスにデータがない場合:「アクション「レコードの追加」の実行エラー。理由: 無効なペイロードが指定されました。テーブル名のスペルとレコードの JSON オブジェクトの構造を確認してください。」レスポンスに「Message」がある場合: 「アクション「レコードの追加」の実行エラー。理由: {0}」.format(Message) 無効な JSON オブジェクト:「レコードの追加」アクションの実行エラー。理由: 無効な JSON オブジェクトが指定されました。構造を確認してください。	一般

結果のタイプ

説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

データが利用可能な場合（is_success = true）: AppSheet のテーブル「{table}」に新しいレコードが正常に追加されました。

アクションが失敗し、ハンドブックの実行が停止します。

認間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「レコードの追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

レスポンスにデータがない場合:「アクション「レコードの追加」の実行エラー。理由: 無効なペイロードが指定されました。テーブル名のスペルとレコードの JSON オブジェクトの構造を確認してください。」

レスポンスに「Message」がある場合: 「アクション「レコードの追加」の実行エラー。理由: {0}」.format(Message)

無効な JSON オブジェクト:「レコードの追加」アクションの実行エラー。理由: 無効な JSON オブジェクトが指定されました。構造を確認してください。

一般

レコードの削除

AppSheet のテーブルでレコードを削除します。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
Table Name	文字列	なし	○	レコードを削除するテーブルの名前を指定します。
レコードの JSON オブジェクト	JSON		○	削除する必要があるレコードの JSON オブジェクトを指定します。レコードの一意の識別子キーを指定するだけで済みます。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success=False

ケースウォール

結果のタイプ	説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。データが利用可能な場合（is_success = true）:「AppSheet 内のテーブル「{table}」のレコードが正常に削除されました。ステータスコード 200 であるものの、rowNumber が null の場合（is_success=true）: AppSheet のテーブル「{table}」に指定されたレコードが存在しませんでした。アクションが失敗し、ハンドブックの実行が停止します。間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「レコードの削除」の実行エラー。理由: {0}」.format(error.Stacktrace) レスポンスにデータがない場合:「アクション「レコードの削除」の実行エラー。理由: 無効なペイロードが指定されました。テーブル名のスペルとレコードの JSON オブジェクトの構造を確認してください。」レスポンスに「Message」がある場合: 「アクション「レコードの削除」の実行エラー。理由: {0}」.format(Message) アクション「レコードの削除」の実行エラー。理由: 無効な JSON オブジェクトが指定されました。構造を確認してください。	一般

結果のタイプ

説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

データが利用可能な場合（is_success = true）:「AppSheet 内のテーブル「{table}」のレコードが正常に削除されました。

ステータスコード 200 であるものの、rowNumber が null の場合（is_success=true）: AppSheet のテーブル「{table}」に指定されたレコードが存在しませんでした。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「レコードの削除」の実行エラー。理由: {0}」.format(error.Stacktrace)

レスポンスにデータがない場合:「アクション「レコードの削除」の実行エラー。理由: 無効なペイロードが指定されました。テーブル名のスペルとレコードの JSON オブジェクトの構造を確認してください。」

レスポンスに「Message」がある場合: 「アクション「レコードの削除」の実行エラー。理由: {0}」.format(Message)

アクション「レコードの削除」の実行エラー。理由: 無効な JSON オブジェクトが指定されました。構造を確認してください。

一般

テーブルのリスト表示

AppSheet のアプリで利用可能なテーブルを一覧表示します。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
フィルタロジック	DDL	等しい値は次のいずれかです。等しい Contains	いいえ	適用するフィルタロジックを指定します。
フィルタ値	文字列	なし	いいえ	フィルタで使用する値を指定します。「Equal」が選択されている場合、アクションはアイテム間で完全一致の検索を試行します。「Contains」が選択されている場合、アクションはその部分文字列を含むアイテムを検索します。このパラメータに何も指定しないと、フィルタは適用されません。
返されるテーブルの最大数	整数	50	いいえ	返すテーブルの数を指定します。デフォルト: 50。

パラメータ名

種類

デフォルト値

必須

説明

フィルタロジック

DDL

等しい

値は次のいずれかです。

等しい
Contains

いいえ

適用するフィルタロジックを指定します。

フィルタ値

文字列

なし

いいえ

フィルタで使用する値を指定します。「Equal」が選択されている場合、アクションはアイテム間で完全一致の検索を試行します。「Contains」が選択されている場合、アクションはその部分文字列を含むアイテムを検索します。このパラメータに何も指定しないと、フィルタは適用されません。

返されるテーブルの最大数

整数

いいえ

返すテーブルの数を指定します。デフォルト: 50。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success=False

JSON の結果

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

ケースウォール

結果のタイプ	説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。結果が見つかった場合（is_success = true）:「AppSheet で指定された条件のテーブルが正常に見つかりました。結果が見つからなかった場合（is_success = true）:「AppSheet で指定された条件に対応するテーブルが見つかりませんでした。アクションが失敗し、ハンドブックの実行が停止します。間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「テーブルの一覧表示」の実行エラー。理由: {0}」.format(error.Stacktrace)	一般
Case Wall テーブル	名前: Available Tables 列: ID Name	一般

結果のタイプ

説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

結果が見つかった場合（is_success = true）:「AppSheet で指定された条件のテーブルが正常に見つかりました。

結果が見つからなかった場合（is_success = true）:「AppSheet で指定された条件に対応するテーブルが見つかりませんでした。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「テーブルの一覧表示」の実行エラー。理由: {0}」.format(error.Stacktrace)

一般

Case Wall テーブル

名前: Available Tables

列:

ID
Name

一般

Ping

AppSheet への接続をテストします。

パラメータ

なし

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success=False

ケースウォール

結果のタイプ	説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。成功した場合:「指定された接続パラメータを使用して AppSheet サーバーに正常に接続されました。」アクションが失敗し、ハンドブックの実行が停止します。成功しなかった場合:「AppSheet サーバーへの接続に失敗しました。エラーは {0}」.format(exception.stacktrace)	一般

結果のタイプ

説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功した場合:「指定された接続パラメータを使用して AppSheet サーバーに正常に接続されました。」

アクションが失敗し、ハンドブックの実行が停止します。

成功しなかった場合:「AppSheet サーバーへの接続に失敗しました。エラーは {0}」.format(exception.stacktrace)

一般

レコードの検索

AppSheet のテーブルでレコードを検索する。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
Table Name	文字列	なし	○	詳細を取得するテーブルの名前を指定します。
セレクタクエリ	文字列	なし	いいえ	結果を制限するために使用されるセレクタクエリを指定します。何も指定しないと、アクションはすべてのレコードを返します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success=False

ケースウォール

結果のタイプ	説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。データが利用可能な場合（is_success = true）:「AppSheet 内のテーブル「{table}」から指定された条件に基づいてレコードが正常に取得されました。利用可能なデータがない場合（is_success=false）:AppSheet 内のテーブル「{table}」で指定された条件に基づくレコードが見つかりませんでした。アクションが失敗し、ハンドブックの実行が停止します。間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「レコードの検索」の実行エラー。理由: {0}」.format(error.Stacktrace) レスポンスに「Message」がある場合: 「アクション「レコードの検索」の実行エラー。理由: {0}」.format(Message)	一般
Case Wall テーブル	名前: レコード	一般

結果のタイプ

説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

データが利用可能な場合（is_success = true）:「AppSheet 内のテーブル「{table}」から指定された条件に基づいてレコードが正常に取得されました。

利用可能なデータがない場合（is_success=false）:AppSheet 内のテーブル「{table}」で指定された条件に基づくレコードが見つかりませんでした。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「レコードの検索」の実行エラー。理由: {0}」.format(error.Stacktrace)

レスポンスに「Message」がある場合: 「アクション「レコードの検索」の実行エラー。理由: {0}」.format(Message)

一般

Case Wall テーブル

名前: レコード

一般

レコードの更新

AppSheet のテーブル内のレコードを更新します。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
Table Name	文字列	なし	○	レコードを更新するテーブルの名前を指定します。
レコードの JSON オブジェクト	JSON		○	更新する必要があるレコードの JSON オブジェクトを指定します。一意の識別子キーと更新するフィールドを指定する必要があります。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success=False

ケースウォール

結果のタイプ	説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。データが利用可能な場合（is_success = true）:「AppSheet 内のテーブル「{table}」のレコードが正常に更新されました。アクションが失敗し、ハンドブックの実行が停止します。間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「レコードの更新」の実行エラー。理由: {0}」.format(error.Stacktrace) レスポンスにデータがない場合:「アクション「レコードの更新」の実行エラー。理由: 無効なペイロードが指定されました。テーブル名のスペルとレコードの JSON オブジェクトの構造を確認してください。」レスポンスに「Message」がある場合: 「アクション「レコードの更新」の実行エラー。理由: {0}」.format(Message) アクション「レコードの更新」の実行エラー。理由: 無効な JSON オブジェクトが指定されました。構造を確認してください。	全般

結果のタイプ

説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

データが利用可能な場合（is_success = true）:「AppSheet 内のテーブル「{table}」のレコードが正常に更新されました。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「レコードの更新」の実行エラー。理由: {0}」.format(error.Stacktrace)

レスポンスにデータがない場合:「アクション「レコードの更新」の実行エラー。理由: 無効なペイロードが指定されました。テーブル名のスペルとレコードの JSON オブジェクトの構造を確認してください。」

レスポンスに「Message」がある場合: 「アクション「レコードの更新」の実行エラー。理由: {0}」.format(Message)

アクション「レコードの更新」の実行エラー。理由: 無効な JSON オブジェクトが指定されました。構造を確認してください。

全般

さらにサポートが必要な場合 コミュニティメンバーや Google SecOps のプロフェッショナルから回答を得ることができます。