Leçon 3 : Ajout d'une classe d'événements

Article
12/15/2008

Au cours de cette leçon, vous allez ajouter une classe d'événements au fichier de définition d'application (FDA), puis mettre à jour l'instance de Notification Services pour appliquer ces modifications à la base de données d'application. Vous pouvez vérifier les modifications apportées à la base de données d'application.

Informations de base sur les classes d'événements

Une classe d'événements représente un type d'événement utilisé par votre application Notification Services. Lorsque vous définissez une classe d'événements, vous définissez un type d'événement qui peut être soumis à votre application et utilisé pour générer des notifications. La définition de classe d'événements inclut les noms des champs d'événements, les types de données et les modificateurs de type.

Une classe d'événements peut définir d'autres informations, telles que des index sur des données d'événement et des tables complémentaires. Pour plus d'informations sur les classes d'événements, consultez Définition des classe d'événements.

Lorsque vous créez l'application, Notification Services utilise la définition de classe d'événements pour créer les tables, les affichages, les index et les procédures stockées pour stocker, collecter et gérer les données d'événement.

La classe d'événements WeatherData

Pour cette application, vous allez ajouter une classe d'événements WeatherData au fichier de définition d'application (FDA). Cette classe d'événements compte cinq champs d'événement : City, Date, Low, High et Forecast. Ils décrivent les données d'événement que vous allez soumettre plus tard à l'application. Pour chaque champ d'événement, la classe d'événements définit le nom du champ, le type de données et les modificateurs de champ.

Pour améliorer les performances du processus de génération des notifications, la classe d'événements spécifie également un index sur le champ City de la classe d'événements WeatherData.

Ajout du XML de la classe d'événements au fichier FDA

Le XML de cette section définit la classe d'événements. Étudiez-le, puis suivez les instructions pour le copier dans le fichier FDA.

Pour ajouter le XML de la classe d'événements au fichier FDA

Cliquez sur Copier le code pour copier le XML dans le Presse-papiers 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>

Dans l'Explorateur de solutions, ouvrez WeatherADF.xml.
Remplacez le commentaire suivant par le XML que vous venez de copier.


Dans le menu Fichier, cliquez sur Enregistrer WeatherADF.xml.

Mise à jour de l'instance de Notification Services

Une fois le fichier FDA modifié, vous devez mettre à jour l'instance de Notification Services pour ajouter les objets de classe d'événements à la base de données d'application.

Pour mettre à jour l'instance de Notification Services

Dans l'Explorateur d'objets, développez Notification Services.
Cliquez avec le bouton droit sur Didacticiel, pointez sur Tâches, puis sélectionnez Mettre à jour.
Dans la boîte de dialogue Mettre à jour l'instance, cliquez sur Parcourir, recherchez et sélectionnez le fichier TutorialICF.xml, puis cliquez sur Ouvrir.
Dans la grille Paramètres, vérifiez les valeurs des paramètres.

Les valeurs doivent être correctes car vous les avez modifiées comme demandé à la leçon 2. Si vous devez modifier ces valeurs, retournez à la leçon 2 pour apprendre à modifier les valeurs par défaut des paramètres dans le fichier de configuration d'instance (ICF).
Cliquez sur OK.
Passez en revue la boîte de dialogue Notification Services - Mettre à jour le résumé, puis cliquez sur Mettre à jour.
Une fois la mise à jour terminée, cliquez sur Fermer.

Vérification des modifications apportées à la base de données d'application

Lorsque vous mettez à jour l'instance, Notification Services ajoute des tables, des affichages et des procédures stockées pour la classe d'événements dans la base de données d'application TutorialWeather.

L'affichage d'événement dbo.WeatherData correspond à l'ensemble actuel d'événements en cours de traitement par l'application. Lorsque vous aurez à écrire des requêtes de génération de notifications, vous sélectionnerez les données dans cet affichage.

La table dbo.NSWeatherDataEvents est la table sous-jacente qui contient les données d'événement pour la classe d'événements. Les données d'événement sont conservées dans cette table tant qu'elles ne sont pas supprimées par le processus de suppression des données (ramasse-miettes).

Attention :
Ne modifiez pas directement les données dans la base de données de l'application et de l'instance. Pour ajouter des données d'événement, vous devez utiliser l'une des méthodes de dépôt d'événement prise en charge et par exemple, les fournisseurs d'événements intégrés, les procédures stockées de dépôt d'événement ou l'API. Pour plus d'informations, consultez Définition des fournisseurs d'événements.

Ne modifiez pas directement les données dans la base de données de l'application et de l'instance. Pour ajouter des données d'événement, vous devez utiliser l'une des méthodes de dépôt d'événement prise en charge et par exemple, les fournisseurs d'événements intégrés, les procédures stockées de dépôt d'événement ou l'API. Pour plus d'informations, consultez Définition des fournisseurs d'événements.

Vous pouvez utiliser l'Explorateur d'objets pour étudier ces objets dans la base de données TutorialWeather. Il peut s'avérer nécessaire de réactualiser l'Explorateur d'objets pour voir les nouveaux objets.

Leçon suivante

Leçon 4 : Ajout d'une classe de notification

Voir aussi