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

    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 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: 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 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. Inserisci 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.

      Il single sign-on (SSO) e l'autenticazione a due fattori (2FA) non sono supportati. Se SSO o 2FA sono imposti sull'account Drupal, usare un account di servizio dedicato esente da entrambi.

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

      Esempio:

      Per sostituire un codice delle 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 link nei tag <img src=\"\" data-lazy-src=\"\", <link href=\"\", <script src=\"\", <iframe src=\"\" e i link 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 mentre è ancora collegato a lavori incompleti in un progetto, inclusi i lavori presenti nel cestino. Il tentativo di eliminare tale connettore restituisce un errore \"Impossibile eliminare il connettore\".

    Risoluzione: apri il progetto associato al connettore e completa o elimina eventuali lavori rimanenti. Vai a 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 il CAT Editor 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 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 caricamento di contenuto esterno nel CAT Editor di Phrase.

    Se si utilizzano 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 di origine all'interno del file zip scaricato.

    4. In Phrase, vai ai portali richieste utilizzati per l'integrazione e apri 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 6.2 o 6.3 alla 6.4 e versioni successive, rimuovere tutte le configurazioni dei servizi cloud legacy dallo strumento amministratore dell'interfaccia utente classica (/miscadmin#/etc/cloudservices/memsource-translation)

      Tutte le configurazioni scompaiono dai servizi cloud legacy > plugin di traduzione Memsource per AEM.

    2. In Strumenti, Distribuzione, andare su Pacchetti.

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

    4. Selezionare Carica 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 il repository 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 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>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 al repository 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=./repository/ -Dpackaging=zip

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

    Configurare il plugin

    Sono richieste due configurazioni:

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

    • Indicare ad Adobe Experience Manager quando e come utilizzare Phrase configurando l'integrazione per la traduzione.

      Esempio:

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

    Aggiungere Phrase come fornitore di servizi di traduzione

    Seguire questi passaggi:

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

    2. Creare un contenitore di configurazione per ciascun servizio Phrase (ad esempio, uno per la traduzione umana e uno separato per la sola traduzione automatica).

    3. In Cloud Services, andare a Translation Cloud Services.

    4. Espandere la directory conf.

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

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

      • Nome utente e Password (deve avere un ruolo PM con l'opzione Modificare le impostazioni globali del server abilitata nei diritti dell'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 unico progetto Phrase.

        Importante

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

      • Impostare 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. 

      • Generare preventivi 

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

    Se si usano versioni legacy, saranno richieste anche le informazioni su service e submitter portal.

    Configurare l'integrazione per la traduzione

    Quando si usa il plugin Phrase per AEM, tutti i file nei processi di traduzione vengono inviati per la traduzione e quindi restituiti da Phrase. Usare la configurazione del progetto Translation Integration 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 specifica per la traduzione.

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

      • Impostare Translate page assets su Non tradurre.

      • Nella scheda Assets, impostare il flusso di lavoro su Non tradurre.

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

    Applicare l'integrazione per la traduzione ai siti

    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:

    • 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, sarà configurato automaticamente per usare la configurazione cloud associata alla pagina radice.

    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 Siti, navigare alla pagina, selezionarla e aprire il Pannello Riferimenti.

    2. Fare clic su Copie lingua ed espandere la sezione Crea e traduci nella parte inferiore della barra.

    3. Selezionare le lingue di destinazione, facoltativamente deselezionare Seleziona tutte le sottopagine.

    4. Selezionare Crea progetto di traduzione multilingue.

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

    6. Passare al progetto nella sezione Progetti 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 Avvia 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 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 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, 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 restanti passaggi del flusso di lavoro su Nuovo.

    11. Una volta accettato un elemento 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 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 alla lingua di origine che a quella di destinazione.

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

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

    3. Crea un nuovo nodo.

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

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

    Per aggiungere la mappatura della lingua in AEM Cloud Services, seguire 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 trovato 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 progetto

    Una volta inviato un lavoro di traduzione, gli ID progetto e gli UID vengono archiviati 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.

    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 Phrase AEM individua i nodi del lavoro di traduzione tramite un translationObjectID assegnato in fase di runtime. Questo identificatore non esiste come proprietà dell'archivio preesistente, pertanto AEM as a Cloud Service non può indicizzarlo in anticipo e ricorre a un attraversamento completo, che Cloud Manager segnala.

    Aggiungere una definizione di indice Oak/Lucene personalizzato di tipo oak:QueryIndexDefinition, con ambito limitato a /content/projects, con un indice di proprietà su translationObjectID. Distribuire la definizione dell'indice attraverso la pipeline di codice invece di crearlo in fase di runtime, e convalidarlo in un ambiente non di produzione prima di distribuirlo in produzione. Limitare l'indice alla struttura della cartella del progetto nell'istanza AEM, restringendo a cartelle di progetto specifiche ove possibile invece di indicizzare tutto /content/projects, poiché un indice con un ambito troppo ampio può creare un proprio impatto sulle prestazioni. Dopo il deployment, AEM imposta la proprietà reindex della definizione dell'indice su false una volta completata la reindicizzazione. Questo conferma che la reindicizzazione è terminata senza errori e che non sono necessarie 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.