Adicione uma localidade para o Forms adaptável com base nos Componentes principais

Última atualização em 2023-12-05
Versão Link do artigo
Componentes de base Clique aqui
Componentes principais Este artigo

O recurso de suporte a idiomas da direita para a esquerda está disponível no programa dos primeiros usuários. Você pode escrever para aem-forms-early-adopter-program@adobe.com a partir de sua ID de e-mail oficial para participar do programa de adoção antecipada e solicitar acesso ao recurso.

O AEM Forms oferece suporte imediato para as localidades de inglês (en), espanhol (es), francês (fr), italiano (it), alemão (de), japonês (ja), português-brasileiro (pt-BR), chinês (zh-CN), chinês-Taiwan (zh-TW) e coreano (ko-KR). Você também pode adicionar suporte para mais locais, como Hindi(hi_IN). Você também pode apresentar o Adaptive Forms em um idioma da Direita para a Esquerda (RTL), como árabe, persa e urdu, adicionando esses locais.

Como a localidade é selecionada para um Formulário adaptável?

Antes de começar a adicionar uma localidade para o Adaptive Forms, crie uma compreensão sobre como uma localidade é selecionada para um Formulário adaptável. Há dois métodos para identificar e selecionar o local de um Formulário adaptável quando ele é renderizado:

  • Usar o locale Seletor no URL: ao renderizar um Formulário adaptável, o sistema identifica o local solicitado inspecionando o [localidade] no URL do formulário adaptável. O URL segue este formato: http:/[URL do servidor do AEM Forms]/content/forms/af/[afName].[localidade].html?wcmmode=disabled. A utilização dos [localidade] O seletor permite o armazenamento em cache do Formulário adaptável. Por exemplo, o URL www.example.com/content/forms/af/contact-us.hi.html?wcmmmode=disabled renderiza o formulário no idioma hindi.

  • Recuperar os parâmetros na ordem listada abaixo:

    • Usar o afAcceptLangparâmetro de solicitação: para substituir o local do navegador do usuário, você pode passar o parâmetro de solicitação afAcceptLang. Por exemplo, a variável https://'[server]:[port]'/<contextPath>/<formFolder>/<formName>.html?wcmmode=disabled&afAcceptLang=ca-fr O URL força o AEM Forms Server a renderizar o formulário no código do idioma francês canadense.

    • Usar o local do navegador (Cabeçalho Aceitar idioma): O sistema também considera a localidade do navegador do usuário, que é especificada na solicitação usando o Accept-Language cabeçalho.

    Se uma biblioteca do cliente (o processo para criar e usar a biblioteca é abordado posteriormente neste artigo) para o local solicitado não estiver disponível, o sistema verificará se existe uma biblioteca do cliente para o código do idioma no local. Por exemplo, se o local solicitado for en_ZA (Inglês da África do Sul) e não há biblioteca de clientes para en_ZA, o Formulário adaptável usa a biblioteca do cliente para en (inglês), se disponível. Se nenhuma for encontrada, o Formulário adaptável recorrerá ao dicionário para o en localidade.

    Depois que a localidade é identificada, o Formulário adaptável seleciona o dicionário correspondente específico do formulário. Se o dicionário da localidade solicitada não for encontrado, ele assumirá como padrão o uso do dicionário no idioma em que o Formulário adaptável foi criado.

    Nos casos em que nenhuma informação de local está disponível, o Formulário adaptável é exibido em seu idioma original, que é o idioma usado durante o desenvolvimento do formulário

Pré-requisitos

Antes de começar a adicionar um local:

  • Instale um editor de texto simples (IDE) para facilitar a edição. Os exemplos neste documento são baseados em Código do Microsoft® Visual Studio.

  • Instalar uma versão de Git, se não estiver disponível no computador.

  • Clonar o Componentes principais adaptáveis do Forms repositório. Para clonar o repositório:

    1. Abra a linha de comando ou a janela do terminal e navegue até um local para armazenar o repositório. Por exemplo, /adaptive-forms-core-components

    2. Execute o seguinte comando para clonar o repositório:

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

    O repositório inclui uma biblioteca do cliente necessária para adicionar um local.

    Na execução bem-sucedida do comando, o repositório é clonado para a variável aem-core-forms-components na sua máquina. No restante do artigo, a pasta é chamada de, [Repositório adaptável dos Componentes principais do Forms].

Adicionar uma localidade

Para adicionar suporte para um novo local, siga estas etapas:

Adicionar um local a um repositório

1. Clonar o repositório Git as a Cloud Service do AEM

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

  2. Execute o seguinte comando para clonar o repositório:

    git clone https://git.cloudmanager.adobe.com/<my-org>/<my-program>/

    Substituir <my-org> e <my-program> no URL acima, com o nome da organização e o nome do programa. Para obter instruções detalhadas sobre como obter o nome da organização, o nome do programa ou o caminho completo do repositório Git, bem como as credenciais necessárias para cloná-lo, consulte Acesso ao Git artigo.

    Após a conclusão bem-sucedida do comando, uma pasta <my-program> é criado. Ele contém o conteúdo clonado do repositório Git. No restante do artigo, a pasta é chamada de, [AEM Forms as a Cloud Service Git repository].

