Een landinstelling toevoegen voor Adaptive Forms op basis van Core Components supporting-new-locales-for-adaptive-forms-localization

URL-kiezer voor landinstelling ([landinstelling]):

Het systeem geeft prioriteit aan de landinstelling die in de URL is opgegeven met behulp van de [landinstelling] kiezer. Met deze indeling kan caching worden gebruikt voor betere prestaties.

Indeling: De URL volgt deze notatie: http:/[URL AEM Forms-server]/content/forms/af/[afName].[landinstelling].html?wcmmode=disabled.

Voorbeeld: https://[server]/content/forms/af/contact-us.hi.html geeft het formulier in het Hindi weer.

afAcceptLang Request-parameter:

Als u de landinstelling van de browser van de gebruiker wilt overschrijven, kunt u de afAcceptLang in de URL.

Voorbeeld: https://[server]/forms/af/survey.ca-fr.html?afAcceptLang=ca-fr dwingt het formulier om het in het Canadese Frans weer te geven.

Landinstelling browser van gebruiker (Koptekst voor geaccepteerde taal):

Als er geen andere landinstelling is opgegeven, neemt AEM Forms de landinstelling van de browser van de gebruiker in overweging die met de Accept-Language header.

Open de opdrachtregel of het terminalvenster.

Navigeer naar de gewenste locatie op uw computer waar u de opslagplaats wilt opslaan (bijvoorbeeld /adaptive-forms-core-components).

Voer de volgende opdracht uit om de gegevensopslagruimte te klonen:

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

Met deze opdracht downloadt u de opslagplaats en maakt u een map met de naam aem-core-forms-components op uw computer. In deze handleiding wordt deze map de [Adaptive Forms Core Components repository]

Open de opdrachtregel en kies een directory waarin de AEM as a Cloud Service opslagplaats moet worden opgeslagen, zoals /cloud-service-repository/.

Voer de onderstaande opdracht uit om de gegevensopslagruimte te klonen:

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

U hebt enkele informatie nodig om uw Git-opslagplaats te klonen:

• Naam organisatie: Dit identificeert uw team of project binnen Adobe Experience Manager as a Cloud Service (AEM as a Cloud Service).

• Programma-id: Dit geeft het programma aan dat is gekoppeld aan uw opslagplaats.

• Credentials: U hebt een gebruikersnaam en wachtwoord (of een persoonlijke toegangstoken) nodig om veilig toegang te krijgen tot de opslagplaats.

Waar vind je deze informatie?

Raadpleeg het Adobe Experience League-artikel "Toegang tot it".

Uw project is klaar!

Wanneer de opdracht met succes is voltooid, ziet u een nieuwe map die in uw lokale map is gemaakt. Deze map krijgt de naam van uw programma (bijvoorbeeld programma-id). Deze map bevat alle bestanden en code die zijn gedownload van de AEM as a Cloud Service Git-opslagplaats.

In deze handleiding wordt deze map de [AEMaaCS project directory].

Open de opslagplaats map in een editor.

Zoek de Guide Localization Service.cfg.json bestand. Dit bestand bepaalt de landinstellingen die worden ondersteund door uw AEM Forms-toepassing. U kunt dit bestand bewerken en een nieuwe landinstelling toevoegen.

• Bestaand bestand: Als het bestand al bestaat, zoekt u het in de AEM Forms-projectmap. De gebruikelijke locatie is:

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

  Vervangen <appid> met uw projectspecifieke toepassings-id. U kunt zoeken <appid> voor uw AEM Project in archetype.properties bestand.

  

• Nieuw bestand: Als het bestand niet bestaat, moet u het op de hierboven vermelde locatie maken. Kopieer niet de naam van het bestand uit dit document, maar typ de naam handmatig. De bestandsnaam Guide Localization Service.cfg.json bevat spaties. Dit is opzettelijk en geen typefout in de documentatie.

  Een voorbeeldbestand met de lijst met door OOTB ondersteunde landinstellingen is:

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

Voeg de landinstellingscode voor de gewenste taal toe aan het bestand.

1. Gebruik de Lijst van ISO 639-1-codes om de code van twee letters te vinden die uw gewenste taal vertegenwoordigt.

