Integrazioni
    1. Phrase
    2. Phrase TMS
    3. Integrazioni

    Adobe Experience Manager - AEM (TMS)

    Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

    Disponibile per

    • Enterprise piano

    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 Phrase Translation plugin 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 del plugin 2.X supporta la 6.5.

    • La versione del plugin 3.X supporta AEM as a Cloud servizio.

    Note di rilascio del plugin

    Configurazione Phrase

    Configura anteprima in-context

    La funzionalità di anteprima in-context offre un'anteprima in tempo reale del testo originale o tradotto sia nel CAT Web Editor che nel CAT Desktop Editor.

    Tabelle, colonne, varie grafiche, formattazione e caratteri (se installati dagli utenti) sono supportati. La funzionalità ha lo scopo di fornire contesto durante la traduzione e non è una rappresentazione perfetta del documento originale o completato; sono previste alcune differenze visive. Può anche essere influenzata dall'abilitazione/disabilitazione dell'opzione Consenti il caricamento di contenuto esterno 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 URL rewrite rule in regex.

      Esempio:

      Per sostituire un codice impostazioni locali completo 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, Crea 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 per AEM.

    2. In Strumenti, Distribuzione, andare su Pacchetti.

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

    4. Selezionare Caricare pacchetto e caricare il file di installazione.

    5. Selezionare Forza caricamento e inviare.

    AEM come servizio cloud

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

    1. Aggiungere l'archivio maven basato sul 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 a all/pom.xml -> filevault-package-maven-plugin configurazione:

      ...
<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 usare Phrase configurando l'integrazione della traduzione.

      Esempio:

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

    Aggiungere Phrase come fornitore di servizi di traduzione

    Seguire questi passaggi:

    1. In Strumenti, Generale, andare su 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 automatica).

    3. In Servizi cloud, andare su 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 si utilizza un URL personalizzato o se lo utilizza il fornitore.

      • 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 lavoro di traduzione all'interno di un progetto AEM saranno creati anche all'interno di un progetto Phrase.

        Importante

        Questa opzione non lavoro 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'importare in AEM 

      • Genera analisi 

        Se attivo, una volta inviato un lavoro di traduzione, le analisi vengono generate automaticamente quando i file vengono importare. 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 di traduzione

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

    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 traducibile o materiali di riferimento, contrassegnarli ed Elimina direttamente in Phrase.

    Applicare l'integrazione al sito

    Configurare il fornitore di traduzione Phrase predefinito con diverse parti della tassonomia del sito. Configurare il fornitore nel 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à automaticamente configurato 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 ogni 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'importare, i fornitori vengono assegnati dal modello di progetto e lo stato dell'elemento del lavoro AEM viene impostato su Committed for translation.

      • Una volta che il lavoro viene accettato da un fornitore, 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, tradurre i lavori del progetto e impostare 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 restanti passaggi del flusso di lavoro su New.

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

    Per ulteriori dettagli sulla creazione di progetti di traduzione utilizzando il pannello Riferimenti, vedere Adobe documentation.

    Varie

    Mappatura lingua personalizzato

    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. Sfogliare fino alla cartella /apps/memsource-connector/language-mapping/.

    3. Creare un nuovo nodo.

    4. Usare il codice della lingua di Adobe Experience Manager come Name (ad es. zh), mantenere Type: nt:unstructured.

    5. Aggiungere proprietà:

      • Nome: memsourceLingua

      • 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 come servizio cloud

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

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

    2. Aprire il file creato e copiare 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. Creare un file .content.xml nella cartella /conf/aem-memsource-plugin/language-mapping/zh-cn.

    4. Aprire il file creato e copiare 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. Aggiungere 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 archiviati in /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob come proprietà PROPERTY_MEMSOURCE_PROJECT_ID e PROPERTY_MEMSOURCE_PROJECT_UID.

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