Hinzufügen eines Gebietsschemas für auf Kernkomponenten basierende adaptive Formulare supporting-new-locales-for-adaptive-forms-localization

URL-Gebietsschema-Auswahl ([locale]):

Das System priorisiert das in der URL angegebene Gebietsschema mithilfe der Auswahlmöglichkeit [locale]. Dieses Format ermöglicht die Zwischenspeicherung für eine bessere Leistung.

Format: Die URL hat folgendes Format: http:/[AEM Forms-Server-URL]/content/forms/af/[afName].[locale].html?wcmmode=disabled.

Beispiel: https://[server]/content/forms/af/contact-us.hi.html rendert das Formular in Hindi.

Anfrageparameter „afAcceptLang“:

Um das Browser-Gebietsschema der Benutzerin bzw. des Benutzers zu überschreiben, können Sie den Parameter afAcceptLang in der URL verwenden.

Beispiel: https://[server]/forms/af/survey.ca-fr.html?afAcceptLang=ca-fr erzwingt die Wiedergabe des Formulars auf kanadischem Französisch.

Gebietsschema des Browsers der Benutzenden (Accept-Language-Header):

Wenn kein anderes Gebietsschema angegeben ist, berücksichtigt AEM Forms das Gebietsschema des Browsers der Benutzenden, das über die Kopfzeile Accept-Language übermittelt wird.

Öffnen Sie die Befehlszeile oder ein Terminal-Fenster.

Navigieren Sie zum gewünschten Speicherort auf Ihrem Computer, auf dem Sie das Repository speichern möchten (z. B. /adaptive-forms-core-components).

Führen Sie den folgenden Befehl aus, um das Repository zu klonen:

git clone https://github.com/adobe/aem-core-forms-components.git

Mit diesem Befehl wird das Repository heruntergeladen und ein Ordner mit dem Namen aem-core-forms-components auf Ihrem Computer erstellt. In diesem Handbuch wird dieser Ordner als [Adaptive Forms Core Components repository] bezeichnet

Öffnen Sie die Befehlszeile und wählen Sie einen Ordner zum Speichern des AEM as a Cloud Service-Repositorys aus, z. B. /cloud-service-repository/.

Führen Sie den folgenden Befehl aus, um das Repository zu klonen:

git clone https://git.cloudmanager.adobe.com/<organization-name>/<program id>/

Zum Klonen Ihres Git-Repositorys benötigen Sie einige Informationen:

• Organisationsname: Identifiziert Ihr Team oder Projekt in Adobe Experience Manager as a Cloud Service (AEM as a Cloud Service).

• Programm-ID: Gibt das mit Ihrem Repository verknüpfte Programm an.

• Anmeldeinformationen: Sie benötigen einen Benutzernamen und ein Kennwort (oder ein persönliches Zugriffstoken), um sicher auf das Repository zugreifen zu können.

Wo finden Sie diese Informationen?

Eine schrittweise Anleitung zum Auffinden dieser Details finden Sie im Adobe Experience League-Artikel Zugriff auf Git.

Ihr Projekt ist bereit.

Wenn der Befehl erfolgreich abgeschlossen wurde, wird in Ihrem lokalen Verzeichnis ein neuer Ordner erstellt. Dieser Ordner wird nach Ihrem Programm benannt (z. B. program-id). Dieser Ordner enthält alle Dateien und den Code, die von Ihrem AEM as a Cloud Service-Git-Repository heruntergeladen wurden.

In diesem Handbuch wird dieser Ordner als [AEMaaCS project directory] bezeichnet.

Öffnen Sie den Repository-Ordner in einem Editor.

Suchen Sie die Datei Guide Localization Service.cfg.json. Diese Datei steuert die von Ihrer AEM Forms-Anwendung unterstützten Gebietsschemata. Sie können diese Datei bearbeiten, um ein neues Gebietsschema hinzuzufügen.

