Implementieren von Benachrichtigungshandlern

Artikel
09/24/2014

Letzte Änderung: Montag, 8. März 2010

Gilt für: SharePoint Foundation 2010

Sie werden über Benachrichtigungsereignisse informiert, wenn Sie die OnNotification-Funktion in der IAlertNotifyHandler-Schnittstelle implementieren.

Sie werden über Ereignisse zum Erstellen und Ändern von Benachrichtigungen informiert, wenn Sie die Funktionen PreUpdate und PostUpdate in IAlertUpdateHandler implementieren.

Wichtig
Benachrichtigungshandler werden nur ausgelöst, wenn der Benutzer E-Mail-Benachrichtigungen abonniert hat. Sie werden nicht ausgelöst, wenn der Benutzer SMS-Benachrichtigungen ausgewählt hat.

Implementieren eines Benachrichtigungshandlers

Mithilfe der folgenden Vorgehensweise können Sie einen Benachrichtigungshandler implementieren.

So implementieren Sie einen Benachrichtigungshandler

Erstellen Sie Klassen zum Implementieren der Schnittstellen IAlertNotifyHandler und IAlertUpdateHandler.
Registrieren Sie die Assemblys im globalen Assemblycache.

Stellen Sie wie folgt eine Verbindung zwischen der Benachrichtigungsvorlage und dem Handler her, indem Sie das Properties-Element der Benachrichtigungsvorlage verwenden:

<Properties>
  <NotificationHandlerAssembly>
    Handler assembly strong name
  </NotificationHandlerAssembly>
  <NotificationHandlerClassName>
    Fully qualified class name
  </NotificationHandlerClassName> 
  <NotificationHandlerProperties>
    Other option properties you want to pass
  </NotificationHandlerProperties>
  <UpdateHandlerAssembly>
    Assembly
  </UpdateHandlerAssembly>
  <UpdateHandlerClassName>
    Class name
  </UpdateHandlerClassName>
  <UpdateHandlerProperties>
    Other properties
  </UpdateHandlerProperties>
</Properties>

Benachrichtigungsvorlagen werden in AlertTemplates.xml und AlertTemplates_SMS.xml gespeichert. Diese Vorlagen definieren das Format, die Inhalte und die Eigenschaften, die zum Erstellen von Warnmeldungen anhand der verschiedenen Listentypen verwendet werden. Entwickler können Benachrichtigungen anpassen, indem sie eine Kopie von einer Datei oder von beiden Dateien erstellen und dann die angepassten Benachrichtigungsvorlagen mithilfe von befehl stsadm -o updatealerttemplates laden.

Hinweis
Sie dürfen AlertTemplates.xml oder AlertTemplates_SMS.xml nicht ändern. Diese Dateien werden möglicherweise überschrieben, wenn ein Service Pack installiert wird. Wenn Sie Änderungen vornehmen möchten, erstellen Sie eine Kopie einer Datei oder beider Dateien, bearbeiten Sie die Kopie, und rufen Sie dann den Befehl stsadm -o updatealerttemplates einmal oder zweimal auf, um die ursprünglichen Vorlagen mit Ihren Änderungen zu überschreiben. Ihre Änderungen werden in der SharePoint Foundation-Konfigurationsdatenbank gespeichert. Ausführliche Informationen finden Sie unter Übersicht über Warnungen und AlertTemplates-Schema.

Sie dürfen AlertTemplates.xml oder AlertTemplates_SMS.xml nicht ändern. Diese Dateien werden möglicherweise überschrieben, wenn ein Service Pack installiert wird. Wenn Sie Änderungen vornehmen möchten, erstellen Sie eine Kopie einer Datei oder beider Dateien, bearbeiten Sie die Kopie, und rufen Sie dann den Befehl stsadm -o updatealerttemplates einmal oder zweimal auf, um die ursprünglichen Vorlagen mit Ihren Änderungen zu überschreiben. Ihre Änderungen werden in der SharePoint Foundation-Konfigurationsdatenbank gespeichert. Ausführliche Informationen finden Sie unter Übersicht über Warnungen und AlertTemplates-Schema.

Wichtig
Wenn Sie eine Änderung an einer bestimmten SPAlertTemplateType.-Vorlage außerhalb des Format-Elements vornehmen, müssen Sie dieselbe Änderung an der entsprechenden SPSmsAlertTemplateType.-Vorlage vornehmen.

Erfassen eines Ereignisses

Implementieren Sie IAlertNotifyHandler, wenn Sie informiert werden möchten, wenn eine Benachrichtigung ausgelöst wird. IAlertNotifyHandler.OnNotification wird aufgerufen, wenn die Benachrichtigung ausgelöst wird. Ein SPAlertHandlerParams-Objekt wird an die Funktion übergeben. Schicken Sie dann die Meldung entweder mit einer E-Mail-Sendemethode wie z. B. SendEmail oder mit einer SMS-Nachrichtensendemethode wie z. B. SendMessage(String).

Implementieren Sie die IAlertNotifyHandler-Schnittstelle, wenn Sie informiert werden möchten, wenn eine neue Benachrichtigung erstellt oder aktualisiert wird (damit Sie die Eigenschaften ändern oder neue Eigenschaften festlegen können). PreUpdate wird aufgerufen, bevor für die Änderungen an der Benachrichtigung ein Commit für die Datenbank ausgeführt wird. PostUpdate wird aufgerufen, nachdem für die Änderungen ein Commit ausgeführt wurde.

Hinweis
Beim Implementieren von IAlertNotifyHandler dürfen Sie nicht auf SPAlertCollection zugreifen oder das SPAlert-Objekt ändern, und testen Sie stets, ob eine SPAlert-Eigenschaft null ist, bevor Sie auf diese zugreifen.

Siehe auch

Konzepte

Warnungen in SharePoint Foundation

Freigeben über