XML로 내보내기(보고서 작성기 2.0)
XML 렌더링 확장 프로그램은 보고서를 XML 형식으로 반환합니다. 보고서의 XML 스키마는 보고서마다 고유하며 데이터만 포함합니다. 레이아웃 정보는 렌더링되지 않으며 페이지 번호는 XML 렌더링 확장 프로그램을 통해 유지되지 않습니다. 이 확장 프로그램에서 생성된 XML을 데이터베이스로 가져오거나 XML 데이터 메시지로 사용하거나 사용자 지정 응용 프로그램으로 전송할 수 있습니다.
다음 표는 보고서 항목을 렌더링하는 방법을 설명합니다.
항목 |
렌더링 동작 |
|---|---|
보고서 |
XML 문서의 최상위 요소로 렌더링합니다. |
데이터 영역 |
해당 컨테이너 요소 내의 요소로 렌더링합니다. |
그룹 및 세부 정보 섹션 |
각 인스턴스를 해당 컨테이너 요소 내의 요소로 렌더링합니다. |
입력란 |
해당 컨테이너 내의 특성 또는 요소로 렌더링합니다. |
직사각형 |
해당 컨테이너 내의 요소로 렌더링합니다. |
행렬 열 그룹 |
행 그룹 내의 요소로 렌더링합니다. |
XML 렌더링 확장 프로그램을 사용하여 렌더링한 보고서는 다음과 같은 규칙을 따릅니다.
XML 요소 및 특성은 보고서 정의에 나타나는 순서대로 렌더링됩니다.
페이지 매기기는 무시됩니다.
페이지 머리글과 바닥글은 렌더링되지 않습니다.
토글을 통해 표시할 수 없는 숨겨진 항목은 렌더링되지 않습니다. 처음에 표시되는 항목과 토글을 통해 표시할 수 있는 숨겨진 항목은 렌더링됩니다.
Images, lines, and custom report items는 무시됩니다.
데이터 형식
입력란 요소 또는 특성은 입력란에 표시되는 값에 따라 XSD 데이터 형식이 지정됩니다.
입력란 값 |
지정되는 데이터 형식 |
|---|---|
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte |
xsd:integer |
Decimal(또는 Decimal 및 정수 또는 바이트 데이터 형식) |
xsd:decimal |
Float(또는 Decimal 및 정수 또는 바이트 데이터 형식) |
xsd:float |
Double(또는 Decimal 및 정수 또는 바이트 데이터 형식) |
xsd:double |
DateTime or DateTime Offset |
xsd:dateTime |
Time |
xsd:string |
Boolean |
xsd:boolean |
String, Char |
xsd:string |
기타 |
xsd:string |
XML 관련 렌더링 규칙
다음 섹션에서는 XML 렌더링 확장 프로그램을 통해 보고서 내의 항목이 어떻게 해석되는지 설명합니다.
보고서 본문
보고서는 XML 문서의 루트 요소로 렌더링됩니다. 요소의 이름은 속성 창에 설정된 DataElementName 속성을 따릅니다.
XML 네임스페이스 정의와 스키마 참조 특성도 보고서 요소에 포함됩니다. 변수는 굵은 글꼴로 표시됩니다.
<Report xmlns=”SchemaName” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xsi:schemaLocation=”SchemaNameReportURL&rc%3aSchema=true” Name=”ReportName”>
변수의 값은 다음과 같습니다.
이름 |
값 |
|---|---|
Report |
Report.DataElementName |
ReportURL |
서버의 보고서를 가리키는 URL 인코딩된 절대 URL |
Schemaname |
Report.SchemaName. Null인 경우 Report.Name입니다. Report.Name이 사용되는 경우 먼저 XmlConvert.EncodeLocalName으로 인코딩됩니다. |
ReportName |
보고서의 이름 |
입력란
입력란은 DataElementStyle RDL 속성에 따라 요소나 특성으로 렌더링됩니다. 요소 또는 특성의 이름은 TextBox.DataElementName RDL 속성을 따릅니다.
차트
차트는 XML로 렌더링됩니다. 차트 데이터는 구조화됩니다.
포함된 보고서
포함된 보고서는 요소로 렌더링됩니다. 요소의 이름은 DataElementName RDL 속성을 따릅니다. 포함된 보고서의 TextBoxesAsElements 속성 설정 대신 보고서의 해당 속성 설정이 적용됩니다. 네임스페이스 및 XSLT 특성은 포함된 보고서 요소에 추가되지 않습니다.
사각형
사각형은 요소로 렌더링됩니다. 요소의 이름은 DataElementName RDL 속성을 따릅니다.
사용자 지정 보고서 항목
CustomReportItems(CRI)는 렌더링 확장 프로그램에 표시되지 않습니다. 보고서에 사용자 지정 보고서 항목이 있는 경우 렌더링 확장 프로그램에서는 이를 일반적인 보고서 항목으로 렌더링합니다.
이미지
이미지는 렌더링되지 않습니다.
선
선은 렌더링되지 않습니다.
테이블, 행렬 및 목록
테이블, 행렬 및 목록은 요소로 렌더링됩니다. 요소의 이름은 테이블릭스 DataElementName RDL 속성을 따릅니다.
행 및 열
열은 행 안에 렌더링됩니다.
테이블릭스 모퉁이
모퉁이는 렌더링되지 않습니다. 모퉁이의 내용만 렌더링됩니다.
테이블릭스 셀
테이블릭스 셀은 요소로 렌더링됩니다. 요소의 이름은 셀의 DataElementName RDL 속성을 따릅니다.
자동 부분합
테이블릭스 자동 부분합은 렌더링되지 않습니다.
그룹과 함께 반복되지 않는 행 및 열 항목
그룹과 함께 반복되지 않는 레이블, 부분합, 합계 등의 항목은 요소로 렌더링됩니다. 요소의 이름은 TablixMember.DataElementName RDL 속성을 따릅니다.
TablixMember.DataElementOutput RDL 속성은 반복되지 않는 항목을 렌더링할지 여부를 제어합니다.
테이블릭스 멤버의 DataElementName 속성을 지정하지 않은 경우 반복되지 않는 항목의 이름은 다음 형식에 따라 동적으로 생성됩니다.
RowX - 반복되지 않는 행의 경우. 여기에서 X는 현재 부모 내에서 0부터 시작하는 행 인덱스입니다.
ColumnY - 반복되지 않는 열의 경우. 여기에서 Y는 현재 부모 내에서 0부터 시작하는 열 인덱스입니다.
반복되지 않는 머리글은 그룹과 함께 반복되지 않는 행 또는 열의 자식으로 렌더링됩니다.
반복되지 않는 멤버에 상응하는 테이블릭스 셀이 없으면 해당 멤버가 렌더링되지 않습니다. 테이블릭스 셀이 여러 개의 열에 걸쳐 있는 경우 등이 여기에 해당할 수 있습니다.
그룹과 함께 반복되는 행 및 열
그룹 내에서 반복되는 행과 열은 Tablix.DataElementOutput 규칙에 따라 렌더링됩니다. 요소의 이름은 DataElementName 속성을 따릅니다.
그룹 내의 고유한 값은 각각 그룹의 자식 요소로 렌더링됩니다. 요소의 이름은 Group.DataElementName 속성을 따릅니다.
DataElementOutput 속성 값이 Output이면 반복되는 항목의 머리글이 세부 정보 요소의 자식으로 렌더링됩니다.
사용자 지정 형식 및 XSL 변환
XML 렌더링 확장 프로그램에서 만든 XML 파일은 XSLT(XSL 변환)를 사용하여 거의 모든 형식으로 변환할 수 있습니다. 이 기능을 사용하면 기존 렌더링 확장 프로그램에서 지원하지 않는 형식으로도 데이터를 만들 수 있습니다. 사용자 고유의 렌더링 확장 프로그램을 만들기 전에 XML 렌더링 확장 프로그램과 XSLT 사용을 고려해 보십시오.
중복 이름
동일한 범위 내에 데이터 요소 이름이 중복되어 있으면 렌더러를 실행할 때 오류 메시지가 나타납니다.
XSLT 변환
XML 렌더러로 서버측 XSLT 변환을 원래 XML 데이터에 적용할 수 있습니다. XSLT를 적용하는 경우 렌더러에서는 원래 XML 데이터 대신 변환된 내용을 출력합니다. 변환은 클라이언트가 아니라 서버측에서 진행됩니다.
출력에 적용할 XSLT는 보고서의 DataTransform 속성을 사용하여 보고서 정의 파일에 정의하거나 XSLT DeviceInfo 매개 변수를 사용하여 정의합니다. 이러한 값 중 하나를 설정하면 XML 렌더러를 사용할 때마다 변환이 일어납니다. 구독을 사용하는 경우에는 RDL DataTransform 속성에 XSLT를 정의해야 합니다.
DataTransform 정의 속성과 장치 정보 설정을 모두 사용하여 XSLT 파일을 지정한 경우에는 DataTransform에 지정한 XSLT가 먼저 진행된 다음 장치 정보 설정을 통해 지정한 XSLT가 적용됩니다.
장치 정보 설정
장치 정보 설정을 변경하여 이 렌더러의 다음과 같은 일부 기본 설정을 변경할 수 있습니다.
XML에 적용할 변환(XSLT)
XML 문서의 MIME 형식
데이터에 형식 문자열 적용 여부
XML 출력에 대한 들여쓰기 여부
XML 스키마 이름 포함 여부
XML 문서 인코딩
XML 문서의 파일 확장명
자세한 내용은 Reporting Services 장치 정보 설정(Reporting Services Device Information Settings)을 참조하십시오.