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)을 통한 보고서 바인딩" 참조).

보고서 위치

이 시나리오에서는 보고서를 복사하여 이를 Crystal Reports Server 또는 BusinessObjects Enterprise(BOE) 내의 RAS(보고서 응용 프로그램 서버)에서 제공하는 Crystal Reports Server 또는 BusinessObjects Enterprise 리포지토리에 배치하거나 Visual Studio 프로젝트 내의 포함 보고서에 배치합니다.

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

설명

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

이 시나리오에서는 게시 마법사를 사용하여 Crystal Reports Server 또는 BusinessObjects Enterprise에 보고서의 복사본을 배치하여 런타임에 Crystal Reports Server 또는 BusinessObjects Enterprise에서 포함 보고서를 관리되는 RAS 서버에 바인딩합니다. 포함 보고서의 기존 코드는 계속 작동하지만 다음 작업을 수행하면 해당 보고서의 소스가 관리되는 RAS 서버로 리디렉션됩니다.

프로젝트에 Crystal Reports Server 또는 BusinessObjects Enterprise 로그온 기능 추가 및 EnterpriseSession 인스턴스 검색
Crystal Reports Server 또는 BusinessObjects Enterprise에서 중복된 보고서의 CUID 속성 검색
ReportDocument의 EnterpriseSession 속성을 EnterpriseSession 인스턴스로 설정
ReportDocument의 FileName 속성을 포함 보고서의 CUID 문자열로 설정

코드 샘플은 아래의 구현 부분을 참조하십시오.

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

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

ReportDocument.ReportClientDocument 속성을 통해 기본 ReportClientDocument 개체 모델에 직접 액세스할 수 있으므로 런타임에 ReportClientDocument 개체 모델을 사용하여 보고서를 수정할 수 있습니다.

장점

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

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

최적화된 성능을 제공합니다. RAS(보고서 응용 프로그램 서버)의 뛰어난 보고서 엔진을 활용하여 성능이 크게 향상됩니다. "Business Objects 보고서 작성 솔루션 간의 아키텍처 비교"를 참조하십시오.

단점

약간의 코딩 작업이 추가로 필요합니다. 프로젝트에서 로그인하여 EnterpriseSession 개체를 검색한 다음 이를 ASP.NET 세션에 저장해야 합니다. ReportDocument를 사용하여 CrystalReportViewer 컨트롤에 보고서를 바인딩할 때마다 CUID를 검색하여 ReportDocument의 FileName 속성에 설정해야 합니다.
유지에 더 많은 작업이 필요합니다. Crystal Reports Server 또는 BusinessObjects Enterprise에 대한 포함 보고서의 복사본을 만들려면 상태 유지를 위해 더 많은 요구 사항이 충족되어야 합니다. 보고서를 수정하거나 삭제해야 하는 경우 이러한 변경 사항을 Visual Studio 프로젝트 내의 포함 보고서와 Crystal Reports Server 또는 BusinessObjects Enterprise의 보고서 복사본에 모두 전파해야 합니다.

ReportDocument의 FileName 속성에 보고서의 CUID를 사용하여 Crystal Reports Server 또는 BusinessObjects Enterprise에 저장된 포함 보고서의 중복된 복사본을 표시하려면

Crystal Reports Server 또는 BusinessObjects Enterprise가 설치되어 있고 제대로 작동해야 합니다.
Crystal Reports Server 또는 BusinessObjects Enterprise SDK(.NET 어셈블리 포함)가 설치되어 있고 제대로 작동해야 합니다.

참고

개발 컴퓨터에 Crystal Reports Server 또는 BusinessObjects Enterprise를 설치한 경우에는 설치 항목에 SDK가 함께 포함되어 있습니다.

참고
개발 컴퓨터에 Crystal Reports Server 또는 BusinessObjects Enterprise를 설치한 경우에는 설치 항목에 SDK가 함께 포함되어 있습니다.

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

Crystal Reports Server 또는 BusinessObjects Enterprise 서버의 이름을 찾아 기록해 둡니다. 이 예제의 경우 서버 이름은 "BOE01"입니다.

