Utilitas Gambar

Serangkaian tindakan utilitas untuk membantu menganalisis, mengekstrak, dan mengonversi konten gambar dan file selama penyelidikan. Fungsi utama mencakup pengenalan karakter optik (OCR) untuk ekstraksi teks, rasterisasi (mengonversi konten web menjadi gambar statis), dan konversi format file. Semua tindakan memerlukan Agen Jarak Jauh.

Tindakan

Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan tertunda dari Ruang Kerja Anda dan Melakukan tindakan manual.

Mengonversi File

Gunakan tindakan Convert File untuk mengubah format file yang ditentukan.

Input tindakan

Tindakan Convert File memerlukan parameter berikut:

Parameter Deskripsi
Input File Format

Wajib.

Format asli file yang dikonversi oleh tindakan.

Kemungkinan nilainya adalah sebagai berikut:

  • PNG
  • PDF

Nilai defaultnya adalah PNG.
Input File Path

Wajib.

Jalur ke file yang dikonversi oleh tindakan.
Output File Format

Wajib.

Format file yang dihasilkan setelah proses konversi.

Kemungkinan nilainya adalah sebagai berikut:

  • PNG
  • PDF

Nilai defaultnya adalah PDF.

Output tindakan

Tindakan Convert File memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Konversi File:

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

Tindakan Convert File dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully converted file.

 Tindakan berhasil.
Error executing action "Convert File". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Konversi File:

Nama hasil skrip Nilai
is_success true atau false

Gambar OCR

Gunakan tindakan OCR Gambar untuk menjalankan OCR dan mengekstrak teks dari file gambar.

Input tindakan

Tindakan Gambar OCR memerlukan parameter berikut:

Parameter Deskripsi
Base64 Encoded Image

Opsional.

String berenkode base64 dari file gambar.
File Path

Wajib.

Jalur ke file gambar.

Output tindakan

Tindakan Gambar OCR memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Gambar OCR:

{ 
  "extracted_text": "",
}
Pesan output

Tindakan OCR Image dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully performed OCR on the provided image.

 Tindakan berhasil.
Error executing action "OCR Image". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Gambar OCR:

Nama hasil skrip Nilai
is_success true atau false

Merasterkan Konten

Gunakan tindakan Rasterisasi Konten untuk mengonversi konten vektor atau kompleks menjadi format gambar bitmap tetap.

Prasyarat Agen Jarak Jauh (Debian)

Untuk memastikan tindakan Rasterisasi Konten berhasil dijalankan di Agen Jarak Jauh berbasis Debian, Anda harus menginstal paket dan dependensi berikut:

Library Python Playwright

Instal Playwright Python Library menggunakan perintah berikut:

python3.11 -m pip install playwright
Dependensi browser

Instal dependensi browser Chromium yang diperlukan agar Playwright berfungsi dengan benar:

playwright install --with-deps chromium

Input tindakan

Parameter Deskripsi
Input Type

Wajib.

Jenis konten yang digunakan tindakan sebagai input utamanya.

Kemungkinan nilainya adalah sebagai berikut:

  • URL
  • Email
  • HTML

Nilai defaultnya adalah URL.
URLs or Body

Wajib.

Konten input yang akan dirasterisasi, berdasarkan Input Type yang dipilih.

Jika URL dipilih, berikan daftar URL yang dipisahkan koma.

Jika Email atau HTML dipilih, berikan isi konten lengkap dari jenis input tersebut.
Output Type

Opsional.

Format output yang dihasilkan untuk konten yang di-raster.

Kemungkinan nilainya adalah sebagai berikut:

  • PNG
  • PDF
  • Both

Nilai defaultnya adalah PNG.
Export Method

Opsional.

Metode yang digunakan untuk menghasilkan konten yang dibuat.

Kemungkinan nilainya adalah sebagai berikut:

  • Case Attachment
  • File Path
  • Both

Nilai defaultnya adalah Case Attachment.
Width

Wajib.

Lebar (dalam piksel) yang digunakan untuk konten raster yang dihasilkan.

Nilai defaultnya adalah 1920.
Height

Wajib.

Tinggi (dalam piksel) yang digunakan untuk konten raster yang dihasilkan.

Nilai defaultnya adalah 1080.
Full Screen

Opsional.

Jika dipilih, konten dirender di seluruh jendela browser sebelum di-raster.

Dinonaktifkan secara default.
Timeout

Opsional.

Waktu maksimum (dalam detik) yang digunakan browser untuk merender konten sebelum rasterisasi dimulai.

Nilai maksimum adalah 60.

Nilai defaultnya adalah 120.
Wait For

Opsional.

Status spesifik yang harus dicapai browser sebelum tindakan dilanjutkan dengan rasterisasi atau ekstraksi konten.

Status NETWORK_IDLE umumnya yang paling andal.

Kemungkinan nilainya adalah sebagai berikut:

  • LOAD
  • DOM_CONTENT_LOADED
  • NETWORK_IDLE COMMIT

Nilai defaultnya adalah NETWORK_IDLE.
Wait for Selector

Opsional.

Pemilih CSS yang ditunggu oleh tindakan agar muncul di halaman sebelum mengambil screenshot.

Output tindakan

Tindakan Rasterisasi Konten memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Rasterisasi Konten:

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

Tindakan Rasterisasi Konten dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

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.

 Tindakan berhasil.
Error executing action "Rasterize Content". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Rasterize Content:

Nama hasil skrip Nilai
is_success true atau false

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.