Zum Hauptinhalt springen
Eine lokalisierte Dokumentdefinition ist eine Dokumentdefinition, die in eine andere Sprache als die Sprache übersetzt wurde, in der sie ursprünglich erstellt wurde. Bei der Installation von FC kann eine UI-Sprache ausgewählt werden. Wenn eine Dokumentdefinition in der ausgewählten UI-Sprache verfügbar ist, verwendet das Produkt diese lokalisierte Version. Beim Lokalisieren einer Dokumentdefinition werden die folgenden Elemente übersetzt:
  • Feldbeschriftungen, Schaltflächen und Texte im Datenformular
  • Feldnamen im Dialogfeld zum Hinzufügen und Bearbeiten von Datensätzen
  • Feldnamen im Dialogfeld, in dem der mit einem Trainings-Batch verknüpfte Vendor geändert werden kann
  • Feldbeschriftungen, die dem Benutzer angezeigt werden, wenn Regionen angegeben werden, die nicht automatisch erkannt wurden
  • Feldbeschriftungen im Datenbank-Lookup-Dialogfeld, das aus dem Dokumenteditor aufgerufen wird
  • Spaltennamen in der Dropdown-Liste, die im Datenbank-Lookup-Dialogfeld angezeigt wird
  • Regelnamen, die dem Operator angezeigt werden, wenn Regelfehler auftreten
  • Meldungen aus Benutzerskripten (zum Beispiel Meldungen, die von Skriptregeln, Exporteinstellung und Event-Handlern angezeigt werden)
Ein Benutzer, der eine Dokumentdefinition bearbeitet, arbeitet immer mit den ursprünglichen, nicht lokalisierten Werten. Ein Operator, der im Dokumenteditor arbeitet, sieht die lokalisierten Werte in seiner UI-Sprache.

​
Der Lokalisierungsprozess

Dokumentdefinitionen werden wie folgt lokalisiert:
  1. Die Bezeichner der zu lokalisierenden Zeichenfolgen werden in eine Textdatei exportiert.
  2. Für jeden Zeichenfolgenbezeichner in der Textdatei wird lokalisierter Text bereitgestellt.
  3. Der lokalisierte Text und die entsprechenden Bezeichner (zusammen als „Lokalisierung“ bezeichnet) werden aus der Textdatei in die Dokumentdefinition exportiert.
Die Lokalisierung wird nur in die Dokumentdefinition exportiert, die Zeichenfolgen mit Bezeichnern enthält, die in der Lokalisierung verwendet werden.

​
Die Lokalisierungsdatei

