Integrações
    1. Phrase
    2. Phrase TMS
    3. Integrações

    Adobe Experience Manager - AEM (TMS)

    O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

    Disponível para

    • Plano Enterprise

    Entre em contato com Comércio para perguntas de licenciamento.

    Disponível a partir de

    • Plano Enterprise (legado)

    Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.

    Versões suportadas

    O Plugin de Tradução Phrase para Adobe Experience Manager segue os mesmos períodos de suporte ao produto que o Adobe Experience Manager. Consulte https://helpx.adobe.com/support/programs/eol-matrix.html para obter informações sobre os períodos de suporte.

    Assim que uma versão do Adobe Experience Manager atinge o fim do suporte principal, o Phrase deixa de manter o plugin. O instalador estará disponível, mas nenhuma melhoria ou correção adicional será implementada.

    • A versão 2.x do plugin suporta 6.5.

    • A versão 3.x do plugin suporta o AEM as a Cloud Service.

    Notas de lançamento do plugin

    Configuração do Phrase

    Configurar a visualização em contexto

    O recurso de visualização em contexto oferece uma visualização em tempo real do texto original ou traduzido, tanto no editor web CAT quanto no editor desktop CAT.

    Tabelas, colunas, vários gráficos, formatação e fontes (se instaladas pelos usuários) são suportados. O recurso destina-se a fornecer contexto durante a tradução e não é uma representação perfeita do documento original ou concluído; algumas diferenças visuais são esperadas. Ele também pode ser influenciado ao ativar/desativar a opção Permitir o carregamento de conteúdo externo nos editores nas configurações de Acesso e Segurança.

    Requisitos do Phrase:

    • Passe pelo firewall corporativo para acessar a instalação local.

    • Autentique-se no ambiente de autoria.

    Configuração de firewall para instalação local:

    • A instalação deve estar acessível a partir dos endereços IP do servidor Phrase. Consulte Endereços IP dos Servidores Phrase para obter a lista atual.

    • O nome de domínio deve poder ser resolvido externamente.

    Nota

    Algumas tags HTML apresentam um risco e o editor CAT as remove deste HTML ao exibir a visualização. Isso serve para garantir a privacidade e a segurança dos dados do usuário.

    Exemplos de tags removidas incluem FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT ou propriedades CSS background-image.

    Configurações do Phrase TMS

    Pré-requisito: Crie um usuário do Adobe Experience Manager com as permissões mínimas necessárias para visualizar páginas não publicadas.

    Dica

    Crie um novo usuário chamado phrase-preview e adicione o usuário ao grupo Authors.

    1. Na página de configurações Setup_gear.png role para baixo até a seção de Integrações.

    2. Clique em Conectores.

      A página Conectores é aberta.

    3. Clique em Novo conector.

      A página Criar conector é aberta.

    4. Altere o Tipo para Adobe Experience Manager Live Preview e forneça um nome para o conector.

    5. Insira o Host.

      Use o endereço de host da instalação do Adobe Experience Manager (por exemplo, https://aem-author.example.org/ ou https://author-X-Y.adobeaemcloud.com/).

      O nome de domínio deve ser resolvível externamente (não um domínio de intranet).

    6. Insira o nome de usuário e a senha.

      O logon único (SSO) e a autenticação de dois fatores (2FA) não são suportados. Se o SSO ou a 2FA forem aplicados à conta Drupal, utilize uma conta de serviço dedicada, isenta de ambos.

    7. Para modificar links contidos no HTML da página, forneça a regra de reescrita de URL em regex.

      Exemplo:

      Para substituir um código de localidade completo apenas pelo código de idioma em https://example.org/en-us/images/sample.jpg, encontre /([a-z]{2})-[a-z]{2}/ e substitua-o por /$1/.

      Links nas tags <img src="" data-lazy-src="", <link href="", <script src="", <iframe src="" e links em estilos CSS e arquivos CSS referenciados (url: ('')) serão reescritos.

    8. Clique em Gravar.

      O conector está adicionado à lista na página de conectores.

    Excluir um Conector

    Para excluir um conector:

    1. Na página Integrações, selecione o conector a ser excluído.

    2. Clique em Excluir.

      A janela Excluir conector é aberta.

    3. Digite \"delete\" e clique em Excluir.

      O conector é excluído e a lista de conectores é exibida.

    Nota

    Um conector não pode ser excluído enquanto ainda estiver vinculado a trabalhos incompletos em um projeto, incluindo trabalhos que estejam na Lixeira. Tentar excluir esse conector retorna um erro de \"Falha ao excluir conector\".

    Resolução: Abra o projeto associado ao conector e conclua ou exclua quaisquer trabalhos restantes. Vá para Configurações/Lixeira e esvazie-a para remover quaisquer trabalhos ainda vinculados ao conector. Tente excluir o conector novamente.

    Nota

    Algumas tags HTML apresentam um risco e o editor CAT as remove deste HTML ao exibir a visualização. Isso serve para garantir a privacidade e a segurança dos dados do usuário.

    Exemplos de tags removidas incluem FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT ou propriedades CSS background-image.

    Configurar fluxo de trabalho de tradução

    Para configurar o processamento de trabalhos do Adobe Experience Manager, crie um modelo de projeto configurado de acordo com suas necessidades:

    • Em Acesso e Segurança, ative a opção Permitir carregamento de conteúdo externo no editor CAT do Phrase.

    Se estiver usando versões legadas, um serviço e um portal de envio precisarão ser criados e validados. Para validar a configuração, siga estas etapas:

    1. Abra um Projeto de Tradução incompleto.

    2. Selecione Exportar no menu do bloco Trabalho.

    3. Encontre o arquivo .XML que contém o texto de origem dentro do arquivo zip baixado.

    4. No Phrase, navegue até os portais de envio utilizados na integração e abra a URL listada.

    5. Preencha o formulário SP, faça o upload do arquivo .XML, valide o e-mail e envie.

    6. Verifique se o novo projeto foi criado a partir do modelo de projeto conforme configurado.

    Configuração do AEM

    Instalar o plugin

    Baixe o pacote de plugin mais recente na página Phrase Ecosystem no Phrase usando o botão Download. O plugin está disponível apenas para organizações que o adquiriram.

    AEM local (on-premise)

    1. Se estiver migrando da versão 6.2 ou 6.3 para a 6.4 ou superior, remova todas as configurações de Legacy Cloud Services da ferramenta Classic UI Admin (/miscadmin#/etc/cloudservices/memsource-translation)

      Todas as configurações desaparecem de Legacy Cloud Services > Memsource Translation Plugin for AEM.

    2. Em Tools, Deployment, vá para Packages.

    3. Desinstale a versão anterior do plugin, se aplicável.

    4. Selecione Upload package e faça o upload do arquivo de instalação.

    5. Marque Force Upload e envie.

    AEM as a Cloud Service

    Se o plugin já estiver instalado, pule para a Etapa 4.

    1. Adicione o repositório maven baseado no sistema de arquivos local à raiz do projeto do serviço de nuvem AEM pom.xml:

      repositories {
{
  repositório
    <id>project.local</id>
    <name>project</name>
    <url>file:${maven.multiModuleProjectDirectory}/repository</url>
  repositório
{
repositories {

    2. Adicione a dependência do plugin ao all/pom.xml:

      <dependency>
  <groupId>com.memsource</groupId>
  <artifactId>aem-memsource-plugin.all</artifactId>
  <version>X.X.X</version>
  <type>zip</type>
</dependency>

    3. Adicione o bloco incorporado à configuração do all/pom.xml -> filevault-package-maven-plugin:

      {
plug-in
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  Configuração
  <group>my_packages</group>
  <embeddeds>
   <embedded>
     <groupId>com.memsource</groupId>
     <artifactId>aem-memsource-plugin.all</artifactId>
     <type>zip</type>
     <target>/apps/aem-memsource-plugin-packages/application/install</target>
   </embedded>
{

    4. Adicione o plugin ao repositório maven local. Execute o seguinte comando a partir da raiz do projeto do AEM cloud service, substituindo o marcador {memsource.plugin.path} pelo caminho para o plugin (por exemplo, /tmp/aem-memsource-plugin.all-3.0.1.zip):

      mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile={memsource.plugin.path} -DlocalRepositoryPath=./repository/ -Dpackaging=zip

    5. Defina a versão correta do plugin em all/pom.xml (por exemplo, 3.0.1):

      <dependency>
  <groupId>com.memsource</groupId>
  <artifactId>aem-memsource-plugin.all</artifactId>
  <version>3.0.1</version>
  <type>zip</type>
</dependency>

    Configure o Plugin

    Duas configurações são necessárias:

    • Informe ao sistema que o Phrase existe, adicionando-o como um Provedor de Serviços de Tradução, especificando como se conectar ao TMS.

    • Informe ao Adobe Experience Manager quando e como o Phrase deve ser usado, configurando a Configuração de Integração de Tradução.

      Exemplo:

      Use o Phrase para conteúdo de alta visibilidade, mas um fornecedor de tradução automática para conteúdo da comunidade.

    Adicione o Phrase como um Provedor de Serviços de Tradução

    Siga estas etapas:

    1. Em Tools, General, vá para Configuration Browser.

    2. Crie um contêiner de configuração para cada serviço Phrase (por exemplo, uma configuração para tradução humana e uma configuração separada para tradução apenas por máquina).

    3. Em Cloud Services, vá para Translation Cloud Services.

    4. Expanda o diretório conf.

    5. Crie uma nova configuração e insira as seguintes informações:

      • Hostname: A URL padrão é https://cloud.memsource.com/web/, mas pode ser diferente se você ou o LSP estiver usando uma URL personalizada.

      • Username e Password (deve estar em uma função PM com a opção Modify global server settings habilitada nos direitos do usuário).

      Clique em Connect.

    6. Selecione outras opções e feche a configuração.

      • Agrupe todos os trabalhos de tradução em um único projeto Phrase 

        Todos os trabalhos de tradução dentro de um projeto AEM também serão criados dentro de um projeto Phrase.

        Importante

        Esta opção não funciona corretamente se Definir trabalho como concluído após pré-tradução e Definir projeto como concluído após a conclusão de todos os trabalhos estiverem habilitados ao mesmo tempo nas configurações do modelo de projeto do Phrase.

      • Definir status do trabalho do Phrase como Entregue após importação para o AEM 

      • Gerar análises 

        Se ativo, assim que um trabalho de tradução é enviado, as análises são geradas automaticamente quando os arquivos são importados. As análises são sempre geradas por idioma, independentemente das configurações do modelo de projeto. 

      • Gerar orçamentos 

        Se a geração automática de análises estiver ativada, orçamentos podem ser gerados com base nessas análises.

    Se estiver usando versões legadas, as informações de serviço e portal do remetente também serão necessárias.

    Configurar Integração de Tradução

    Ao usar o Plugin de Tradução Phrase para AEM, todos os arquivos nos trabalhos de tradução são enviados para tradução e, portanto, retornados do Phrase. Use a configuração de Integração de Tradução do projeto para evitar que ativos não traduzíveis ou materiais de referência sejam incluídos nos projetos.

    1. Em Tools, vá para Cloud Services, clique em Translation Cloud Services.

    2. Crie uma nova configuração especificamente para tradução.

      • Certifique-se de que Traduzir Strings de Componentes e Traduzir Tags estejam desmarcados.

      • Defina Traduzir ativos da página como Não traduzir.

      • Na guia Ativos, defina o Fluxo de Trabalho de Tradução como Não traduzir.

    3. Se um projeto ainda contiver ativos não traduzíveis ou materiais de referência, marque-os e exclua-os diretamente no Phrase.

    Aplicar Integração de Tradução aos Sites

    Configure o Provedor de Tradução Phrase padrão com diferentes partes da taxonomia do site. Configure o provedor no nó raiz do site. Todas as páginas descendentes herdarão a configuração. Substitua a configuração no nó que deve usar uma configuração de provedor diferente (por exemplo, todo o site usa tradução humana, mas a seção da comunidade usa tradução automática).

    Para aplicar a integração de tradução:

    • Na guia Advanced, selecione a configuração recém-criada como a Cloud Configuration.

    Ao adicionar conteúdo a partir dessas páginas, apenas o conteúdo traduzível será adicionado. Se um projeto for criado a partir do Painel de Referências, ele será configurado automaticamente para usar a configuração de nuvem associada à página raiz.

    Enviar Conteúdo para Tradução

    Para enviar conteúdo (Sites, Ativos) para tradução, crie um projeto de tradução no Adobe Experience Manager. Os projetos podem ser criados manualmente na seção Projetos ou usar fluxos de trabalho integrados para minimizar o esforço.

    Para preparar um projeto para envio por meio dos fluxos de trabalho integrados, siga estas etapas:

    1. Na visualização Sites, navegue até a página, selecione-a e abra o Painel de Referências.

    2. Clique em Cópias de Idioma e expanda a seção Criar e Traduzir na parte inferior da barra lateral.

    3. Selecione os idiomas de destino, opcionalmente desmarque Selecionar todas as subpáginas.

    4. Selecione Criar Projeto de Tradução Multilíngue.

      Se houver vários idiomas de destino, um projeto separado será criado para cada idioma.

    5. Insira o título do projeto e clique em Criar.

    6. Navegue até o projeto na seção Projetos e abra-o.

    7. Clique nas reticências no primeiro bloco para abrir as configurações avançadas do projeto.

      Se configurado corretamente, as configurações criadas nas etapas acima são referenciadas.

    8. Para enviar um trabalho, selecione Iniciar no menu do bloco de trabalho.

      Um novo projeto será criado dentro de alguns minutos.

      • Após a importação, os provedores são atribuídos a partir do modelo de projeto e o status do item de trabalho do AEM é definido como Comprometido para tradução.

      • Assim que o trabalho é aceito por um provedor, o status do item de trabalho do AEM muda para Tradução em andamento.

      • O status do item de trabalho do AEM muda para Cancelado se o trabalho for excluído ou cancelado.

      Dica

      O Adobe Experience Manager verifica se há uma atualização de status de trabalho em um cronograma configurado na Translation Platform Configuration, acessada via Web Console.

      Definir a propriedade Scheduler Cron para ser executada com frequência (por exemplo, 0 0/5 * * * ? * aciona uma atualização do status do trabalho de tradução a cada 5 minutos).

      Atualizar a página de detalhes do projeto força um pull.

    9. No Phrase, traduza os trabalhos do projeto e defina seus status como Concluído. Após a conclusão, os trabalhos são importados de volta para o AEM.

    10. Se rejeitado, a primeira etapa do fluxo de trabalho do trabalho é definida como Enviado por email, e as etapas restantes do fluxo de trabalho como Novo.

    11. Assim que um item de trabalho do AEM é aceito, o status do trabalho é atualizado para Entregue, conforme configurado nas configurações do plugin.

    Para mais detalhes sobre a criação de projetos de tradução usando o Painel de Referências, consulte a documentação da Adobe.

    Diversos

    Mapeamento de idioma personalizado

    AEM local (on-premise)

    Para mapear idiomas do Adobe Experience Manager para idiomas diferentes no Phrase (por exemplo, zh para zh_tw), siga estas etapas.

    O mapeamento se aplica aos idiomas de origem e de destino.

    1. Abra o CRXDE (/crx/de/index.jsp).

    2. Navegue até a pasta /apps/memsource-connector/language-mapping/.

    3. Crie um novo nó.

    4. Use o código de idioma do Adobe Experience Manager como o Nome (por exemplo, zh), mantenha Tipo: nt:unstructured.

    5. Adicione a propriedade:

      • Nome: memsourceLanguage

      • Tipo String

      • Valor: código de idioma (por exemplo, zh_tw)

    6. Clique em Salvar Tudo.

    Códigos de idioma não mapeados são enviados como estão.

    AEM as a Cloud Service

    Para adicionar mapeamento de idioma no AEM Cloud Services, siga estas etapas:

    1. Crie um arquivo .content.xml na pasta /conf/aem-memsource-plugin/language-mapping/.

    2. Abra o arquivo criado e copie o seguinte para dentro dele:

      <?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
    jcr:primaryType="sling:Folder"/>

    3. Crie um arquivo .content.xml na pasta /conf/aem-memsource-plugin/language-mapping/zh-cn.

    4. Abra o arquivo criado e copie o seguinte para dentro dele:

      <?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0"
          jcr:primaryType="nt:unstructured"
          memsourceLanguage="zh_cn">
</jcr:root>

    5. Adicione os caminhos criados nas etapas anteriores ao arquivo filter.xml encontrado em ui.content/src/main/content/META-INF/vault/filter.xml:

      <?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
{
    <filter root="/conf/aem-memsource-plugin" mode="update"/>
    <filter root="/conf/aem-memsource-plugin/language-mapping" mode="update"/>
</workspaceFilter>

    IDs do projeto

    Assim que um trabalho de tradução é enviado, o ID do projeto e o UID são armazenados em /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob como propriedades PROPERTY_MEMSOURCE_PROJECT_ID e PROPERTY_MEMSOURCE_PROJECT_UID.

    Use os IDs para exibição no ambiente AEM ou em APIs para estender a funcionalidade do plugin.

    Solução de problemas do AEM

    Problema

    Causa(s)

    Solução

    O Cloud Manager relata um alerta de \"Consulta Sem Índice\" para uma consulta em translationObjectID em /content/projects

    O conector Phrase AEM localiza nós de trabalho de tradução por um translationObjectID atribuído em tempo de execução. Este identificador não existe como uma propriedade de repositório pré-existente, portanto, o AEM as a Cloud Service não pode indexá-lo com antecedência e recorre a uma varredura completa, o que o Cloud Manager sinaliza.

    Adicione uma definição de índice Oak/Lucene personalizada do tipo oak:QueryIndexDefinition, com escopo para /content/projects, com um índice de propriedade em translationObjectID. Implante a definição de índice por meio do pipeline de código em vez de criá-la em tempo de execução, e valide-a em um ambiente que não seja de produção antes de implantar em produção. Limite o índice à estrutura de pastas do projeto na instância do AEM, restringindo a pastas de projeto específicas sempre que possível em vez de indexar todo o /content/projects, já que um índice com escopo muito amplo pode criar seu próprio impacto no desempenho. Após a implantação, o AEM define a propriedade reindex da definição de índice como false assim que a reindexação é concluída, o que confirma que a reindexação terminou sem erros e não exige nenhuma ação adicional.
    Esse artigo foi útil?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.