1.  서버 이름을 찾으려면 내 컴퓨터 아이콘을 마우스 오른쪽 단추로 클릭한 다음, 속성을 선택합니다.
2.  시스템 속성 대화 상자에서 네트워크 식별 탭을 클릭합니다.
3.  컴퓨터 이름이 "전체 컴퓨터 이름" 필드에 표시됩니다.

게시 마법사를 사용하여 Hierarchical Grouping.rpt를 Crystal Reports Server 또는 BusinessObjects Enterprise 서버에 게시합니다.

<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>게시 마법사를 사용하는 방법에 대한 자세한 내용은 Crystal Reports Server 또는 BusinessObjects Enterprise 사용 설명서를 참조하십시오.</p></td>
</tr>
</tbody>
</table>

샘플 보고서에 대한 자세한 내용은 ["샘플 보고서 디렉터리"](ms225622\(v=vs.90\).md)를 참조하십시오.

"프로젝트 설정"에서 만든 ConfigureCrystalReports() 메서드 내에 다음과 같은 보고서 바인딩 코드가 있습니다.
```
Dim hierarchicalGroupingReport As Hierarchical_Grouping = New
Hierarchical_Grouping()
myCrystalReportViewer.ReportSource = hierarchicalGroupingReport
```
```
Hierarchical_Grouping hierarchicalGroupingReport = new
Hierarchical_Grouping();
crystalReportViewer.ReportSource = hierarchicalGroupingReport;
```
보고서를 CrystalReportViewer 컨트롤에 바인딩하기 전에 다음 작업을 수행하는 여러 줄의 코드를 이러한 두 줄의 코드 사이에 새로 추가합니다(3-14단계 참조).
- 네트워크의 Crystal Reports Server 또는 BusinessObjects Enterprise 서버에 로그인
- Crystal Reports Server 또는 BusinessObjects Enterprise에 저장된 보고서를 식별하는 CUID 검색
- CUID를 통해 보고서 호출
프로젝트에 다음과 같은 어셈블리 참조를 추가합니다.

1.   CrystalDecisions.Enterprise.Framework
2.   CrystalDecisions.Enterprise.InfoStore