Die Lokalisierungsdatei ist eine TXT-Datei, die eine Liste lokalisierter Zeichenfolgen enthält. Die Zeichenfolgen in dieser Datei sind nach dem Typ des Oberflächenelements sortiert, in dem sie vorkommen (Feldnamen, Name der Dokumentdefinition, Shell-Meldungen und Skriptmeldungen), und anschließend alphabetisch nach Namen. Das Dialogfeld „Localization Options“ enthält Steuerelemente zum Erstellen und Verwalten von Lokalisierungsdateien. Beispiel für eine Zeichenfolge in einer Lokalisierungsdatei, die noch nicht übersetzt wurde: 
BANK_CODE ,"Код банка"
In diesem Beispiel ist BANK_CODE der Bezeichner des string. Kein anderes Feld in der Dokumentdefinition kann denselben Bezeichner haben. Dieser Bezeichner wird automatisch auf eine von zwei Arten generiert: entweder auf Grundlage des Feldnamens oder mithilfe der Vorlage FC_<Nummer des Felds>. Auf den Bezeichner folgt ein Komma, gefolgt von dem string, der dem Benutzer in Anführungszeichen angezeigt wird (“Bankleitzahl”). Dieser string ist der Teil, der bei der Lokalisierung übersetzt wird. Wenn der string übersetzt und wieder in die Dokumentdefinition importiert wird, wird nach dem lokalisierten string automatisch ein Kommentartrennzeichen (zwei Schrägstriche) gefolgt vom ursprünglichen string (“Bank Code”) hinzugefügt. Der ursprüngliche string ist der Standard-string, der Benutzern angezeigt wird, die die Dokumentdefinition bearbeiten. Der obige string sieht nach der Lokalisierung ins Russische wie folgt aus: 
BANK_CODE ,"Код банка" // "Bank Code"
Syntax der Lokalisierungsdatei:
  • Der Bezeichner einer Zeichenfolge und die Zeichenfolge selbst werden durch ein Komma (,) getrennt.
  • Kommentare werden durch das Kommentartrennzeichen (//) eingeleitet.
  • Zeichenfolgen werden in Anführungszeichen eingeschlossen (“String”).
  • Anführungszeichen innerhalb von Zeichenfolgen müssen mit einem vorangestellten Backslash versehen werden (”).
  • Backslashes in Zeichenfolgen müssen mit einem vorangestellten Backslash versehen werden (****).
  • Zeilenumbrüche werden durch die Zeilenumbruch-Zeichenfolge \n angegeben.

​
Lokalisieren einer Dokumentdefinition mit einer Lokalisierungsdatei

​
Erstellen einer Lokalisierungsdatei

  1. Klicken Sie im Dokumentdefinition Editor auf Dokumentdefinition → Localization → Localization Options…
  2. Wählen Sie eine Sprache aus, für die Sie eine Lokalisierungsdatei erstellen möchten (Sprachen ohne Lokalisierungsdatei haben den Status Nonlocalized), und klicken Sie auf die Schaltfläche Export…
  3. Geben Sie im daraufhin geöffneten Dialogfeld den Ordner an, in dem Sie die Lokalisierungsdatei speichern möchten, sowie den Dateinamen.

​
Eine Lokalisierungsdatei bearbeiten

  1. Öffnen Sie die Lokalisierungsdatei in einem Texteditor und übersetzen Sie die Strings.
  2. Speichern Sie die Datei. Stellen Sie sicher, dass sie in Unicode kodiert ist.

​
Importieren einer Lokalisierungsdatei in eine Dokumentdefinition

  1. Klicken Sie im Dokumentdefinitionseditor auf Dokumentdefinition → Lokalisierung → Localization Options…
  2. Wählen Sie in der Liste die Sprache aus, für die Sie eine Lokalisierungsdatei importieren möchten, und klicken Sie auf die Schaltfläche Importieren…
  3. Geben Sie im Dialogfeld, das daraufhin geöffnet wird, den Pfad zur Lokalisierungsdatei an.
  4. Nachdem die Lokalisierungsdatei importiert wurde, ändert sich der Status der Sprache in Localized.
  5. Speichern Sie die Dokumentdefinition.
Nachdem eine Lokalisierungsdatei importiert wurde, enthält das Datenformular im Dokumentdefinitionseditor weiterhin den Standardtext (nicht lokalisiert). Der lokalisierte Text wird nur im Dokumenteditor angezeigt. Benutzer der Project Setup Station können lokalisierten Text nur beim Testen von Dokumentdefinitionen sehen und nur, wenn die Sprache der Lokalisierung als Sprache der Benutzeroberfläche von FC ausgewählt ist. Wenn eine lokalisierte Zeichenfolge länger ist als die ursprüngliche, werden die Felder im Datenformular entsprechend verschoben, damit die längere Zeichenfolge Platz hat.

​
Löschen einer Lokalisierung

  1. Öffnen Sie im Dokumentdefinition Editor Dokumentdefinition und klicken Sie auf Localization → Localization Options…
  2. Wählen Sie die Sprache der Lokalisierung aus, die Sie löschen möchten (Sprachen, für die eine Lokalisierung verfügbar ist, haben den Status Localized).
  3. Der Status der Sprache ändert sich in Nonlocalized.

​
Lokalisierung von Meldungen aus Benutzerskripten

Um Meldungen aus Benutzerskripten (z. B. Skriptregeln und Ereignishandlern) zu lokalisieren, erstellen Sie für jede Meldung einen Bezeichner, geben Sie für jede Meldung einen lokalisierten Text an und verweisen Sie im Skriptcode auf die Bezeichner der Meldungen. Um Meldungen aus Benutzerskripten in eine Lokalisierungsdatei zu exportieren, klicken Sie auf Dokumentdefinition → Localization → Localization Options… Anschließend können Sie die Meldungen übersetzen und die Lokalisierungsdatei wie im Abschnitt „Importing a localization file to a Dokumentdefinition“ dieses Artikels beschrieben in die Dokumentdefinition importieren. Lokalisierte Meldungen aus Benutzerskripten werden angezeigt, wenn in FC die entsprechende Sprache der Benutzeroberfläche ausgewählt ist. Klicken Sie im Dokumentdefinition Editor auf Dokumentdefinition → Localization → Localizable Script Messages… Ein Dialogfeld mit einer Liste aller möglichen Fehlermeldungen wird geöffnet. Klicken Sie auf die Schaltflächen Add…, Edit… und Delete, um Meldungen zu bearbeiten. In dem Dialogfeld, das sich öffnet, wenn Sie auf Add… oder Edit… klicken, können Sie den Namen der Meldung und ihren Standardtext ändern.

​
Abrufen lokalisierter Meldungen aus Skripten

Verwenden Sie zum Abrufen einer Meldung in einem Benutzerskript das Objekt FCTools.LocalizedStrings. Dieses Objekt verwendet die Methode IProperties. Das folgende Codebeispiel gibt eine lokalisierte Meldung mit dem Bezeichner MY_ MESSAGE_1 zurück: 
FCTools.LocalizedStrings.Get ("MY _MESSAGE_1")