이미지 유틸리티

조사 중에 이미지 및 파일 콘텐츠를 분석, 추출, 변환하는 데 도움이 되는 유틸리티 작업 집합입니다. 주요 기능으로는 텍스트 추출을 위한 광학 문자 인식 (OCR), 래스터화 (웹 콘텐츠를 정적 이미지로 변환), 파일 형식 변환이 있습니다. 모든 작업에는 원격 에이전트가 필요합니다.

작업

작업에 대한 자세한 내용은 내 Workdesk에서 대기 중인 작업에 응답 및 수동 작업 실행을 참고하세요.

파일 변환

파일 변환 작업을 사용하여 지정된 파일의 형식을 변경합니다.

작업 입력

파일 변환 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
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)

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를 선택한 경우 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 선택기입니다.

작업 출력

콘텐츠 래스터화 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용할 수 없음
케이스 월 링크 사용할 수 없음
케이스 월 테이블 사용할 수 없음
보강 테이블 사용할 수 없음
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시에서는 콘텐츠 래스터화 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

[
   {
       "attachment_name": "",
       "file_path": ""
   }
]
출력 메시지

콘텐츠 래스터화 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

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

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 콘텐츠 래스터화 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.