2. De landinstellingscode opnemen in het dialoogvenster Guide Localization Service.cfg.json bestand. Hier volgen enkele voorbeelden:

   • Talen van links naar rechts:

     • Engels (Verenigde Staten): en-US
     • Spaans (Spanje): es-ES
     • Frans (Frankrijk): fr-FR

   • Talen van rechts naar links:

     • Arabische Emiraten: ar-ae
     • Hebreeuws: he (of iw voor historische referentie)
     • Farsi: fa

Nadat u wijzigingen hebt aangebracht, controleert u de Guide Localization Service.cfg.json bestand correct is opgemaakt als een geldig JSON-bestand. Fouten in JSON-opmaak kunnen ervoor zorgen dat deze niet goed werkt. Sla het bestand op.

Zoek de voorbeeldclientbibliotheek:

Binnen uw lokale exemplaar van [Adaptive Forms Core Components-opslagplaats]navigeer naar het volgende pad:

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

Kopieer en plak de bibliotheek:

1. De clientlib-it-custom-locale map.

   

2. Navigeer naar de volgende map in de map [AEMaaCS-projectmap]:

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

   Belangrijk: Vervangen <app-id> met de werkelijke id van uw toepassing.

3. De gekopieerde bestanden plakken clientlib-it-custom-locale in deze map.

   

Navigeer naar de map Locale:

Binnen uw [AEMaaCS project directory]navigeer naar het volgende pad:

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

Belangrijk: Vervangen <program-id> met uw werkelijke toepassings-id.

Zoek het voorbeeld Engels:

AEM Forms biedt een voorbeeld Engelstalig bestand (.json) op GitHub.

Het Engelstalige bestand bevat de standaardset tekenreeksen ter referentie. In het bestand dat specifiek is voor de landinstelling, moet de structuur van het taalbestand worden nagebootst.

Voor talen zoals Arabisch, Hebreeuws en Farsi wordt tekst van rechts naar links (RTL) gelezen in plaats van van van links naar rechts (LTR) zoals Engels. Om ervoor te zorgen dat uw formulieren correct in deze talen worden weergegeven, raden we u aan onze voorbeeldbestanden als richtlijn te gebruiken. Deze bestanden bevatten een referentie voor het opmaken van tekst, datums en andere elementen voor RTL-talen. U kunt de voorbeeldbestanden voor landinstellingen vinden:

• Arabisch
• Hebreeuws
• Farsi

Door deze voorbeeldbestanden te benutten, kunt u ervoor zorgen dat uw formulieren gebruikers die in RTL-talen werken, een naadloze ervaring bieden.

Maak uw lokale bestand:

1. Maak een nieuw .json-bestand in het dialoogvenster i18n directory.
2. Geef het bestand een naam met de juiste landcode voor de gewenste taal (bijvoorbeeld fr-FR.json voor Frans en ar-ae.json voor Arabisch). De structuur van dit bestand moet het Engelse landinstellingsbestand weerspiegelen.

Structuur en omzetting:

1. Open het nieuwe bestand in een teksteditor.

2. Vervang de Engelse waarden door de corresponderende vertalingen voor uw doeltaal.

3. Nadat u de tekenreeksen hebt vertaald, slaat u het bestand op.

Zoek de configuratiemap:

Navigeer naar de volgende map in de [AEMaaCS-projectmap]:

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

Maak de benodigde mappen (indien deze ontbreken):

Als de etc map bestaat niet binnen jcr_root maken. Binnen etc, maakt u een andere map met de naam languages als het ontbreekt.

Maak het configuratiebestand voor de landinstelling:

Binnen de languages een nieuw bestand met de naam .content.xml. Kopieer niet de naam van het bestand uit dit document, maar typ de naam handmatig.

Open dit bestand en plak de volgende inhoud, waarbij u [LOCALE_CODE] met de werkelijke landinstellingscode (bijvoorbeeld ar-ae voor 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]"/>

Waarschuwing: vervang de bestaande lijst niet. Voeg in plaats daarvan de nieuwe landinstellingscode toe binnen vierkante haakjes, gescheiden door komma's, zoals in dit voorbeeld (met ar-ae):

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

Neem de nieuwe mappen op in filter.xml:

Ga naar de /ui.content/src/main/content/meta-inf/vault/filter.xml bestand in uw [AEMaaCS-projectmap].

Open het bestand en voeg de volgende regel aan het einde toe:

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

Sla het bestand op.