Adicione uma localidade para o Forms adaptável com base nos Componentes principais supporting-new-locales-for-adaptive-forms-localization

Seletor de Localidade da URL ([localidade]):

O sistema prioriza a localidade especificada na URL usando o seletor de [localidade]. Esse formato permite o armazenamento em cache para melhorar o desempenho.

Formato: A URL segue este formato: http:/[URL do AEM Forms Server]/content/forms/af/[afName].[locale].html?wcmmode=disabled.

Exemplo: https://[server]/content/forms/af/contact-us.hi.html renderiza o formulário em híndi.

Parâmetro de Solicitação afAcceptLang:

Para substituir a localidade do navegador do usuário, você pode usar o parâmetro afAcceptLang na URL.

Exemplo: https://[server]/forms/af/survey.ca-fr.html?afAcceptLang=ca-fr força o formulário a ser renderizado em francês canadense.

Localidade do Navegador do Usuário (Cabeçalho Accept-Language):

Se nenhuma outra localidade for especificada, a AEM Forms considerará a localidade do navegador do usuário enviada usando o cabeçalho Accept-Language.

Abra a linha de comando ou a janela do terminal.

Navegue até o local desejado no computador onde deseja armazenar o repositório (por exemplo, /adaptive-forms-core-components).

Execute o seguinte comando para clonar o repositório:

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

Este comando baixa o repositório e cria uma pasta chamada aem-core-forms-components no computador. Neste guia, nos referimos a esta pasta como [Adaptive Forms Core Components repository]

Abra a linha de comando e escolha um diretório para armazenar seu repositório do AEM as a Cloud Service, como /cloud-service-repository/.

Execute o comando abaixo para clonar o repositório:

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

Para clonar o repositório Git, você precisa de algumas informações:

• Nome da organização: isso identifica sua equipe ou projeto na Adobe Experience Manager as a Cloud Service (AEM as a Cloud Service).

• ID do programa: especifica o programa associado ao seu repositório.

• Credenciais: você precisa de um nome de usuário e senha (ou um token de acesso pessoal) para acessar o repositório com segurança.

Onde encontrar essas informações?

Para obter instruções passo a passo sobre como localizar esses detalhes, consulte o artigo da Adobe Experience League "Acessando o Git".

Seu projeto está pronto!

Quando o comando for concluído com sucesso, você verá uma nova pasta criada no diretório local. Essa pasta é nomeada com base no seu programa (por exemplo, id-do-programa). Esta pasta contém todos os arquivos e códigos baixados do repositório Git da AEM as a Cloud Service.

Neste guia, nos referimos a essa pasta como [AEMaaCS project directory].

Abra a pasta do repositório em um editor.

Localize o arquivo Guide Localization Service.cfg.json. Esse arquivo controla as localidades compatíveis com seu aplicativo AEM Forms. Você pode editar esse arquivo para adicionar um novo local.

• Arquivo existente: se o arquivo já existir, localize-o no diretório do projeto do AEM Forms. A localização típica é:

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

  Substitua <appid> pela ID do aplicativo específica do seu projeto. Você pode encontrar <appid> para seu projeto AEM no arquivo archetype.properties.

  

• Novo arquivo: se o arquivo não existir, você precisará criá-lo no mesmo local mencionado acima. Não copie e cole o nome do arquivo deste documento. Em vez disso, digite manualmente o nome. O nome de arquivo Guide Localization Service.cfg.json inclui espaços. Isso é intencional e não um erro de digitação na documentação.

  Um arquivo de amostra com a lista de localidades com suporte para OOTB é:

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

Adicione o código de localidade do idioma desejado ao arquivo.

1. Use a Lista de códigos ISO 639-1 para localizar o código de duas letras que representa o idioma desejado.

