ReportDocument.FileName 속성을 사용하여 관리되지 않는 RAS 서버에 바인딩

아티클
01/05/2008

참고
이 페이지에서는 Crystal Reports for Visual Studio에서 사용할 수 없지만 업그레이드 버전에서는 사용할 수 있는 기능을 설명합니다. Crystal Reports for Visual Studio에 대한 자세한 내용은 "Crystal Reports for Visual Studio의 정의"를 참조하십시오. 업그레이드된 버전에 대한 자세한 내용은 "업그레이드 옵션"을 참조하십시오.

이 페이지에서는 Crystal Reports for Visual Studio에서 사용할 수 없지만 업그레이드 버전에서는 사용할 수 있는 기능을 설명합니다. Crystal Reports for Visual Studio에 대한 자세한 내용은 "Crystal Reports for Visual Studio의 정의"를 참조하십시오. 업그레이드된 버전에 대한 자세한 내용은 "업그레이드 옵션"을 참조하십시오.

개체 모델

이 보고서 바인딩 시나리오에는 ReportClientDocument가 사용됩니다("ReportClientDocument 개체 모델(RAS)을 통한 보고서 바인딩" 참조).

보고서 위치

이 시나리오에서는 기존의 포함 보고서를 이용합니다. 코드의 보고서 래퍼 클래스를 통해 포함 보고서를 계속 참조하지만 FileName 속성을 통해 포함 보고서를 관리되지 않는 RAS 서버에 있는 훨씬 빠른 외부 복사본으로 리디렉션합니다("RAS(보고서 응용 프로그램 서버)" 참조).

참고
보고서는 궁극적으로 원격 서버를 통해 표시되므로, 이 보고서 바인딩 시나리오는 보고서 바인딩 시나리오 "ReportDocument 클래스에 로드된 비포함 보고서에 바인딩"에서 구현된 것과 마찬가지로 비포함 보고서에도 적용됩니다.

설명

이는 보고서 바인딩 시나리오 "ReportDocument.Load() 메서드를 사용하여 관리되지 않는 RAS에 바인딩"의 최적화된 버전입니다.

Crystal Reports for Visual Studio에서 ReportDocument 개체 모델과 포함 보고서를 사용하여 작성된 원래의 프로젝트를 관리되지 않는 RAS 서버로 쉽게 이식할 수 있습니다.

이 시나리오에서는 Crystal Reports에 사용하도록 디자인된 포함 보고서를 런타임에 관리되지 않는 RAS 서버에 바인딩하고, RAS 서버에 직접 액세스할 수 있는 폴더에 이 보고서의 복사본을 배치하여 더욱 최적화합니다. 이를 위해 다음 작업을 수행하는 코드 두 줄을 추가해야 합니다.

RAS 서버의 이름을 ReportDocument.ReportAppServer 속성에 할당
RAS에서 액세스할 수 있는 디렉터리 경로 문자열을 ReportDocument.FileName 속성에 전달

비포함 보고서를 관리되지 않는 RAS 서버에 바인딩할 수도 있습니다. 이를 수행하려면 "ReportDocument 클래스에 로드된 비포함 보고서에 바인딩"에서 설명하는 ReportDocument.Load(String filename) 메서드에 대한 호출을 삭제하고 위에서 설명한 단계에 나온 코드를 입력해야 합니다.

이 시나리오에서는 Crystal Reports Developer의 경우 ReportClientDocument 개체 모델을 사용하는 RAS 서버에 ReportDocument 개체 모델을 사용하는 포함 보고서나 비포함 보고서를 직접 바인딩할 수 있음을 보여 줍니다. 이러한 작업이 가능한 이유는 Crystal Reports 10에서 ReportDocument 개체 모델이 ReportClientDocument 개체 모델을 처리하는 프록시 계층으로 재작성되었기 때문입니다. 자세한 내용은 아키텍처의 "ReportClientDocument 개체 모델(RAS)"을 참조하십시오.

그러나 "ReportDocument.Load() 메서드를 사용하여 관리되지 않는 RAS에 바인딩"의 기본 시나리오에는 성능 면에서 제약이 있습니다. 즉 매번 RAS 서버에 포함 보고서를 로드해야 하므로 속도가 느려집니다. 성능을 향상시키기 위해 RAS 서버에 표시되는 파일 디렉터리에 보고서를 복사한 다음 디렉터리 경로 문자열을 보고서 인스턴스의 FileName 속성에 전달합니다.

참고
FileName 속성은 관리되는 RAS 서버의 보고서를 참조합니다. 관리되는 RAS 서버의 보고서는 이 보고서의 버전이나 이름이 포함 보고서와 다른 경우에도 항상 표시됩니다.

ReportDocument.ReportClientDocument 속성을 통해 기본 ReportClientDocument 개체 모델에 직접 액세스할 수 있으므로 런타임에 ReportClientDocument 개체 모델을 사용하여 보고서를 수정할 수 있습니다. 코드 샘플은 아래의 구현 부분을 참조하십시오.

장점

ReportDocument 개체 모델을 사용하는 보고서와 상호 작용하는 모든 원래 코드를 유지하면서, 동시에 ReportDocument.ReportClientDocument 속성을 통해 기본 ReportClientDocument 개체 모델에 대한 모든 액세스를 제공할 수 있습니다.

참고
ReportClientDocument 개체 모델을 사용하면 프로그래밍 방식으로 보고서 정의 파일을 작성 또는 수정하고 변경 사항을 저장할 수 있습니다. 자세한 내용은 아키텍처의 "ReportClientDocument 개체 모델(RAS)"을 참조하십시오.

