Utilità per le immagini

Un insieme di azioni di utilità per assistere nell'analisi, nell'estrazione e nella conversione di contenuti di immagini e file durante le indagini. Le funzioni principali includono il riconoscimento ottico dei caratteri (OCR) per l'estrazione del testo, la rasterizzazione (conversione dei contenuti web in immagini statiche) e la conversione del formato dei file. Tutte le azioni richiedono un agente remoto.

Azioni

Per ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

Converti file

Utilizza l'azione Converti file per modificare il formato di un file specificato.

Importante: questa azione richiede un agente remoto per funzionare correttamente.

Input azione

L'azione Converti file richiede i seguenti parametri:

Parametro	Descrizione
Input File Format	Obbligatorio. Il formato originale del file che l'azione converte. I valori possibili sono: PNG PDF Il valore predefinito è PNG.
Input File Path	Obbligatorio. Il percorso del file che l'azione converte.
Output File Format	Obbligatorio. Il formato risultante del file dopo il processo di conversione. I valori possibili sono: PNG PDF Il valore predefinito è PDF.

Output dell'azione

L'azione Converti file fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	Non disponibile
Link alla bacheca richieste	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra gli output dei risultati JSON ricevuti quando si utilizza l'azione Converti file:

[
   {
       "output_format": ""  
       "file_path": ""
   }
]

Messaggi di output

L'azione Converti file può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully converted file.	L'azione è riuscita.
Error executing action "Convert File". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando utilizzi l'azione Converti file:

Nome del risultato dello script	Valore
is_success	true o false

Immagine OCR

Utilizza l'azione OCR Image per eseguire l'OCR ed estrarre il testo da un file immagine.

Importante: questa azione richiede un agente remoto con il pacchetto tesseract-ocr installato per funzionare correttamente.

Input azione

L'azione Immagine OCR richiede i seguenti parametri:

Parametro	Descrizione
Base64 Encoded Image	Facoltativo. La stringa con codifica base64 del file immagine.
File Path	Obbligatorio. Il percorso del file immagine. Nota:se vengono forniti sia Base64 Encoded Image sia File Path, viene elaborato Base64 Encoded Image.

Output dell'azione

L'azione Immagine OCR fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	Non disponibile
Link alla bacheca richieste	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

Il seguente esempio mostra gli output dei risultati JSON ricevuti quando si utilizza l'azione OCR Image:

{ 
  "extracted_text": "",
}

Messaggi di output

L'azione Immagine OCR può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully performed OCR on the provided image.	L'azione è riuscita.
Error executing action "OCR Image". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando si utilizza l'azione Immagine OCR:

Nome del risultato dello script	Valore
is_success	true o false

Rasterizza contenuti

Utilizza l'azione Rasterizza contenuti per convertire contenuti vettoriali o complessi in un formato immagine bitmap fisso.

Importante: questa azione richiede un agente remoto con il pacchetto playwright installato per funzionare correttamente.

Prerequisiti dell'agente remoto (Debian)

Per garantire che l'azione Rasterizza contenuti venga eseguita correttamente su un agente remoto basato su Debian, devi installare i seguenti pacchetti e dipendenze:

Libreria Python Playwright

Installa la libreria Python di Playwright utilizzando il seguente comando:

python3.11 -m pip install playwright

Dipendenze del browser

Installa le dipendenze del browser Chromium necessarie per il corretto funzionamento di Playwright:

playwright install --with-deps chromium

Input azione

Parametro	Descrizione
Input Type	Obbligatorio. Il tipo di contenuti che l'azione utilizza come input principale. I valori possibili sono: URL Email HTML Il valore predefinito è URL.
URLs or Body	Obbligatorio. I contenuti di input da rasterizzare, in base al Input Type selezionato. Se è selezionato URL, fornisci un elenco di URL separati da virgole. Se è selezionato Email o HTML, fornisci il corpo completo dei contenuti di quel tipo di input.
Output Type	Facoltativo. Il formato di output risultante per i contenuti rasterizzati. I valori possibili sono: PNG PDF Both Il valore predefinito è PNG.
Export Method	Facoltativo. Il metodo utilizzato per generare l'output dei contenuti generati. I valori possibili sono: Case Attachment File Path Both Il valore predefinito è Case Attachment.
Width	Obbligatorio. La larghezza (in pixel) utilizzata per i contenuti raster generati. Il valore predefinito è 1920.
Height	Obbligatorio. L'altezza (in pixel) utilizzata per i contenuti raster generati. Il valore predefinito è 1080.
Full Screen	Facoltativo. Se selezionati, i contenuti vengono visualizzati nell'intera finestra del browser prima di essere rasterizzati. Disabilitato per impostazione predefinita.
Timeout	Facoltativo. Il tempo massimo (in secondi) che il browser dedica al rendering dei contenuti prima dell'inizio della rasterizzazione. Il valore massimo è 60. Il valore predefinito è 120.
Wait For	Facoltativo. Lo stato specifico che il browser deve raggiungere prima che l'azione proceda con la rasterizzazione o l'estrazione dei contenuti. Lo stato NETWORK_IDLE è in genere il più affidabile. I valori possibili sono: LOAD DOM_CONTENT_LOADED NETWORK_IDLE COMMIT Il valore predefinito è NETWORK_IDLE.
Wait for Selector	Facoltativo. Un selettore CSS che l'azione attende che venga visualizzato sulla pagina prima di acquisire lo screenshot. Nota:questa impostazione è consigliata per le pagine in cui i contenuti vengono caricati in modo dinamico, in quanto conferma la presenza di tutti gli elementi prima dell'esecuzione dell'azione.

Output dell'azione

L'azione Rasterizza contenuti fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	Non disponibile
Link alla bacheca richieste	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra gli output dei risultati JSON ricevuti quando si utilizza l'azione Rasterizza contenuti:

[
   {
       "attachment_name": "",
       "file_path": ""
   }
]

Messaggi di output

L'azione Rasterizza contenuti può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
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.	L'azione è riuscita.
Error executing action "Rasterize Content". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando si utilizza l'azione Rasterizza contenuti:

Nome del risultato dello script	Valore
is_success	true o false

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.