Cette documentation est archivée et n’est pas conservée.

Format des modèles d'alerte

Windows SharePoint Services 3

Windows SharePoint Services 3.0 comprend un ensemble de modèles d'alerte prédéfinis. Ces modèles d'alerte sont stockés dans le fichier Alerttemplates.xml. Celui-ci définit le format, le contenu et les propriétés permettant de créer des messages d'alerte à partir de chaque type de liste Un développeur peut personnaliser les alertes en modifiant une copie de Alerttemplates.xml, puis en chargeant les modèles d'alerte personnalisés à l'aide de la commande stsadm -o updatealerttemplates.

Remarque Remarque :

Ne modifiez pas le fichier Alerttemplates.xml. Cela peut entraîner une perte de fonctionnalités lors de la mise à niveau ou de l'installation de Service Packs.

Pour obtenir la liste des modèles d'alerte prédéfinis, voir Modèles d'alerte prédéfinis.

Schéma des modèles d'alerte

Les modèles d'alerte présentent le format suivant :

<AlertTemplates>
  <AlertTemplate Type="List" Default="True" Name ="Default Template">
  </AlertTemplate>
  <AlertTemplate Type="List" Name="SPAlertTemplateType.GenericList">
    <EventTypes IsVisible="True"/>
    <Format>
    </Format>
    <Properties>
    </Properties>
    <Filters>
      <FilterDefinition>
      </FilterDefinition>
    </Filters>
  </AlertTemplate>
</AlertTemplates>

Tableau 1. Attributs de modèle d'alerte

Attribut

Description

Name

Nom du modèle. La recherche sur les noms de modèles permet de rechercher un modèle particulier facilement.

Type

L'attribut de type peut être défini sur List, Item ou Custom.

Default

Default = "True" définit le modèle d'alerte par défaut.

Filters

Si IsVisible = "True", les champs de filtre sont affichés lorsque vous créez l'alerte.

Définitions de filtres

Définissez un filtre (requête).

Format

La mise en forme du message électronique est définie dans l'élément Format.

Champs

Spécifient les champs à afficher dans le message d'alerte.

Filtres et éléments de définition de filtres

Les filtres vous permettent de créer des déclencheurs pour un événement tel que « la priorité d'une tâche a été modifiée ». Pour modifier les filtres existants ou créer des filtres supplémentaires, modifiez l'élément FilterDefinition du modèle approprié. Définissez l'élément Query à l'intérieur du filtre à l'aide du langage Collaborative Application Markup Language (CAML).

La requête suivante crée un événement d'alerte si la date d'événement, la date de fin ou l'emplacement change.

<FilterDefinition>
  <FriendlyName>$Resources:Alerts_4_filter;</FriendlyName>
  <ShortName>$Resources:Alerts_4_filter_shortname;</ShortName>
  <Query>
  <Or>
    <Or>
      <Neq><FieldRef name="EventDate/New"/>
        <FieldRef name="EventDate/Old"/>
      </Neq>
      <Neq>
        <FieldRef name="EndDate/New"/>
        <FieldRef name="EndDate/Old"/>
      </Neq>
    </Or>
      <Neq>
        <FieldRef name="Location/New"/>
        <FieldRef name="Location/Old"/>
      </Neq>
    </Or>
  </Query>
</FilterDefinition>

Les variables de ressource répertoriées dans AlertTemplates.xml, telles que $Resources:Alerts_anything_filter_shortname, se trouvent dans le fichier core.resx stocké dans lecteur_local\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\Resources.

Remarque Remarque :

L'élément Query du schéma Alerts ne contient pas d'élément Where.

Pour plus d'informations sur le schéma de requête CAML, voir Schéma de requête.

Élément Format

Utilisez l'élément Format d'un modèle d'alerte pour modifier l'apparence du message d'alerte. Vous pouvez également personnaliser la mise en forme du message d'alerte à l'aide des styles intégrés.

<Format>
  <Digest> - digest format
    <Subject>
    </Subject>
    <Header>
    </Header>
    <HeaderFieldsHeader>
    </HeaderFieldsHeader>
    <HeaderFields>
    </HeaderFields>
    <HeaderFieldsFooter>
    </HeaderFieldsFooter>
    <RowHeader>
    </RowHeader>
    <RowFields>
    </RowFields>
    <RowFooter>
    </RowFooter>
    <Footer>
    </Footer>
  </Digest>
  <Immediate>
    <Subject>
    </Subject>
    <Header>
    </Header>
    <Fields>
    </Fields>
    <Footer>
  </Footer>
  </Immediate>
</Format>

Élément d'en-tête de ligne

Chaque ligne d'en-tête de ligne fait référence à chaque modification au niveau de l'élément dans la notification Digest.

Élément Subject

Objet du courrier électronique.

Élément Fields

L'élément Fields indique les champs à restituer dans le message électronique. Par exemple, vous pouvez spécifier <GetVar Name="NewValue#{Field}"> à l'intérieur de la section Fields. Vous pouvez consulter davantage d'exemples dans AlertTemplates.xml.

CAML passe en revue tous les champs et restitue cette partie du modèle. Le champ lui-même doit être référencé à l'aide de <GetVar Name=”OldValue#{Field}” /> ou <GetVar Name=”NewValue#{Field}” />

Pour empêcher le rendu de certains champs dans le message électronique, vous devez les inclure dans les sections DigestNotificationExcludedFields et ImmediateNotificationExcludedFields, qui vous permettent de restituer différents champs pour les alertes immédiates et les alertes de synthèse (Digest).

Élément Properties

L'élément Properties vous permet d'inclure ou d'exclure dans la liste des champs qui seraient restitués dans le message électronique et de spécifier les gestionnaires d'alerte. L'exemple ci-dessous montre comment exclure des champs pour les alertes immédiates et de synthèse (Digest).

<Properties>
   <ImmediateNotificationExcludedFields>
      ID;Author;Editor;Modified_x0020_By;Created_x0020_By;
      _UIVersionString;ContentType;TaskGroup;IsCurrent;Attachments;
      NumComments;
   </ImmediateNotificationExcludedFields>
   <DigestNotificationExcludedFields>
      ID;Author;Editor;Modified_x0020_By;Created_x0020_By;
      _UIVersionString;ContentType;TaskGroup;IsCurrent;Attachments;
      NumComments;
   </DigestNotificationExcludedFields>
</Properties>

Voir aussi

Afficher: