개요

i-AUD Viewer에서 보고서를 열거나 데이터를 조회(Refresh)할 때 발생하는 이벤트의 종류와 실행 순서를 알아보겠습니다.

보고서 개발자는 해당 가이드를 참고하여 적절한 시점에 스크립트가 실행되도록 로직을 설계해야 합니다.

보고서 이벤트 API 목록

보고서(Document) 및 컨트롤 동작 시점에서 자동으로 호출되는 주요 이벤트 API입니다.

API 명	발생 시점	인자	적용 대상
OnDocumentLoadComplete	문서 로딩이 완료된 직후, 자동 조회(AutoRefresh)가 실행되기 전		Report
OnLoadComplete	문서 로딩 및 자동 조회(AutoRefresh)까지 모두 완료된 후	`Success`: 성공 여부 `Message`: 에러 메시지	Report
OnExecuteStart	데이터 조회(Refresh)가 시작될 때	`IsAutoRefresh`: 자동 조회 여부(Boolean) `Target`: 조회 대상 명칭 `Cancel`: `true` 반환 시 실행 취소	Control
OnRefreshComplete	데이터 조회(Refresh)가 완료된 후	`Success`: 성공 여부 `Message`: 에러 메시지	Report
OnDataBindEnd	데이터셋이 컨트롤에 바인딩(Binding)된 후	`Id`: 컨트롤 명 `RecordCount`: 조회된 데이터 건수	Control

컨트롤의 속성에서 설정할 수 있는 자동화 옵션입니다.

옵션 명	설명	비고
AutoRefresh	보고서를 열 때 자동으로 데이터를 조회할지 여부를 설정합니다.
doRefresh	보고서 상단의 [실행] 버튼 클릭 시 데이터를 조회할지 여부를 설정합니다.
AfterRefresh	특정 리스트(ComboBox) 아이템 선택 후, 이어서 자동으로 조회할 다른 컨트롤을 지정합니다.	ComboBox 컨트롤만 설정 가능

보고서의 라이프사이클에 따라 이벤트가 실행되는 순서입니다.

로직 작성 시 순서를 혼동하지 않도록 주의하세요.

보고서를 열 때	데이터를 조회할 때 (조회 컨트롤별)

개발자를 위한 Tip

Q1. 초기화는 어디에서 설정하나요?

A1. 변수 선언이나 UI 초기 세팅은 [OnDocumentLoadComplete] 시점에 작성하는 것이 가장 안전합니다.

Q2. 데이터 후처리는 어디에서 설정하나요?

A2. 데이터를 받아온 후 특정 셀의 색상을 바꾸거나 계산을 해야 한다면 [OnDataBineEnd] 시점이 적절합니다. 데이터가 화면에 뿌려진 직후이기 때문입니다.