페이지 트리

버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.


Easy Heading Macro
titleExpandClickabletrue
navigationTitle목차
navigationExpandOptioncollapse-all-but-headings-1

작성자 : 장민지 / 검수자 : - 


Release No. 7.0.500.20260122-11 


개요

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
컨트롤 이벤트 옵션 목록

화면 설명

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

  • ListGrid의 Event 속성
    Image Removed
  • ComboBox의 Event 속성
    Image Removed
옵션 명설명비고AutoRefresh보고서를 열 때 자동으로 데이터를 조회할지 여부를 설정합니다.DoRefresh보고서 상단의 [실행] 버튼 클릭 시 데이터를 조회할지 여부를 설정합니다.AfterRefreshComboBox의 목록에서 아이템 선택 후, 이어서 자동으로 조회할 다른 컨트롤을 지정합니다.ComboBox 컨트롤만 설정 가능



이벤트 실행 순서

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

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

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

image2025-4-28_14-14-27.png

image2025-4-28_14-14-42.png


참고사항

개발자를 위한 Tip

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

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

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

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