코드 숨김 페이지의 위쪽에 CrystalDecisions.Enterprise 네임스페이스에 대한 "Imports" [Visual Basic] 또는 "using" [C#] 문을 추가합니다.

``` vb
Imports CrystalDecisions.Enterprise
```

``` csharp
using CrystalDecisions.Enterprise;
```

이제 포함 보고서를 Crystal Reports Server 또는 BusinessObjects Enterprise에 리디렉션하는 코드를 추가할 준비가 되었습니다.

hierarchicalGroupingReport를 인스턴스화하는 코드 행 다음에 serverName 문자열을 선언하고 이 문자열에 Crystal Reports Server 또는 BusinessObjects Enterprise 서버의 이름을 설정합니다.
```
Dim serverName As String = "BOE01"
```
```
string serverName = "BOE01";
```
SessionMgr 클래스를 선언하고 인스턴스화합니다.

``` vb
Dim mySessionMgr As SessionMgr = New SessionMgr()
```

``` csharp
SessionMgr sessionMgr = new SessionMgr();
```

사용자 이름(Administrator), 암호(공백), serverName 변수 및 로그온 유형(secEnterprise)을 SessionMgr 인스턴스의 Logon 메서드에 전달하고 이를 EnterpriseSession 인스턴스로 가져옵니다.

``` vb
Dim myEnterpriseSession As EnterpriseSession = mySessionMgr.Logon(
_
"Administrator", "", serverName, "secEnterprise")
```

``` csharp
EnterpriseSession enterpriseSession = sessionMgr.Logon(
"Administrator", "", serverName, "secEnterprise");
```

EnterpriseSession의 GetService 메서드에서 InfoStore 서비스를 EnterpriseService로 가져옵니다.

Dim myEnterpriseService As EnterpriseService = _
myEnterpriseSession.GetService("InfoStore")

EnterpriseService enterpriseService =
enterpriseSession.GetService("InfoStore");

가져온 InfoStore 서비스를 사용하여 InfoStore를 선언하고 인스턴스화합니다.

``` vb
Dim myInfoStore As InfoStore = New InfoStore(myEnterpriseService)
```

``` csharp
InfoStore infoStore = new InfoStore(enterpriseService);
```

이제 Crystal Reports Server 또는 BusinessObjects Enterprise에서 계층 그룹화 보고서의 CUID를 가져올 준비가 되었습니다.

아래 쿼리 문자열을 입력하여 Crystal Reports Server 또는 BusinessObjects Enterprise에서 보고서의 CUID를 쿼리합니다.

``` vb
Dim queryString As String = "Select SI_CUID From CI_INFOOBJECTS " _
& "Where SI_PROGID='CrystalEnterprise.Report' " _
& "And SI_NAME Like 'Hierarchical Grouping'"
```

``` csharp
string queryString = "Select SI_CUID From CI_INFOOBJECTS "
+ "Where SI_PROGID='CrystalEnterprise.Report' "
+ "And SI_NAME Like 'Hierarchical Grouping'";
```

쿼리 문자열을 InfoStore의 Query 메서드에 전달하여 쿼리 결과가 포함된 인덱싱된 InfoObjects 클래스를 가져옵니다.

``` vb
Dim myInfoObjects As InfoObjects = myInfoStore.Query(queryString)
```

``` csharp
InfoObjects infoObjects = infoStore.Query(queryString);
```

인덱싱된 InfoObjects 클래스의 첫 번째 열에서 InfoObject를 가져옵니다.

<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>인덱싱된 InfoObjects 클래스는 0이 아닌 1부터 시작합니다.</p></td>
</tr>
</tbody>
</table>

``` vb
Dim myInfoObject As InfoObject = myInfoObjects(1)
```

``` csharp
InfoObject infoObject = infoObjects[1];
```

이제 Crystal Reports Server 또는 BusinessObjects Enterprise에서 포함 보고서의 중복된 복사본을 로드할 준비가 되었습니다.

InfoObject의 SI_CUID 속성에서 보고서의 CUID 문자열을 가져와 reportCUID 문자열 변수에 저장합니다.
```
Dim reportCUID As String = myInfoObject.CUID
```
```
string reportCUID = infoObject.CUID;
```
포함 보고서의 EnterpriseSession 속성을 EnterpriseSession 인스턴스로 설정합니다.

``` vb
hierarchicalGroupingReport.EnterpriseSession = myEnterpriseSession
```

``` csharp
hierarchicalGroupingReport.EnterpriseSession = enterpriseSession;
```

cecuid:/// 프로토콜을 접두사로 사용하여 포함 보고서의 FileName 속성을 reportCUID 변수로 설정합니다.

팁

두 개의 슬래시(//)가 아닌 세 개의 슬래시(///)를 사용합니다. 이렇게 하면 호스트 이름이 null임을 나타냅니다.
```
hierarchicalGroupingReport.FileName = "cecuid:///" & reportCUID
```
```
hierarchicalGroupingReport.FileName = "cecuid:///" + reportCUID;
```
프로젝트를 빌드하고 실행하여 보고서를 확인합니다.

팁
두 개의 슬래시(//)가 아닌 세 개의 슬래시(///)를 사용합니다. 이렇게 하면 호스트 이름이 null임을 나타냅니다.

이제 보고서가 Crystal Reports Server 또는 BusinessObjects Enterprise에서 로드되고 관리되는 RAS 서버에서 제공됩니다.

ReportDocument 개체 모델 내에서 ReportClientDocument 개체 모델에 액세스하려면 "ReportDocument.Load() 메서드를 사용하여 관리되지 않는 RAS에 바인딩"의 구현 부분을 참조하십시오.

다음을 통해 공유

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

개체 모델

보고서 위치

설명

장점

단점

ReportDocument의 FileName 속성에 보고서의 CUID를 사용하여 Crystal Reports Server 또는 BusinessObjects Enterprise에 저장된 포함 보고서의 중복된 복사본을 표시하려면

참고 항목

추가 리소스