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 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 X do plug-in suporta 6.5.

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

    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 conteúdo 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 Acessar 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 estar acessível a partir dos endereços IP do servidor Phrase. Consulte Phrase Servers IP Addresses para obter a lista atual.

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

    Nota

    Algumas tags HTML apresentam um risco e o CAT Editor as remove deste HTML ao exibir a prévia. 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 de background-image.

    Configurações do Phrase TMS

    Pre-requisite: 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 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. Alterar o Type 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.

    7. Para modificar links contidos no HTML da página, forneça a URL rewrite rule 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.

    Nota

    Algumas tags HTML apresentam um risco e o CAT Editor as remove deste HTML ao exibir a prévia. 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 de 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 de acordo com suas necessidades:

    • Em Access and Security, ative a opção Allow loading of external content in Phrase CAT editor.

    Se estiver usando versões 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. Selecione 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 do solicitante usados para a integração e abra a URL listada.

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

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

    Configuração 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 de legado da ferramenta Admin da UI Clássica (/miscadmin#/etc/cloudservices/memsource-translation)

      Todas as configurações desaparecem de Serviços de Nuvem de legado > 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 de pacote e faça o upload do arquivo de instalação.

    5. Marque Forçar upload e enviar.

    AEM como um serviço

    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 de nuvem AEM pom.xml:

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

    2. Adicionar dependência de plug-in a 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 maven local. Execute o seguinte comando a partir da raiz do projeto do serviço de nuvem AEM, 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 por 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 Integração de Tradução.

      Exemplo:

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

    Adicionar Phrase como um responsável por serviço 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 responsável estiver usando uma URL personalizado.

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

      Clique em Connect.

    6. Selecione outras opções e feche 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 Set job to completed once pre-translated e Set project to completed once all jobs are completed estiverem habilitados ao mesmo tempo nas configurações de modelo de projeto<3> Phrase.

      • Definir o estado do trabalho Phrase como Entregue após importar para o AEM 

      • Gerar análises 

        Se ativo, uma vez 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 poderão ser gerados com base nessas análises.

    Ao usar 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 do 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 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 Cloud Services, clique em Translation Cloud Services.

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

      • Certifique-se de que Translate Component Strings e Translate Tags estejam desmarcados.

      • Defina Translate page assets como Do not translate.

      • Na aba Assets, defina o fluxo de trabalho de tradução como Do not translate.

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

    Aplicar integração de tradução aos sites

    Configurar o responsável pela tradução do 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 Advanced, Selecionar a configuração recém-criada como a Configuração de Nuvem.

    Ao adicionar conteúdo destas páginas, apenas conteúdo traduzível será adicionado. Se um projeto for criado a partir do Painel de Referências, ele será automaticamente configurado 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 criados manualmente na seção Projetos ou usar fluxos de trabalho integrados para minimizar o esforço.

    Para preparar um projeto para envio através dos fluxos de trabalho integrados, siga estas etapas:

    1. A partir da visualização Sites, navegue até a página, selecionar ela e abrir 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. Selecionar idiomas de tradução, opcionalmente desmarque Selecionar todas as subpáginas.

    4. Selecionar 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 configurado corretamente, as configurações criadas nas etapas acima são referenciadas.

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

      Um novo projeto será criado dentro de alguns minutos.

      • Após importar, 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 o estado do trabalho em um agendamento configurado em Translation Platform Configuration, acessado via Web Console.

      Definir a propriedade Scheduler Cron para ser executada com frequência (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 Completed. 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 Emailed, e as etapas restantes do fluxo de trabalho como New.

    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 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 diferentes idiomas 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. Usar o código do idioma do Adobe Experience Manager como 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 Gravar tudo.

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

    AEM como um serviço

    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 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 do projeto

    Assim que um trabalho de tradução for enviado, o ID do projeto e o UID serã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 plug-in.

    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.