Lección 3: Agregar una clase de eventos

Artículo
12/15/2008

En esta lección, agregará una clase de evento al archivo de definición de aplicación (ADF) y después actualizará la instancia de Notification Services para aplicar los cambios a la base de datos de la aplicación. Luego podrá revisar los cambios realizados en la base de datos de la aplicación.

Información básica sobre la clase de evento

Una clase de evento representa un tipo de evento utilizado por la aplicación de Notification Services. Al definir una clase de evento, se define un tipo de evento que puede enviarse a la aplicación y utilizarse para generar notificaciones. La definición de clase de evento incluye nombres de campos de evento, tipos de datos y modificadores de tipo.

Una clase de evento puede definir otro tipo de información, como índices en tablas de datos de evento y tablas adicionales. Para obtener más información sobre las clases de evento, vea Definir clases de eventos.

Al crear la aplicación, Notification Services utiliza la definición de clase de evento para crear tablas, vistas, índices y procedimientos almacenados para almacenar, recopilar y administrar datos de evento.

Clase de evento WeatherData

Para esta aplicación, agregará una clase de evento WeatherData al archivo ADF. Esta clase de evento tiene cinco campos: City, Date, Low, High y Forecast. Estos campos describen los datos de evento que más adelante se enviarán a la aplicación. La clase de evento define, para cada campo de evento, un nombre de campo, un tipo de datos y modificadores de campo.

Con el fin de mejorar el rendimiento de la generación de notificaciones, la clase de evento también especifica un índice en el campo City de la clase de evento WeatherData.

Agregar XML de clase de evento al ADF

El XML de esta sección define la clase de evento. Examine el XML y siga las instrucciones que se indican para copiarlo en el ADF.

Para agregar XML de clase de evento al ADF

Haga clic en Copiar código para copiar el XML en el Portapapeles de Windows.

<!-- Event Classes -->
<EventClasses>
  <EventClass>
    <EventClassName>WeatherData</EventClassName>
    <Schema>
      <Field>
        <FieldName>City</FieldName>
        <FieldType>nvarchar(35)</FieldType>
        <FieldTypeMods>not null</FieldTypeMods>
      </Field>
      <Field>
        <FieldName>Date</FieldName>
        <FieldType>datetime</FieldType>
        <FieldTypeMods>not null</FieldTypeMods>
      </Field>
      <Field>
        <FieldName>Low</FieldName>
        <FieldType>float</FieldType>
        <FieldTypeMods>not null</FieldTypeMods>
      </Field>
      <Field>
        <FieldName>High</FieldName>
        <FieldType>float</FieldType>
        <FieldTypeMods>not null</FieldTypeMods>
      </Field>
      <Field>
        <FieldName>Forecast</FieldName>
        <FieldType>nvarchar(3500)</FieldType>
        <FieldTypeMods>not null</FieldTypeMods>
      </Field>
    </Schema>
    <IndexSqlSchema>
      <SqlStatement>CREATE INDEX myIndex 
      ON WeatherData ( City );
      </SqlStatement>
    </IndexSqlSchema>
  </EventClass>
</EventClasses>

En el Explorador de soluciones, abra el archivo WeatherADF.xml.
Sustituya el comentario siguiente por el XML que acaba de copiar.


En el menú Archivo, seleccione Guardar WeatherADF.xml.

Actualizar la instancia de Notification Services

Tras modificar el ADF, debe actualizar la instancia de Notification Services para agregar los objetos de clase de evento a la base de datos de la aplicación.

Para actualizar la instancia de Notification Services

En el Explorador de objetos, expanda Notification Services.
Haga clic con el botón secundario en Tutorial, seleccione Tareas y, a continuación, seleccione Actualizar.
En el cuadro de diálogo Actualizar instancia, haga clic en Examinar, busque el archivo TutorialICF.xml y haga clic en Abrir.
En la cuadrícula Parámetros, revise los valores de los parámetros.

Estos valores deben ser correctos, porque los ha modificado adecuadamente en la Lección 2. Si es preciso modificarlos, vuelva a la Lección 2 para obtener información sobre cómo modificar los valores predeterminados de los parámetros del ICF.
Haga clic en Aceptar.
Revise el cuadro de diálogo Notification Services: resumen de actualización y haga clic en Actualizar.
Cuando las acciones de actualización hayan finalizado, haga clic en Cerrar.

Revisar los cambios realizados en la base de datos de la aplicación

Una vez que ha actualizado la instancia, Notification Services agrega tablas, vistas y procedimientos almacenados para la clase de evento en la base de datos TutorialWeather de la aplicación.

La vista de evento dbo.WeatherData es el conjunto de eventos actual que procesa la aplicación. Cuando más adelante escriba las consultas para generar notificaciones, seleccionará datos de esta vista.

La tabla dbo.NSWeatherDataEvents es la tabla subyacente que contiene los datos de evento para la clase de evento. Los datos de evento permanecen en esta tabla hasta que el proceso de eliminación de datos Vacuumer los elimina.

Advertencia:
No modifique directamente los datos de la aplicación y de las bases de datos de la instancia. Para agregar datos de evento, debe utilizar uno de los métodos de envío de eventos admitido, como los proveedores de eventos integrados, procedimientos almacenados de envío de eventos o la API. Para obtener más información, vea Definir proveedores de eventos.

Puede utilizar el Explorador de objetos para examinar estos objetos en la base de datos TutorialWeather. Es posible que deba actualizar el Explorador de objetos para ver los objetos nuevos.

Lección siguiente

Lección 4: Agregar una clase de notificación

Vea también

Compartir a través de