Web.Config 파일 구성

아티클
01/05/2008

ASP.NET 웹 응용 프로그램의 Web.Config 파일은 데이터베이스 연결 정보, 어셈블리 참조 및 오류 처리 등의 전역 설정을 저장합니다. 이 파일은 XML로 작성되며, 루트 요소는 항상 <configuration>이어야 합니다. 이것은 고급 구성이며 필수 사항이 아닙니다.

다음은 Crystal Reports에 고유한 요소이며 사용자의 Web.Config 파일에 추가할 수 있습니다.

참고
버전 번호는 사용하는 제품에 따라 달라질 수 있습니다.

CrystalImageHandler

CrystalImageHandler 요소는 CrystalReportViewer 컨트롤에서 모든 동적 이미지를 표시합니다. 이 설정은 CrystalImageHandler.aspx에 대한 요청을 내부 전용 이미지 처리기 클래스로 리디렉션하도록 ASP.NET 작업자 프로세스를 구성합니다. Web.Config 파일에 CrystalImageHandler 설정이 없는 경우에는 웹 사이트의 이미지가 나타나지 않습니다. CrystalReportViewer 컨트롤을 웹 사이트에 추가하면 이 요소가 자동으로 Web.Config 파일에 추가됩니다.

<system.web>
<httpHandlers>
<add verb="GET" path="CrystalImageHandler.aspx" type="CrystalDecisions.Web.CrystalImageHandler, CrystalDecisions.Web, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692fbea5521e1304"/>
</httpHandlers>
</system.web>

CrystalImageCleaner

CrystalImageCleaner 프로세스는 CrystalReportViewer 컨트롤에 의해 렌더링된 동적으로 생성된 이미지를 자동으로 삭제합니다. 이 설정을 사용하면 이미지 디렉터리 검사 시간 간격 및 파일 삭제 전 최소 수명을 설정할 수 있습니다. CrystalReportViewer 컨트롤을 웹 사이트에 추가하면 이 요소가 자동으로 Web.Config 파일에 추가됩니다. 이 요소가 CrystalImageCleaner 클래스에 해당합니다.

CrystalImageCleaner-Sleep는 동적 이미지 디렉터리에서 이미지 파일을 검사하고 정리하기 전에 이미지 정리기가 비활성 상태로 있는 시간(밀리초)을 초기화합니다.
CrystalImageCleaner-Age는 파일이 삭제되기 전까지의 파일의 최소 수명(밀리초)을 초기화합니다.
CrystalImageCleaner-AutoStart는 CrystalImageCleaner 프로세스를 제어합니다. 이미지 정리기는 값이 true로 설정된 보고서를 볼 때 만들어지는 임시 이미지를 정리합니다.

참고
단일 ASP.NET 작업자 프로세스에서 단 하나의 이미지 정리기만 시작될 수 있습니다.

<appSettings>
<add key="CrystalImageCleaner-AutoStart" value="true" />
<add key="CrystalImageCleaner-Sleep" value="60000" />
<add key="CrystalImageCleaner-Age" value="120000" />
</appSettings>

printControl

