> ## Documentation Index > Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt > Use this file to discover all available pages before exploring further. # Lokalisieren einer Dokumentdefinition > Übersetzen Sie Dokumentdefinitionen mit Lokalisierungsdateien in andere Sprachen: Exportieren Sie string-Bezeichner, übersetzen Sie sie und importieren Sie die lokalisierte TXT-Datei. 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 Strings werden in eine Textdatei exportiert. 2. Für jeden String-Bezeichner 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 Strings mit Bezeichnern enthält, die in der Lokalisierung verwendet werden.
## Die Lokalisierungsdatei
Die Lokalisierungsdatei ist eine TXT-Datei, die eine Liste lokalisierter Strings enthält. Die Strings 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 String 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\_\**. 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 String und die String selbst werden durch ein Komma (**,**) getrennt. * Kommentare werden durch das Kommentartrennzeichen (**//**) eingeleitet. * Strings werden in Anführungszeichen eingeschlossen ("**String**"). * Anführungszeichen innerhalb von Strings müssen mit einem vorangestellten Backslash versehen werden (**"**). * Backslashes in Strings 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](/de/flexi-capture/templates/testing) 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 Event-Handlern) 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](/de/flexi-capture/appendix/scripts/iproperties). Das folgende Codebeispiel gibt eine lokalisierte Meldung mit dem Bezeichner **MY\_ MESSAGE\_1** zurück: ``` FCTools.LocalizedStrings.Get ("MY _MESSAGE_1") ```