2. Adicione o novo local ao Serviço de localização do guia

  1. Abra a pasta do repositório, clonada na seção anterior, em um editor de texto simples.

  2. Navegue até a [AEM Forms as a Cloud Service Git repository]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config pasta. Você pode encontrar o <appid> no archetype.properties arquivos do projeto.

  3. Abra o [AEM Forms as a Cloud Service Git repository]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config/Guide Localization Service.cfg.json arquivo para edição. Crie o arquivo, caso ele não exista. Um arquivo de amostra com localidades suportadas é semelhante ao seguinte:

    Um exemplo de Guia de localização Service.cfg.json

  4. Adicione o código de localidade do idioma que você deseja adicionar, por exemplo, adicione "hi" para hindi.

  5. Salvar e fechar o arquivo.

3. Crie uma Biblioteca do cliente para adicionar um local

O AEM Forms fornece um exemplo de biblioteca de cliente para ajudá-lo a adicionar novas localidades facilmente. Você pode baixar e adicionar o clientlib-it-custom-locale biblioteca do cliente do [Repositório adaptável dos Componentes principais do Forms] no GitHub para o repositório as a Cloud Service do Forms. Para adicionar a biblioteca do cliente, siga estas etapas:

  1. Abra o [Repositório adaptável dos Componentes principais do Forms] no editor de texto simples. Se você não tiver o repositório clonado, consulte Pré-requisitos para obter instruções sobre como clonar o repositório.
  2. Navegue até a /aem-core-forms-components/it/apps/src/main/content/jcr_root/apps/forms-core-components-it/clientlibs diretório.
  3. Copie o clientlib-it-custom-locale diretório.
  4. Navegue até [AEM Forms as a Cloud Service Git repository]/ui.apps/src/main/content/jcr_root/apps/moonlightprodprogram/clientlibs e cole a variável clientlib-it-custom-locale diretório.

4. Criar um arquivo específico de local

  1. Navegue até [AEM Forms as a Cloud Service Git repository]/ui.apps/src/main/content/jcr_root/apps/<program-id>/clientlibs/clientlib-it-custom-locale/resources/i18n/
  2. Localize o Inglês locale .json file on GitHub, que contém o conjunto mais recente de strings padrão incluídas no produto.
  3. Crie um arquivo .json para o local específico.
  4. No arquivo .json recém-criado, espelhe a estrutura do arquivo de localidade em inglês.
  5. Substitua as strings do idioma inglês no arquivo .json pelas strings localizadas correspondentes para o seu idioma.
  6. Salve e feche o arquivo.

5. Adicionar suporte local ao dicionário

Execute esta etapa somente se a variável <locale> você está adicionando não está entre en, de, es, fr, it, pt-br, zh-cn, zh-tw, ja, ko-kr.

  1. Navegue até a [AEM Forms as a Cloud Service Git repository]/ui.content/src/main/content/jcr_root/etc/ pasta.

  2. Criar um etc pasta sob o jcr_root pasta, se ainda não estiver presente.

  3. Criar uma pasta languages no etc pasta, se ainda não estiver presente.

    Texto alternativo

  4. Criar um .content.xml arquivo sob o languages pasta. Adicione o seguinte conteúdo ao arquivo:

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

  5. Adicione o código de localidade à languages propriedade. Por exemplo, hi adicionou para hindi ao código de exemplo a seguir.

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

  6. Adicione as pastas recém-criadas na filter.xml em /ui.content/src/main/content/meta-inf/vault/filter.xml como:

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

    Adicione as pastas criadas na em

6. Confirme as alterações e implante o pipeline

Confirme as alterações no repositório GIT após adicionar a nova localidade. Implante seu código usando o pipeline de pilha completa. Saiba mais como configurar um pipeline para adicionar novo suporte de local.

Depois que a execução do pipeline for bem-sucedida, o local recém-adicionado estará pronto para uso.

Visualizar um formulário adaptável com a localidade recém-adicionada

Execute as seguintes etapas para visualizar um Adaptável com um local recém-adicionado:

  1. Faça logon na sua instância do AEM Forms as a Cloud Service.
  2. Ir para Forms > Forms e documentos.
  3. Selecione um Formulário adaptável e clique em Adicionar dicionário e Adicionar Dicionário Ao Projeto De Tradução é exibido.
  4. Especifique a Título do projeto e selecione o Idiomas de destino no menu suspenso da caixa Adicionar Dicionário Ao Projeto De Tradução assistente.
  5. Clique em Concluído e execute o projeto de tradução criado.
  6. Selecione um Formulário adaptável e clique em Visualizar como HTML.
  7. Adicionar &afAcceptLang=<locale-name> no URL de um Formulário adaptável.
  8. Atualizar a página e o Formulário adaptável é renderizado em um local especificado.

Práticas recomendadas para oferecer suporte à nova localização

  • O Adobe recomenda criar um projeto de tradução após criar um Formulário adaptável.

  • Quando novos campos são adicionados em um Formulário adaptável existente:

    • Para tradução automática: recrie o dicionário e executar o projeto de tradução. Os campos adicionados a um Formulário adaptável após a criação de um projeto de tradução permanecem não traduzidos.
    • Para tradução humana: exporte o dicionário usando a interface do usuário em [AEM Forms Server]/libs/cq/i18n/gui/translator.html. Atualize o dicionário para os campos recém-adicionados e faça upload dele.

Veja mais

Consulte também

Página anterior
Next page

Nesta página