RAS(보고서 응용 프로그램 서버)의 뛰어난 보고서 엔진 기능을 활용하여 성능이 크게 향상됩니다. 자세한 내용은 "Business Objects 보고서 작성 솔루션 간의 아키텍처 비교"를 참조하십시오.
RAS 서버에 표시되는 파일 디렉터리에 보고서를 복사하여 성능을 더욱 향상시킬 수 있습니다.

단점

코드를 일부 추가해야 합니다. ReportDocument를 통해 CrystalReportViewer 컨트롤에 보고서를 바인딩할 때마다 코드 두 줄을 추가해야 합니다. 코드 샘플은 아래 부분을 참조하십시오.
RAS 서버에 표시되는 파일 디렉터리에 포함 보고서의 복사본을 만드는 경우 유지 관리를 위한 요구 사항이 늘어납니다. 보고서를 수정하거나 삭제해야 하는 경우 해당 변경 사항을 Visual Studio 프로젝트의 포함 보고서와 RAS 서버에 표시되는 디렉터리의 보고서 복사본 모두에 전파해야 합니다.
관리되지 않는 RAS로 업그레이드하면 보고서 성능이 크게 향상되지만 관리되는 RAS로 업그레이드하는 경우만큼 향상되지는 않습니다.

지정된 관리되지 않는 RAS 서버에서 볼 수 있는 파일 디렉터리의 포함 보고서 복사본을 로드하려면

관리되지 않는 RAS(보고서 응용 프로그램 서버) 10이 설치되어 올바르게 작동되어야 합니다.
네트워크에서 관리되지 않는 RAS 서버의 이름을 찾아 기록해 둡니다. 이 예제의 경우 서버 이름은 "RAS01"입니다.

이 절차는 "프로젝트 설정"을 통해 생성된 프로젝트에서만 사용할 수 있습니다. 프로젝트 설정에는 이 절차에 필요한 코드 구성 및 특정 네임스페이스 참조가 포함되어 있으므로 해당 구성이 없으면 절차를 완료할 수 없습니다. 따라서 이 절차를 시작하기 전에 먼저 "프로젝트 설정"의 단계를 수행해야 합니다.

RAS는 웹 프로젝트에만 사용할 수 있습니다.

"프로젝트 설정"에서 만든 ConfigureCrystalReports() 메서드 내에 다음과 같은 보고서 바인딩 코드가 있습니다.

CrystalReportViewer 컨트롤에 보고서를 바인딩하기 전에, 위에 있는 두 줄의 코드 사이에 다음 두 가지 작업을 수행하는 코드 두 줄을 새로 추가해야 합니다( 2단계 및 4단계 참조).
- 네트워크에서 관리되지 않는 RAS 서버 식별
- 보고서의 복사본이 포함된 파일 경로 제공
```
Dim hierarchicalGroupingReport As Hierarchical_Grouping = New
Hierarchical_Grouping()
myCrystalReportViewer.ReportSource = hierarchicalGroupingReport
```
```
Hierarchical_Grouping hierarchicalGroupingReport = new
Hierarchical_Grouping();
crystalReportViewer.ReportSource = hierarchicalGroupingReport;
```
hierarchicalGroupingReport를 인스턴스화한 다음 hierarchicalGroupingReport 변수의 ReportApplicationServer 속성에 RAS 서버의 이름을 입력합니다.
```
hierarchicalGroupingReport.ReportAppServer = "RAS01"
```
```
hierarchicalGroupingReport.ReportAppServer = "RAS01";
```
RAS 서버의 C 드라이브에 있는 Report Application Server 10 디렉터리에 보고서를 복사합니다. 파일 경로는 다음과 같습니다. C:\Program Files\Crystal Decisions\Report Application Server 10\Reports\
그런 다음 " RAS" 프로토콜을 접두사로 사용하여 보고서의 파일 경로를 코드에 입력합니다.

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images\e2c9s1d7.alert_note(ko-kr,VS.90).gif" alt="Note" class="note" />참고</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>이 경로는 RAS 보고서를 저장하기 위한 기본 디렉터리입니다. 다른 보고서 경로를 사용하면 RAS 서버에서 거부되고 &quot;액세스가 거부되었습니다&quot;라는 오류가 발생할 수 있습니다.</p></td>
</tr>
</tbody>
</table>

이 코드 행 뒤에 ["프로젝트 설정"](ms227453\(v=vs.90\).md)에서 만든 보고서 바인딩 코드가 표시됩니다.

``` vb
hierarchicalGroupingReport.FileName = "ras://C:\Program Files\Crystal Decisions" _ & "\Report Application Server 10\Reports" _ & "\Hierarchical_Grouping.rpt"
```

``` csharp
hierarchicalGroupingReport.FileName = "ras://C:\\Program Files\\Crystal Decisions" + "\\Report Application Server 10\\Reports" + "\\Hierarchical_Grouping.rpt";
```

프로젝트를 빌드하고 실행하여 보고서를 확인합니다.

보고서가 파일 경로에서 로드되고 관리되지 않는 RAS(보고서 응용 프로그램 서버)에서 제공됩니다.

ReportClientDocument 개체 모델 내에서 ReportDocument 개체 모델에 액세스하는 방법에 대한 자세한 내용은 "ReportDocument.Load() 메서드를 사용하여 관리되지 않는 RAS에 바인딩"의 코드 부분을 참조하십시오.

다음을 통해 공유

ReportDocument.FileName 속성을 사용하여 관리되지 않는 RAS 서버에 바인딩

개체 모델

보고서 위치

설명

장점

단점

지정된 관리되지 않는 RAS 서버에서 볼 수 있는 파일 디렉터리의 포함 보고서 복사본을 로드하려면

참고 항목

추가 리소스