Lokalisierung
In diesem Thema
Überblick
Das Geoportal ist vollständig lokalisierbar. Die Lokalisierung besteht aus mehreren Vorgängen, die alle im folgenden Abschnitt beschrieben werden:
- Lokalisieren der Geoportal-Weboberfläche
- Lokalisieren der Geoportal-Webhilfe
- Lokalisieren der Geoportal-E-Mail-Nachrichten
- Lokalisieren der Lucene-Suchmaschine des Geoportals
- Lokalisieren der Geoportal-Clients
Lokalisieren der Geoportal-Weboberfläche
Die Geoportal-Weboberfläche kann in jeder beliebigen Sprache angezeigt werden, auch in Multibyte-Sprachen und Sprachen, die von rechts nach links geschrieben werden. Die Sprache für die Anzeige wird in den Einstellungen im Internetbrowser des jeweiligen Benutzers ausgewählt und hängt nicht von serverseitigen Variablen ab. Das heißt, dass ein- und dieselbe Instanz des Geoportals von verschiedenen Benutzern gleichzeitig in verschiedenen Sprachen angezeigt werden kann. In den folgenden Schritten wird beschrieben, wie die Weboberfläche lokalisiert wird.
- Ermitteln Sie den richtigen Sprachcode für Ihre sprachliche Anpassung. Immer wenn lokalisierte Oberflächen angeboten werden, wird die Lokalisierung über einen bestimmten Sprachcode angegeben. Nachdem Sie festgestellt haben, welche Sprachen von Ihrem Geoportal unterstützt werden, ermitteln Sie den aus zwei Buchstaben bestehenden Internetsprachcode für die gewünschten Sprachen. Dieser lautet für Französisch beispielsweise fr, für Deutsch de und für Spanisch es. Falls Sie eine Lokalisierung in eine bestimmte Sprachvariante vornehmen, beispielsweise in Französisch (Kanada) oder Spanisch (Chile), besteht der Sprachcode aus 4 Buchstaben. Die ersten beiden stehen für die Sprache, die letzten beiden für das Land. Die beiden Codes werden durch einen Bindestrich getrennt. So lautet der Sprachcode für Französisch (Kanada) fr-ca und für Spanisch (Chile) es-cl.
- Richten Sie Ihren Browser für mehrere Sprachen ein. Internetbrowser verfügen über eine Einstellung, mit der die Benutzer die Sprachen (in einer bestimmten Reihenfolge) auswählen können, in denen Sie Webseiteninhalte bevorzugt anzeigen möchten. Das Geoportal versucht grundsätzlich seine Oberfläche in der zu oberst angeführten Sprache anzuzeigen. Falls die zu oberst angeführte Sprache nicht verfügbar ist, da das Geoportal nicht für diese Sprache lokalisiert wurde, wird standardmäßig Englisch ausgewählt. Stellen Sie sicher, dass Sie Ihre ausgewählten Sprachen im Internetbrowser aktivieren, wenn Sie diese sprachliche Anpassung testen.
- Aktivieren Sie zusätzliche Sprachen im Geoportal. Damit eine Sprache vom Geoportal erkannt wird, müssen Sie in der Datei gpt-faces-config.xml einen Verweis auf die hinzugefügte Sprache einfügen. Dazu müssen Sie die folgenden Schritte ausführen:
- Entscheiden Sie, welche Sprachen Sie anbieten möchten, und schlagen Sie die erforderlichen Codes wie oben beschrieben nach.
- Navigieren Sie zum Verzeichnis \\geoportal\WEB-INF.
- Führen Sie einen Bildlauf zum Ende der Datei durch, und suchen Sie die Tags <application>\<locale-config>.
- Für jede Sprache, die von der Geoportal-Oberfläche unterstützt werden soll, muss ein zusätzliches <supported-locale>-Tag hinzugefügt werden. Der Wert für das Tag ist dann der Internetcode für die hinzugefügte Sprache. Beispiel: <supported-locale>es</supported-locale>, wenn Spanisch unterstützt werden soll.
- Speichern Sie die Datei.
- Lokalisieren Sie den Text der Benutzeroberfläche. Standardmäßig verweist die Datei gpt.properties unter\\geoportal\WEB-INF\classes\gpt\resources auf die Zeichenfolgen, die auf der Benutzeroberfläche angezeigt werden. Wenn Sie die Datei dauerhaft in eine andere Sprache lokalisieren möchten, übersetzen Sie die Zeichenfolgen in der Datei gpt.properties direkt, und speichern Sie die Datei, wobei Sie die Originaldatei überschreiben. Die Standarddatei wird die Benutzeroberfläche jetzt in der neuen Sprache wiedergeben. Wenn Sie die Geoportal-Oberfläche in mehreren Sprachen anbieten möchten, gehen Sie wie folgt vor:
- Entscheiden Sie, welche Sprachen Sie anbieten möchten, und schlagen Sie die erforderlichen Codes wie oben beschrieben nach.
- Kopieren Sie die Datei gpt.properties in eine neue Datei, die Sie unter einem Dateinamen speichern, der einen Unterstrich und den Sprachcode nach gpt enthält. Bei einer französischen Datei würde der Dateiname zum Beispiel gpt_fr.properties lauten. Bei einer Datei in Spanisch (Chile) würde der Dateiname folglich gpt_es-cl.properties lauten.
- Öffnen Sie die neu erstellte Eigenschaftendatei in einem Texteditor, und übersetzen Sie sie in die betreffende Sprache.
- Speichern und schließen Sie die übersetzte Datei.
- Falls die Sprache, in die Sie übersetzen, Zeichen enthält, die nicht zum lateinischen Alphabet (Latin1) gehören, können Sie die neu erstellte Datei mithilfe des Dienstprogramms native2ascii ordnungsgemäß codieren.
- Starten Sie die Geoportal-Webanwendung neu, damit die Änderungen wirksam werden.
Sobald die übersetzten Dateien verfügbar sind, werden, wenn ein Benutzer als Hauptsprache in seinem Browser eine Sprache eingestellt hat, die einer der verfügbaren Dateien in Ihrer Geoportal-Bereitstellung entspricht, im Geoportal die Ressourcenzeichenfolgen aus der passenden Datei angezeigt, sodass eine lokalisierte Benutzeroberfläche erscheint.
Lokalisieren der Geoportal-Webhilfe
Das Geoportal bietet ein kontextsensitives Hilfesystem an, das mit der vom Geoportal bereitgestellten Webhilfe verknüpft ist. Wenn ein Benutzer bei der Verwendung des Geoportals Hilfe benötigt, kann er auf den Hilfe-Link ganz oben auf einer beliebigen Seite klicken und gelangt so direkt zu den Hilfeinformationen in der Webhilfe. Schritte für das Lokalisieren der Webhilfe:
- Konfigurieren Sie das Geoportal so, dass es auf die von Ihnen angepasste Hilfe und nicht auf die von Esri gehostete Webhilfe verweist. Anweisungen hierzu erhalten Sie in Artikel 37450 der Knowledge Base.
- Navigieren Sie zum Verzeichnis für die Geoportal-Webhilfe unter \\geoportal\webhelp.
- In ähnlicher Weise, wie Sie die Dateigpt.properties umbenannt haben, um auf einen Sprachcode zu verweisen, müssen Sie hierbei ein Verzeichnis im Ordner\\geoportal\webhelp erstellen, das den gewünschten aus zwei oder vier Buchstaben bestehenden Sprachcode aufweist. Kopieren Sie hierfür den en-Ordner aus \\geoportal\webhelp, und kopieren Sie ihn in dasselbe Verzeichnis \\geoportal\webhelp. Benennen Sie den kopierten Ordner dann entsprechend Ihrem aus zwei oder vier Buchstaben bestehenden Sprachcode um.
- Navigieren Sie in dem von Ihnen umbenannten Ordner zum Verzeichnis geoportal_10\00t0.
- Im Verzeichnis 00t0 befinden sich viele .htm-Dateien sowie Grafikdateien. Übersetzen Sie diese Dateien entsprechend Ihrem Gebietsschema.
- Navigieren Sie einen Ordner nach oben zum Ordner \\geoportal_10, und öffnen Sie die Datei index.html in einem Texteditor. Übersetzen Sie den Text im Parameter <title>.
- Nachdem die Dateien übersetzt wurden, müssen alle Dateien gespeichert werden, und die Geoportal-Webanwendung muss neu gestartet werden. Sobald die nun übersetzten Dateien verfügbar sind, zeigt das Geoportal, wenn ein Benutzer als Hauptsprache in seinem Browser eine Sprache eingestellt hat, die Sie durch diese Lokalisierungsschritte aktiviert haben, das lokalisierte Hilfesystem an.
Lokalisieren von E-Mail-Nachrichten
Benutzer, die Herausgeber sind, können anfordern, dass Sie benachrichtigt werden, wenn die von ihnen registrierte Netzwerkressource synchronisiert wird. Die Benachrichtigungsmeldungen werden von der Datei notifMessage.xslt im Ordner \\geoportal\WEB-INF\classes\gpt\harvest gesteuert. Da diese E-Mails gesendet werden, sobald die Synchronisierung einsetzt, und nicht auf Anforderung des Endnutzers hin, kann das Geoportal nicht feststellen, in welcher Sprache der Endbenutzer die E-Mail erhalten möchte. Daher ist es, falls Ihre Organisation Herausgeber benachrichtigt, die jeweils unterschiedliche Sprachen sprechen, wichtig, die Meldung in der Datei notfiMessage.xslt zu bearbeiten, damit sie in mehreren Sprachen angezeigt wird. In den folgenden Schritten wird beschrieben, wie Sie die Datei notifMessage.xslt lokalisieren:
- Navigieren Sie zum Ordner \\geoportal\WEB-INF\classes\gpt\harvest, und öffnen Sie die Datei notifMessage.xslt in einem Texteditor.
- Bearbeiten Sie den Text zwischen den <body>-Tags, sodass er in einer oder mehreren Sprachen Ihrer Wahl ausgegeben wird. Achten Sie darauf, folgende Platzhalter nicht zu ändern:
- <xsl:value-of select="repositoryName"/> Name der registrierten Netzwerkressource
- <xsl:value-of select="eventData"/> Datum der Synchronisierung
- <a href="{reportLink}"><xsl:value-of select="reportLink"/> Link zum Synchronisierungsbericht
- Speichern Sie die Datei notifMessage.xslt.
Lokalisieren der Lucene-Suchmaschine des Geoportals
Das Geoportal wird mit der Suchmaschine Apache Lucene bereitgestellt, die standardmäßig für Englisch konfiguriert ist. Um die Performance des Lucene-Index zu verbessern, falls Ihr Geoportal eine andere Sprache verwendet, können Sie einen für Ihre Sprache erstellten Analyzer verwenden. Unter lucene contrib-analyzers API for Javadoc finden Sie mögliche Analyzer. Gehen Sie wie folgt vor, um die Standardsprache für die Lucene-Engine in Ihrer Geoportal-Bereitstellung zu ändern:
- Laden Sie die Datei lucene-3.0.1.zip herunter, die Sie im Apache Lucene-Archivierungsverzeichnis (http://archive.apache.org/dist/lucene/java) finden. Es handelt sich hierbei um das Lucene-Archiv, das der von Geoportal Version 10 implementierten Lucene-Version entspricht.
- Entpacken Sie die Datei lucene-3.0.1.zip, und navigieren Sie zum Verzeichnis \\lucene-3.0.1\contrib\analyzers\common.
- Kopieren Sie hier die Datei lucene-3.0.1.zip, und kopieren Sie sie in das Verzeichnis \\geoportal\WEB-INF\lib.
- Navigieren Sie zum Verzeichnis \\geoportal\WEB-INF\classes\gpt\config, und öffnen Sie die Datei gpt.xml in einem Texteditor.
- Suchen Sie das Element "<lucene>".
- Ändern Sie das Attribut für analyzerClassName, sodass es auf die Analyzer-Klasse für den Analyzer verweist, den Sie verwenden möchten. Javadoc-Informationen für vorkonfigurierte Analyzer-Klassen erhalten Sie unter http://lucene.apache.org/java/3_0_1/api/contrib-analyzers/index.html. Im folgenden Beispiel wird auf einen Analyzer für Französisch verwiesen:
analyzerClassName="org.apache.lucene.analysis.fr.FrenchAnalyzer
- Speichern Sie die Datei gpt.xml, und starten Sie die Geoportal-Webanwendung neu, damit die Änderungen wirksam werden.
Tipp:
Sie können auch Ihre eigene Analyzer-Klasse erstellen, um bestimmte Filter einzuschließen. Nachdem Sie Ihren eigenen Analyzer erstellt und kompiliert haben, können Sie ihn in das Verzeichnis \\geoportal\WEB-INF\lib einfügen. Aktualisieren Sie dann das <lucene>-Element der Datei gpt.xml, sodass es auf die von Ihnen kompilierte Analyzer-Klasse verweist.
Lokalisieren der Geoportal-Clients
In diesem Abschnitt wird die Lokalisierung der Geoportal-Clients behandelt. Im Allgemeinen werden bei diesen Schritten die Richtlinien befolgt, die in der ArcGIS Desktop Developer-Hilfe unter Lokalisieren von Add-Ins zu finden sind.
Vorsicht:
Die hier beschriebenen Anweisungen werden anhand einer Anpassung für Spanisch dargestellt. Wenn Sie die Anweisungen in diesem Abschnitt befolgen, aktualisieren Sie die Dateinamen entsprechend der tatsächlichen Lokalisierungssprache. In diesem Beispiel für Spanisch, haben die Dateinamen den spanischen Sprachcode "es".
Voraussetzung für die Lokalisierung der Geoportal-Clients:
- Für ArcMap- und ArcCatalog-Geoportal-Clients:
- ArcGIS Desktop 10.0 wurde installiert.
- ArcGIS Desktop Developer SDK für .NET-Anwendungen wurde installiert.
- Microsoft Visual Studio 2010 wurde installiert.
- Für ArcGIS Explorer-Geoportal-Clients:
- ArcGIS Explorer 1200 wurde installiert.
- ArcGIS Explorer 1200-Entwicker-SDK wurde installiert.
- Microsoft Visual Studio 2008 wurde installiert.
- Sie verfügen über den Quellcode für die Geoportal-Clients, die Sie lokalisieren möchten.
- Sie können ArcGIS Desktop und ArcGIS Explorer in der Sprache starten, in die Sie lokalisieren möchten.
- Öffnen des Projekts
- Zu lokalisierende Dateien
- Anweisungen für die Lokalisierung
- Kopieren der Eigenschaftendateien
Öffnen des Projekts
Öffnen Sie Microsoft Visual Studio, und rufen Sie das Menü Datei auf. Wählen Sie Öffnen und dann Projekt/Projektmappe. Navigieren Sie dann gemäß der folgenden Darstellung zu der Projektmappendatei für den Client, den Sie lokalisieren möchten.
| Clientname | Solution-Dateiname |
|---|---|
Publish Client | PublishClient.sln |
CSW-Clients für ArcGIS Desktop | CSWSearch.sln |
CSW-Clients für ArcGIS Explorer | CSWSearchDockWindow.sln |
WMC-Client | WMCOpener.sln |
Zu lokalisierende Dateien
In den folgenden Diagrammen werden die für das jeweilige Tool zu lokalisierenden Dateien und eine kurze Beschreibung der lokalisierbaren Schnittstelle der entsprechenden Datei dargestellt. Befolgen Sie die Anweisungen im Abschnitt "Lokalisierung" weiter unten, um die für die einzelnen Tools aufgeführten Dateien zu lokalisieren. Nachdem Sie die Lokalisierung gemäß den Anweisungen durchgeführt haben, kompilieren Sie die gesamte Lösung, und führen Sie das Projekt im Debugmodus aus, um es zu testen.
Publish Client
| Dateiname | Lokalisierbare Benutzeroberfläche |
|---|---|
| Config.esriaddinx | Benutzeroberflächen-Containerdatei |
| FormMessageBox.resx | Benutzeroberflächendatei: Benutzeroberfläche für Pop-up-Meldungen |
| PublishForm.resx | Benutzeroberflächendatei: Benutzeroberfläche für Publish Client-Eingaben |
| StringMessages.resx | Zeichenfolgenmeldungen, auf die in RESX-Dateien verwiesen wird |
CswClient for ArcMap
| Dateiname | Lokalisierbare Benutzeroberfläche |
|---|---|
| Config.esriaddinx | Benutzeroberflächen-Containerdatei |
| CswClientDockableWindow.resx | Benutzeroberflächendatei: Benutzeroberfläche für CSW-Client-Eingaben |
| FormMessageBox.resx | Benutzeroberflächendatei: Benutzeroberfläche für Pop-up-Meldungen |
| FormViewMetadata.resx | Benutzeroberflächendatei: Benutzeroberfläche für Fenster "Metadaten anzeigen" |
| PromptCredentials.resx | Benutzeroberflächendatei: Benutzeroberfläche zur Eingabe von Anmeldeinformationen für die Verbindung mit einem sicheren Service. Hinweis:Diese Datei befindet sich im CSWClient-Projekt und nicht im UI-Ordner in der Datei CSWSearch.sln. |
| StringResources.resx Resources.resx | Zeichenfolgenmeldungen, auf die in RESX-Dateien verwiesen wird |
CswClient for ArcGIS Explorer
| Dateiname | Lokalisierbare Benutzeroberfläche |
|---|---|
| AddIns.xml Resources.resx-Zeichenfolgenmeldungen, auf die in RESX-Dateien verwiesen wird | Benutzeroberflächen-Containerdatei |
| CswSearchDockableWindow.resx | Benutzeroberflächendatei: Benutzeroberfläche für CSW-Client-Eingaben |
| FormMessageBox.resx | Benutzeroberflächendatei: Benutzeroberfläche für Pop-up-Meldungen |
| FormViewMetadata.resx | Benutzeroberflächendatei: Benutzeroberfläche für Fenster "Metadaten anzeigen" |
| PromptCredentials.resx | Benutzeroberflächendatei: Benutzeroberfläche zur Eingabe von Anmeldeinformationen für die Verbindung mit einem sicheren Service. Hinweis:Diese Datei befindet sich im CSWClient-Projekt und nicht im UI-Ordner in der Datei CswSearchDockWindow.sln. |
| CSWResources.resx Resources.resx | Zeichenfolgenmeldungen, auf die in RESX-Dateien verwiesen wird |
WMC-Client
| Dateiname | Lokalisierbare Benutzeroberfläche |
|---|---|
| Config.esriaddinx | Benutzeroberflächen-Containerdatei |
| OpenWMC.resx | Benutzeroberflächendatei: Benutzeroberfläche zum Öffnen von WMC |
| StringResources.resx | Zeichenfolgenmeldungen, auf die in RESX-Dateien verwiesen wird |
Anweisungen für die Lokalisierung
Es werden drei Dateitypen lokalisiert: Benutzeroberflächen-Containerdateien, Benutzeroberflächendateien und Zeichenfolgendateien. Die einzelnen Dateien und die zugehörigen Lokalisierungsschritte werden im Folgenden beschrieben. Bevor Sie mit der Lokalisierung beginnen, ziehen Sie das Diagramm im Abschnitt Zu lokalisierende Dateien für den Client, den Sie anpassen möchten zurate, um zu ermitteln, welche Dateien lokalisiert werden sollen.
- Lokalisierung von Benutzeroberflächen-Containerdatei:Benutzeroberflächen-Containerdateien befinden sich auf der Stammebene der Projektmappe. Diese Dateien definieren den Container – das Fenster, in dem sich der Client befindet – für die Benutzeroberfläche. Sie heißen entweder Config.esriaddinx für ArcGIS Desktop-Clients oder AddIns.xml für ArcGIS Explorer-Clients. Im Folgenden sehen Sie die Schritte, die zum Lokalisieren der Benutzeroberflächen-Containerdateien erforderlich sind:
- Navigieren Sie über die Projektstruktur in Visual Studio zur Datei "Config.esriaddinx" oder "AddIns.xml".
- Kopieren Sie die Datei "Config.esriaddinx" oder "AddIns.xml", und fügen Sie sie in die Stammebene der Projektmappe.
- Sie müssen den Namen der Datei ändern. Der Name der Datei muss den Sprachcode der Lokalisierungssprache enthalten. Der Name muss das Format Config.xx.xml aufweisen, wobei "xx" für Ihren Sprachcode steht. In unserem Beispiel für Spanisch muss "Copy of Config.esriaddinx" in "Config.es.xml" geändert werden.
- Öffnen Sie die frisch umbenannte Datei und stellen Sie sicher, dass die neue Datei "Config.es.xml" dieselben Informationen enthält, wie die alte Datei "Config.esriaddinx". Falls nicht, kopieren Sie den Text aus der alten Datei "Config.esriaddinx" in die neue Datei "Config.es.xml", sodass sie denselben Inhalt haben.
- Lokalisieren Sie die folgenden XML-Attribute in der neuen Datei entsprechend Ihrem Gebietsschema:
- Bei "Config.es.xml" für das PublishClient.sln-Projekt:
- Aktualisieren Sie die Attribute caption und tip im Element Add-In>ArcMap>Commands>Button>.
- Aktualisieren Sie die Attribute caption und tip im Element Add-In>ArcCatalog>Commands>Button>.
- Bei "Config.es.xml" für das CSWSearch.sln-Projekt:
- Aktualisieren Sie die Attribute caption und tip im Element Add-In>ArcMap>Commands>Button>.
- Aktualisieren Sie das Attribut caption im Element Add-In>ArcMap>DockableWindows>DockableWindow>.
- Bei "AddIns.es.xml" für das CSWSearchDockWindow.sln-Projekt:
- Aktualisieren Sie die Attribute description und groupCaption im Element ExplorerAddIns>.
- Aktualisieren Sie die Attribute caption und tooltip im Element ExplorerAddIns>dockWindow>.
Vorsicht:
Nachdem Sei diese Änderungen an der Datei "AddIns.es.xml" vorgenommen haben, kopieren Sie den gesamten Inhalt zurück in die ursprüngliche Datei AddIns.xml, speichern Sie sie, und löschen Sie die Datei AddIns.es.xml.
- Bei "Config.es.xml" für das WMCOpener.sln-Projekt:
- Aktualisieren Sie die Attribute caption und tip im Element Add-In>ArcMap>Commands>Button>.
- Bei "Config.es.xml" für das PublishClient.sln-Projekt:
- Ändern Sie im Fenster Eigenschaften für die Datei die Build Action-Eigenschaft von Embedded Resource in AddInContent.
Hinweis:
Beim CSWSearchDockWindow.sln-Projekt gibt es die Option AddInContent nicht. Lassen Sie die Build Action-Eigenschaft hier auf Embedded Resource eingestellt.
- Speichern Sie die Datei.
- Lokalisierung von Benutzeroberflächendateien: Benutzeroberflächendateien befinden sich normalerweise im Benutzeroberflächenordner in der Projektmappe, und werden angezeigt, wenn Sie das Formular einblenden (Erweiterung ".cs"), in dem sie enthalten sind. Diese Dateien haben die Erweiterung ".resx". Sie definieren die eigentliche Formularoberfläche für die Clients, die der Benutzer sieht, sowie den Text, der in Meldungsfenstern angezeigt wird. Die Benutzerflächendateien arbeiten mit Zeichenfolgendateien und weisen der Benutzeroberfläche den entsprechenden Text zu. Beispielsweise kann eine Benutzeroberflächendatei einen Verweis auf eine in einer Zeichenfolgendatei verwalteten Zeichenfolge enthalten. Die einzelnen Schritte für die Lokalisierung der Benutzeroberflächendateien finden Sie hier:
Vorsicht:
Bei den Benutzeroberflächendateien im CSWSearchDockWindow.sln-Projekt (CSW-Clients für ArcGIS Explorer) müssen Sie keine Kopien der ursprünglichen Dateien erstellen oder die ursprünglichen Dateinamen ändern. Sie lokalisieren die Originaldateien einfach entsprechend Schritt 7–10 (siehe unten).
- Navigieren Sie zum Benutzeroberflächenordner in der Projektmappe.
- Doppelklicken Sie auf den Knoten "parent .cs" für die RESX-Datei, die Sie lokalisieren möchten. Beachten Sie, dass die Eigenschaften des Formulars im Fenster Eigenschaften angezeigt werden.
- Führen Sie im Fenster Eigenschaften einen Bildlauf nach unten bis zum Attribut Language durch. Ändern Sie unter Language die Sprache von Default in das gewünschte Gebietsschema, das Sie auch für Ihre Benutzeroberflächen-Containerdatei in den Schritten zur Lokalisierung der Containerdatei angegeben haben.
- Stellen Sie sicher, dass das Attribut Localisable unterhalb des Attributs Language auf True gesetzt ist.
- Erweitern Sie den Knoten für das CS-Formular im Lösungsbaum. Beachten Sie, dass eine neue Datei erstellt wurde, deren Name automatisch den Sprachcode enthält, der dem Attribut Language aus der Formulardatei entspricht.
- Doppelklicken Sie auf die neue RESX-Datei, um sie zu öffnen. Stellen Sie sicher, dass die neue Datei dieselben Informationen enthält, wie die entsprechende RESX-Datei des Formulars. So sollte beispielsweise eine neu generierte Datei FormMessageBox.es.resx dieselbe Anzahl an Spalten und Zeilen sowie denselben Text in den Zellen enthalten, wie die Datei FormMessageBox.resx. Falls nicht, kopieren Sie den Text aus der alten Datei in die neue Datei, sodass sie denselben Inhalt haben.
- Die RESX-Dateien enthalten mindestens zwei Spalten. Zwei der Spalten tragen die Titel Name und Wert.
- Suchen Sie die Spalten Name und Wert in der neu generierten RESX-Datei. Ändern Sie die Informationen in der Spalte Name nicht. Aktualisieren Sie die Informationen in der Spalte Wert nur, wenn Name mit dem Suffix QuickInfo, QuickInfo-Text oder Text endet. Alle anderen Elemente stehen entweder in Bezug zu nicht lokalisierbaren Werkzeugfunktionen oder werden von Zeichenfolgen in den Zeichenfolgendateien referenziert.
- Aktualisieren Sie Elemente, bei denen es sich um QuickInfo, QuickInfo-Text oder Text handelt, indem Sie sie für Ihr Gebietsschema lokalisieren.
- Speichern Sie die Datei.
- Wiederholen Sie die Schritte 2–12 für alle Benutzeroberflächendateien in der Benutzeroberfläche.
- Lokalisierung von Zeichenfolgenmeldungen: Zeichenfolgendateien befinden sich normalerweise im Stamm der Projektmappe, außer beim Projekt CSWSearchDockWindow.sln, bei dem sie sich im Ordner Ressourcen befinden. Die Zeichenfolgendateien haben wie die Benutzeroberflächendateien ebenfalls die Erweiterung ".resx". Sie definieren Zeichenfolgen, die in den von den Benutzeroberflächendateien definierten Formularen und anderen Teilen des Werkzeugs verwendet werden. Jeder Client verfügt über eine oder zwei Zeichenfolgendateien. Die einzelnen Schritte für die Lokalisierung der Zeichenfolgendateien finden Sie hier:
Vorsicht:
Bei den Zeichenfolgendateien im CSWSearchDockWindow.sln-Projekt (CSW-Clients für ArcGIS Explorer) müssen Sie keine Kopien der ursprünglichen Dateien erstellen oder die ursprünglichen Dateinamen ändern. Sie lokalisieren die Originaldateien einfach entsprechend Schritt 4–5 (siehe unten).
- Führen Sie einen Bildlauf zur ersten Zeichenfolgendatei durch, die in der Tabelle im Abschnitt Zu lokalisierende Dateien für den Client aufgeführt ist, den Sie lokalisieren möchten. Kopieren Sie die Datei.
- Fügen Sie die Kopie in denselben Ordner ein, aus dem Sie die ursprüngliche Zeichenfolgendatei kopiert haben.
- Benennen Sie die Kopie um, sodass der Name das von Ihnen gewählte Gebietsschema enthält. So wird Copy of StringResources.resx beispielsweise in StringResources.es.resx umbenannt.
- Öffnen Sie die Datei, und aktualisieren Sie die Einträge in der Spalte Wert entsprechend Ihrem Gebietsschema. Anders als bei den Benutzeroberflächendateien können Sie hierbei jeden vorhandenen Eintrag aktualisieren. Es ist jedoch, wie auch bei den Benutzeroberflächendateien, wichtig, dass Sie die Informationen in der Spalte Name nicht ändern.
- Speichern Sie die Datei.
- Wiederholen Sie die Schritte 1–5 für jede Zeichenfolgendatei für den Client.
Kopieren der Eigenschaftendateien
Wenn die Geoportal-Clients mithilfe von kompiliertem Code und dem Installationsprogramm installiert wurden, wird für jedes Werkzeug eine Eigenschaftendatei installiert, die zur Laufzeit aufgerufen wird. Da Sie das Installationsprogramm nicht ausgeführt haben, sondern eine Testausführung mit Quellcode vornehmen, müssen Sie die Eigenschaftendatei an den richtigen Speicherort kopieren, bevor Sie die Testausführung im Debugmodus starten können.
Kopieren Sie gemäß der folgenden Tabelle für den jeweils zu lokalisierenden Client die Eigenschaftendatei, die in der Spalte Dateiname aufgeführt ist, vom Speicherort unter Ursprünglicher Speicherort an den Speicherort unter Zielspeicherort.
| Client | Dateiname | Ursprünglicher Speicherort | Zielspeicherort |
|---|---|---|---|
Publish Client | PublishClient.properties | \\PUBLISHCLIENT | \\PUBLISHCLIENT\bin\Debug |
CSW-Clients für ArcGIS Desktop | CswClient.properties | \\CSWCLIENTS\Common\DotNet\Src\CswClient | \\CSWCLIENTS\ArcMap\Src\CswSearch\bin\Debug |
CSW-Clients für ArcGIS Explorer | CswClient.properties | \\CSWCLIENTS\Common\DotNet\Src\CswClient | \\ArcGIS Explorer\Bin |
WMC-Client | WMCOpener.properties | \\WMCOPENER | \\WMCOPENER\bin\Debug |
Hinweis:
Bevor Sie, die Eigenschaftendatei für die Projekte CSWSearch.sln und CSWSearchDockWindow.sln kopieren, müssen Sie deren dataFolder-Parameter bearbeiten. Der Parameter dataFolder ist standardmäßig auf C:\\Programme\\ESRI\\Portal\\CswClients\\Data festgelegt. Dieser standardmäßige Speicherort zeigt den CSW-Clients, wo die CSW-Profile zu finden sind, und wenn der Client über das Windows-Installationsprogramm installiert wird, wird der Ordner Data in einem bestimmten Verzeichnis erstellt (standardmäßig C:\Programme\ESRI\Portal\CSWClients). Da dieser Speicherort für den Datenordner noch nicht vorhanden ist, wenn Sie eine lokalisierte Version erstellen, müssen Sie den Parameter dataFolder in der Eigenschaftendatei auf den Datenordner in Ihrer Buildstruktur verweisen. Mit den folgenden Schritten aktualisieren Sie den dataFolder-Parameter:
- Öffnen Sie die Datei CswClient.properties in einem Texteditor.
- Ändern Sie den dataFolder-Speicherort von C:\\Programme\\ESRI\\Portal\\CswClients\\Data in den Speicherort, der Ihrer Buildstruktur entspricht. Wenn beispielweise der Quellcode für Ihren CSW-Client im Ordner CSWClients auf Ihrem Laufwerk C gespeichert ist, so wird der Dateipfad in C:\\CSWClients\\Common\\Data geändert.
- Speichern Sie die aktualisierte Datei.
- Kopieren Sie sie, und fügen Sie sie unter Zielspeicherort in die oben stehende Tabelle ein.
Nachdem Sie die Benutzeroberflächen-Containerdateien, die Benutzeroberflächendateien und die Zeichenfolgenmeldungen für den zu lokalisierenden Geoportal-Client lokalisiert haben, können Sie die Lösung erstellen. Führen Sie die Lösung anschließend zum Testen im Debugmodus aus.