Erstellung und Bearbeitung von Sprachpaketen

Über die Bearbeitung und Erstellung von Sprachpaketen

Sie können die Sprachressourcen auf Ihrem Cryptshare-Server nach Ihren Wünschen anpassen. Sie können sowohl die Sprachressourcen ändern, die im Lieferumfang des Cryptshare-Servers enthalten sind, als auch zusätzliche Sprachressourcen selbst erstellen, um Cryptshare in weiteren Sprachen bereitzustellen, die nicht zum Lieferumfang gehören.

Sprachpakete und Server-Updates

Bitte beachten Sie, dass die Update-Routinen für den Cryptshare-Server vorhandene Sprachpakete auf dem Server durch neuere Versionen überschreiben können. Dies ist immer dann der Fall, wenn die Serverversion, auf die Sie aktualisieren möchten, neue Funktionen enthält, für deren Anzeige zusätzliche Sprachressourcen erforderlich sind. Cryptshare führt vor jedem Update eine automatische Sicherung der vorherigen Version des Cryptshare-Servers durch. Diese Sicherung umfasst auch die Sprachpakete, sodass etwaige von Ihnen vorgenommene Änderungen nicht verloren gehen , wenn Sprachpakete während des Updates überschrieben werden. Diese müssen jedoch manuell aus der gesicherten Version des Sprachpakets kopiert und entsprechend in die aktualisierte Version des Sprachpakets übertragen werden. Sie finden die Sicherungen im Unterordner „backup“ Ihres Cryptshare-Server-Programmverzeichnisses. Öffnen Sie das ZIP-Archiv, aus dem Sie die Sprachpakete wiederherstellen möchten, und navigieren Sie in den Ordner system\resources\lang
Sprachpakete und Datumsformate

Bitte beachten Sie, dass die Datumsformate für Java-Dateien („server/texts/administration.properties“, „server/texts/system.properties“ und „server/texts/mail.properties“) mit den jeweiligen Programmiersprachen kompatibel sein müssen. Weitere Details finden Sie hier: Java.

Voraussetzungen

Im Allgemeinen reicht es aus, nur diejenigen Dateien in das Paket aufzunehmen, die geändert (in der Regel übersetzt) werden sollen. Fehlt ein Element innerhalb eines Sprachpakets, wird stattdessen das entsprechende Element aus dem Fallback-Paket verwendet.

Darüber hinaus müssen die folgenden Bedingungen erfüllt sein:

Datei(en) Bedingung

version.xml

Die Kodierung muss UTF-8 ohne BOM

Alle Dateien

Dürfen keinen Sprachcode im Dateinamen enthalten

<\*.properties>

Die Kodierung muss ISO-8859-1 sein.

<\*.html>

Die Kodierung muss UTF-8 ohne BOM sein

Wenn die oben aufgeführten Kodierungen nicht verwendet werden, kann dies zu Fehlern in der Benutzeroberfläche und bei E-Mail-Benachrichtigungen führen. Daher wird empfohlen, zur Bearbeitung der Dateien einen Editor zu verwenden, der verschiedene Kodierungen unterstützt. Der Windows-Editor „Notepad“ unterstützt kein geeignetes Format. Editoren, die zusätzliche Formate unterstützen, sind beispielsweise:

Paketbeschreibung (version.xml)

Sprachpakete werden durch ihre jeweilige Beschreibungsdatei (version.xml) definiert und (nach der Installation) erkannt. Die Datei beschreibt die folgenden Details zum Paket:

  1. Version des Sprachpakets

  2. Sprache und optional das Land des Sprachpakets (ISO-639-1)

  3. Produktschlüssel, für den dieses Sprachpaket bestimmt ist

Version des Sprachpakets

Die Versionsnummer eines Pakets besteht aus einer Hauptversionsnummer und einer Nebenversionsnummer: <Haupt>.<Neben>. Die Hauptnummer beschreibt die Kompatibilität mit dem Produkt, für das das Paket bestimmt ist. Die Nebenversion wird bei jeder Änderung erhöht, die am Paket vorgenommen wurde.

Beispiel