printControl 요소를 사용하면 보고서를 로컬 프린터에서 직접 인쇄할 수 있습니다. 기본적으로 이 컨트롤은 로컬 컴퓨터에 설치되지 않으며 별도로 다운로드해야 합니다. Business Objects 기술 지원 웹 사이트(http://technicalsupport.businessobjects.com/)에서 PrintControl .cab 파일을 다운로드할 수 있습니다. 이 설정을 사용하면 사용자의 Crystal Reports.NET 웹 사이트에서 .cab 파일을 볼 수 있습니다. 이 요소는 사용자 웹 사이트의 Web.Config 파일에 수동으로 추가해야 합니다.

<configSections>
<sectionGroup name="businessObjects">
<sectionGroup name="crystalReports">
<section name="printControl" type="System.Configuration.NameValueSectionHandler, System, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=b77a5c561934e089, Custom=null" />
</sectionGroup>
</sectionGroup>
</configSections>

<businessObjects>
<crystalReports>
<printControl>
<add key="url" value="https://localhost/PrintControl.cab" />
</printControl>
</crystalReports>
</businessObjects>

reportMappings

reportMappings 요소는 Visual Studio 2003에서 만들어졌으며 포함 보고서를 사용하는 웹 사이트를 Visual Studio 2005 이상에서 열 때 비포함 웹 사이트로 업데이트합니다. 이 설정은 Visual Studio 2003에서 만들어진 .dll 파일을 디스크 파일로 변환합니다. Visual Studio 2005 및 2008은 포함 웹 사이트를 지원하지 않으며, 보고서가 최신 버전의 Visual Studio에서도 작동하도록 하려면 Web.Config 파일을 수정해야 합니다. 이 요소는 사용자 웹 사이트의 Web.Config 파일에 수동으로 추가해야 합니다. reportMappings 설정에는 절대 경로가 필요합니다.

참고
이 요소는 Visual Studio 2005 및 Visual Studio 2008에서만 사용할 수 있습니다.

<configSections>
<sectionGroup name="businessObjects">
<sectionGroup name="crystalReports">
<section name="reportMappings" type="CrystalDecisions.Shared.ReportMappingHandler, CrystalDecisions.Shared, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692fbea5521e1304, Custom=null" />
</sectionGroup>
</sectionGroup>
</configSections>

<businessObjects>
<crystalReports>
<reportMappings>
<add reportName="World Sales Report.rpt" path="C:\Report\World Sales Report.rpt" />
</reportMappings>
</crystalReports>
</businessObjects>

UseBrowserLocale

UseBrowserLocale 요소는 CrystalReportViewer 컨트롤에 대한 브라우저의 언어 설정을 검색합니다. true로 설정하면 이 설정은 브라우저 로캘을 확인하도록 CrystalReportViewer 컨트롤을 구성합니다. 반대로 false로 설정하면 페이지별로 표시되는 로캘을 제한합니다. 이 요소는 사용자 웹 사이트의 Web.Config 파일에 수동으로 추가해야 합니다.

<configSections>
<sectionGroup name="businessObjects">
<sectionGroup name="crystalReports">
<section name="crystalReportViewer" type="System.Configuration.NameValueSectionHandler" />
</sectionGroup>
</sectionGroup>
</configSections>

<businessObjects>
<crystalReportViewer>
<add key="UseBrowserLocale" value="true" />
</crystalReportViewer>
</businessObjects>

serverFileReportManager

serverFileReportManager 요소는 서버 컴퓨터에 서버 파일을 열거하는 웹 서비스입니다. 이 설정을 사용하면 원격 컴퓨터에서 개체(폴더 및 보고서) 목록을 가져올 수 있습니다. 이 설정은 서버에 대한 파일 디렉터리 루트를 할당합니다. 이 예제에서는 루트가 c:\inetpub\wwroot로 설정되었습니다. 이 요소는 사용자 웹 사이트의 Web.Config 파일에 수동으로 추가해야 합니다.

참고
이 요소가 serverFileReportManager 클래스에 해당합니다.

<configSections>
<sectionGroup name="crystalDecisions">
<section name="serverFileReportManager" type="System.Configuration.NameValueSectionHandler, System, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=b77a5c561934e089, Custom=null" />
</sectionGroup>
</configSections>

<crystalDecisions>
<serverFileReportManager>
<add key="rootDirectory" value="c:\inetpub\wwwroot" />
</serverFileReportManager>
</crystalDecisions>

globalResourcePath

globalResourcePath 요소는 전역 리소스의 파일 디렉터리 경로에 대한 참조입니다. 중앙 위치에 사용자 지정 언어 리소스가 포함된 이 파일 디렉터리는 여러 웹 응용 프로그램에서 공유할 수 있습니다. 이 설정을 사용하면 특정 웹 사이트의 전역 리소스에 액세스할 수 있습니다. CrystalReports.NET에서 기본 리소스 파일은 제품 설치와 함께 제공되지 않으며 Business Objects 기술 지원 웹 사이트(http://technicalsupport.businessobjects.com/)에서 다운로드할 수 있습니다. 이 요소는 사용자 웹 사이트의 Web.Config 파일에 수동으로 추가해야 합니다.

<appSettings>
<add key="globalResourcePath" value="c:\CrystalReportViewer_resource_files\"/>
</appSettings>

샘플 Web.Config 파일

<?xml version="1.0"?>
<configuration>
<appSettings>
<add key="CrystalImageCleaner-AutoStart" value="true"/>
<add key="CrystalImageCleaner-Sleep" value="60000"/>
<add key="CrystalImageCleaner-Age" value="120000"/>
</appSettings>
<connectionStrings/>
<system.web>
<compilation debug="true">
<assemblies>
<add assembly="CrystalDecisions.Web, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692FBEA5521E1304"/>
<add assembly="CrystalDecisions.Shared, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692FBEA5521E1304"/>
<add assembly="CrystalDecisions.ReportSource, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692FBEA5521E1304"/>
<add assembly="CrystalDecisions.Enterprise.Framework, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692FBEA5521E1304"/>
<add assembly="CrystalDecisions.Enterprise.Desktop.Report, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692FBEA5521E1304"/>
<add assembly="CrystalDecisions.CrystalReports.Engine, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692FBEA5521E1304"/>
<add assembly="CrystalDecisions.Enterprise.InfoStore, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692FBEA5521E1304"/>
<add assembly="CrystalDecisions.ReportAppServer.ClientDoc, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692fbea5521e1304"/>
</assemblies>
</compilation>
<authentication mode="Windows"/>
<httpHandlers>
<add verb="GET" path="CrystalImageHandler.aspx" type="CrystalDecisions.Web.CrystalImageHandler, CrystalDecisions.Web, Version=10.5.3700.0, Culture=neutral, PublicKeyToken=692fbea5521e1304"/>
</httpHandlers>
</system.web>
</configuration>

다음을 통해 공유