RwReportViewer
RwReportViewer는 WaveWorks 보고서 모델을 윈도우에 렌더링하고 미리보기 또는 인쇄 흐름을 제공하는 구성요소입니다.
보고서 표시 영역
ItemSource에 보고서 데이터와 템플릿 정보를 전달하고 Title, Width와 Height로 뷰어 창을 구성합니다. Show 메서드의 print 값으로 일반 보기와 인쇄 실행을 구분합니다.
보고서 보기 적용 기준
서버 또는 보고서 엔진에서 준비한 문서를 화면에서 확인하고 인쇄할 때 사용합니다. 단순 HTML 표 내보내기에는 Excel 또는 브라우저 인쇄가 더 적합할 수 있습니다.
보고서와 출력 설정
| 파라미터 | 용도 |
|---|---|
| ItemSource | 렌더링할 WaveWorksReportModel입니다. |
| Title | 뷰어 윈도우 제목입니다. |
| Width | 뷰어 초기 너비이며 기본값은 1000입니다. |
| Height | 뷰어 초기 높이이며 기본값은 800입니다. |
| Show(print) | 미리보기 또는 인쇄 모드로 창을 엽니다. |
조회와 내보내기
- 보고서 템플릿과 데이터를 ItemSource에 구성합니다.
- 사용자가 알아볼 수 있는 Title을 지정합니다.
- 일반 화면 크기에 맞는 Width와 Height를 정합니다.
- 데이터 준비가 끝난 뒤 Show를 호출합니다.
- 인쇄 후 결과와 오류 메시지를 확인합니다.
로딩과 오류 처리
뷰어는 호출 시점의 ItemSource를 사용합니다. 조회가 진행 중이거나 모델이 비어 있을 때 Show를 호출하지 않도록 상위 화면에서 상태를 제어합니다.
보고서 대체 정보
보고서 제목을 명확히 제공하고 뷰어 창의 닫기와 인쇄 단추를 키보드로 사용할 수 있게 합니다. 시각 보고서의 핵심 결과는 별도 텍스트나 표로도 제공하는 것이 좋습니다.
권한과 대용량 출력
큰 보고서는 렌더링과 인쇄에 시간이 걸릴 수 있습니다. 중복 Show 호출을 막고, 인쇄는 브라우저와 클라이언트 환경에 따라 다를 수 있으므로 배포 대상에서 확인합니다.
보고서 화면 점검
- 데이터 없음과 여러 페이지 보고서를 확인합니다.
- 미리보기와 인쇄 모드가 구분되는지 확인합니다.
- 창 닫기 후 다시 열 때 최신 모델을 사용하는지 확인합니다.