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 plug-in de tradução do 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 plug-in. O instalador estará disponível, mas nenhuma melhoria ou correção adicional será implementada.

    • A versão 2.X do plug-in suporta a 6.5.

    • A versão 3.X do plug-in suporta o AEM as a Cloud Service.

    Notas de lançamento do plug-in

    Configuração do Phrase

    Configurar prévia no contexto

    O recurso de prévia no contexto oferece uma prévia em tempo real do texto original ou traduzido tanto no CAT Web Editor quanto no CAT Desktop Editor.

    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 ao traduzir 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<1> nas configurações de Acesso e Segurança.

    Requisitos do Phrase:

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

    • Autentique-se no ambiente de autoria.

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

    • A instalação deve ser 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 ser capaz de ser resolvido externamente.

    Nota

    Algumas tags HTML apresentam um risco e o CAT Editor as remove deste HTML ao exibir a prévia. Isso é 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: Criar um usuário do Adobe Experience Manager com as permissões mínimas necessárias para visualizar páginas não publicadas.

    Dica

    Criar um novo usuário chamado phrase-preview e adicionar o usuário ao grupo Autores.

    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. Alterar o Tipo para Adobe Experience Manager Live Preview e fornecer 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 resolúvel externamente (não um domínio de intranet).

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

      Logon único (SSO) e autenticação de dois fatores (2FA) não são suportados. Se o Logon único ou a autenticação de dois fatores for imposta na conta Drupal, use 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 local completo apenas pelo código do 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, selecionar o conector para excluir.

    2. Clique em Excluir.

      A janela Excluir conector é aberta.

    3. Digite \"excluir\" 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 na lixeira. Tentar excluir esse conector retorna um erro \"Falha ao excluir conector\".

    Resolução: Abra o projeto associado ao conector e concluir ou excluir 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 CAT Editor as remove deste HTML ao exibir a prévia. Isso é 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 trabalho do Adobe Experience Manager, crie um modelo de projeto configurado conforme suas necessidades:

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

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

    1. Abra um projeto de tradução incompleto.

    2. Selecionar Exportar no menu do bloco trabalho.

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

    4. No Phrase, navegue até os portais de solicitações usados para a integração e abra a URL listada.

    5. Concluir o formulário SP, fazer upload do arquivo .XML, validar o e-mail e enviar.

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

    Configuração do AEM

    Instalar o plug-in

    AEM local

    1. Se estiver migrando da 6.2 ou 6.3 para a 6.4 ou superior, remova todas as configurações de serviços de nuvem legados da ferramenta admin da interface clássica (/miscadmin#/etc/cloudservices/memsource-translation)

      Todas as configurações desaparecem de Serviços de nuvem legados > Plug-in de tradução Memsource para AEM.

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

    3. Desinstale a versão anterior do plug-in, 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 plug-in 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 AEM pom.xml:

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

    2. Adicione a dependência do plug-in 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. Adicionar bloco incorporado à configuração de all/pom.xml -> filevault-package-maven-plugin:

      ...
<plugin>
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  <configuration>
  <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. Adicionar o plug-in ao repositório local do maven. Execute o seguinte comando a partir da raiz do projeto do serviço AEM cloud, substituindo o marcador de posição {memsource.plugin.path} pelo caminho para o plug-in (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 plug-in 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>

    Configurar o plug-in

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

    • Informe ao sistema que o Phrase existe, adicionando-o como um responsável pelo serviço 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.

    Adicionar o Phrase como um responsável pelo serviço de tradução

    Siga estas etapas:

    1. Em Ferramentas, Geral, vá para Navegador de configurações.

    2. Criar 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 Serviços em nuvem, vá para Serviços de tradução em nuvem.

    4. Expandir o diretório conf.

    5. Criar uma nova configuração e inserir as seguintes informações:

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

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

      Clicar em Conectar.

    6. Selecionar outras opções e fechar a configuração.

      • Agrupar 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 de modelo de projeto do Phrase.

      • Definir estado do trabalho 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 de legado, as informações de serviço e portal de solicitações também serão necessárias.

    Configurar integração de tradução

    Ao usar o plug-in 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. Usar a configuração de integração de tradução do projeto para evitar que ativos não traduzível ou materiais de referência sejam incluídos nos projetos.

    1. Em Ferramentas, vá para Serviços de Nuvem, clique em Serviços de Nuvem de Tradução.

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

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

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

      • Na aba<1> Ativos, definir o fluxo de trabalho de tradução como Não traduzir.

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

    Aplicar integração de tradução a Sites

    Configurar o responsável de tradução Phrase padrão com diferentes partes da taxonomia do site. Configurar o responsável no nó raiz do site. Todas as páginas descendentes herdarão a configuração. Substituir a configuração no nó que deve usar uma configuração de responsável 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 aba Avançado, Selecionar a configuração recém-criada como a Configuração de Nuvem.

    Ao adicionar conteúdo dessas páginas, apenas conteúdo traduzível será adicionado. Se um projeto for Criar a partir do Painel de Referências, ele será automaticamente configurar 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, Criar um projeto de tradução no Adobe Experience Manager. Projetos podem ser Criar 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.

    3. Selecione os idiomas de tradução, opcionalmente desmarque Selecionar todas as subpáginas.

    4. Selecione Criar Projeto de Tradução em vários idiomas.

      Se houver vários idiomas de tradução, 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 dentro de alguns minutos.

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

      • Assim que o trabalho é aceito por um responsável, o estado do item de trabalho do AEM muda para Tradução em progresso.

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

      Dica

      O Adobe Experience Manager verifica a atualização do estado do trabalho em um cronograma configurado na Configuração da Plataforma de Tradução, acessada via Console da Web.

      Definir a propriedade Cron do Agendador para ser executada frequentemente (por exemplo, 0 0/5 * * * ? * aciona uma atualização do estado do trabalho de tradução a cada 5 minutos).

      Atualizar a página de detalhes do projeto força uma extração.

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

    10. Se rejeitada, 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 estado do trabalho é atualizado para Delivered conforme configurado nas configurações do plug-in.

    Para obter 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

    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 texto original e de tradução.

    1. Open CRXDE (/crx/de/index.jsp).

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

    3. Criar um novo nó.

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

    5. Adicionar propriedade:

      • Name: memsourceLanguage

      • Type: String

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

    6. Clique em Save All.

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

    AEM as a Cloud Service

    Para adicionar o 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 ele:

      <?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 ele:

      <?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 de 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.

    Usar os IDs para exibição no ambiente AEM ou em APIs para estender a funcionalidade do plug-in.

    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 Personalizado 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 Criar 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 for concluída, o que confirma que a reindexação terminou sem erros e não requer 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.