AppSheet と Google SecOps を統合する

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

ユースケース

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 オブジェクトが指定されました。構造を確認してください。

一般

レコードの削除

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 オブジェクトが指定されました。構造を確認してください。

一般

テーブルのリスト表示

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

パラメータ

パラメータ名 種類 デフォルト値 必須 説明
フィルタ ロジック DDL

等しい

値は次のいずれかです。

  • 等しい
  • Contains
いいえ 適用するフィルタ ロジックを指定します。
フィルタ値 文字列 なし いいえ フィルタで使用する値を指定します。「Equal」が選択されている場合、アクションはアイテム間で完全一致の検索を試行します。「Contains」が選択されている場合、アクションはその部分文字列を含むアイテムを検索します。このパラメータに何も指定しないと、フィルタは適用されません。
返されるテーブルの最大数 整数 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 で指定された条件に対応するテーブルが見つかりませんでした。

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

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「テーブルの一覧表示」の実行エラー。理由: {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 のテーブルでレコードを検索します。

パラメータ

パラメータ名 種類 デフォルト値 必須 説明
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 テーブル 名前: レコード 一般

レコードの更新

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 オブジェクトが指定されました。構造を確認してください。

全般

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