ReportDocument.Load() 메서드를 사용하여 관리되지 않는 RAS에 바인딩

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

개체 모델

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

보고서 위치

보고서는 프로젝트에 포함됩니다. 런타임에 네트워크를 통해 지정된 "RAS(보고서 응용 프로그램 서버)"로 보고서가 로드됩니다.

설명

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

이 시나리오에서는 네트워크를 통해 포함 보고서를 지정된 관리되지 않는 RAS(보고서 응용 프로그램 서버)에 로드합니다. 코드 샘플은 다음 작업을 수행하는 두 줄의 코드가 추가된 아래의 구현 부분을 참조하십시오.

• RAS 서버의 이름을 ReportDocument.ReportAppServer 속성에 할당
• ReportDocument.Load() 메서드 호출

포함 보고서는 ReportDocument 개체 모델에 대해 작성되지만 Crystal Reports Developer에서는 ReportClientDocument 개체 모델을 사용하는 RAS 서버에 포함 보고서를 직접 바인딩할 수 있습니다. Crystal Reports Developer에서는 ReportDocument 개체 모델이 ReportClientDocument 개체 모델을 처리하는 프록시 계층으로 재작성되었기 때문입니다. 자세한 내용은 "ReportClientDocument 개체 모델(RAS)"을 참조하십시오.

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

장점

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

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

• RAS(보고서 응용 프로그램 서버)의 뛰어난 보고서 엔진 기능을 활용하여 성능이 크게 향상됩니다. 자세한 내용은 "Business Objects 보고서 작성 솔루션 간의 아키텍처 비교"를 참조하십시오.

단점

• 코드를 일부 추가해야 합니다. ReportDocument를 통해 CrystalReportViewer 컨트롤에 보고서를 바인딩할 때마다 코드 두 줄을 추가해야 합니다. 아래 구현 부분을 참조하십시오.
• RAS 서버로 업그레이드하면 보고서 성능이 크게 향상됩니다.

네트워크를 통해 포함 보고서를 지정된 관리되지 않는 RAS 서버로 로드하려면

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

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

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

   CrystalReportViewer 컨트롤에 포함 보고서를 바인딩하기 전에, 위에 있는 두 줄의 코드 사이에 네트워크상에서 관리되지 않는 RAS 서버를 식별한 다음 해당 RAS 서버에 이 보고서를 로드하는 코드 두 줄을 새로 추가해야 합니다.

   hierarchicalGroupingReport = New Hierarchical_Grouping()
   myCrystalReportViewer.ReportSource = hierarchicalGroupingReport
   

   hierarchicalGroupingReport = new Hierarchical_Grouping();
   crystalReportViewer.ReportSource = hierarchicalGroupingReport;
   

2. hierarchicalGroupingReport를 인스턴스화한 다음 hierarchicalGroupingReport 변수의 ReportAppServer 속성에 RAS 서버의 이름을 입력합니다.

   hierarchicalGroupingReport.ReportAppServer = "RAS01"
   

   hierarchicalGroupingReport.ReportAppServer = "RAS01";
   

3. ReportDocument.Load()를 호출합니다.

   이 코드 행 뒤에 "프로젝트 설정"에서 만든 보고서 바인딩 코드가 표시됩니다.

   hierarchicalGroupingReport.Load("rassdk://C:\report.rpt",
   "RAS01")
   

   hierarchicalGroupingReport.Load(@"rassdk://C:\report.rpt",
   "RAS01");
   

4. 프로젝트를 컴파일하고 디버깅합니다.

네트워크를 통해 프로젝트에서 관리되지 않는 RAS(보고서 응용 프로그램 서버)로 보고서가 로드됩니다.

ReportDocument 개체 모델 내에서 ReportClientDocument 개체 모델에 액세스하려면

1. 이전 절차에서 디버그 모드를 종료합니다.

2. 프로젝트에 대한 참조로 다음 어셈블리를 추가합니다.

   • CrystalDecisions.ReportAppServer.ClientDoc
   • CrystalDecisions.ReportAppServer.Controllers
   • CrystalDecisions.ReportAppServer.DataDefModel

3. 클래스 위쪽에 세 개의 "Imports" [Visual Basic] 또는 "using" [C#] 문을 입력합니다.

   Imports CrystalDecisions.ReportAppServer.ClientDoc
   Imports CrystalDecisions.ReportAppServer.Controllers
   Imports CrystalDecisions.ReportAppServer.DataDefModel
   

   using CrystalDecisions.ReportAppServer.ClientDoc;
   using CrystalDecisions.ReportAppServer.DataDefModel;
   using CrystalDecisions.ReportAppServer.Controllers;
   

4. ConfigureCrystalReports() 메서드 내에서 Load() 메서드를 호출하는 코드 행과 보고서를 컨트롤에 바인딩하는 코드 행 사이에 새로운 private 도우미 메서드 ModifyReport에 대한 호출을 입력합니다.

   ModifyReport()
   

   ModifyReport();
   

5. 아래의 각 샘플처럼 private 도우미 메서드 ModifyReport()를 만듭니다. 이 코드는 ReportDocument 개체 모델 내에서 ReportClientDocument 개체 모델에 액세스하는 방법을 보여 주기 위한 것입니다. 이 코드는 보고서에 표시된 필드 중에서 첫 번째로 사용 가능한 필드를 제거합니다.

   참고
   데이터베이스 테이블 필드가 보고서 결과 필드 컬렉션에 없으면 응용 프로그램에서 예외를 throw합니다.

   Private Sub ModifyReport()
   Dim myReportClientDocument As ISCDReportClientDocument = _
   hierarchicalGroupingReport.ReportClientDocument
   Dim myTables As Tables = _
   myReportClientDocument.DatabaseController.Database.Tables
   Dim myTable As CrystalDecisions.ReportAppServer.DataDefModel.Table
   myTable = CType(myTables(0), CrystalDecisions.ReportAppServer.DataDefModel.Table)
   Dim myFields As Fields = myTable.DataFields
   
   Dim myField As ISCRField
   For Each myField In myFields
   Dim myResultFieldController As ResultFieldController = _
   myReportClientDocument.DataDefController.ResultFieldController
   Try
   myResultFieldController.Remove(myField)
   Exit For
   Catch
   End Try
   Next
   End Sub
   

   private void ModifyReport()
   {
   ISCDReportClientDocument reportClientDocument = hierarchicalGroupingReport.ReportClientDocument;
   Tables tables = reportClientDocument.DatabaseController.Database.Tables;
   CrystalDecisions.ReportAppServer.DataDefModel.Table table =
   (CrystalDecisions.ReportAppServer.DataDefModel.Table)tables[0];
   Fields fields = table.DataFields;
   
   for (int i = 0; i < fields.Count; i++)
   {
   ISCRField field = fields[i];
   ResultFieldController resultFieldController =
   reportClientDocument.DataDefController.ResultFieldController;
   try
   {
   resultFieldController.Remove(field);
   break;
   }
   catch
   {
   }
   }
   }
   

   참고
   기본 ReportClientDocument 개체 모델에 대해 프로그래밍한 모든 내용은 CrystalReportViewer 컨트롤에 바인딩된 바깥쪽 ReportDocument 인스턴스에서 논리적으로 발생합니다. 이 코드 샘플에서 보여 주는 필드 제거는 런타임에만 발생합니다. 이는 보고서 정의 파일에 다시 저장되지 않습니다.

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

참고 항목

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

• 전체 시나리오 세부 목록