Comment : activer les notifications par e-mailHow-to: enable email notification

Les notifications par e-mail permettent à un propriétaire de contenu protégé d’être averti quand un utilisateur accède à son contenu.Email notification allows for a protected content owner to be notified when his or her content is accessed.

Si vous voulez configurer les notifications par e-mail pour une licence donnée, utilisez IpcSetLicenseProperty avec le paramètre de type de propriété dwPropID comme IPC_LI_APP_SPECIFIC_DATA, et les champs de données de l’application comme IPC_NAME_VALUE_LIST.To setup your email notification for a given license, use IpcSetLicenseProperty with the property type parameter, dwPropID, as IPC_LI_APP_SPECIFIC_DATA and the application data fields formatted as an IPC_NAME_VALUE_LIST.

C++

int numDataPairs = 3;

IPC_NAME_VALUE propertyValuePairs [numDataPairs];

// lcid field set to 0 causes the default lcid to be used

propertyValuePairs[0] = {"MS.Conetent.Name", 0, "FinancialReport.docx"};
propertyValuePairs[1] = {"MS.Notify.Enabled",0 , "true"};
propertyValuePairs[2] = {"MS.Notify.Culture",0 , “en-US”};

IPC_NAME_VALUE_LIST emailNotificationAppData = {numDataPairs, propertyValuePairs};

result = IpcSetLicenseProperty( licenseHandle, FALSE, IPC_LI_APP_SPECIFIC_DATA, emailNotificationAppData);

Le tableau suivant contient les champs de données de l’application (les paires nom/valeur des propriétés) pour les e-mails de notification RMS.The following table contains the application data fields, property name and value pairs, for RMS email notification.

Nom de la propriétéProperty Name Type de donnéesData Type Exemple de valeurExample Value RemarquesNotes
MS.Content.NameMS.Content.Name stringstring « FinancialReport.docx »“FinancialReport.docx” Il s’agit d’un identificateur associé au contenu protégé.This is an identifier associated with the protected content.

Pour les fichiers protégés, cette valeur doit être le nom du fichier, sans les informations de chemin.For protected files this value should be the name of the file without any path information.

Pour les autres types de contenu, par exemple, les e-mails, cette valeur peut correspondre à l’objet de l’e-mail ou bien être vide.For other types of content such as an email message it might be the subject of the email or it might be empty.
MS.Notify.EnabledMS.Notify.Enabled stringstring « true » | « false »“true” | “false” Si cette valeur est définie sur « true », un e-mail de notification est envoyé au propriétaire de la licence de publication quand un utilisateur tente d’utiliser sa licence pour obtenir une licence utilisateur final.If this value is set to “true” a notification email will be sent to the owner of the publishing license when someone attempts to use it to obtain an end user license.
MS.Notify.CultureMS.Notify.Culture stringstring « en-US »“en-US” Source : System.Globalization.CultureInfo.CurrentUICulture.NameSource: System.Globalization.CultureInfo.CurrentUICulture.Name

Cette valeur est utilisée pour déterminer la langue localisée de l’e-mail de notification, ainsi que le format de date et d’heure qui doit être utilisé dans l’e-mail.This value is used to determine the localized language of the notification email and the date/time and number formatting that should be used in the email message.

Elle doit être définie selon les paramètres utilisateur de l’ordinateur sur lequel est créée la licence de publication, ou selon la culture par défaut du propriétaire de la licence de publication.It should be set based on user settings of the machine that the publish license is created on, or based on the preferred culture of the owner of the publish license.
MS.Notify.TZIDMS.Notify.TZID stringstring « Pacific Standard Time »“Pacific Standard Time” Source : TimeZoneInfo.Local.Id - ID de fuseau horaire Windows.Source: TimeZoneInfo.Local.Id - Windows time zone ID.

Cette valeur correspond à l’identificateur de fuseau horaire du système d’exploitation Microsoft Windows qui décrit un fuseau horaire particulier et ses caractéristiques.This value is the Microsoft Windows OS time zone identifier describing a particular time zone and its characteristics.
MS.Notify.TZOMS.Notify.TZO stringstring « -480 »“-480” Il s’agit du décalage horaire du propriétaire de la licence de publication, exprimé en minutes, par rapport à l’heure UTC.This is the publish license owner’s time zone offset in terms of minutes from UTC time.

Si une valeur TZID est fournie, le décalage du fuseau horaire spécifié sera utilisé et cette valeur sera ignorée.If a valid TZID value is provided the offset of the time zone specified by it will be used and this value will be ignored.

Cette valeur sera probablement utilisée par les plateformes de publication non Windows qui n’ont pas accès à la liste des valeurs d’ID de fuseau horaire du système d’exploitation Windows.This value will more than likely be used by non-windows based publishing platforms that do not have access to the list of Windows OS time zone ID values.

Si aucune valeur TZID n’est fournie, cette valeur sera utilisée pour calculer le décalage des messages de notification et la valeur TZSN sera utilisée (quelle que soit la valeur de fuseau horaire) pour indiquer le nom du fuseau horaire.If a TZID value is not provided this value will be used to calculate the time offset in notification messages, and the TZSN will be used (regardless of the time zone value) to indicate the name of the time zone. De cette manière, le fuseau horaire reste fixe et n’est pas mis à jour à l’heure d’été.This will result time zone being fixed and not updating for daylight savings when it is applicable.

Exemple :For example:

Si la valeur TXID est vide, et si la valeur TZ0 est définie sur « -420 » et la valeur TZSN définie sur « Pacific Daylight Time », toutes les valeurs indiquées dans l’e-mail de notification seront ajustées à l’heure « Pacific Daylight Time » et le resteront, même si l’heure d’été n’est plus en cours.If TXID is blank and TZ0 is set to “-420” and the TZSN is set to “Pacific Daylight Time” all values shown in the notification email will be adjusted to "Pacific Daylight Time” and displayed as such even if daylight savings is no longer in affect currently.

En revanche, si une valeur TZID est fournie, ainsi qu’une valeur TZSN et une valeur TZDN, les heures spécifiées dans l’e-mail de notification seront ajustées et s’afficheront selon le mode d’affichage de date et d’heure défini (Heure d’été ou Standard).On the other hand if a TZID is supplied along with both TZSN and TZDN, then the times specified in the notification email will be adjusted and displayed based on whether the date and time should be displayed in Daylight mode or Standard mode.
MS.Notify.TZSNMS.Notify.TZSN stringstring « Pacific Standard Time »“Pacific Standard Time” Source : TimeZoneInfo.Local.StandardName - Nom du fuseau horaire.Source: TimeZoneInfo.Local.StandardName - Standard Time Zone name.

Cela doit correspondre au nom localisé du fuseau horaire Standard.This should the localized name of the time zone’s standard time zone name.
MS.Notify.TZDNMS.Notify.TZDN stringstring « Pacific Daylight Time »“Pacific Daylight Time” Source : TimeZoneInfo.Local.DaylightName - Nom du fuseau horaire de l’heure d’été.Source: TimeZoneInfo.Local.DaylightName - Daylight Time Zone name.

Cela doit correspondre au nom localisé du fuseau horaire de l’heure d’été.This should be the localized name of the time zone’s daylight savings name. Il peut être le même que le nom standard si le fuseau horaire ne prend pas en charge l’heure d’été.It can be the same as the standard name if the time zone does not support daylight savings.

Rubriques connexesRelated topics

CommentairesComments

Avant de transmettre vos commentaires, nous vous demandons de consulter notre règlement interne.Before commenting, we ask that you review our House rules.