예제: ReportViewer용 Web Log Analyzer
Web Log Analyzer 예제는 Microsoft IIS(인터넷 정보 서버)와 같은 웹 서버에서 만든 로그 파일을 분석하는 Windows Form 응용 프로그램입니다. 이 응용 프로그램에는 페이지 방문 횟수, 서버 작업 및 다른 사이트에서의 조회에 대한 통계를 보여 주는 보고서가 포함되어 있습니다.
Web Log Analyzer에는 분석에 포함되는 파일을 구성할 수 있는 기능이 있습니다. 웹 서버에서 생성한 로그 파일을 선택하고 특정 파일 유형을 필터링하여 제외시킬 수 있습니다.
이 예제는 Visual Basic으로 사용할 수 있습니다. 모든 예제 파일을 컴퓨터로 복사하려면 페이지 맨 위의 디스크 단추를 클릭합니다. 단일 파일을 보려면 파일 이름을 선택하고 보기 단추를 클릭합니다. 이 페이지에서 모든 예제 파일을 직접 볼 수 있는 것은 아닙니다. 폴더에 있는 예제 파일은 목록에 나타나지 않습니다.
이 항목에서는 예제를 실행하고 수정하는 방법을 설명합니다. 필요에 따라 보고서 테이블 수정 지침도 포함되어 있습니다. 테이블은 여러 부분으로 구성됩니다. 각 부분에는 해당 속성과 동작이 있습니다. 예를 들어 열을 추가하려면 인접한 열을 선택해야 합니다. 테이블에 대한 자세한 내용은 테이블 데이터 영역 추가(Visual Studio 보고서 디자이너)을 참조하십시오. 다른 예제 및 개발자 연습에 대한 자세한 내용은 샘플 및 연습을 참조하십시오.
참고 |
---|
MainForm.vb를 열기 전에 먼저 응용 프로그램을 빌드해야 합니다. |
예제를 실행하려면
Visual Studio 2008에서 WebLogAnalyzer.sln을 엽니다.
F5 키를 눌러 예제를 컴파일하고 실행합니다. 응용 프로그램이 시작되면 프로젝트에 포함된 예제 로그 파일을 분석하고 테이블 및 차트 형식으로 결과를 표시합니다. 컴퓨터의 다른 로그 파일을 사용하여 실제 데이터를 볼 수도 있습니다.
Web Log Analyzer의 파일 메뉴에서 로그 파일 열기를 선택합니다. 기본적으로 웹 로그는 C:\Windows\System32\LogFiles\W3SVC1 디렉터리에 저장됩니다.
로그 파일이 포함된 폴더를 선택하고 확인을 클릭합니다. 응용 프로그램은 선택한 폴더의 모든 로그 파일을 읽고 데이터를 분석한 다음 결과를 표시합니다.
분석하지 않을 파일 유형(예: 이미지 파일 및 스타일시트)을 필터링하여 제외시킬 수 있습니다(옵션). 이렇게 하려면 보기 메뉴로 이동하여 파일 무시를 선택합니다. 대화 상자에서 무시할 파일 확장명 목록을 쉼표로 구분하여 입력합니다. 확인을 클릭합니다. 보고서를 새로 고치려면 파일 메뉴에서 로그 파일 열기를 선택하여 로그 파일을 다시 엽니다.
ReportViewer 도구 모음의 옵션을 사용하여 인쇄, 검색 및 페이지 탐색의 수행 방법을 확인할 수 있습니다. 주 보고서에는 보고서의 특정 섹션으로 이동하는 데 사용되는 문서 구조가 있습니다. ReportViewer 도구 모음을 통해 문서 구조를 열 수 있습니다.
제목 표시줄에 나타나는 텍스트를 변경하려면
솔루션 탐색기에서 MainForm.vb를 마우스 오른쪽 단추로 클릭한 다음 디자이너 보기를 선택합니다.
속성 창의 드롭다운 목록에서 MainForm이 선택되어 있는지 확인하고 Text 속성 값을 찾아서 변경합니다. 예를 들어 텍스트를 "Web Log Analyzer"에서 "<Your Company Name> Web Log Analyzer"로 변경합니다.
Enter 키를 누르면 폼의 Text 속성이 변경됩니다. 폼의 제목 표시줄에 새 텍스트가 적용됩니다.
차트에 3차원 효과를 추가하려면
솔루션 탐색기에서 MainReport.rdlc를 두 번 클릭하여 보고서를 엽니다.
차트를 마우스 오른쪽 단추로 클릭한 다음 속성을 선택합니다.
차트 속성 대화 상자에서 3차원 효과 탭으로 전환합니다.
3차원 시각 효과의 차트 표시를 선택합니다.
슬라이더를 사용하여 3차원 차트를 회전합니다.
확인을 클릭하여 대화 상자를 닫습니다.
차트의 가로 막대 색을 변경하려면
솔루션 탐색기에서 MainReport.rdlc를 두 번 클릭하여 보고서를 엽니다.
차트를 마우스 오른쪽 단추로 클릭한 다음 속성을 선택합니다.
데이터 탭으로 전환하여 값 목록 옆의 편집 단추를 클릭합니다.
차트 값 편집 대화 상자에서 모양 탭으로 전환합니다.
계열 스타일 단추를 클릭하여 스타일 속성 대화 상자를 엽니다.
채우기 탭으로 전환하여 새로운 색을 선택합니다.
표시되는 가장 많이 사용된 페이지 수를 변경하려면
솔루션 탐색기에서 MainReport.rdlc를 두 번 클릭합니다.
"Most popular pages" 제목 아래의 테이블을 클릭합니다. 테이블의 다양한 선택기가 표시됩니다.
자세히 행의 행 선택기를 마우스 오른쪽 단추로 클릭한 다음 그룹 편집을 선택합니다.
그룹화 세부 정보 대화 상자에서 필터 탭을 선택합니다. 첫 번째 필터의 값 열에 표시할 행 수를 입력합니다. 텍스트 문자열이 아닌 숫자로 해석되려면 값이 등호(=)로 시작해야 합니다.
웹 사이트에서 가장 많이 참조된 페이지를 표시하려면
솔루션 탐색기에서 LogFileEntry.vb를 두 번 클릭합니다.
LogFileEntry 클래스를 찾아서 Referrer 속성을 추가합니다.
Public ReadOnly Property Referrer() As String Get Return m_referrer End Get End Property
빌드 메뉴에서 WebLogAnalyzer 빌드를 클릭하여 오류가 없는지 확인합니다.
솔루션 탐색기에서 보고서 폴더를 확장한 다음 MainReport.rdlc를 두 번 클릭합니다.
보고서 아래쪽으로 스크롤한 다음 보고서 본문의 아래쪽 가장자리를 위로 끌어 새 테이블을 배치할 공간을 만듭니다.
도구 상자에서 테이블을 보고서로 끌어 옵니다.
기본적으로 테이블에는 3개의 열이 있습니다. 마지막 열은 필요 없으므로 삭제할 수 있습니다. 마지막 열의 열 머리글을 마우스 오른쪽 단추로 클릭한 다음 삭제를 클릭합니다.
데이터에 맞게 열 크기를 조정합니다. 열 테두리를 끌어 크기를 조정할 수 있습니다. 두 번째 열의 너비를 줄입니다. 이 열에는 숫자만 포함되어야 합니다. 첫 번째 열을 확장하여 테이블의 나머지 공간을 사용할 수 있습니다.
데이터 메뉴에서 데이터 소스 표시를 선택합니다. 데이터 소스 창에 LogFileEntry 클래스의 공용 속성이 표시됩니다. 새로 추가한 Referrer 속성도 표시됩니다.
데이터 소스 창에서 Referrer 속성을 테이블에 있는 첫 번째 열의 자세히 행으로 끌어 옵니다. 자세히 행은 가운데 행입니다. 머리글 행에 자동으로 기본 열 머리글이 채워집니다.
자세히 행의 행 선택기를 마우스 오른쪽 단추로 클릭한 다음 그룹 편집을 선택합니다.
그룹화 세부 정보 대화 상자에서 그룹화 대상 테이블의 첫 번째 행을 클릭합니다. 드롭다운 목록에서 =Fields!Referrer.Value를 선택합니다.
그룹화 세부 정보 대화 상자에서 필터 탭을 전환합니다. 식 열에 **=CountRows()**를 입력합니다. 연산자 열에서 Top N을 선택합니다. 값 열에 =10을 입력한 다음 확인을 클릭하여 대화 상자를 닫습니다.
테이블에서 두 번째 열의 머리글 행에 Referrals를 입력하고 자세히 행에 **=CountRows()**를 입력합니다.
테이블 선택기를 마우스 오른쪽 단추로 클릭한 다음 속성을 선택합니다.
테이블 속성 대화 상자에서 정렬 탭으로 전환합니다. 식 열에 **=CountRows()**를 입력하고 방향 열에서 Descending을 선택합니다.
필요에 따라 사용자 사이트와 같은 참조된 특정 페이지를 필터링하여 제외시킬 수 있습니다. 테이블 속성 대화 상자에서 필터 탭으로 전환합니다. 식 열에 **=Fields!Referrer.Value.StartsWith("http://mysite")**를 입력합니다. "http://mysite"를 사용자 사이트의 URL로 바꿉니다. 연산자 열에서 **=**를 선택합니다. 값 열에 =false를 입력합니다.
필요에 따라 속성 창에서 머리글 및 자세히 행과 테이블에 대한 글꼴, 색 및 테두리를 지정합니다.
응용 프로그램을 빌드하여 변경 내용을 확인합니다.
요구 사항
Visual Basic 컴파일러가 포함된 Microsoft Visual Studio 2008이 있어야 합니다.
보고서에 사용되는 데이터는 IIS의 웹 로그에서 제공합니다. 예제를 실행할 수 있도록 정적 데이터 파일이 예제에 포함되어 있습니다. 해당 웹 서버의 로그 파일을 사용하려면 IIS 인스턴스에 액세스할 수 있어야 합니다.
데모
원본 코드에서는 다음을 보여 줍니다.
차트, 테이블, 문서 구조 등을 포함하는 클라이언트 보고서 정의(.rdlc) 파일 만들기
Windows Form 내에서 보고서를 실행하는 ReportViewer 컨트롤 만들기
ReportViewer 클래스의 ReportRefresh 및 Drillthrough 메서드 사용
ReportViewer 클래스의 LocalReport 및 DocumentMapCollapsed 속성 사용
LocalReport 클래스의 DataSources 사용
Report 클래스의 GetDocumentMap 메서드 사용