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

Journaux des événements dans Windows SharePoint Services

Windows SharePoint Services 3

Le rendu des messages électroniques d'alerte se produit après la modification qui a généré l'alerte. Des données du journal des événements sont utilisées pour le rendu des alertes, car l'élément modifié n'existe peut-être pas ou peut exister sous une forme différente au moment de l'envoi du message électronique.

Le journal des événements utilise une table SQL nommée EventCache pour enregistrer les événements de niveau SQL au fur et à mesure qu'ils se produisent. Chaque ligne de la table correspond à un événement. Les événements peuvent être lus à l'aide du modèle objet Windows SharePoint Services.

Le nombre de lignes écrites dans la table correspond au minimum nécessaire pour capturer la sémantique de l'événement. Il est supposé que le lecteur de l'événement sait comment utiliser la ligne d'événement pour évaluer toutes les implications d'un événement donné. Par exemple, lorsqu'un dossier est supprimé, l'événement de suppression de dossier est le seul événement écrit dans le journal des modifications. Aucun événement n'est écrit pour les fichiers et sous-dossiers contenus dans le dossier. Le lecteur de l'événement de suppression de dossier doit comprendre que cela implique la suppression de la totalité du dossier.

Remarque Remarque :

Lorsque vous transférez un fichier vers plusieurs bibliothèques de documents Windows SharePoint Services 3.0, un message électronique d'alerte est envoyé à partir des bibliothèques de documents comme prévu. Toutefois, un message d'alerte est envoyé à partir d'une seule bibliothèque de documents. Vous pourriez vous attendre à ce qu'un message d'alerte soit envoyé à partir de toutes les bibliothèques de documents vers lesquelles vous avez transféré le fichier. Ce problème a été traité dans le correctif logiciel du 12 avril 2007. Pour plus d'informations, voir Description de package Windows SharePoint Services 3.0 de correctifs.

Par défaut, le journal des modifications conserve l'équivalent de 15 jours de données. Vous pouvez configurer ce comportement à l'aide de la page Paramètres généraux de l'application Web située dans la page Administration centrale. Un travail du minuteur s'exécute quotidiennement pour supprimer toutes les entrées du journal des modifications ayant expiré.

Événements de modification

Les événements de modification sont retournés en tant qu'objets dans un objet SPChangeCollection. Chaque objet de modification est une sous-classe de l'objet SPChange. Selon le type d'objet SPChange, différentes propriétés sont disponibles. La collection de modifications est créée via l'appel de SPSite.GetChanges, SPWeb.GetChanges, SPList.GetChanges ou SPContentDatabase.GetChanges. Un objet SPChangeToken est passé à GetChanges pour spécifier l'emplacement auquel doit commencer la lecture dans le journal. Un objet SPChangeToken peut être sérialisé en un format de chaîne via l'appel de la méthode ToString.

Utilisez la propriété SPList.CurrentChangeToken pour obtenir le jeton de modification actuel pour cet objet de liste. Vous pouvez trouver des propriétés semblables sur les objets SPSite, SPWeb et SPContentDatabase.

En règle générale, l'objet SPChangeToken d'un objet ne peut pas être utilisé dans la méthode GetChanges d'un autre objet. La seule exception est que l'objet SPChangeToken d'un objet SPContentDatabase peut être utilisé dans n'importe quel objet se trouvant dans cette base de données de contenu.

Il existe également un objet nommé SPChangeTokenCollection que vous pouvez utiliser pour stocker plusieurs jetons de modification ensemble. Vous pouvez ensuite sérialiser les jetons de modification en une seule chaîne.

Types d'événements du journal des modifications

Le tableau suivant décrit les types d'événements enregistrés dans le journal des modifications. Seuls les types d'événements Add, Modify, Delete, Rename et Restore sont visibles aux alertes.

Tableau 1. Types d'événements

Type d'événement

Description

Add

Un objet a été ajouté. Pour les éléments, les fichiers et les dossiers, la valeur TimeLastModified dans le journal doit être la même que la propriété Created de l'objet.

Modify

Un objet a été modifié. Pour les éléments, les fichiers et les dossiers, la valeur TimeLastModified dans le journal doit être la même que la propriété Modified de l'objet.

Delete

Un objet a été supprimé.

Rename

Un objet a été renommé. Cela signifie que la partie nom de fichier de l'URL a été modifiée.

MoveInto/MoveAway

Un objet a été renommé. Cela signifie que la partie chemin d'accès de l'URL a été modifiée. En outre, la partie nom de fichier peut avoir été modifiée ou non.

Restore

Un objet a été restauré à partir de la Corbeille ou d'une sauvegarde. Cet événement signale au lecteur du journal des modifications d'un client de synchronisation qu'il doit resynchroniser l'objet et tous ses enfants.

Role Add

Un rôle a été ajouté à l'étendue de l'objet.

Assignment Add

Une affectation de rôle a été ajoutée à l'étendue de l'objet.

System Modify

Un objet a été modifié sans que sa propriété Modified ou Modified By ait changé. La valeur TimeLastModified dans le journal doit correspondre à l'instant auquel la mise à jour s'est produite, et non pas à la valeur de la propriété Modified.

Member Add

Un membre a été ajouté à un groupe SharePoint.

Member Delete

Un membre a été supprimé d'un groupe SharePoint.

Role Delete

Un rôle a été supprimé de l'étendue de l'objet.

Role Update

Un rôle a été mis à jour dans l'étendue de l'objet.

Assignment Delete

Une affectation de rôle a été supprimée de l'étendue de l'objet.

Navigation

Les nœuds de navigation ont été mis à jour dans l'étendue de l'objet.

Types d'objets

Le tableau suivant répertorie les types d'objets dont les modifications peuvent être enregistrées dans le journal des modifications. Tous les types d'événements ne sont pas possibles sur tous les types d'objets.

Tableau 2. Types d'objets

Type d'objet

Description

Item

Ce type d'objet s'applique à tous les objets qui existent dans une liste : éléments de liste, fichiers et dossiers.

List

Type d'objet de liste.

Web

Type d'objet Web.

Site

Type d'objet de site.

File

Ce type d'objet s'applique aux fichiers qui existent en dehors d'une liste et n'ont pas d'éléments correspondants.

Folder

Ce type d'objet s'applique aux dossiers qui existent en dehors d'une liste et n'ont pas d'éléments correspondants.

Alert

Type d'objet d'alerte.

User

Type d'objet d'utilisateur.

Group

Type d'objet de groupe.

ContentType

Type d'objet de contenu.

Field

Type d'objet de champ.

SecurityPolicy

Une modification de stratégie de sécurité apportée au niveau de l'application Web affecte la totalité de la base de données de contenu. Cet événement ayant été ajouté tardivement dans le cycle de développement, lui-même et l'événement de restauration au niveau de la base de données de contenu sont enregistrés en tant qu'événement au niveau du site avec un ID de site de « 00000000-0000-0000-000000000000 ».

Voir aussi

Afficher: