圖片公用程式

這組實用動作可協助您在調查期間分析、擷取及轉換圖片和檔案內容。主要功能包括光學字元辨識 (OCR) 文字擷取、點陣化 (將網頁內容轉換為靜態圖片) 和檔案格式轉換。所有動作都需要遠端服務專員。

動作

如要進一步瞭解動作，請參閱「 從工作台回覆待處理動作」和「執行手動動作」。

轉換檔案

使用「轉換檔案」動作，即可變更指定檔案的格式。

動作輸入內容

「轉換檔案」動作需要下列參數：

參數 說明
Input File Format

必填。

動作轉換的檔案原始格式。

可能的值如下：

  • PNG
  • PDF

預設值為 PNG。
Input File Path

必填。

動作轉換的檔案路徑。
Output File Format

必填。

轉換程序完成後，檔案的格式。

可能的值如下：

  • PNG
  • PDF

預設值為 PDF。

動作輸出內容

「轉換檔案」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「轉換檔案」動作時收到的 JSON 結果輸出內容：

[
   {
       "output_format": ""  
       "file_path": ""
   }
]
輸出訊息

「轉換檔案」動作可能會傳回下列輸出訊息：

輸出訊息 訊息說明

Successfully converted file.

 動作成功。
Error executing action "Convert File". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「轉換檔案」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
is_success true或false

OCR 圖片

使用 OCR 圖片動作執行 OCR，並從圖片檔案中擷取文字。

動作輸入內容

「OCR 圖片」動作需要下列參數：

參數 說明
Base64 Encoded Image

選填。

圖片檔案的 Base64 編碼字串。
File Path

必填。

圖片檔案的路徑。

動作輸出內容

「OCR 圖片」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「OCR 圖片」動作時收到的 JSON 結果輸出內容：

{ 
  "extracted_text": "",
}
輸出訊息

「OCR 圖片」動作可傳回下列輸出訊息：

輸出訊息 訊息說明

Successfully performed OCR on the provided image.

 動作成功。
Error executing action "OCR Image". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用 OCR 圖片動作時，指令碼結果輸出的值：

指令碼結果名稱 值
is_success true或false

點陣化內容

使用「光柵化內容」動作，將向量或複雜內容轉換為固定點陣圖圖片格式。

遠端代理程式的必要條件 (Debian)

如要確保 Rasterize Content 動作在以 Debian 為基礎的遠端代理程式上順利執行，請安裝下列套件和依附元件：

Playwright Python 程式庫

使用下列指令安裝 Playwright Python 程式庫：

python3.11 -m pip install playwright
瀏覽器依附元件

安裝 Playwright 正常運作所需的 Chromium 瀏覽器依附元件：

playwright install --with-deps chromium

動作輸入內容

參數 說明
Input Type

必填。

動作做為主要輸入內容使用的內容類型。

可能的值如下：

  • URL
  • Email
  • HTML

預設值為 URL。
URLs or Body

必填。

要點陣化的輸入內容，取決於所選的 Input Type。

如果選取 URL，請提供以半形逗號分隔的網址清單。

如果選取 Email 或 HTML，請提供該輸入類型的完整內容主體。
Output Type

選填。

點陣化內容的輸出格式。

可能的值如下：

  • PNG
  • PDF
  • Both

預設值為 PNG。
Export Method

選填。

用於輸出生成內容的方法。

可能的值如下：

  • Case Attachment
  • File Path
  • Both

預設值為 Case Attachment。
Width

必填。

用於產生的點陣內容寬度 (以像素為單位)。

預設值為 1920。
Height

必填。

用於產生的點陣內容高度 (以像素為單位)。

預設值為 1080。
Full Screen

選填。

如果選取這個選項，系統會先在整個瀏覽器視窗中顯示內容，再進行點陣化。

預設為停用。
Timeout

選填。

瀏覽器在開始點陣化之前，用於算繪內容的時間上限 (以秒為單位)。

最大值為 60。

預設值為 120。
Wait For

選填。

瀏覽器必須達到特定狀態，動作才會繼續進行點陣化或內容擷取。

NETWORK_IDLE 狀態通常最可靠。

可能的值如下：

  • LOAD
  • DOM_CONTENT_LOADED
  • NETWORK_IDLE COMMIT

預設值為 NETWORK_IDLE。
Wait for Selector

選填。

動作等待顯示在網頁上的 CSS 選取器，然後擷取螢幕截圖。

動作輸出內容

「Rasterize Content」(點陣化內容) 動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「Rasterize Content」(點陣化內容) 動作時收到的 JSON 結果輸出內容：

[
   {
       "attachment_name": "",
       "file_path": ""
   }
]
輸出訊息

「Rasterize Content」(點陣化內容) 動作可傳回下列輸出訊息：

輸出訊息 訊息說明

Successfully rasterized content based on the provided input.

Successfully rasterized content based on the following URLs: URLS

Action wasn't able to rasterize content for the following URLs: URLS

Action wasn't able to rasterize content for the provided URLs.

 動作成功。
Error executing action "Rasterize Content". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「Rasterize Content」(點陣化內容) 動作時，指令碼結果輸出的值：

指令碼結果名稱 值
is_success true或false

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求答案。