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 del prodotto 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 come servizio cloud.

    Note di rilascio del plugin

    Configurazione di Phrase

    Configura l'anteprima nel contesto

    La funzione di anteprima nel contesto offre un'anteprima in tempo reale del testo originale o tradotto sia nell'editor web CAT che nell'editor desktop CAT.

    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. Cambia il Tipo in Adobe Experience Manager Live Preview e fornisci un nome per il connettore.

    5. 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).

    6. Inserisci il Nome utente e la Password.

      Il Single Sign-On (SSO) e l'autenticazione a due fattori (2FA) non sono supportati. Se l'SSO o la 2FA sono applicati sull'account Drupal, utilizza un account di servizio dedicato esente da entrambi.

    7. Per modificare i link 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.

    8. Clicca su Salva.

      Il connettore viene aggiunto all'elenco nella pagina Connettori.

    Elimina un connettore

    Per eliminare un connettore:

    1. Dalla pagina Integrazioni, seleziona il connettore da eliminare.

    2. Fai clic su Elimina.

      Si apre la finestra Elimina connettore.

    3. Digita \"delete\" e fai clic su Elimina.

      Il connettore viene eliminato e viene visualizzato l'elenco dei connettori.

    Nota

    Un connettore non può essere eliminato finché è ancora collegato a lavori incompleti in un progetto, inclusi i lavori presenti nel Cestino. Il tentativo di eliminare un connettore di questo tipo restituisce l'errore \"Impossibile eliminare il connettore\".

    Risoluzione: Apri il progetto associato al connettore e completa o elimina tutti i lavori rimanenti. Vai su Impostazioni/Cestino e svuotalo per rimuovere eventuali lavori ancora collegati al connettore. Riprova a eliminare il connettore.

    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 di Adobe Experience Manager, crea un modello di progetto configurato in base alle tue esigenze:

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

    Se utilizzi versioni precedenti, sarà necessario creare e convalidare un servizio e un portale di invio. 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 di invio 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 del plugin dalla pagina Ecosistema Phrase in Phrase utilizzando il pulsante Scarica. Il plugin è disponibile solo per le organizzazioni che lo hanno acquistato.

    AEM on-premise

    1. Se si esegue la migrazione dalla versione 6.2 o 6.3 alla 6.4 e successive, rimuovi tutte le configurazioni dei Servizi cloud legacy dallo strumento di amministrazione dell'interfaccia utente classica (/miscadmin#/etc/cloudservices/memsource-translation.

      Tutte le configurazioni scompaiono da Servizi cloud legacy > Plugin di traduzione Memsource per 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. Seleziona Forza caricamento e invia.

    AEM come servizio cloud

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

    1. Aggiungi il repository maven basato sul file system locale alla radice del progetto del servizio cloud AEM pom.xml:

      repositories {

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

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

    • Comunica ad Adobe Experience Manager quando e come utilizzare Phrase configurando la Configurazione di Integrazione della Traduzione.

      Esempio:

      Utilizza 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 fornitore di servizi linguistici (LSP) state utilizzando un URL personalizzato.

      • Nome utente e Password (devono 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 verranno creati anche all'interno di un unico progetto Phrase.

        Importante

        Questa opzione non funziona correttamente se Imposta lavoro su completato una volta pre-tradotto e Imposta progetto su completato una volta completati tutti i lavori 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 attiva, 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 di invio.

    Configura l'Integrazione della Traduzione

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

    1. In Strumenti, vai su Cloud Services, fai clic su Translation Cloud Services.

    2. Crea una nuova configurazione specifica per la traduzione.

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

      • Imposta Traduci risorse pagina su Non tradurre.

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

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

    Applica l'Integrazione della Traduzione a Sites

    Configura il provider di traduzione Phrase predefinito con diverse parti della tassonomia del sito. Configura il provider nel nodo radice del sito. Tutte le pagine discendenti erediteranno l'impostazione. Sovrascrivi 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, seleziona la configurazione appena creata come configurazione cloud.

    Quando si aggiungono contenuti da queste pagine, verranno aggiunti solo i contenuti traducibili. Se un progetto viene creato dal References Panel, verrà configurato automaticamente per utilizzare la configurazione cloud associata alla pagina radice.

    Invia contenuti per la traduzione

    Per inviare contenuti (Siti, Risorse) per la traduzione, crea un progetto di traduzione in Adobe Experience Manager. I progetti possono essere creati manualmente nella sezione Progetti o utilizzare 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 in fondo alla barra.

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

    4. Seleziona Crea progetto di traduzione multilingue.

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

    6. Naviga fino al progetto nella sezione Projects e aprilo.

    7. Fai clic sui puntini di sospensione sul 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.

      Un nuovo progetto verrà creato entro pochi minuti.

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

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

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

      Consiglio

      Adobe Experience Manager esegue il polling per un aggiornamento dello stato del lavoro secondo una pianificazione configurata in Translation Platform Configuration accessibile tramite Web Console.

      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 Completed. 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 New.

    11. Una volta accettato un elemento del lavoro AEM, lo stato del lavoro viene aggiornato in Delivered 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. da zh a zh_tw), segui questi passaggi.

    La mappatura si applica sia alle lingue di origine che a quelle di destinazione.

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

    2. Naviga fino 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), mantieni 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 come servizio cloud

    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 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 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 progetti

    Una volta inviato un lavoro di traduzione, l'ID progetto e l'UID vengono archiviati in /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 in /content/projects

    Il connettore Phrase AEM individua i nodi del lavoro di traduzione tramite un translationObjectID assegnato durante l'esecuzione. Questo identificatore non esiste come proprietà del repository preesistente, pertanto 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, con ambito /content/projects, con un indice di proprietà su translationObjectID. Distribuisci la definizione dell'indice tramite la pipeline del codice invece di crearla durante l'esecuzione 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 il campo a cartelle di progetto specifiche ove possibile invece di indicizzare l'intero /content/projects, poiché un indice con un ambito troppo ampio può avere un 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.
    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.