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

URL de Kiezer van de Plaats ([ scène ]):

Het systeem geeft voorrang aan de scène binnen URL wordt gespecificeerd gebruikend de [ scène ] selecteur die. Met deze indeling kan caching worden gebruikt voor betere prestaties.

Formaat: URL volgt dit formaat: http:/[ de Server URL van AEM Forms ]/content/forms/af/[ afName ].[ scène ].html?wcmmode=disabled.

Voorbeeld: https://[ server ] /content/forms/af/contact-us.hi.html geeft de vorm in Hindi terug.

afAcceptLang de Parameter van het Verzoek:

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

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

Browser van de Gebruiker Scène (Accept-Taal Kopbal):

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

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 map waarin u de AEM as a Cloud Service-opslagplaats wilt opslaan, bijvoorbeeld /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 van de Organisatie: Dit identificeert uw team of project binnen Adobe Experience Manager as a Cloud Service (AEM as a Cloud Service).

• identiteitskaart van het Programma: Dit specificeert het programma verbonden aan uw bewaarplaats.

• Geloofsbrieven: U hebt een gebruikersbenaming en een wachtwoord (of een persoonlijk toegangstoken) nodig om tot de bewaarplaats veilig toegang te hebben.

waar om deze informatie te vinden?

Voor geleidelijke instructies bij het bepalen van de plaats van deze details, verwijs naar het artikel van Adobe Experience League " tot Toegang hebbend Git".

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 u hebt gedownload van uw AEM as a Cloud Service Git-opslagplaats.

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

Open de opslagplaats map in een editor.

Zoek het 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 dossier: Als het dossier reeds bestaat, bepaal de plaats van het binnen uw het projectfolder van AEM Forms. De gebruikelijke locatie is:

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

  Vervang <appid> door uw projectspecifieke toepassings-id. U kunt <appid> voor uw AEM Project in het archetype.properties dossier vinden.

  

• Nieuw dossier: Als het dossier niet bestaat, moet u het in de zelfde hierboven vermelde plaats tot stand brengen. 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 codesom de twee-brief code te vinden die uw gewenste taal vertegenwoordigt.

2. Neem de landinstellingscode op in het 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 of het 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 lokaal exemplaar van de [ Adaptieve plaats van de Componenten van de Kern van Forms ], navigeer aan de volgende weg:

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

Kopieer en plak de bibliotheek:

1. Kopieer de map clientlib-it-custom-locale .

   

2. Navigeer aan de volgende folder binnen uw [ AEMaaCS projectfolder ]:

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

   Belangrijk: Vervang <app-id> met daadwerkelijke identiteitskaart van uw toepassing.

3. Plak de gekopieerde clientlib-it-custom-locale map in deze map.

   

Navigeer naar de map Locale:

Navigeer binnen uw [AEMaaCS project directory] naar het volgende pad:

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

Belangrijk: Vervang <program-id> met uw daadwerkelijke toepassingsidentiteitskaart

Zoek het voorbeeld Engels:

AEM Forms verstrekt het van de a steekproef Engelse scènedossier (.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 de map i18n .
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 aan de volgende folder in uw [ AEMaaCS projectfolder ]:

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

Maak de benodigde mappen (indien deze ontbreken):

Als de map etc niet in de map jcr_root staat, maakt u deze. Maak binnen etc een andere map met de naam languages als deze ontbreekt.

Maak het configuratiebestand voor de landinstelling:

Maak in de map 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 dossier en kleef de volgende inhoud, die [ LOCALE_CODE ] met de daadwerkelijke scènecode (bijvoorbeeld, ar-ae voor Arabisch) vervangt.

<?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:

Navigeer aan het /ui.content/src/main/content/meta-inf/vault/filter.xml dossier in uw [ AEMaaCS projectfolder ].

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

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

Sla het bestand op.