Integrazioni
    1. Phrase
    2. Phrase TMS
    3. Integrazioni

    Adobe Experience Manager - AEM (TMS)

    Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

    Disponibile per

    • Piano Enterprise

    Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

    Disponibile per

    • Piano Enterprise (legacy)

    Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

    Versioni supportate

    Il plugin di traduzione Phrase per Adobe Experience Manager segue gli stessi periodi di supporto di Adobe Experience Manager. Vedi https://helpx.adobe.com/support/programs/eol-matrix.html per informazioni sui periodi di supporto.

    Una volta che una versione di Adobe Experience Manager raggiunge la fine del supporto principale, Phrase non mantiene più il plugin. Il programma di installazione sarà disponibile, ma non verranno implementati ulteriori miglioramenti o correzioni.

    • La versione 2.x del plugin supporta la 6.5.

    • La versione 3.x del plugin supporta AEM as a Cloud Service.

    Note di rilascio del plugin

    Configurazione di Phrase

    Configura l'anteprima contestuale

    La funzione di anteprima contestuale offre un'anteprima in tempo reale del testo originale o tradotto sia nel CAT Web Editor che nel CAT Desktop Editor.

    Sono supportati tabelle, colonne, vari elementi grafici, formattazione e caratteri (se installati dagli utenti). La funzione ha lo scopo di fornire contesto durante la traduzione e non rappresenta una riproduzione perfetta del documento originale o completato; sono previste alcune differenze visive. Può anche essere influenzata dall'abilitazione/disabilitazione dell'opzione Consenti il caricamento di contenuti esterni negli editor nelle impostazioni di Accesso e sicurezza.

    Requisiti di Phrase:

    • Attraversa il firewall aziendale per accedere all'installazione on-premise.

    • Autenticati nell'ambiente di authoring.

    Configurazione del firewall per l'installazione on-premise:

    • L'installazione deve essere accessibile dagli indirizzi IP del server Phrase. Consulta Indirizzi IP dei server Phrase per l'elenco corrente.

    • Il nome di dominio deve poter essere risolto esternamente.

    Nota

    Alcuni tag HTML presentano un rischio e l'editor CAT li rimuove da questo HTML durante la visualizzazione dell'anteprima. Questo per garantire la privacy e la sicurezza dei dati dell'utente.

    Esempi di tag rimossi includono FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT o proprietà CSS background-image.

    Impostazioni Phrase TMS

    Prerequisito: Crea un utente Adobe Experience Manager con i permessi minimi richiesti per visualizzare le pagine non pubblicate.

    Consiglio

    Crea un nuovo utente chiamato phrase-preview e aggiungi l'utente al gruppo Autori.

    1. Dalla pagina Impostazioni Setup_gear.png, scorri verso il basso fino alla sezione Integrazioni.

    2. Fai clic su Connettori.

      Si apre la pagina Connettori.

    3. Fai clic su Nuovo connettore.

      Si apre la pagina Crea connettore.

    4. Modifica il Tipo in Adobe Experience Manager Live Preview e fornisci un nome per il connettore.

    5. Facoltativamente, abilita Applica connessione sicura.

    6. Inserisci l'Host.

      Utilizza l'indirizzo host dell'installazione di Adobe Experience Manager (ad es. https://aem-author.example.org/ o https://author-X-Y.adobeaemcloud.com/).

      Il nome di dominio deve essere risolvibile esternamente (non un dominio intranet).

    7. Inserisci il Utente Live preview e la Password Live preview.

    8. Per modificare i collegamenti contenuti nell'HTML della pagina, fornisci la Regola di riscrittura URL in regex.

      Esempio:

      Per sostituire un codice locale completo con solo il codice lingua in https://example.org/en-us/images/sample.jpg, trova /([a-z]{2})-[a-z]{2}/ e sostituiscilo con /$1/.

      I collegamenti nei tag <img src="" data-lazy-src="", <link href="", <script src="", <iframe src="" e i collegamenti negli stili CSS e nei file CSS referenziati (url: ('')) verranno riscritti.

    9. Clicca su Salva.

      Il connettore viene aggiunto all'elenco nella pagina Connettori.

    Nota

    Alcuni tag HTML presentano un rischio e l'editor CAT li rimuove da questo HTML durante la visualizzazione dell'anteprima. Questo per garantire la privacy e la sicurezza dei dati dell'utente.

    Esempi di tag rimossi includono FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT o proprietà CSS background-image.

    Configura il flusso di lavoro di traduzione

    Per configurare l'elaborazione dei lavori in Adobe Experience Manager, crea un modello di progetto configurato secondo le tue esigenze:

    • In Accesso e sicurezza, attiva l'opzione Consenti il caricamento di contenuti esterni nell'editor CAT di Phrase.

    Se utilizzi versioni legacy, sarà necessario creare e convalidare un servizio e un portale richieste. Per convalidare la configurazione, segui questi passaggi:

    1. Apri un progetto di traduzione incompleto.

    2. Seleziona Esporta dal menu del riquadro Lavoro.

    3. Trova il file .XML che contiene il testo sorgente all'interno del file zip scaricato.

    4. In Phrase, vai ai portali richieste utilizzati per l'integrazione e apri l'URL elencato.

    5. Compila il modulo SP, carica il file .XML, convalida l'email e invia.

    6. Verifica che il nuovo progetto sia stato creato dal modello di progetto come configurato.

    Configurazione AEM

    Installa il plugin

    Scarica l'ultimo pacchetto plugin dalla pagina Phrase Ecosystem in Phrase utilizzando il pulsante Download. Il plugin è disponibile solo per le organizzazioni che lo hanno acquistato.

    AEM on-premise

    1. Se esegui la migrazione dalla versione 6.2 o 6.3 alla 6.4 e successive, rimuovi tutte le configurazioni dei Legacy Cloud Services dallo strumento di amministrazione dell'interfaccia classica (/miscadmin#/etc/cloudservices/memsource-translation)

      Tutte le configurazioni scompaiono da Legacy Cloud Services > Memsource Translation Plugin for AEM.

    2. In Strumenti, Distribuzione, vai a Pacchetti.

    3. Disinstalla la versione precedente del plugin, se applicabile.

    4. Seleziona Carica pacchetto e carica il file di installazione.

    5. Controlla Caricamento forzato e invia.

    AEM as a Cloud Service

    Se il plugin è già installato, passa al passaggio 4.

    1. Aggiungi il repository maven basato su filesystem locale alla root del progetto AEM cloud service pom.xml:

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

    2. Aggiungi la dipendenza del plugin 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. Aggiungi il blocco incorporato alla configurazione di all/pom.xml -> filevault-package-maven-plugin:

      ...
<plugin>
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  <configuration>
  <group>i_miei_pacchetti</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. Aggiungi il plugin al repository maven locale. Esegui il seguente comando dalla root del progetto AEM cloud service sostituendo il segnaposto {memsource.plugin.path} con il percorso del plugin (ad es. /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. Imposta la versione corretta del plugin in all/pom.xml (ad es. 3.0.1):

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

    Configura il plugin

    Sono richieste due configurazioni:

    • Comunica al sistema che Phrase esiste aggiungendolo come fornitore di servizi di traduzione e specificando come connettersi al TMS.

    • Indica ad Adobe Experience Manager quando e come usare Phrase configurando la Translation Integration Configuration.

      Esempio:

      Usa Phrase per i contenuti ad alta visibilità, ma un fornitore di traduzione automatica per i contenuti della community.

    Aggiungi Phrase come fornitore di servizi di traduzione

    Segui questi passaggi:

    1. In Strumenti, Generale, vai a Browser di configurazione.

    2. Crea un contenitore di configurazione per ogni servizio Phrase (ad esempio, una configurazione per la traduzione umana e una configurazione separata per la traduzione solo automatica).

    3. In Servizi cloud, vai a Servizi cloud di traduzione.

    4. Espandi la directory conf.

    5. Crea una nuova configurazione e inserisci le seguenti informazioni:

      • Nome host: L'URL predefinito è https://cloud.memsource.com/web/ ma può essere diverso se tu o il LSP state utilizzando un URL personalizzato.

      • Nome utente e Password (deve avere un ruolo PM con l'opzione Modifica impostazioni server globali abilitata nei diritti utente).

      Fai clic su Connetti.

    6. Seleziona altre opzioni e chiudi la configurazione.

      • Raggruppa tutti i lavori di traduzione in un unico progetto Phrase 

        Tutti i lavori di traduzione all'interno di un progetto AEM saranno creati anche all'interno di un unico progetto Phrase.

        Importante

        Questa opzione non funziona correttamente se Imposta lavoro come completato una volta pre-tradotto e Imposta progetto come completato una volta che tutti i lavori sono completati sono abilitati contemporaneamente nelle impostazioni del modello di progetto Phrase.

      • Imposta lo stato del lavoro Phrase su Consegnato dopo l'importazione in AEM 

      • Genera analisi 

        Se attivo, una volta inviato un lavoro di traduzione, le analisi vengono generate automaticamente quando i file vengono importati. Le analisi vengono sempre generate per lingua, indipendentemente dalle impostazioni del modello di progetto. 

      • Genera preventivi 

        Se la generazione automatica delle analisi è attivata, è possibile generare preventivi basati su tali analisi.

    Se si utilizzano versioni legacy, saranno necessarie anche le informazioni su servizio e portale richieste.

    Configurare l'integrazione di traduzione

    Quando si utilizza il plug-in di traduzione Phrase per AEM, tutti i file nei lavori di traduzione vengono inviati per la traduzione e quindi restituiti da Phrase. Utilizzare la configurazione del progetto integrazione di traduzione per evitare che risorse non traducibili o materiali di riferimento vengano inclusi nei progetti.

    1. In Strumenti, andare su Servizi cloud, fare clic su Servizi cloud di traduzione.

    2. Creare una nuova configurazione specifica per la traduzione.

      Nota

      Creare la configurazione in conf. Le voci in /libs sono impostazioni predefinite Adobe di sola lettura.

      • Assicurarsi che Traduci stringhe componente e Traduci tag non siano selezionati.

      • Impostare Traduci risorse pagina su Non tradurre.

      • Nella scheda Risorse, impostare il Flusso di lavoro di traduzione su Non tradurre.

    3. Se un progetto contiene ancora risorse non traducibili o materiali di riferimento, contrassegnarli ed eliminarli direttamente in Phrase.

    Applicare l'integrazione della traduzione ai siti

    Configurare il provider di traduzione Phrase predefinito con diverse parti della tassonomia del sito. Configurare il provider nel nodo radice del sito. Tutte le pagine discendenti erediteranno l'impostazione. Sovrascrivere l'impostazione nel nodo che dovrebbe utilizzare una configurazione del provider diversa (ad esempio, l'intero sito utilizza la traduzione umana, ma la sezione community utilizza la traduzione automatica).

    Per applicare l'integrazione della traduzione:

    • Nella scheda Avanzate, selezionare la configurazione appena creata come Configurazione cloud.

    Quando si aggiunge contenuto da queste pagine, verrà aggiunto solo il contenuto traducibile. Se un progetto viene creato dal References Panel, verrà configurato automaticamente per utilizzare la configurazione cloud associata alla pagina principale.

    Invia contenuto per la traduzione

    Per inviare contenuto (Siti, Risorse) per la traduzione, crea un progetto di traduzione in Adobe Experience Manager. I progetti possono essere creati manualmente nella sezione Progetti oppure tramite flussi di lavoro integrati, per ridurre al minimo lo sforzo.

    Per preparare un progetto per l'invio tramite i flussi di lavoro integrati, segui questi passaggi:

    1. Dalla vista Sites, naviga fino alla pagina, selezionala e apri il References Panel.

    2. Fai clic su Language Copies ed espandi la sezione Create & Translate nella parte inferiore della barra.

    3. Seleziona le lingue di destinazione e, facoltativamente, deseleziona il Select all sub-pages.

    4. Selezionare Create Multi-language Translation Project.

      Se sono presenti più lingue di destinazione, verrà creato un progetto separato per ciascuna lingua.

    5. Inserisci il titolo del progetto e fai clic su Create.

    6. Vai al progetto nella sezione Projects ed aprilo.

    7. Fai clic sui puntini di sospensione del primo riquadro per aprire le impostazioni avanzate del progetto.

      Se configurate correttamente, le configurazioni create nei passaggi precedenti vengono referenziate.

    8. Per inviare un lavoro, seleziona Start dal menu del riquadro del lavoro.

      Un nuovo progetto verrà creato entro pochi minuti.

      • All'importazione, i fornitori vengono assegnati dal modello di progetto e lo stato dell'elemento di lavoro AEM viene impostato su Committed for translation.

      • Una volta che il lavoro viene accettato da un fornitore, lo stato dell'elemento di lavoro AEM cambia in Translation in progress.

      • Lo stato dell'elemento di lavoro AEM cambia in Annullato se il lavoro viene eliminato o annullato.

      Consiglio

      Adobe Experience Manager esegue il polling per un aggiornamento dello stato del processo secondo una pianificazione configurata in Configurazione piattaforma di traduzione accessibile tramite Console Web.

      L'impostazione della proprietà Scheduler Cron per l'esecuzione frequente (ad es. 0 0/5 * * * ? *) attiva un aggiornamento dello stato del lavoro di traduzione ogni 5 minuti.

      L'aggiornamento della pagina dei dettagli del progetto forza un pull.

    9. In Phrase, traduci i lavori del progetto e imposta il loro stato su Completato. Al completamento, i lavori vengono importati nuovamente in AEM.

    10. Se rifiutato, il primo passaggio del flusso di lavoro del lavoro viene impostato su Emailed e i passaggi rimanenti del flusso di lavoro su Nuovo.

    11. Una volta accettato un elemento del lavoro AEM, lo stato del lavoro si aggiorna su Consegnato come configurato nelle impostazioni del plugin.

    Per ulteriori dettagli sulla creazione di progetti di traduzione utilizzando il Pannello Riferimenti, consulta la documentazione Adobe.

    Varie

    Mappatura lingua personalizzata

    AEM on-premise

    Per mappare le lingue di Adobe Experience Manager a lingue diverse in Phrase (ad es. zh a zh_tw), segui questi passaggi.

    La mappatura si applica sia alla lingua di origine che a quella di destinazione.

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

    2. Vai alla cartella /apps/memsource-connector/language-mapping/.

    3. Crea un nuovo nodo.

    4. Usa il codice lingua di Adobe Experience Manager come Nome (ad es. zh) e conserva Tipo: nt:unstructured.

    5. Aggiungi proprietà:

      • Nome: memsourceLanguage

      • Tipo: Stringa

      • Valore: codice lingua (ad es. zh_tw)

    6. Fai clic su Salva tutto.

    I codici lingua non mappati vengono inviati così come sono.

    AEM as a Cloud Service

    Per aggiungere la mappatura della lingua in AEM Cloud Services, segui questi passaggi:

    1. Crea un file .content.xml nella cartella /conf/aem-memsource-plugin/language-mapping/.

    2. Apri il file appena creato e copia quanto segue al suo interno:

      <?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. Crea un file .content.xml nella cartella /conf/aem-memsource-plugin/language-mapping/zh-cn.

    4. Apri il file appena creato e copia quanto segue al suo interno:

      <?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. Aggiungi i percorsi creati nei passaggi precedenti al file filter.xml che si trova in 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>

    ID dei progetti

    Una volta inviato un lavoro di traduzione, l'ID progetto e l'UID vengono archiviati nel /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob come proprietà PROPERTY_MEMSOURCE_PROJECT_ID e PROPERTY_MEMSOURCE_PROJECT_UID.

    Utilizza gli ID per la visualizzazione nell'ambiente AEM o nelle API per estendere la funzionalità del plugin.

    Risoluzione dei problemi AEM

    Problema

    Causa

    Soluzione

    Cloud Manager segnala un avviso "Query Without Index" per una query su translationObjectID sotto /content/projects

    Il connettore AEM di Phrase individua i nodi del processo di traduzione tramite un translationObjectID assegnato in fase di runtime. Questo identificatore non esiste come proprietà del repository preesistente, quindi AEM as a Cloud Service non può indicizzarlo in anticipo e ricorre a un attraversamento completo, che Cloud Manager segnala.

    Aggiungi una definizione di indice Oak/Lucene personalizzata di tipo oak:QueryIndexDefinition, limitata a /content/projects, con un indice di proprietà su translationObjectID. Distribuisci la definizione dell'indice tramite la pipeline del codice invece di crearla in fase di runtime e convalidala in un ambiente non di produzione prima di distribuirla in produzione. Limita l'indice alla struttura delle cartelle del progetto nell'istanza AEM, restringendo ove possibile a cartelle di progetto specifiche invece di indicizzare tutto /content/projects, poiché un indice con un ambito troppo ampio può creare un proprio impatto sulle prestazioni. Dopo la distribuzione, AEM imposta la proprietà reindex della definizione dell'indice su false una volta completata la reindicizzazione, il che conferma che la reindicizzazione è terminata senza errori e non richiede ulteriori azioni.

    La build Maven fallisce a causa di errori di validazione del filevault-package-maven-plugin, come “Package of type ‘APPLICATION’ is not supposed to contain any sub packages” o “Package of type ‘APPLICATION’ is not supposed to contain OSGi bundles or configurations”.

    Nelle versioni del plugin 3.1.18.6 e precedenti, i bundle OSGi e i file di configurazione sono pacchettizzati all'interno di un pacchetto di tipo applicazione, che la convalida di AEM as a Cloud Service rifiuta.

    Aggiorna alla versione del plugin 3.1.18.7 o successiva. Rimuovi skipSubPackageValidation dalla configurazione Maven se è stato aggiunto come soluzione alternativa.

    Phrase non è presente nell'elenco sotto /libs in Translation Cloud Services.

    Le voci sotto /libs sono predefiniti Adobe di sola lettura. Il plugin memorizza la sua configurazione sotto /conf, /apps/aem-memsource-plugin e /var/memsource-tms.

    Crea la configurazione dell'integrazione della traduzione sotto conf. La connessione al server è memorizzata separatamente in /conf/global/settings/cloudconfigs/translation/memsource-translation.
    Questo articolo ti è stato utile?
    ★ ★ ★ ★ ★

    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.