Lägg till en språkinställning för adaptiv Forms baserat på kärnkomponenter supporting-new-locales-for-adaptive-forms-localization

URL-språkväljare ([locale]):

Systemet prioriterar det språkområde som anges i URL:en med väljaren [locale] . Det här formatet möjliggör cachelagring för bättre prestanda.

Format: URL:en har följande format: http:/[AEM Forms Server URL]/content/forms/af/[afName].[locale].html?wcmmode=disabled.

Exempel: https://[server]/content/forms/af/contact-us.hi.html återger formuläret på hindi.

afAcceptLang-begärandeparameter:

Om du vill åsidosätta användarens språkområde i webbläsaren kan du använda parametern afAcceptLang i URL:en.

Exempel: https://[server]/forms/af/survey.ca-fr.html?afAcceptLang=ca-fr tvingar formuläret att återges på kanadensisk franska.

Användarens språkområde (Accept-Language Header):

Om ingen annan språkinställning har angetts hanterar AEM Forms användarens språkområde i webbläsaren som har skickats med rubriken Accept-Language.

Öppna kommandoraden eller terminalfönstret.

Navigera till önskad plats på datorn där du vill lagra databasen (till exempel /adaptive-forms-core-components).

Kör följande kommando för att klona databasen:

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

Det här kommandot hämtar databasen och skapar en mapp med namnet aem-core-forms-components på datorn. I den här guiden ser vi den här mappen som [Adaptive Forms Core Components repository]

Öppna kommandoraden och välj en katalog där AEM as a Cloud Service-databasen ska lagras, t.ex. /cloud-service-repository/.

Kör följande kommando för att klona databasen:

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

För att klona din Git-databas behöver du viss information:

• Organisationsnamn: Detta identifierar ditt team eller projekt inom Adobe Experience Manager as a Cloud Service (AEM as a Cloud Service).

• Program-ID: Detta anger det program som är associerat med din databas.

• Autentiseringsuppgifter: Du behöver ett användarnamn och ett lösenord (eller en personlig åtkomsttoken) för att komma åt databasen på ett säkert sätt.

Var hittar du den här informationen?

Stegvisa instruktioner om hur du hittar dessa uppgifter finns i Adobe Experience League-artikeln Accessing Git.

Projektet är klart!

När kommandot har slutförts visas en ny mapp som har skapats i din lokala katalog. Den här mappen namnges efter programmet (till exempel program-id). Den här mappen innehåller alla filer och all kod som hämtats från din AEM as a Cloud Service Git-databas.

I hela den här guiden ser vi den här mappen som [AEMaaCS project directory].

Öppna databasmappen i en redigerare.

Leta reda på filen Guide Localization Service.cfg.json. Den här filen kontrollerar de språkområden som stöds av ditt AEM Forms-program. Du kan redigera den här filen om du vill lägga till en ny språkinställning.

• Befintlig fil: Om filen redan finns letar du reda på den i AEM Forms projektkatalog. Den typiska platsen är:

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

  Ersätt <appid> med ditt projektspecifika program-ID. Du kan hitta <appid> för ditt AEM projekt i filen archetype.properties.

  

• Ny fil: Om filen inte finns måste du skapa den på samma plats som anges ovan. Kopiera inte filnamnet från det här dokumentet, utan skriv in namnet manuellt. Filnamnet Guide Localization Service.cfg.json innehåller blanksteg. Detta är avsiktligt och inte ett stavfel i dokumentationen.

  En exempelfil med en lista över språk som stöds av OOTB är:

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

Lägg till språkkoden för det språk du vill använda i filen.

1. Använd List of ISO 639-1 codes för att hitta den tvåbokstavskod som representerar det språk du vill använda.

2. Inkludera språkkoden i filen Guide Localization Service.cfg.json. Här är några exempel:

   • Vänster till höger-språk:

     • Engelska (USA): en-US
     • Spanska (Spanien): es-ES
     • Franska (Frankrike): fr-FR

   • Höger till vänster-språk:

     • Arabiska (Förenade Arabemiraten): ar-ae
     • Hebreiska: han (eller iw for history reference)
     • Persiska: fa

När du har gjort ändringar kontrollerar du att filen Guide Localization Service.cfg.json är korrekt formaterad som en giltig JSON-fil. JSON-formateringsfel kan förhindra att det fungerar som det ska. Spara filen.

Leta reda på exempelklientbiblioteket:

Gå till följande sökväg i den lokala kopian av [adaptiva Forms Core Components-databasen]:

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

Kopiera och klistra in biblioteket:

1. Kopiera mappen clientlib-it-custom-locale.

   

2. Navigera till följande katalog i din [AEMaaCS-projektkatalog]:

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

   Viktigt: Ersätt <app-id> med ditt programs faktiska ID.

3. Klistra in den kopierade mappen clientlib-it-custom-locale i den här katalogen.

   

Navigera till språkkatalogen:

Navigera till följande sökväg i din [AEMaaCS project directory]:

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

Viktigt: Ersätt <program-id> med ditt faktiska program-ID.

Leta reda på exempelfilen för engelska:

AEM Forms tillhandahåller en exempelfil för engelska språk (.json) på GitHub.

Den engelska språkfilen innehåller standarduppsättningen med strängar för referens. Den språkområdesspecifika filen bör härma strukturen i den engelska språkfilen.

För språk som arabiska, hebreiska och farsi läses texten från höger till vänster (RTL) i stället för från vänster till höger (LTR) som engelska. För att formulären ska visas på rätt sätt på dessa språk rekommenderar vi att du använder våra exempelspråkfiler som vägledning. Dessa filer innehåller en referens för hur du formaterar text, datum och andra element för RTL-språk. Du kan hitta exempelfilerna för språkområdet för:

• Arabiska
• Hebreiska
• Persiska

Genom att utnyttja dessa exempelfiler kan du säkerställa att formulären blir en smidig upplevelse för användare som arbetar på RTL-språk.

Skapa din språkfil:

1. Skapa en ny .json-fil i katalogen i18n.
2. Namnge filen med rätt språkkod för det språk du vill arbeta med (t.ex. fr-FR.json för franska och ar-ae.json för arabiska). Strukturen i den här filen ska spegla den engelska språkfilen.

Struktur och översättning:

1. Öppna den nya filen i en textredigerare.

2. Ersätt de engelska värdena med motsvarande översättningar för målspråket.

3. När du är klar med översättningen av strängarna sparar du filen.

Hitta konfigurationsmappen:

Navigera till följande katalog i din [AEMaaCS-projektkatalog]:

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

Skapa nödvändiga mappar (om de saknas):

Om mappen etc inte finns i mappen jcr_root skapar du den. I etc skapar du en annan mapp med namnet languages om den saknas.

Skapa språkkonfigurationsfilen:

Skapa en ny fil med namnet .content.xml i mappen languages. Kopiera inte filnamnet från det här dokumentet, utan skriv in namnet manuellt.

Öppna den här filen och klistra in följande innehåll och ersätt [LOCALE_CODE] med den faktiska språkkoden (t.ex. ar-ae för arabiska).

<?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]"/>

VARNING: Ersätt inte den befintliga listan. Lägg i stället till den nya språkkoden inom hakparenteser, avgränsade med kommatecken, som detta (med ar-ae som exempel):

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

Inkludera de nya mapparna i filter.xml:

Navigera till filen /ui.content/src/main/content/meta-inf/vault/filter.xml i [AEMaaCS-projektkatalogen].

Öppna filen och lägg till följande rad i slutet:

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

Spara filen.