Anvisningar: Aktivera e-postaviseringHow-to: enable email notification

E-postaviseringen gör det möjligt för den som är ägare till skyddat innehåll att få en avisering när någon kommer åt personens innehåll.Email notification allows for a protected content owner to be notified when his or her content is accessed.

Om du vill konfigurera e-postaviseringen för en licens använder du IpcSetLicenseProperty med egenskaps typ parametern DwPropID, som IPC _ Li _ app _ Specific _ data och program data fälten formaterade som en IPC _ Name Value- _ _ lista.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++: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);

Följande tabell innehåller programdatafält, egenskapsnamn och värdepar för e-postaviseringar från RMS.The following table contains the application data fields, property name and value pairs, for RMS email notification.

EgenskapsnamnProperty Name DatatypData Type ExempelvärdeExample Value KommentarerNotes
MS.Content.NameMS.Content.Name strängstring ”FinancialReport.docx”“FinancialReport.docx” Det här är en identifierare som är kopplad till det skyddade innehållet.This is an identifier associated with the protected content.

För skyddade filer bör detta värde vara namnet på filen utan att någon information om sökvägen.For protected files this value should be the name of the file without any path information.

För andra typer av innehåll, till exempel ett e-postmeddelande, kan det vara e-postmeddelandets ämnesrad eller vara tomt.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 strängstring ”true” | ”false”“true” | “false” Om det här värdet är inställt på ”true” skickas en avisering via e-post till ägaren av publiceringslicensen när någon försöker använda den för att skaffa en slutanvändarlicens.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 strängstring ”en-US”“en-US” Källa: System.Globalization.CultureInfo.CurrentUICulture.NameSource: System.Globalization.CultureInfo.CurrentUICulture.Name

Det här värdet används för att fastställa det lokaliserade språket för e-postaviseringen och datum/tid och talformat som ska användas i e-postmeddelandet.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.

Det ska ställas in baserat på användarinställningarna för den dator som publiceringslicensen skapas på, eller baserat på den önskade kulturen för ägaren av publiceringslicensen.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 strängstring ”Pacific Standard Time”“Pacific Standard Time” Källa: TimeZoneInfo.Local.Id – Windows tidszons-ID.Source: TimeZoneInfo.Local.Id - Windows time zone ID.

Det här värdet är den tidszonsidentifierare i Microsoft Windows-operativsystemet som beskriver en viss tidszon och dess egenskaper.This value is the Microsoft Windows OS time zone identifier describing a particular time zone and its characteristics.
MS.Notify.TZOMS.Notify.TZO strängstring ”-480”“-480” Den här är den publicerade licensägarens tidszonsförskjutning räknat i minuter från UTC-tid.This is the publish license owner’s time zone offset in terms of minutes from UTC time.

Om det finns ett giltigt värde för TZID används den förskjutning av tidszonen som anges av den och det här värdet ignoreras.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.

Det är mycket sannolikt att det här värdet kommer att användas av icke-Windows-baserade publiceringsplattformar som inte har tillgång till listan över ID-värden för Windows-operativsystemets tidszoner.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.

Om ett TZID-värde inte tillhandahålls används detta värde för att beräkna tidsförskjutningen i aviseringsmeddelanden och TZSN används (oavsett tidszonsvärdet) för att ange namnet på tidszonen.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. Detta leder till att tidszonen blir fast och inte uppdateras för sommartid när det är aktuellt.This will result time zone being fixed and not updating for daylight savings when it is applicable.

Exempel:For example:

Om TXID är tomt och TZ0 är inställd på ”-420” och TZSN anges till ”Pacific Daylight Time” kommer alla värden som visas i e-postmeddelandet med aviseringen att justeras till ”Pacific Daylight Time” och visas så även om sommartid inte råder för närvarande.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.

Å andra sidan, om ett TZID har angetts tillsammans med både TZSN och TZDN, och justeras de tider som anges i e-postmeddelandet med aviseringen och visas baserat på om datum och klockslag ska visas i sommartidsläge eller normaltidsläge.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 strängstring ”Pacific Standard Time”“Pacific Standard Time” Källa: TimeZoneInfo.Local.StandardName – namn på standardtidszon.Source: TimeZoneInfo.Local.StandardName - Standard Time Zone name.

Det här bör vara det lokaliserade namnet på tidszonens normaltidszonsnamn.This should the localized name of the time zone’s standard time zone name.
MS.Notify.TZDNMS.Notify.TZDN strängstring ”Pacific Daylight Time”“Pacific Daylight Time” Källa: TimeZoneInfo.Local.DaylightName – namn på sommartidszon.Source: TimeZoneInfo.Local.DaylightName - Daylight Time Zone name.

Detta bör vara det lokaliserade namnet för tidszonens sommartidsnamn.This should be the localized name of the time zone’s daylight savings name. Det kan vara detsamma som standardnamnet om tidszonen inte har stöd för sommartid.It can be the same as the standard name if the time zone does not support daylight savings.