Problem
Jeg vil gerne ændre skabelonerne i min e-mail, men jeg ved ikke, hvordan jeg gør.
Løsning
Denne artikel gælder kun for ESET Endpoint Encryption (EEE) Server 2.5.0 eller nyere
EEE Server indeholder en række skabeloner, som bruges til at generere e-mails, der sendes til brugerne. Disse e-mails kan have forskellige årsager, f.eks. at give brugeren en ny aktiveringskode eller informere dem om ændringer i FDE-status på en arbejdsstation.
Disse skabeloner kan nemt tilpasses, så de passer til din egen virksomhedsidentitet, eller der kan tilføjes nye brugerdefinerede oversættelser.
Skabelonfiler og ressourcer gemmes i undermappen Templates under EEE Server-installationsmappen. Det kan f.eks. være C:\Program Files\EnterpriseConsole\Templates.
Du kan redigere disse direkte, men det anbefales, at du IKKE gør det, da enhver fremtidig EEE Server-installation kan overskrive disse filer, og du vil blive tvunget til at gøre dine ændringer om. En bedre løsning er at tilføje dine egne filer og ændre det brugerdefinerede skabelonreferenceobjekt. Se nedenfor.
Inkludering af billeder
Skabeloner kan både være en tekstkomponent, som er en almindelig tekstfil, og en html-komponent, som kan indeholde grafiske elementer. Assets skal placeres i samme mappe som skabelonen og refereres direkte i skabelonen. Når EEE-serveren indlæser og analyserer skabelonen, vil den forsøge at tilføje de linkede aktiver som vedhæftede filer til meddelelsen. Se venligst de eksisterende skabeloner som reference.
Det er vigtigt, at billedtags skal være komplette over en enkelt linje, f.eks. 
. Selvom det er gyldigt i HTML at opdele tagget, så der kan forekomme et linjeskift mellem "img"- og "src"-delene, vil EEE-serveren ikke analysere tagget, medmindre det er et tag på en enkelt linje.
Tags til e-mail-skabeloner
E-mail-skabeloner kan gøre brug af flere tags. Du kan tilføje disse til EEE-serveren, og de vil blive erstattet med passende tekst, når EEE-serveren genererer meddelelsen. Følgende tags kan bruges:
Generiske tags
| Navn på tag | Beskrivelse |
| $adminNavn | Administratorens navn, som defineret i EEE-serveren |
| $brugernavn | Navnet på brugeren, som defineret i EEE Server |
| $meddelelsesoprettelsesdato | Datoen, hvor meddelelsen blev oprettet |
| $messageCreationTime | Tidspunktet, hvor beskeden blev oprettet |
| $meddelelseURL# | En brugerdefineret URL som defineret af skabelonreferenceobjektet |
Aktiverings-tags
| Tag-navn | Beskrivelse |
| $aktiveringskode | Aktiveringskodeteksten, der skal indtastes på aktiveringsskærmen |
| $aktiveringsURL | URL'en til aktiveringskoden, som du skal klikke på for at aktivere |
| $licensType | Typen af licens |
| $licensDato | Tidspunktet og datoen, hvor aktiveringskoden blev genereret |
FDE-tags
| Navn på tag | Beskrivelse |
| navn på arbejdsstation | Navnet på arbejdsstationen |
| $arbejdsstationID | Arbejdsstationens ID for arbejdsstationen |
| $loginType | Typen af login. Dette kan være Normal eller SSO.*1 |
| $fdeLoginBrugernavn | FDE's login-brugernavn. |
| $fdeLoginPassword | Adgangskoden til FDE-login. |
| $canChangePassword | Den boolske tekst, hvis brugeren kan eller ikke kan ændre adgangskoden.*1 |
| $rebootcount | Antallet af tilladte genstarter*2 |
| $startMode | Den valgte starttilstand (1-4).*1 |
*1 Den faktiske tekst, der tilføjes, er defineret i skabelonens referenceobjekt. Se EmailTemplates.json eller EmailTemplatesCustom.json
*2 Dette tag forekommer som standard i teksten for $startMode. Da denne værdi er et tal, der kan indikere ental eller flertal, kan du for at undgå tvetydighed eller bruge et udtryk som "reboot(s)" bruge et særligt tag, så den korrekte entals- eller flertalsform kan bruges automatisk. Ved at bruge formen {$rebootcount|reboot|reboots} betyder det, at e-mailen korrekt vil indeholde teksten "1 reboot" eller "2 reboots" afhængigt af den faktiske værdi af $rebootCount.
Redigering af det brugerdefinerede skabelonreferenceobjekt
Når du har dine egne skabeloner klar til brug, skal du redigere referenceobjektet, så EEE Server kan indlæse og bruge de nye skabeloner. Denne fil skal placeres i EEE-serverens scripts-mappe. Det kan f.eks. være C:\Program Files\EnterpriseConsole\Scripts. Filnavnet skal være EmailTemplatesCustom.json.
Dette objekt er defineret af JSON-sproget. Det gør det muligt at definere et komplekst objekt i en simpel tekstfil. Den kan nemt redigeres i hånden med en simpel teksteditor.
Hvis du ønsker at redigere objektet eller oprette dit eget brugerdefinerede objekt, skal du kontakte support. Formatet kan være ret komplekst, hvis man ikke er bekendt med JSON-notationen.
Men i store træk beskriver formatet 5 grundlæggende meddelelsestyper:
- testmessage;
- aktivering;
- initiatefde;
- modifyfdelogin; og
- addfdelogin.
Disse relaterer til skabelonerne for:
- Testbeskeder fra EEE Server-kontrolpanelet;
- Meddelelse om aktiveringskode;
- Start af FDE på en arbejdsstation;
- Ændring af en brugers FDE-login; og
- Tilføjelse af et FDE-login til en bruger.
Under hver af disse noder er der undernoder til forskellige sprog. Sproget "en" bruges som en catch-all, der bruges som standard, hvis det valgte sprog f.eks. ikke findes. Derfor SKAL "en"-versionen altid eksistere. Sprog kan specificeres ved hjælp af enten en standard ISO 639-1 2-bogstavskode (med valgfri variantkode), i hvilket tilfælde EEE-serveren omformaterer det relevante sprognavn. For eksempel vil EEE-serveren fortolke koden "en" som "engelsk". Alternativt kan koderne "en-GB" og "en-US" bruges til at give forskellige skabeloner for britisk engelsk og amerikansk engelsk.
De standardoversættelser, der følger med EEE-serveren, er i øjeblikket
- en - engelsk
- de-DE - tysk
- es-ES - spansk
- fr-FR - fransk
- ja-JP - japansk
- nl-NL - hollandsk
- pl-PL - polsk
Derudover kan aktiveringsmeddelelser definere separate skabeloner for forskellige licensgrupper. I øjeblikket vedrører disse 1 - Windows eller 2 - Mobile (iOS) licenser.
Inden for hver sprogknude kan du definere html- og klartekstskabelonernes filnavne, meddelelsens emne og eventuelle nødvendige sætninger.
Tilføjelse af URL'er til beskeder
URL'er kan føjes til beskeden ved hjælp af arrayet messageURL, hvor hvert element i arrayet relaterer til tagsene $messageURL1, $messageURL2 osv. Hvert objekt, der er angivet i messageURL-arrayet, kan specificere linkteksten, den faktiske URL (href), alt-tekst og et mål. Href er obligatorisk, alt andet er valgfrit.
For beskeder i klartekst bruges kun attributterne href og text. Hvis der angives tekst, sættes den foran href, og href omsluttes af parenteser.
Overvej for eksempel JSON-fragmentet
"messageURL": [
{
"href": "http://www.eset.com/",
"text": "EEE's hjemmeside"
},
{
"href": "https://support.eset.com/"
}
]
Så vil tagget $messageURL1 blive udvidet til "EEE Website (http://www.eset.com/)", mens $messageURL2 blot vil være "https://support.eset.com".
Hvis du vil angive en tekst, der kun gælder for HTML-skabelonen, skal du bruge elementet texthtml. Det kan være nyttigt, hvis du ønsker, at teksttagget skal indeholde html eller et billede, som ikke ville være passende for den almindelige tekstskabelon.
Tilføjelse af brugerdefinerede skabeloner
Hvis du vælger at implementere dine egne brugerdefinerede skabeloner, skal du kun gøre det i EmailTemplatesCustom.json. Hvis du redigerer EmailTemplates.json, vil denne fil blive overskrevet ved en opgradering af EEE Server. Du bør bruge en lint for at sikre, at din JSON er gyldig. Hvis din fil ikke er gyldig, vil den simpelthen blive ignoreret af EEE Server.
En nyttig JSON-lint-side er: https: //jsonlint.com/
Understøttede versioner
Kun EEE Server 2.5.0 eller nyere
