SMART datagrid v1.4 > Reporting > Concepts
SMART datagrid Reporting에서 지정하는 위치와 크기 값은 PrintDimension 자료형으로 설정된다. 아래 테이블에 나열한 몇 가지 단위로 지정할 수 있는데, 단위를 명시하지 않으면 pixel로 지정된다.
pixel이 아닌 경우 전역 상수인 html dpi 값에 따라 내부적으로 pixel로 변환되는데, html dpi 기본값은 96이다. Dpi 전역값은 PrintOptions를 통해 변경할 수 있다.
| 단위 | 설명 | 예제 |
|---|---|---|
| in | inches. '값 x dpi' 으로 변환된다. | '120in' |
| cm | centimeters. '값 x 0.393701 dpi*' 으로 변환된다. | '21.1cm' |
| mm | milliimeters. '값 x 0.0393701 dpi*' 으로 변환된다. | '211mm' |
| px | pixels. 기본값. 단위를 지정하지 않아도 된다. | '800px', 1200 |
var report = {
pageHeader: {
items: [{
right: '1cm',
text: 'DataLudi Inc'
}]
},
...
};
DLReport.preview(grdMain, report, data, {
// PrintOptions
papaerWidth: "180mm",
paperHeight: "23.0cm",
paperMaringTop: "0.3in",
paperMarginBottom: "50px",
paperMarginLeft: 43
...
}, true);
순수 웹 프린팅에서 Javascript가 알거나 제어할 수 있는 프린트 정보는 거의 없다고 할 수 있다. 특히, 기본 프린터의 종이 크기를 알 수도 없기 때문에 개발자(혹은, 사용자)가 물리적으로 설정된 프린트의 종이 크기와 여백 및 인쇄 방향을 직접 설정해야 출력되는 요소들의 크기가 실제 크기와 맞게 된다.
SMART datagrid 리포팅 모듈에서는 PrintOptions를 통해서 이런 설정들을 할 수 있고, 설정 정보는 DLReport.preview 함수로 전달된다.
PrintOptions에서 종이 너비와 높이는 A4(210 X 297mm)로 기본 설정되어 있고, 상, 하, 좌, 우 여백은 각각 15mm, 15mm, 12mm, 12mm가 기본값이다. 또, 출력 방향은 PaperOrientation.PORTRAIT로 설정돼 있다. 이 값들이 물리적 프린터 설정과 일치해야 출력된 문서에서 각 요소들의 실제 크기가 리포트 모델에서 지정한 크기와 동일하게 된다.
특히, 브라우저들은 스케일링을 통해서 페이지 맞춤을 처리하고 있으므로 브라우저 미리보기에서 페이지 별로 잘 표시된다고 해서 실측에 잘 맞춰진 상태를 의미하는 것은 아니다. 치수가 중요한 출력물인 경우 반드시 출력된 문서로 실제 측정해봐야 한다. 또, 경험적으로 1mm 수준의 오차는 존재할 수 있으므로 특히 여러 페이지를 출력해야 하는 경우 등을 위해서는 특정한 프린터에 대한 다소의 시행착오가 필요할 수도 있다.