EventArgs Tracking 샘플

아티클
04/23/2008

이 샘플에서는 Windows Workflow Foundation에서 제공하는 SQL 추적 서비스를 사용하여 워크플로 실행을 추적하는 방법을 보여 줍니다.

워크플로 런타임은 워크플로를 실행 중일 때 특정 이벤트를 발생시킵니다. 추적 서비스는 이러한 이벤트를 catch하고 관련 정보를 쿼리 가능한 SQL Server 데이터베이스에 저장할 수 있습니다.

추적 런타임은 워크플로 종료, 일시 중단 및 예외에 대한 정보를 저장하기 위해 각각 TrackingWorkflowTerminatedEventArgs, TrackingWorkflowSuspendedEventArgs 및 TrackingWorkflowExceptionEventArgs 형식을 정의합니다. WorkflowEventArgs가 해당 이벤트에 대해 WorkflowTrackingRecord와 함께 전송됩니다. 예를 들어 워크플로 상태가 WorkflowTerminated 상태에 도달하면 TrackingWorkflowTerminatedEventArgs가 WorkflowTrackingRecord와 함께 전송됩니다.

추적 프로필에서 요청할 경우, SqlTrackingService에서는 이러한 다양한 EventArgs 개체가 도착하면 이를 수신하고 serialize하며 해당 이벤트와 함께 추적 데이터베이스에 저장합니다. 그런 다음 serialize된 형식이 deserialize되고 이를 추적 사용자가 사용합니다. 사용되는 추적 프로필은 SqlTrackingService 기본 추적 프로필입니다.

참고

WorkflowTrackingRecord의 시간 값은 협정 세계시(그리니치 표준시)입니다.

샘플 개요

이 샘플은 워크플로 콘솔 응용 프로그램이며 다음과 같은 두 개의 워크플로로 구성됩니다.

ExceptionWorkflow. 코드 처리기가 있는 간단한 워크플로이며 여기서 예외가 throw됩니다. 이 예외는 처리되지 않으며 그 결과 워크플로가 종료됩니다.
SuspendedWorkflow. 일시 중단 활동이 있는 간단한 워크플로입니다. 워크플로가 일시 중단 상태가 됩니다.

이 샘플의 주 항목은 Program 클래스이며 이 클래스에는 다음 논리가 포함됩니다.

SqlTrackingService 데이터베이스와의 connectionString을 만듭니다.
다음과 같이 SqlTrackingService를 워크플로 런타임에 추가합니다.
```
workflowRuntime.AddService(new SqlTrackingService(connectionString));
```

다음과 같이 워크플로를 실행합니다.

WorkflowInstance exceptionWorkflowInstance = workflowRuntime.CreateWorkflow(typeof(ExceptionWorkflow));
exceptionWorkflowInstance.Start();

워크플로 유형에 따라 워크플로가 끝나거나 종료될 때까지 대기하는 이벤트 처리기를 만듭니다.
SqlTrackingService에서 특정 WorkflowEvents를 쿼리하고 이진 serialize된 개체인 TrackingWorkflowTerminatedEventArgs, TrackingWorkflowSuspendedEventArgs 및 TrackingWorkflowExceptionEventArgs를 검색합니다.
데이터를 deserialize하고 그 내용을 콘솔에 씁니다.

SqlTrackingService 데이터베이스 만들기

Windows Workflow Foundation으로 설치되는 SQL 서비스는 Microsoft SQL Server를 사용하여 정보를 저장합니다. 이러한 작업에 Microsoft SQL Server 2005 Express, SQL Server 2000 이상 버전 또는 SQL Server 2000 Desktop Engine(MSDE)을 사용할 수 있습니다.

Windows Workflow Foundation 설치 프로그램은 이러한 서비스에 필요한 데이터베이스를 설치하지 않지만, 이러한 서비스에 대한 데이터베이스를 만들고 구성하기 위한 SQL 스크립트를 설치합니다.

SQL 추적 데이터베이스를 만들려면

Microsoft SQL Server 2005 Express, SQL Server 2000 이상 버전 또는 MSDE(SQL Server 2000 Desktop Engine)에서 다음과 같은 SQL 쿼리문을 사용하여 이름이 Tracking인 새 데이터베이스를 만듭니다.

CREATE DATABASE Tracking

참고 워크플로 응용 프로그램에서 SqlTrackingService와 SqlWorkflowPersistenceService를 모두 사용할 경우 유지와 추적 모두에 단일 데이터베이스를 사용하는 것이 좋습니다.
SQL 쿼리 분석기 작업 영역의 사용 가능한 데이터베이스 목록에서 1단계에서 만든 데이터베이스를 선택합니다.
파일 메뉴에서 열기를 클릭하고 SQL 스크립트 %WINDIR%\Microsoft.NET\Framework\v3.0\Windows Workflow Foundation\SQL\<language>\Tracking_Schema.sql을 엽니다.
실행을 클릭하거나 F5 키를 눌러 쿼리를 실행하여 SQL 추적 서비스 테이블을 만듭니다.
파일 메뉴에서 열기를 클릭하고 SQL 스크립트 %WINDIR%\Microsoft.NET\Framework\v3.0\Windows Workflow Foundation\SQL\<language>\Tracking_Logic.sql을 엽니다.
실행을 클릭하거나 F5 키를 눌러 쿼리를 실행하여 SQL 추적 서비스 저장 프로시저를 만듭니다.

이 샘플을 빌드하려면

샘플 다운로드를 클릭하여 샘플을 다운로드합니다.

이렇게 하면 샘플 프로젝트가 로컬 하드 디스크에 추출됩니다.
시작을 클릭하고 프로그램, Microsoft Windows SDK를 차례로 가리킨 다음 CMD 셸을 클릭합니다.
샘플의 소스 디렉터리로 이동합니다.
명령 프롬프트에서 **MSBUILD <Solution file name>**을 입력합니다.

이 샘플을 실행하려면

SDK 명령 프롬프트 창에서 샘플의 주 폴더 아래에 있는 EventArgsTrackingSample\bin\debug 폴더 또는 EventArgsTrackingSample\bin 폴더(VB 버전의 샘플의 경우)의 .exe 파일을 실행합니다.

참고 항목

참조

SqlTrackingService
SqlTrackingQuery
SqlTrackingWorkflowInstance
ActivityEvents
ActivityTrackingRecord
WorkflowEvents
WorkflowTrackingRecord

기타 리소스

추적 샘플
Simple Tracking 샘플
Query Using SQLTrackingService 샘플
Tracking Using User Track Points 샘플
ConsoleTrackingService 샘플
Query Using SQLTrackingService 샘플
RuleActionTrackingEvent 샘플
File Tracking Service and Query 샘플
Using the Tracking Profile Object Model 샘플
SQL Data Maintenance 샘플
Windows Workflow Tracking Services

Footer image

다음을 통해 공유