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 não mantém mais 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 visualização no contexto

    O recurso de visualização no 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 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. Opcionalmente, ative Impor conexão segura.

    6. 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 resolúvel externamente (não um domínio de intranet).

    7. Insira o Nome de usuário da visualização ao vivo e Senha da visualização ao vivo.

    8. 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.

    9. Clique em Gravar.

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

    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 tarefas 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 Phrase CAT.

    Se estiver usando versões legadas, um serviço e um portal de submissão 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 Tarefa.

    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 submissão usados para a integração e abra a URL listada.

    5. Preencha o formulário SP, carregue o 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 Ecossistema Phrase no Phrase usando o botão Baixar. 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 Serviços de Nuvem Legados da ferramenta de Administração da UI Clássica (/miscadmin#/etc/cloudservices/memsource-translation).

      Todas as configurações desaparecem de Serviços de Nuvem Legados > Plugin de Tradução Memsource para AEM.

    2. Em Ferramentas, Implantação, vá para Pacotes.

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

    4. Selecione Carregar pacote e carregue o arquivo de instalação.

    5. Marque Forçar Upload e envie.

    AEM como um serviço em nuvem

    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 AEM cloud service 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 de 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 serviço de nuvem AEM, substituindo o espaço reservado {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 e especificando como 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 Ferramentas, Geral, vá para Navegador de Configuração.

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

    3. Em Serviços na Nuvem, vá para Serviços de Tradução na Nuvem.

    4. Expanda o diretório conf.

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

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

      • Nome de usuário e Senha (deve estar em uma função PM com a opção Modificar configurações globais do servidor habilitada nos direitos do usuário).

      Clique em Conectar.

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

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

        Todos os trabalhos de tradução dentro de um projeto AEM também serão criados dentro de um projeto do 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 a 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, os 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 submetedor também serão necessárias.

    Configurar integração de tradução

    Ao usar o Plugin de Tradução do Phrase para o AEM, todos os arquivos dos trabalhos de tradução são enviados para tradução e, consequentemente, 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 Ferramentas, vá para Serviços na Nuvem, clique em Serviços de Tradução na Nuvem.

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

      Nota

      Crie a configuração em conf. As entradas em /libs são padrões do Adobe somente leitura.

      • 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 a sites

    Configure o Provedor de Tradução do 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 Avançado, selecione a configuração recém-criada como a Configuração de Nuvem.

    Ao adicionar conteúdo 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 do painel lateral.

    3. Selecione os idiomas de destino e, opcionalmente, desmarque a opção 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 configuradas 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 em 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 for 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 em Configuração da plataforma de tradução, acessado via Console da Web.

      Definir a propriedade Cron do agendador 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 aciona uma operação de 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 e-mail, 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 plug-in.

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

    Diversos

    Mapeamento de Idioma Personalizado

    AEM local

    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 Nome (por exemplo, zh), mantenha Tipo: nt:unstructured.

    5. Adicione a propriedade:

      • Nome: memsourceLanguage

      • Tipo string

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

    6. Clique em Salvar Tudo.

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

    AEM como um serviço em nuvem

    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

    Após o envio de um trabalho de tradução, o ID do projeto e o UID são armazenados em /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob como as 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. Defina o escopo do índice para a 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 requer nenhuma ação adicional.

    O build do Maven falha com erros de validação do filevault-package-maven-plugin, como “Package of type ‘APPLICATION’ is not supposed to contain any sub packages” ou “Package of type ‘APPLICATION’ is not supposed to contain OSGi bundles or configurations”.

    Nas versões 3.1.18.6 e anteriores do plugin, os bundles OSGi e os arquivos de configuração são empacotados dentro de um pacote do tipo aplicação, o que a validação do AEM as a Cloud Service rejeita.

    Atualize para a versão 3.1.18.7 ou posterior do plugin. Remova skipSubPackageValidation da configuração do Maven se ele foi adicionado como uma solução alternativa.

    O Phrase está ausente da lista em /libs em Translation Cloud Services.

    As entradas em /libs são padrões somente leitura da Adobe. O plugin armazena sua configuração em /conf, /apps/aem-memsource-plugin e /var/memsource-tms.

    Crie a configuração de Integração de Tradução em conf. A conexão do servidor é armazenada separadamente em /conf/global/settings/cloudconfigs/translation/memsource-translation.
    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.