ReportAppFactory.OpenDocument() 메서드를 사용하여 관리되는 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 서버 또는 BusinessObjects Enterprise의 서버에 저장됩니다.

설명

이 보고서 바인딩 시나리오에서는 ReportClientDocument 개체 모델에 직접 액세스합니다. 이 시나리오에서는 EnterpriseSession, ReportAppFactory 및 InfoObject를 검색한 다음, InfoObject의 ID 속성과 정수 0(Visual Basic의 경우 선택적 매개 변수)을 ReportAppFactory의 OpenDocument() 메서드에 전달합니다. 이 메서드는 Crystal Reports 서버 또는 BusinessObjects Enterprise에서 ReportClientDocument의 인스턴스를 반환합니다. 코드 샘플은 아래의 구현 부분을 참조하십시오.

장점

CE 9 이상의 RAS를 사용하는 ReportClientDocument 개체 모델에서 보고서와 상호 작용하기에 적합한 방법입니다.
Crystal Reports Server 또는 BusinessObjects Enterprise 내에서 관리되는 RAS 서버의 뛰어난 보고서 엔진을 활용하여 성능이 크게 향상됩니다. 자세한 내용은 "Business Objects 보고서 작성 솔루션 간의 아키텍처 비교"를 참조하십시오.

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

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

ReportClientDocument 개체 모델에 직접 액세스할 수 있습니다.

단점

ReportDocument 개체 모델을 사용하여 Crystal Reports에 대해 이전에 개발된 코드가 있는 경우 이 시나리오에서는 보고서 바인딩을 완전히 다시 코딩해야 합니다. 이 경우 ReportDocument를 사용하는 다음과 같은 대체 시나리오 중 하나를 사용하는 것이 좋습니다.
- "ReportDocument.Load() 메서드를 사용하여 관리되는 RAS 서버에 바인딩"
- "ReportDocument.FileName 속성을 사용하여 관리되는 RAS 서버에 바인딩"

ReportAppFactory의 OpenDocument 메서드를 사용하여 Crystal Reports 서버 또는 BusinessObjects Enterprise에서 RAS 서버로 보고서를 로드하려면

Crystal Reports 서버 또는 BusinessObjects Enterprise가 설치되어 있고 제대로 작동해야 합니다.
Crystal Reports 서버 또는 BusinessObjects Enterprise SDK(.NET 어셈블리 포함)가 개발 컴퓨터에 설치되어 있어야 합니다.

참고

개발 컴퓨터에 Crystal Reports 서버 또는 BusinessObjects Enterprise를 설치한 경우에는 설치 항목에 SDK가 함께 포함되어 있습니다.
Crystal Reports 서버 또는 BusinessObjects Enterprise 서버의 이름을 찾아 기록해 둡니다. 이 예제의 경우 서버 이름은 "BOE01"입니다.

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

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

게시 마법사를 사용하여 Chart.rpt를 Crystal Reports 서버 또는 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)를 참조하십시오.

프로젝트에 다음과 같은 어셈블리 참조를 추가합니다.

1.  CrystalDecisions.Enterprise.Framework
2.  CrystalDecisions.Enterprise.InfoStore
3.  CrystalDecisions.ReportAppServer.ClientDoc

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

``` vb
Imports CrystalDecisions.Enterprise
Imports CrystalDecisions.ReportAppServer.ClientDoc
```

``` csharp
using CrystalDecisions.Enterprise;
using CrystalDecisions.ReportAppServer.ClientDoc;
```

이제 Crystal Reports 서버 또는 BusinessObjects Enterprise 내의 RAS 서버에서 보고서를 여는 코드를 추가할 준비가 되었습니다.

ConfigureCrystalReports() 메서드("프로젝트 설정"에서 만든 메서드) 내에서 serverName 문자열을 선언하고 이 변수에 Crystal Reports 서버 또는 BusinessObjects Enterprise 서버의 이름을 설정합니다.
```
Dim serverName As String = "BOE01"
```
```
string serverName = "BOE01";
```

SessionMgr 클래스를 선언하고 인스턴스화합니다.

Dim mySessionMgr As SessionMgr = New SessionMgr()

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 메서드에서 EnterpriseService 형식의 InfoStore 서비스를 검색합니다.

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);
```

"RASReportFactory" 문자열을 EnterpriseSession의 GetService() 메서드에 전달하여 EnterpriseService 인스턴스의 값을 다시 할당합니다.

``` vb
myEnterpriseService =
myEnterpriseSession.GetService("RASReportFactory")
```

``` csharp
enterpriseService =
enterpriseSession.GetService("RASReportFactory");
```

EnterpriseService에서 개체 변수 형식의 Interface 속성을 반환합니다.

Dim rrfObject As Object = myEnterpriseService.Interface

Object rrfObject = enterpriseService.Interface;

개체 변수를 ReportAppFactory 인스턴스로 캐스팅합니다.

``` vb
Dim myReportAppFactory As ReportAppFactory = CType(rrfObject,
ReportAppFactory)
```

``` csharp
ReportAppFactory reportAppFactory = (ReportAppFactory)rrfObject;
```

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

``` vb
Dim queryString As String = "Select SI_ID, SI_NAME, SI_PARENTID
From CI_INFOOBJECTS " _
& "Where SI_PROGID='CrystalEnterprise.Report' "
_
& "And SI_NAME Like 'Chart'"
```

``` csharp
string queryString = "Select SI_ID, SI_NAME, SI_PARENTID From
CI_INFOOBJECTS "
+ "Where SI_PROGID='CrystalEnterprise.Report' "
+ "And SI_NAME Like 'Chart'";
```

쿼리 문자열을 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];
```

ReportClientDocument를 선언하고 인스턴스화합니다.

Dim myReportClientDocument As ReportClientDocument = New
ReportClientDocumentClass()

ReportClientDocument reportClientDocument = new
ReportClientDocumentClass();

ReportAppFactory 인스턴스의 OpenDocument 메서드에 InfoObject의 ID 속성과 정수 0(Visual Basic의 경우 선택적)을 전달합니다.

<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 서버 또는 BusinessObjects Enterprise의 RAS(보고서 응용 프로그램 서버)에서 ReportClientDocument 인스턴스 형식의 보고서가 열립니다.</p></td>
</tr>
</tbody>
</table>

``` vb
myReportClientDocument =
myReportAppFactory.OpenDocument(myInfoObject.ID, 0)
```

``` csharp
reportClientDocument = reportAppFactory.OpenDocument(infoObject.ID,
0);
```

CrystalReportViewer 컨트롤에 ReportClientDocument 인스턴스를 바인딩합니다.

``` vb
myCrystalReportViewer.ReportSource = myReportClientDocument
```

``` csharp
crystalReportViewer.ReportSource = reportClientDocument;
```

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

참고 항목

ReportClientDocument 개체 모델(RAS)

다음을 통해 공유

ReportAppFactory.OpenDocument() 메서드를 사용하여 관리되는 RAS 서버에 바인딩

개체 모델

보고서 위치

설명

장점

단점

ReportAppFactory의 OpenDocument 메서드를 사용하여 Crystal Reports 서버 또는 BusinessObjects Enterprise에서 RAS 서버로 보고서를 로드하려면

참고 항목

추가 리소스