개요

잡(Job)은 스케줄에 의해 실행되는 작업 단위입니다. 잡은 특정 거래와 연결되어 있으며, 스케줄이 실행될 때 해당 거래를 호출합니다.

잡의 주요 특징은 다음과 같습니다.

  • 업무시스템 내에 배포된 거래를 지정하여 실행합니다.

  • 요청 메시지의 필드 값을 설정하여 거래에 전달합니다.

  • 대기 관리 방식을 통해 동시 실행 시 동작을 제어합니다.

  • 스케줄과 연동하여 주기적으로 실행하거나, 즉시 실행할 수 있습니다.

잡 목록 조회

잡 목록을 조회하려면 WebAdmin 메인 메뉴에서 [운영관리] > [잡]을 선택합니다.

잡 화면은 잡 목록 테이블과 상단의 검색창으로 구성됩니다.

job list
  • ① 검색창

    검색 조건을 설정하여 잡을 조회할 수 있습니다. 잡 아이디, 잡 이름, 거래 이름을 기준으로 검색할 수 있습니다.

    하나의 조건에 여러 값을 입력할 경우 쉼표(,)로 구분합니다.

  • ② 잡 목록

    검색 영역에서 설정한 조건에 따라 잡 목록이 표시됩니다.

잡 생성

잡을 생성하려면 잡 목록 오른쪽 상단의 [+ 생성] 버튼을 클릭합니다.

잡 생성 화면에서 설정 항목을 입력한 후 [생성] 버튼을 클릭합니다.

job create

다음은 설정 항목에 대한 설명입니다. (*: 필수 설정 항목)

항목 설명

잡 아이디 *

잡의 고유 식별자입니다. 영문, 숫자, 언더스코어(_)를 조합하여 2~32자 이내로 입력합니다.

잡 이름

잡의 이름을 입력합니다. 미입력 시 아이디 값으로 자동 설정됩니다.

실행 모드 *

잡의 동시 실행을 제어하는 방식을 선택합니다.

  • 비동기 처리 : 이전 잡의 완료를 기다리지 않고 바로 실행합니다. 여러 잡이 동시에 실행될 수 있습니다. (기본값)

  • 동기 (이전 잡 종료 후 실행): 이전 잡이 완료될 때까지 대기한 후 실행합니다.

  • 동기 (중복 시 실행 취소): 이전 잡이 실행 중인 경우 현재 잡 실행을 취소합니다.

거래 *

입력 필드를 클릭 시 표시되는 우측 사이드 패널에서 거래를 선택합니다.

배포된 거래만 선택할 수 있습니다.

거래 응답 대기 시간 (ms)

거래를 선택하면 선택한 거래의 타임아웃 설정이 자동으로 표시됩니다. 직접 수정할 수 없습니다.

거래를 선택하면 해당 거래의 요청 메시지가 표시됩니다. 각 필드에 잡 실행 시 전달할 값을 입력합니다.

job create message
항목 설명

메시지/필드 이름

선택된 거래의 요청 메시지와 필드의 이름

필드 아이디

메시지 필드의 ID

타입

메시지 필드의 데이터 타입

  • String

  • Object

  • Integer, int

  • Long, long

  • Float, float

  • Double, double

  • Boolean, boolean

각 필드에 전달할 값을 입력합니다. 타입에 맞는 값을 입력해야 합니다.

OBJECT 타입 필드는 중첩된 하위 필드를 가질 수 있습니다.

잡 상세 조회

잡 목록에서 특정 항목을 클릭하면 해당 잡의 상세 정보를 확인하고 수정할 수 있습니다.

job detail

조회 가능한 상세 정보는 잡 생성을 참고합니다.

잡 수정 및 삭제

잡 정보를 수정하려면 잡 상세 정보 화면에서 [편집] 버튼을 클릭하여 편집 모드로 전환합니다.

설정 정보를 수정한 후 [저장] 버튼을 클릭합니다.

  1. 잡 아이디는 변경할 수 없습니다.

  2. 거래를 변경하면 요청 메시지 필드가 선택한 거래의 메시지 구조에 맞게 갱신됩니다.

잡을 삭제하려면 잡 목록에서 삭제할 잡의 체크박스를 선택한 후, 목록 상단의 [삭제] 버튼을 클릭합니다.

스케줄에서 사용 중인 잡은 삭제할 수 없습니다. 삭제를 시도하면 해당 잡을 사용하는 스케줄 목록이 표시됩니다. 잡은 스케줄에서 제거한 후 삭제할 수 있습니다.

여러 건의 잡을 삭제할 때 일부 잡의 삭제에 실패하더라도, 삭제 가능한 잡은 정상적으로 삭제됩니다.

삭제에 실패한 잡은 실패 사유(연결된 스케줄 목록)와 함께 결과에 표시됩니다.

잡 실행

잡 목록에서 실행할 잡의 [발송] 버튼을 클릭하면 해당 잡에 저장된 요청 메시지 값으로 거래를 즉시 실행합니다.

job send immediately

잡 실행 결과는 [통계분석] > [스케줄 실행 이력] 메뉴에서 확인할 수 있습니다. 자세한 내용은 스케줄 실행 이력을 참고합니다.

테스트 발송

잡 생성 및 수정 화면에서 요청 메시지 영역 오른쪽 상단의 [테스트 발송] 버튼을 클릭합니다.

job send test

테스트 발송은 잡을 저장하지 않고 현재 화면에 입력된 값으로 거래를 실행함으로써, 메시지 값이 올바르게 동작하는지 미리 확인할 수 있습니다.

테스트 발송 결과는 스케줄 실행 이력에 'test’라는 잡 아이디로 기록됩니다.