Postupy: Povolení e-mailových oznámeníHow-to: enable email notification

E-mailová oznámení umožňují nastavit upozornění vlastníka chráněného obsahu na přístup k jeho obsahu.Email notification allows for a protected content owner to be notified when his or her content is accessed.

Pokud chcete nastavit e-mailová oznámení pro danou licenci, použijte vlastnost IpcSetLicenseProperty s parametrem typu vlastnosti dwPropID jako IPC_LI_APP_SPECIFIC_DATA a datová pole aplikace naformátovaná jako 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);

Následující tabulka uvádí datová pole aplikace, dvojici názvu vlastnosti a hodnoty pro e-mailová oznámení RMS.The following table contains the application data fields, property name and value pairs, for RMS email notification.

Název vlastnostiProperty Name Datový typData Type Příklad hodnotyExample Value PoznámkyNotes
MS.Content.NameMS.Content.Name řetězecstring FinancialReport.docx“FinancialReport.docx” Toto je identifikátor přidružený k chráněnému obsahu.This is an identifier associated with the protected content.

Pro chráněné soubory by tato hodnota měla být název souboru bez jakýchkoli informací o cestě.For protected files this value should be the name of the file without any path information.

Pro jiné typy obsahu, jako jsou například e-mailové zprávy, to může být předmět e-mailu. Taky může být prázdná.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 řetězecstring true | false“true” | “false” Pokud je tato hodnota nastavená na true, e-mailové oznámení se odešle vlastníkovi licence pro publikování, když se někdo pokusí ji použít k získání licence koncového uživatele.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 řetězecstring cs-CZ“en-US” Zdroj: System.Globalization.CultureInfo.CurrentUICulture.NameSource: System.Globalization.CultureInfo.CurrentUICulture.Name

Tato hodnota se používá k určení lokalizovaného jazyka e-mailových oznámení a formátování data/času a čísla, které by se mělo používat v e-mailové zprávě.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.

Mělo by být nastavené na základě uživatelského nastavení počítače, na kterém je vytvořená publikovaná licence, nebo na základě upřednostňované jazykové verze vlastníka licence pro publikování.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 řetězecstring Tichomoří (běžný čas)“Pacific Standard Time” Zdroj: TimeZoneInfo.Local.Id - Windows time zone ID.Source: TimeZoneInfo.Local.Id - Windows time zone ID.

Tato hodnota označuje identifikátor časového pásma operačního systému Microsoft Windows popisující konkrétní časové pásmo a jeho vlastnosti.This value is the Microsoft Windows OS time zone identifier describing a particular time zone and its characteristics.
MS.Notify.TZOMS.Notify.TZO řetězecstring “-480”“-480” Toto je posunutí oproti časovému pásmu vlastníka licence pro publikování od času UTC v minutách.This is the publish license owner’s time zone offset in terms of minutes from UTC time.

Pokud je zadaná platná hodnota TZID, použije se posunutí oproti časovému pásmu, které specifikuje a hodnota se bude ignorovat.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.

Tuto hodnotu budou s největší pravděpodobností používat šablony pro publikování jiných platforem než Window, které nemají přístup k seznamu hodnot ID časových pásem operačního systému 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.

Pokud hodnota TZID není zadaná, použije se tato hodnota k výpočtu časového posunu v oznamovacích zprávách a TZSN bude sloužit (bez ohledu na hodnotu časového pásma) k označení názvu časového pásma.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. Ve výsledku se časové pásmo opraví a nebude se aktualizovat podle letního času tam, kde se používá.This will result time zone being fixed and not updating for daylight savings when it is applicable.

Příklad:For example:

Pokud je pole TXID prázdné a v poli TZ0 je nastavená hodnota -420 a v poli TZSN Tichomoří (běžný čas), všechny hodnoty v e-mailu s oznámení se upraví na Tichomoří (běžný čas) a budou se tak zobrazovat, i když už není aktuálně ovlivněný letní čas.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.

Pokud je ale naopak TZID zadaný s hodnotou TZSN i TZDN, časy specifikované v e-mailu s oznámením se upraví a budou se zobrazovat bez ohledu na to, jestli se datum a čas budou zobrazovat v režimu letního času nebo standardním režimu.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 řetězecstring Tichomoří (běžný čas)“Pacific Standard Time” Zdroj: TimeZoneInfo.Local.StandardName – název standardního časového pásma.Source: TimeZoneInfo.Local.StandardName - Standard Time Zone name.

To by měl lokalizovaný název názvu standardního časového pásma pro dané časové pásmo.This should the localized name of the time zone’s standard time zone name.
MS.Notify.TZDNMS.Notify.TZDN řetězecstring Tichomoří (letní čas)“Pacific Daylight Time” Zdroj: TimeZoneInfo.Local.DaylightName – Název časového pásma pro letní čas.Source: TimeZoneInfo.Local.DaylightName - Daylight Time Zone name.

To by měl být lokalizovaný název letního času časového pásma.This should be the localized name of the time zone’s daylight savings name. Pokud dané časové pásmo nepodporuje letní čas, může být stejný jako běžný název.It can be the same as the standard name if the time zone does not support daylight savings.

KomentářeComments

Před přidáním komentáře se podívejte na naše pravidla organizace.Before commenting, we ask that you review our House rules.