• Vorhandene Datei: Wenn die Datei bereits vorhanden ist, suchen Sie sie in Ihrem AEM Forms-Projektverzeichnis. Der Standardspeicherort lautet:

  code language-shell
  [AEMaaCS project directory]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config`.

  Ersetzen Sie <appid> mit Ihrer projektspezifischen Anwendungs-ID. Sie finden <appid> für Ihr AEM-Projekt in der Datei archetype.properties.

  

• Neue Datei: Wenn die Datei nicht vorhanden ist, müssen Sie sie an dem gleichen oben genannten Speicherort erstellen. Kopieren Sie den Dateinamen nicht aus diesem Dokument, sondern geben Sie ihn manuell ein. Der Dateiname Guide Localization Service.cfg.json enthält Leerzeichen. Dies ist beabsichtigt und kein Tippfehler in der Dokumentation.

  Eine Beispieldatei mit der Liste der vorkonfigurierten unterstützten Gebietsschemata ist:

  code language-none
  { "supportedLocales":[ "en", "fr", "de", "ja", "pt-br", "zh-cn", "zh-tw", "ko-kr", "it", "es" ] }

Fügen Sie der Datei den Gebietsschema-Code für die gewünschte Sprache hinzu.

1. Suchen Sie anhand der Liste der ISO 639-1-Codes den aus zwei Buchstaben bestehenden Code, der die gewünschte Sprache darstellt.

2. Fügen Sie den Gebietsschema-Code zur Datei Guide Localization Service.cfg.json hinzu. Im Folgenden einige Beispiele:

   • Sprachen mit Links-nach-rechts-Schreibrichtung:

     • Englisch (Vereinigte Staaten): en-US
     • Spanisch (Spanien): es-ES
     • Französisch (Frankreich): fr-FR

   • Sprachen mit Rechts-nach-links-Schreibrichtung:

     • Arabisch (Vereinigte Arabische Emirate): ar-ae
     • Hebräisch: he (oder iw als historische Referenz)
     • Farsi: fa

Stellen Sie nach den Änderungen sicher, dass die Datei Guide Localization Service.cfg.json korrekt als gültige JSON-Datei formatiert ist. Fehler in der JSON-Formatierung können das ordnungsgemäße Funktionieren verhindern. Speichern Sie die Datei.

Lokalisieren Sie die Beispiel-Client-Bibliothek:

Navigieren Sie in Ihrer lokalen Kopie des [Repositorys für adaptive Formular-Kernkomponenten] zum folgenden Pfad:

    /aem-core-forms-components/it/apps/src/main/content/jcr_root/apps/forms-core-components-it/clientlibs

Kopieren Sie die Bibliothek und fügen Sie sie ein:

1. Kopieren Sie den Ordner clientlib-it-custom-locale:

   

2. Wechseln Sie in das folgende Verzeichnis in Ihrem [AEMaaCS-Projektverzeichnis]:

   code language-none
   /ui.apps/src/main/content/jcr_root/apps/<app-id>/clientlib

   Wichtig: Ersetzen Sie <app-id> durch die tatsächliche ID Ihrer Anwendung.

3. Fügen Sie den kopierten Ordner clientlib-it-custom-locale in dieses Verzeichnis ein.

   

Navigieren Sie zum Verzeichnis Ihres Gebietsschemas:

Navigieren Sie innerhalb Ihres [AEMaaCS project directory] zu folgendem Pfad:

    /ui.apps/src/main/content/jcr_root/apps/<program-id>/clientlibs/clientlib-it-custom-locale/resources/i18n/

Wichtig: Ersetzen Sie <program-id> durch Ihre tatsächliche Anwendungs-ID.

Suchen Sie die englischsprachige Beispieldatei:

AEM Forms stellt auf GitHub](https://github.com/adobe/aem-core-forms-components/blob/master/ui.af.apps/src/main/content/jcr_root/apps/core/fd/af-clientlibs/core-forms-components-runtime-all/resources/i18n/en.json) eine [beispielhafte englische Gebietsschema-Datei (.json) zur Verfügung.

Die englische Sprachdatei enthält den Standardsatz von Zeichenfolgen als Referenz. Ihre gebietsschemaspezifische Datei sollte die Struktur der englischsprachigen Datei imitieren.

In Sprachen wie Arabisch, Hebräisch und Farsi wird der Text von rechts nach links (RTL) und nicht wie im Englischen von links nach rechts (LTR) geschrieben. Um sicherzustellen, dass Ihre Formulare in diesen Sprachen korrekt angezeigt werden, empfehlen wir die Verwendung unserer Gebietsschema-Beispieldateien als Anleitung. Diese Dateien bieten eine Referenz für die Formatierung von Text, Daten und anderen Elementen für RTL-Sprachen. Sie finden Beispiele für Gebietsschemadateien für:

• Arabisch
• Hebräisch
• Farsi

Mit Hilfe dieser Beispieldateien können Sie sicherstellen, dass Ihre Formulare Benutzenden, die in RTL-Sprachen arbeiten, ein nahtloses Erlebnis bieten.

Erstellen Sie Ihre Gebietsschema-Datei:

1. Erstellen Sie eine neue .json-Datei im Verzeichnis i18n.
2. Benennen Sie die Datei mit dem entsprechenden Gebietsschema-Code für die gewünschte Sprache (z. B. fr-FR.json für Französisch und ar-ae.json für Arabisch). Die Struktur dieser Datei sollte die englische Gebietsschema-Datei widerspiegeln.

Struktur und Übersetzung:

1. Öffnen Sie die neu erstellte Datei in einem Texteditor.

2. Ersetzen Sie die englischen Werte durch die entsprechenden Übersetzungen für Ihre Zielsprache.

3. Nachdem Sie mit der Übersetzung der Strings fertig sind, speichern Sie die Datei.

Lokalisieren Sie den Konfigurationsordner:

Wechseln Sie in das folgende Verzeichnis in Ihrem [AEMaaCS-Projektverzeichnis]:

/ui.content/src/main/content/jcr_root/etc

Erstellen Sie die erforderlichen Ordner (falls noch nicht vorhanden):

Wenn der Ordner etc im Ordner jcr_root nicht vorhanden ist, erstellen Sie ihn. Erstellen Sie innerhalb von etc einen weiteren Ordner mit dem Namen languages, falls dieser noch nicht vorhanden ist.

Erstellen Sie die Konfigurationsdatei des Gebietsschemas:

Erstellen Sie im Ordner languages eine neue Datei namens .content.xml. Kopieren Sie den Dateinamen nicht aus diesem Dokument, sondern geben Sie ihn manuell ein.

Öffnen Sie diese Datei und fügen Sie den folgenden Inhalt ein. Ersetzen Sie dabei [LOCALE_CODE] durch den tatsächlichen Gebietsschema-Code (zum Beispiel ar-ae für Arabisch).

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
      jcr:primaryType="nt:unstructured"
      languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi]"/>

WARNUNG: Ersetzen Sie nicht die vorhandene Liste. Hängen Sie stattdessen Ihren neuen Gebietsschema-Code in eckigen Klammern und durch Kommas getrennt an, wie z. B. (unter Verwendung von ar-ae als Beispiel):

languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi,ar-ae]"

Schließen Sie die neuen Ordner in filter.xml ein:

Navigieren Sie zur Datei /ui.content/src/main/content/meta-inf/vault/filter.xml in Ihrem [AEMaaCS-Projektverzeichnis].

Öffnen Sie die Datei und fügen Sie die folgende Zeile am Ende ein:

<filter root="/etc/languages"/>

hinzu

Speichern Sie die Datei.