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. Vedere 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 servizio.

    Note di rilascio del plugin

    Configurazione Phrase

    Configura anteprima contestuale

    La funzionalità 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 funzionalità 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:

    • Attraversare il firewall Enterprise per accedere all'installazione on-premise.

    • Autenticarsi nell'ambiente di authoring.

    Configurazione firewall per installazione on-premise:

    • L'installazione deve essere accessibile dagli indirizzi IP del server Phrase. Fare riferimento a Phrase Servers IP Addresses per l'elenco corrente.

    • Il nome del dominio deve poter essere risolto esternamente.

    Nota

    Alcuni tag HTML presentano un rischio e il CAT Editor li rimuove da questo HTML durante la visualizzazione dell'anteprima. Questo serve a 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

    Pre-requisite: Creare un utente Adobe Experience Manager con le autorizzazioni minime richieste per visualizzare le pagine non pubblicate.

    Consiglio

    Creare un nuovo utente chiamato phrase-preview e aggiungere l'utente al gruppo Authors.

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

    2. Fai clic su Connettori.

      Si apre la pagina Connettori.

    3. Fare clic su New connector.

      Si apre la pagina Create connector.

    4. Modificare il Type in Adobe Experience Manager Live Preview e fornire un nome per il connettore.

    5. Inserire l'Host.

      Usare 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 del dominio deve essere risolvibile esternamente (non un dominio intranet).

    6. Inserire nome utente e password.

    7. Per modificare i collegamenti contenuti nell'HTML della pagina, fornire la URL rewrite rule in regex.

      Esempio:

      Per sostituire un codice completo delle impostazioni locali con solo il codice della lingua in https://example.org/en-us/images/sample.jpg, trovare /([a-z]{2})-[a-z]{2}/ e sostituirlo 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.

    Nota

    Alcuni tag HTML presentano un rischio e il CAT Editor li rimuove da questo HTML durante la visualizzazione dell'anteprima. Questo serve a 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.

    Configurare il flusso di lavoro di traduzione

    Per configurare l'elaborazione del lavoro di Adobe Experience Manager, creare un modello di progetto configurato in base alle proprie esigenze:

    • In Access and Security, attivare l'opzione Allow loading of external content in Phrase CAT editor.

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

    1. Aprire un progetto di traduzione incompleto.

    2. Selezionare Esporta dal menu del riquadro lavoro.

    3. Trovare il file .XML che contiene il testo di origine all'interno del file zip scaricato.

    4. In Phrase, navigare verso i portali richieste utilizzati per l'integrazione e aprire l'URL elencato.

    5. Completare il modulo SP, caricare il file .XML, verificare l'e-mail e inviare.

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

    Configurazione AEM

    Installare il plugin

    AEM on-premise

    1. In caso di migrazione dalla versione 6.2 o 6.3 alla 6.4 e successive, rimuovere tutte le configurazioni legacy Cloud Services dallo strumento amministratore dell'interfaccia classica (/miscadmin#/etc/cloudservices/memsource-translation)

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

    2. In Strumenti, Deployment, andare su Packages.

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

    4. Selezionare Upload package e caricare il file di installazione.

    5. Selezionare Force Upload e inviare.

    AEM as a Cloud Service

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

    1. Aggiungere l'archivio maven basato su file system locale alla radice del progetto del servizio cloud AEM pom.xml:

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

    2. Aggiungere 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. Aggiungere il blocco embedded 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>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. Aggiungere il plugin all'archivio maven locale. Eseguire il seguente comando dalla radice del progetto del servizio cloud AEM 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=./archivio/ -Dpackaging=zip

    5. Impostare la versione corretta del plugin in all/pom.xml (ad esempio 3.0.1):

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

    Configurare il plugin

    Sono richieste due configurazioni:

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

    • Comunicare ad Adobe Experience Manager quando e come Phrase deve essere usato configurando la configurazione dell'integrazione di traduzione.

      Esempio:

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

    Aggiungere Phrase come fornitore di servizi di traduzione

    Seguire questi passaggi:

    1. In Strumenti, Generale, andare in Browser di configurazione.

    2. Creare 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, andare in Servizi cloud di traduzione.

    4. Espandere la directory conf.

    5. Creare una nuova configurazione e inserire le seguenti informazioni:

      • Nome host: L'URL predefinito è https://cloud.memsource.com/web/ ma può essere diverso se l'utente o il fornitore di servizi linguistici sta utilizzando un URL personalizzato.

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

      Fare clic su Connetti.

    6. Selezionare altre opzioni e chiudere la configurazione.

      • Raggruppare 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 progetto Phrase.

        Importante

        Questa opzione non funziona correttamente se Set job to completed once pre-translated e Set project to completed once all jobs are completed sono abilitati contemporaneamente nelle impostazioni del modello di progetto Phrase.

      • Impostare lo stato del lavoro Phrase su Delivered 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. 

      • Generare preventivi 

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

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

    Configurare l'integrazione alla traduzione

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

    1. In Strumenti, andare su Cloud Services, fare clic su Translation Cloud Services.

    2. Creare una nuova configurazione specificamente per la traduzione.

      • Assicurarsi che Translate Component Strings e Translate Tags non siano selezionati.

      • Impostare Translate page assets su Do not translate.

      • Nella scheda Assets, impostare il flusso di lavoro di traduzione su Do not translate.

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

    Applicare l'integrazione alla traduzione ai siti

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

    Per applicare l'integrazione della traduzione:

    • Nella scheda Advanced, selezionare la configurazione appena creata come Cloud Configuration.

    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 usare la configurazione cloud associata alla pagina principale.

    Inviare contenuto per la traduzione

    Per inviare contenuto (siti, risorse) per la traduzione, creare un progetto di traduzione in Adobe Experience Manager. I progetti possono essere creati manualmente nella sezione Progetti o usare flussi di lavoro integrati per ridurre al minimo lo sforzo.

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

    1. Dalla vista Sites, navigare alla pagina, selezionarla e aprire il References Panel.

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

    3. Selezionare le lingue di destinazione, facoltativamente deselezionare 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. Inserire il titolo del progetto e fare clic su Create.

    6. Navigare al progetto nella sezione Projects e aprirlo.

    7. Fare 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, selezionare 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 Inviato per la traduzione.

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

      • 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 lavoro secondo una pianificazione configurata nella Configurazione della 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, tradurre i lavori del progetto e impostare 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 Inviato tramite email, e i passaggi del flusso di lavoro rimanenti su Nuovo.

    11. Una volta accettato un elemento di 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, vedere 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), seguire questi passaggi.

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

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

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

    3. Creare un nuovo nodo.

    4. Usare il codice della lingua di Adobe Experience Manager come Nome (ad es. zh), mantenere Tipo: NT:non strutturato.

    5. Aggiungi proprietà:

      • Nome: memsourceLanguage

      • Tipo: stringa

      • Valore: codice della lingua (ad es. zh_tw)

    6. Fai clic su Salva tutto.

    I codici della 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 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="aggiornare"/>
    <filter root="/conf/aem-memsource-plugin/language-mapping" mode="aggiornare"/>
</workspaceFilter>

    ID progetto

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

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

    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.