2. Inclua o código de localidade no arquivo Guide Localization Service.cfg.json. Veja alguns exemplos:

   • Idiomas da esquerda para a direita:

     • Inglês (Estados Unidos): en-US
     • Espanhol (Espanha): es-ES
     • Francês (França): fr-FR

   • Idiomas da direita para a esquerda:

     • Árabe (Emirados Árabes Unidos): ar-ae
     • Hebraico: ele (ou iw para referência histórica)
     • Farsi: fa

Depois de fazer as alterações, verifique se o arquivo Guide Localization Service.cfg.json está formatado corretamente como um arquivo JSON válido. Erros na formatação JSON podem impedir que ela funcione corretamente. Salve o arquivo.

Localize a biblioteca de exemplo de cliente:

Em sua cópia local do [repositório dos Componentes principais do Forms adaptável], navegue até o seguinte caminho:

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

Copie e cole a biblioteca:

1. Copie a pasta clientlib-it-custom-locale.

   

2. Navegue até o seguinte diretório no [diretório do projeto AEMaaCS]:

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

   Importante: substitua <app-id> pela ID real do seu aplicativo.

3. Cole a pasta clientlib-it-custom-locale copiada neste diretório.

   

Navegue até o Diretório de Localidade:

Em seu [AEMaaCS project directory], navegue até o seguinte caminho:

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

Importante: substitua <program-id> pela ID do aplicativo real.

Localize o arquivo de amostra no idioma inglês:

O AEM Forms fornece um arquivo de local em inglês de exemplo (.json) no GitHub.

O arquivo de idioma inglês inclui o conjunto padrão de cadeias de caracteres para referência. O arquivo específico de local deve imitar a estrutura do arquivo de idioma inglês.

Para idiomas como árabe, hebraico e farsi, o texto é lido da direita para a esquerda (RTL) em vez da esquerda para a direita (LTR) como inglês. Para garantir que seus formulários sejam exibidos corretamente nesses idiomas, recomendamos usar nossos arquivos de localidade de amostra como guia. Esses arquivos fornecem uma referência sobre como formatar texto, datas e outros elementos para idiomas RTL. Você pode encontrar os arquivos de código do idioma de exemplo para:

• Árabe
• Hebraico
• Farsi

Ao aproveitar esses arquivos de amostra, você pode garantir que seus formulários forneçam uma experiência perfeita para usuários que trabalham em idiomas RTL.

Crie seu arquivo de local:

1. Crie um novo arquivo .json no diretório i18n.
2. Nomeie o arquivo usando o código de localidade apropriado para o idioma desejado (por exemplo, fr-FR.json para francês e ar-ae.json para árabe). A estrutura desse arquivo deve refletir o arquivo de localidade em inglês.

Estrutura e tradução:

1. Abra o arquivo recém-criado em um editor de texto.

2. Substitua os valores em inglês pelas traduções correspondentes para o seu idioma de destino.

3. Depois de concluir a tradução das cadeias de caracteres, salve o arquivo.

Localize a pasta de configuração:

Navegue até o seguinte diretório no seu [diretório do projeto AEMaaCS]:

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

Crie as pastas necessárias (se estiverem ausentes):

Se a pasta etc não existir na pasta jcr_root, crie-a. Dentro de etc, crie outra pasta chamada languages, se ela estiver ausente.

Crie o arquivo de configuração de local:

Na pasta languages, crie um novo arquivo chamado .content.xml. Não copie e cole o nome do arquivo deste documento. Em vez disso, digite manualmente o nome.

Abra este arquivo e cole o conteúdo a seguir, substituindo [LOCALE_CODE] pelo código de localidade real (Por exemplo, ar-ae para Árabe).

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

AVISO: não substitua a lista existente. Em vez disso, anexe o novo código de localidade entre colchetes, separados por vírgulas, desta forma (usando ar-ae como exemplo):

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

Incluir as Novas Pastas em filter.xml:

Navegue até o arquivo /ui.content/src/main/content/meta-inf/vault/filter.xml no seu [diretório do projeto AEMaaCS].

Abra o arquivo e adicione a seguinte linha no final:

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

Salve o arquivo.