CSSCurrent de:Anpassungen der Sprachpakete
Sprachpakete anpassen und modifizieren
Sie haben die Möglichkeit, die Sprachressourcen auf Ihrem Cryptshare Server nach Ihren Wünschen zu modifizieren. Dabei können Sie sowohl die im Lieferumfang enthaltenen Sprachpakete ändern, als auch selbst erstellte Sprachpakete hinzufügen, um die Benutzeroberfläche von Cryptshare in weiteren Sprachen zu präsentieren, die nicht durch den Lieferumfang abgedeckt sind.
Vor jedem Update wird jedoch automatisch ein Backup der bisherigen Version Ihres Cryptshare Servers durchgeführt. Dabei werden auch die Sprachpakete gesichert. Eventuell von Ihnen durchgeführte Änderungen sind also nicht verloren. Sie müssen jedoch manuell aus der gesicherten Version des alten Sprachpaketes entnommen und entsprechend in die neue Version des Sprachpaketes eingepflegt werden.
Sie finden Backups im Unterordner "backup" Ihres Cryptshare Server Programmverzeichnisses. Öffnen Sie das zip-Archiv des Backups, aus dem Sie die Dateien wiederherstellen möchten und navigieren Sie in den Ordner `system\resources\lang`.Voraussetzungen
Grundsätzlich ist es ausreichend, nur die Dateien in das Sprachpaket aufzunehmen, deren Inhalte verändert werden soll (bspw. zum Zweck der Übersetzung). Falls bei der Darstellung ein Element im zugehörigen Sprachpaket nicht gefunden werden kann, wird das entsprechende Element aus dem Fallback-Sprachpaket gezogen.
Ferner müssen die folgenden Voraussetzungen erfüllt werden:
|
Datei)(en) |
Voraussetzung |
|---|---|
| version.xml | Die Codierung der Datei muss UTF-8 ohne BOM sein. |
| Alle Dateien
|
Die Dateinamen dürfen keinen Sprachcode enthalten. |
| <*.properties> | Codierung muss ISO-8859-1 sein. |
| <*.html> | Codierung muss UTF-8 ohne BOM sein. |
Editoren, die die erforderlichen Codierungen anbietenn sind bspw.:
- Notepad++ - http://notepad-plus-plus.org/
- PsPad – http://www.pspad.com/
Paketbeschreibung (version.xml)
Installierte Sprachpakete werden anhand ihrer zugehörigen Paketbeschreibungs-Datei (version.xml) definiert und erkannt. Die Datei beschreibt die folgenden Details des Sprachpaketes:
- Version des Paketes
- Sprache, optional auch die Landeszugehörigkeit (ISO-639-1)
- Produktschlüssel für den das Paket geeignet ist.
Version des Sprachpaketes
Die Versionsnummern des Sprachpaketes bestehen aus einer Hauptversionsnummer und einer Unterversionsnummer: <Haupt>.<Unter> Die Hauptnummer beschreibt die Kompatibilität mit dem Produkt, für welches das Sprachpaket angelegt ist. Die Unternummer ist ein Zähler, der bei jeder Änderung an dem Sprachpaket hochgezählt wird.
Sprachpaket Produkt-Schlüssel
Die Verwaltung der Sprachpakete unterscheidet zwischen Paketen für verschiedene Cryptshare Produkte. Dies ist insbesondere für die Generierung von E-Mail-Benachrichtigungen von Bedeutung, um verschiedene Benachrichtigung aus verschiedenen Produkten heraus erzeugen zu können. Zum Beispiel verwendet Cryptshare for Outlook zwei verschiedene E-Mail Vorlagen für Absender- und Empfängerbenachrichtigung.
| Produktname | Produktschlüssel |
|---|---|
| Cryptshare Server | server |
| Cryptshare for Outlook | client.outlook |
| Cryptshare for Notes | client.notes |
| Cryptshare Robot | client.robot |
| Cryptshare .NET API | api.dotnet |
| Cryptshare Java API | api.java |
<value key="vendor" type="string">[VENDOR]</value> <value key="version" type="string">[LANG_VERSION]</value> <value key="locale" type="string">[LANGUAGE]</value> <value key="product" type="string">[PRODUCT]</value></locale>
<value key="vendor" type="string">Pointsharp GmbH</value> <value key="version" type="string">4.0</value> <value key="locale" type="string">de_DE</value> <value key="product" type="string">client.outlook</value></locale>
Struktur eines Sprachpaketes
Ein Sprachpaket hat folgende Struktur:
| Pfad | Inhalt | Erforderlich |
|---|---|---|
| version.xml | Beinhaltet Meta-Daten über das Sprachpaket:
|
Ja |
| administration.properties | Sprachressourcen für die Administrationsoberfläche. | Nur erforderlich, wenn eine Übersetzung der Administrationsoberfläche gewünscht ist. |
| web-app.properties | Sprachressourcen für die Benutzeroberfläche | Nur erforderlich, wenn eine Übersetzung der Benutzeroberfläche gewünscht ist. |
| web-common.properties | Ressourcen, die von der Benutzeroberfläche und der Administrationsoberfläche gemeinsam verwendet werden. | Bei Anpassung entweder der Administrations- oder Benutzeroberfläche sollten diese Ressourcen ebenfalls angepasst werden. |
| system.properties | Ressourcen, die von Anwendungsprozessen verwendet werden. | Ja |
| mail.properties | Enthält Textbausteine für E-Mail-Benachrichtigungen. | Ja |
| templates | Enthält alle E-Mail Vorlagen, die für den Versand von E-Mail-Benachrichtigungen erforderlich sind. | Ja, andernfalls wird das definierte Fallback Sprachpaket verwendet. |
| Pfad | Inhalt | Erforderlich |
|---|---|---|
| version_<isocode>.xml | Beinhaltet Meta-Daten über das Sprachpaket:
|
Ja |
| lang_<isocode>.xml | Beinhaltet Ressourcen für die Cryptshare for Outlook Benutzeroberfläche. | Ja |
| templates → recipient | Die E-Mail Vorlage für die Empfängerbenachrichtigung, wenn ein Transfer per Cryptshare for Outlook durchgeführt wird. | Ja |
| templates → sent | Die E-Mail Vorlage für die Nachricht, die in Gesendete Elemente gespeichert wird, wenn ein Transfer per Cryptshare for Outlook durchgeführt wird. | Ja |
| templates → sms | Die E-Mail Vorlage für die SMS-Benachrichtigung, die versendet wird, wenn ein Transfer per Cryptshare for Outlook durchgeführt und die Option "Passwort via SMS senden" aktiviert wird. | Ja |
