BIRT 보고서
BIRT(Business Intelligence and Reporting Tools)에 대한 EGL 지원의 핵심은 BIRTReport라는 외부 유형입니다. 이 주제에서는 해당 유형의 변수를 작성하는 방법과 이 변수를 사용하여 출력을 작성하는 방법에 대해 설명합니다.
BIRT에 대한 EGL 지원의 개요에 대해서는 프로그래머 안내서에서 "BIRT를 사용하여 보고서 작성"을 참조하십시오.
BIRTReport 유형의 변수 선언
보고서(BIRTReport 유형의 변수)를 선언할 때 출력 작성에 필요한 일부 또는 모든 세부사항을 포함시킬 수 있습니다. 그런 다음 보고서 특정 필드와 함수를 호출하여 선언에 포함되지 않은 세부사항을 추가하거나 세부사항을 변경할 수 있습니다. 어떤 경우에도 여러 세부사항을 지정하고 나중에 특정 보고서에 대한 출력을 작성하는 함수를 호출합니다.
보고서를 작성할 때 다음 구문을 사용하여 세부사항을 지정할 수 있습니다.
myReport BIRTReport = new BIRTReport
(designFile, documentFile, reportFile,
outputFormat, reportHandler);
- myReport
- 변수 이름입니다.
- designFile
- 디자인 파일의 이름입니다. 디자인 파일이 아닌 문서 파일에서 출력을 작성하는 경우
사용자가 지정한 이름은 무시됩니다. 그러나 명확하게 하기 위해
파일 이름 대신 널을 지정할 수 있습니다.
이 주제의 후반부에 있는 "파일 이름 지정 규칙"도 참조하십시오.
- documentFile
- 문서 파일의 이름입니다. 디자인 파일에서 출력을 작성하는 경우
사용자가 지정한 이름은 무시됩니다. 그러나 명확하게 하기 위해
파일 이름 대신 널을 지정할 수 있습니다.
이 주제의 후반부에 있는 "파일 이름 지정 규칙"도 참조하십시오.
- reportFile
- 보고서 파일의 이름입니다. 문서 파일을 작성하고 출력은 작성하지 않는 경우
사용자가 지정한 이름은 무시됩니다. 그러나 명확하게 하기 위해
파일 이름 대신 널을 지정할 수 있습니다.
이 주제의 후반부에 있는 "파일 이름 지정 규칙"도 참조하십시오.
- outputFormat
- 출력을 작성하는 경우 "HTML", "PDF" 또는 해당 문자열 중 하나를 해석하는 변수를 지정하십시오. 기본값은 "HTML"입니다. 문서 파일만 작성하는 경우 모든 설정은 무시됩니다. 그러나 명확하게 하기 위해 출력 형식 대신 널을 지정할 수 있습니다.
- reportHandler
- BIRT 핸들러 파트를 기반으로 하는 변수 이름입니다. 이 핸들러 파트에는 런타임 시 이벤트에 응답하는 함수가 포함됩니다. BIRT 핸들러 파트를 사용하지 않는 경우 변수 이름 대신 널을 지정하십시오.
마지막이 STRING? 유형인 각 필드(물음표는 널이 유효함을 표시함). 마지막 필드는 ANY 유형입니다.
myReport BIRTReport{};
- myReport
- 변수 이름입니다.
myReport BIRTReport = new BIRTReport();
보고서 특정 필드와 함수
BIRTReport 유형의 각 변수는 디자인 파일, 문서 파일, 보고서 파일 또는 출력 형식의 이름을 지정할 수 있는 필드에 대한 액세스를 제공합니다. 각 필드에 대한 참조는 보고서 이름(예: myReport) 뒤에 옵니다. 다음은 명령문 예입니다.
myReport.designFile = "C:/myDesignFile.rptDesign";
- designFile
- 디자인 파일의 이름입니다. 디자인 파일이 아닌 문서 파일에서 출력을 작성하는 경우
사용자가 지정한 이름은 무시됩니다. 그러나 명확하게 하기 위해
파일 이름 대신 널을 지정하거나 이름을 전혀 지정하지 않도록 할 수 있습니다.
이 주제의 후반부에 있는 "파일 이름 지정 규칙"도 참조하십시오.
- documentFile
- 문서 파일의 이름입니다. 디자인 파일일에서 출력을 작성하는 경우
사용자가 지정한 이름은 무시됩니다. 그러나 명확하게 하기 위해
파일 이름 대신 널을 지정하거나 이름을 전혀 지정하지 않도록 할 수 있습니다.
이 주제의 후반부에 있는 "파일 이름 지정 규칙"도 참조하십시오.
- reportFile
- 보고서 파일의 이름입니다. 문서 파일을 작성하고 출력은 작성하지 않는 경우
사용자가 지정한 이름은 무시됩니다. 그러나 명확하게 하기 위해
파일 이름 대신 널을 지정할 수 있습니다.
이름을 지정하지 않아도 createReportFromDesign 또는 createReportFromDocument가 호출되는 경우 보고서 엔진은 출력이 작성될 때 이름을 지정합니다.
이 주제의 후반부에 있는 "파일 이름 지정 규칙"도 참조하십시오.
- outputFormat
- 출력을 작성하는 경우 필드를 "HTML", "PDF" 또는 해당 문자열 중 하나를 해석하는 표현식으로 설정하십시오. 기본값은 "HTML"입니다. 문서 파일만 작성하는 경우 모든 설정은 무시됩니다. 그러나 명확하게 하기 위해 출력 형식 대신 널을 지정할 수 있습니다.
- 보고서 매개변수의 기본값을 얻습니다(있는 경우). BIRT 보고서 디자이너의 데이터 탐색기 보기에서 작업 중인 경우 보고서 디자이너가 매개변수를 선언합니다.
- 보고서를 작성하기 전에 보고서 매개변수의 값을 설정합니다.
- 보고서 핸들러를 지정합니다.
- PDF 또는 HTML 형식의 출력을 생성하거나 문서 파일만 생성할 수 있는 세 개의 create 함수 중 하나를 호출하여 보고서를 작성합니다. 필드 값, 보고서 매개변수 값 또는 보고서 핸들러는 지정한 경우 이후에 보고서 특정 create 함수를 호출한 경우에만 변경사항이 적용됩니다. 문서 파일은 파일이 작성된 위치에 있는 매개변수 값을 반영하기 때문에 문서 파일에서 보고서를 작성하는 경우 보고서 매개변수 값을 지정해도 아무 영향을 미치지 않음을 참고하십시오.
myReport.setParameterValue("CustomerNumber", 500);
myReport.setParameterValue
(parameterName STRING in, parameterValue ANY in);
- parameterName
- 매개변수의 이름입니다.
- parameterValue
- 매개변수의 값입니다.
myReport.getParameterDefaultValue
(parameterName STRING in) returns (parameterValue);
- parameterName
- 매개변수의 이름입니다.
- parameterValue
- ANY 유형의 매개변수 값입니다.
myReport.setReportHandler (reportHandler ANY in);
- reportHandler
- BIRT 핸들러 파트를 기반으로 하는 변수 이름입니다. 이 핸들러 파트에는 런타임 이벤트에 응답하는 함수가 포함됩니다. BIRT 핸들러 파트를 사용하지 않는 경우 널을 지정하거나 이 함수를 호출하지 마십시오.
- myReport.createReportFromDesign ()은 디자인 파일에서 출력을 작성하고 필드와 함수(있는 경우)에서 지정한 정보를 사용하지만, 문서 파일을 저장하지 않습니다.
- myReport.createReportFromDocument ()는 중간 형식의 기존 보고서를 HTML 또는 PDF로 변환하여 기존 문서 파일에서 출력을 작성합니다.
- myReport.createDocument ()는 디자인 파일에서 문서 파일을 작성하고 필드와 함수에서 지정한 정보를 사용합니다.
파일 이름 지정 규칙
- 이름을 UNIX 형식으로 표현할 수 있습니다(예: C:/myFolder/myFile.rptDesign). 또는 Windows 형식을 사용하지만 EGL에서 백슬래시를 이스케이프 문자로 사용하는 계정을 사용해야 합니다(예: C:\\myDirectory\\myDesignFile.rptDesign).
- 파일이 있는 프로젝트와 관련하여 파일 이름을 표현할 수 있습니다.
- 리터럴 문자열 또는 변수를 사용할 수 있습니다.
- UNIX 시스템에서 임시 디렉토리는 /tmp 또는 /var/tmp입니다.
- Microsoft 2000/XP에서 임시 디렉토리는 C:\\temp입니다.
파일 이름은 "BIRTReport" 문자열로 시작합니다. 해당 문자열 뒤에 EGL 시스템 코드에서 지정한 문자 세트가 옵니다. 파일 확장자는 파일 유형에 따라 적절하게 .rptdocument, .PDF 또는 .HTML로 지정됩니다.