画像ユーティリティ
調査中に画像やファイルの内容の分析、抽出、変換を支援する一連のユーティリティ アクション。主な機能には、テキスト抽出用の光学式文字認識（OCR）、ラスタライズ（ウェブ コンテンツを静止画像に変換）、ファイル形式の変換などがあります。すべてのアクションにはリモート エージェントが必要です。
操作
アクションの詳細については、 デスクから保留中のアクションに対応すると手動アクションを実行するをご覧ください。
ファイルを変換する
Convert File アクションを使用して、指定したファイルの形式を変更します。
アクション入力
[Convert File] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Input File Format |
必須。 アクションで変換されるファイルの元の形式。 値は次のいずれかになります。
デフォルト値は |
Input File Path |
必須。 アクションが変換するファイルのパス。 |
Output File Format |
必須。 変換プロセス後のファイルの形式。 値は次のいずれかになります。
デフォルト値は |
アクションの出力
[Convert File] アクションは次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、[ファイルの変換] アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"output_format": ""
"file_path": ""
}
]
出力メッセージ
[Convert File] アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Convert File". Reason:
ERROR_REASON |
操作に失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ファイルの変換アクションを使用した場合のスクリプト結果出力の値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
OCR 画像
OCR 画像アクションを使用して OCR を実行し、画像ファイルからテキストを抽出します。
アクション入力
[OCR 画像] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Base64 Encoded Image |
省略可。 画像ファイルの base64 エンコード文字列。 |
File Path |
必須。 画像ファイルのパス。 |
アクションの出力
[OCR Image] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、OCR 画像アクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"extracted_text": "",
}
出力メッセージ
OCR 画像アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "OCR Image". Reason:
ERROR_REASON |
操作に失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、OCR 画像アクションを使用した場合のスクリプト結果出力の値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
コンテンツのラスタライズ
[コンテンツをラスタライズ] アクションを使用して、ベクター コンテンツや複雑なコンテンツを固定のビットマップ画像形式に変換します。
リモート エージェントの前提条件（Debian）
Debian ベースの Remote Agent で Rasterize Content アクションが正常に実行されるようにするには、次のパッケージと依存関係をインストールする必要があります。
Playwright Python ライブラリ
次のコマンドを使用して、Playwright Python ライブラリをインストールします。
python3.11 -m pip install playwright
ブラウザの依存関係
Playwright が正しく機能するために必要な Chromium ブラウザの依存関係をインストールします。
playwright install --with-deps chromium
アクション入力
| パラメータ | 説明 |
|---|---|
Input Type |
必須。 アクションが主な入力として使用するコンテンツのタイプ。 値は次のいずれかになります。
デフォルト値は |
URLs or Body |
必須。 選択した [
|
Output Type |
省略可。 ラスタライズされたコンテンツの出力形式。 値は次のいずれかになります。
デフォルト値は |
Export Method |
省略可。 生成されたコンテンツの出力に使用されるメソッド。 値は次のいずれかになります。
デフォルト値は |
Width |
必須。 生成されたラスタ コンテンツに使用される幅（ピクセル単位）。 デフォルト値は |
Height |
必須。 生成されたラスタ コンテンツに使用される高さ（ピクセル単位）。 デフォルト値は |
Full Screen |
省略可。 選択すると、コンテンツはラスタライズされる前にブラウザ ウィンドウ全体にレンダリングされます。 デフォルトでは無効にされています。 |
Timeout |
省略可。 ラスタライズが開始される前にブラウザがコンテンツのレンダリングに費やす最大時間（秒単位）。 最大値は デフォルト値は |
Wait For |
省略可。 アクションがラスタライズまたはコンテンツ抽出に進む前にブラウザが到達する必要がある特定の状態。 通常、 値は次のいずれかになります。
デフォルト値は |
Wait for Selector |
省略可。 アクションがスクリーンショットをキャプチャする前にページに表示されるのを待つ CSS セレクタ。 |
アクションの出力
[コンテンツをラスタライズ] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、[コンテンツをラスタライズ] アクションを使用した場合に受信される JSON 結果の出力例を示しています。
[
{
"attachment_name": "",
"file_path": ""
}
]
出力メッセージ
[コンテンツをラスタライズ] アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Rasterize Content". Reason:
ERROR_REASON |
操作に失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[コンテンツをラスタライズ] アクションを使用した場合のスクリプト結果出力の値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。