Der Cryptshare Server v3.10 erfordert mindestens ein Sprachpaket der Hauptversion 4. Ein akzeptiertes Paket muss daher mindestens die Version 4.0 aufweisen.

Benutzerdefinierte Versionsnummer

Um zu erfahren, auf welchem Sprachpaket Ihr benutzerdefiniertes Paket basiert, können Sie die ursprüngliche Versionsnummer verwenden und die Hauptversionsnummer mit 10 multiplizieren: v6.1 -→ v60.1

Produkt-Schlüssel für Sprachpakete

Die neue Verwaltung von Sprachpaketen kann zwischen Paketen unterscheiden, die für verschiedene Cryptshare-Produkte erstellt wurden. Dies ist insbesondere interessant für die E-Mail-Vorlagen-Engine , um auf dem Server unterschiedliche Benachrichtigungen für verschiedene Produkte zu installieren. Beispielsweise definiert Cryptshare für Outlook (Classic) zwei verschiedene E-Mail-Vorlagen für die Absender- und Empfängerbenachrichtigung.

Produktname Produktschlüssel

Cryptshare Server

server

Cryptshare for Outlook (Classic)

client.outlook

Cryptshare für Notes

client.notes

Cryptshare Robot

client.robot

Cryptshare .NET-API

api.dotnet

Cryptshare Java-API

api.java

 
<locale>
    <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>
<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 Sprachpakets

Cryptshare-Server

Ein reguläres Cryptshare-Server-Sprachpaket weist folgende Struktur auf:

Pfad Inhalt Erforderlich

version.xml

Enthält Metainformationen zum Sprachpaket:

  • Sprache des Pakets in Form eines ISO-639-1-Codes

  • Paketversion: Nicht unterstützte Versionen werden vom Cryptshare-Server abgelehnt* Produkt: Der Produkttyp des Pakets

Ja

administration.properties

Inhalte für die Administrationsoberfläche

Nur erforderlich, wenn eine Übersetzung der Administrationsoberfläche gewünscht ist.

web-app.properties

Inhalte für die Benutzeroberfläche

Nur erforderlich, wenn eine Übersetzung der Benutzeroberfläche gewünscht ist.

web-common.properties

Inhalte, die sowohl für die Benutzeroberfläche als auch für die Administrationsoberfläche verwendet werden.

Wenn entweder die Administrationsoberfläche oder die Benutzeroberfläche geändert wird, sollten diese Ressourcen ebenfalls angepasst werden.

system.properties

Inhalte, die für Systemprozesse verwendet werden

Ja

mail.properties

Enthält Textausschnitte für E-Mail-Benachrichtigungen

Ja

templates

Enthält alle E-Mail-Vorlagen , die für E-Mail-Benachrichtigungen erforderlich sind

Ja, andernfalls wird das definierte Fallback-Paket verwendet.

Cryptshare for Outlook (Classic)

Pfad Inhalt Obligatorisch

version_<isocode>.xml

Enthält Metainformationen zum Sprachpaket:

  • Sprache des Pakets in Form eines ISO-639-1-Codes

  • Paketversion: Nicht unterstützte Versionen werden vom Cryptshare-Server abgelehnt * Produkt: Der Produkttyp des Pakets

Ja

lang_<isocode>.xml

Enthält Ressourcen für die Benutzeroberfläche von Cryptshare für Outlook (Classic)

Ja

templates → recipient

Die E-Mail-Vorlage für die Benachrichtigung des Empfängers bei einem Transfer über Cryptshare for Outlook (Classic)

Ja

templates → sent

Die E-Mail-Vorlage für die E-Mail, die im Ordner „Gesendete Objekte“ von Outlook gespeichert wird, wenn ein Transfer über Cryptshare für Outlook (Classic) durchgeführt wird

Ja

Vorlagen → SMS

Die E-Mail-Vorlage für die SMS-Benachrichtigung bei einem Transfer über Cryptshare for Outlook (Classic), wenn gewählt wird, das Passwort per SMS zu versenden

Ja

Verzeichnisstruktur für ein Cryptshare for Outlook-Sprachpaket

directory structure language package