Ejemplo de seguimiento simple

Download sample

En este ejemplo se muestra el uso del servicio de seguimiento de SQL proporcionado por Windows Workflow Foundation para realizar el seguimiento de la ejecución de un flujo de trabajo.

El motor en tiempo de ejecución de flujos de trabajo provoca ciertos eventos mientras está ejecutando un flujo de trabajo. El servicio de seguimiento puede detectar estos eventos y almacenar información al respecto en una base de datos de SQL Server en la que se pueden hacer consultas.

El tiempo de ejecución del flujo de trabajo provoca los tipos de eventos siguientes:

• Eventos del nivel de instancia. Estos eventos se provocan cuando una instancia de flujo de trabajo entra en un estado determinado. Por ejemplo, se provoca un evento cuando la instancia de flujo de trabajo se inicializa o cuando está en ejecución.

• Eventos del nivel de actividad. Un flujo de trabajo consta de actividades y cada actividad sigue un ciclo de vida. Durante su ciclo de vida, la actividad atraviesa varios estados. Se provoca un evento cuando una actividad llega a un estado determinado.

• Eventos supervisados por el usuario. El autor de un flujo de trabajo puede crear eventos de seguimiento personalizados y agregarlos al código lateral del flujo de trabajo.

Se pueden emitir los datos del contexto de datos del flujo de trabajo, y entregarlos al servicio de seguimiento junto con los eventos.

Al estar realizando el seguimiento de un flujo de trabajo, podrían no interesarle todos los eventos para todos los estados y actividades. Puede crear un perfil del seguimiento para especificar los eventos y datos que le interesan. El servicio de seguimiento de SQL tiene un perfil del seguimiento predeterminado. En este ejemplo se muestra cómo utilizar el servicio de seguimiento de SQL con el perfil del seguimiento predeterminado.

Use el código siguiente para registrar un servicio de seguimiento con el tiempo de ejecución del flujo de trabajo:

WorkflowRuntime wr = new WorkflowRuntime();
wr.AddService(new SqlTrackingService(connectionstring));
wr.StartRuntime();

La segunda línea registra el servicio de seguimiento de SQL con el tiempo de ejecución del flujo de trabajo. La cadena de conexión es la cadena de conexión de la base de datos de seguimiento.

El resultado del ejemplo será el siguiente:

Crear la base de datos de seguimiento

Los servicios SQL instalados por Windows Workflow Foundation utilizan Microsoft SQL Server para almacenar información. Puede utilizar Microsoft SQL Server 2005 Express, SQL Server 2000 o versiones posteriores, o Microsoft SQL Server 2000 Desktop Engine (MSDE) para estas tareas.

El programa de instalación de Windows Workflow Foundation no instala las bases de datos necesarias para estos servicios; sin embargo, el programa de instalación instala los scripts de SQL para crear y configurar las bases de datos para estos servicios.

Para crear la base de datos de seguimiento de SQL

• Utilice Microsoft SQL Server 2005 Express, SQL Server 2000 o versiones posteriores, o SQL Server 2000 Desktop Engine (MSDE) para crear una nueva base de datos denominada Tracking, utilizando la instrucción de consulta SQL:

  CREATE DATABASE Tracking
  

1. En el área de trabajo del Analizador de consultas SQL, seleccione la base de datos que creó en el paso 1, en la lista de bases de datos disponibles.

2. En el menú Archivo, haga clic en Abrir y abra el script de SQL %WINDIR%\Microsoft.NET\Framework\v3.0\Windows Workflow Foundation\SQL\<lenguaje>\Tracking_Schema.sql.

3. Ejecute la consulta haciendo clic en Ejecutar o presionando F5 para crear las tablas del servicio de seguimiento de SQL.

4. En el menú Archivo, haga clic en Abrir y abra el script de SQL %WINDIR%\Microsoft.NET\Framework\v3.0\Windows Workflow Foundation\SQL\<lenguaje>\Tracking_Logic.sql.

5. Ejecute la consulta haciendo clic en Ejecutar o presionando F5 para crear los procedimientos almacenados del servicio de seguimiento de SQL.

Para generar el ejemplo

1. Para descargar el ejemplo, haga clic en Descargar ejemplo.

   Así se extrae el proyecto de ejemplo en su disco duro local.

2. Haga clic en Inicio, señale Programas, señale Microsoft Windows SDK y, a continuación, haga clic en CMD Shell.

3. Vaya al directorio de origen del ejemplo.

4. En el símbolo del sistema, escriba MSBUILD <nombre del archivo de solución>.

Para ejecutar el ejemplo

• En la ventana del símbolo del sistema del SDK, ejecute el archivo .exe de la carpeta SimpleTrackingSample\bin\debug (o la carpeta SimpleTrackingSample\bin para la versión de VB del ejemplo), que se encuentra bajo la carpeta principal del ejemplo.

Consulte también

Referencia

SqlTrackingService
SqlTrackingQuery
SqlTrackingWorkflowInstance
ActivityEvents
ActivityTrackingRecord
WorkflowEvents
WorkflowTrackingRecord

Otros recursos

Ejemplos de seguimiento
Ejemplo de consulta mediante SQLTrackingService
Ejemplo de seguimiento mediante puntos de seguimiento del usuario
Ejemplo de seguimiento de EventArgs
Ejemplo de ConsoleTrackingService
Ejemplo de consulta mediante SQLTrackingService
Ejemplo de RuleActionTrackingEvent
Ejemplo de servicio de seguimiento y de consulta
Usar el modelo de objetos de perfil de seguimiento (ejemplo)
Ejemplo de mantenimiento de datos de SQL

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.