-
Piani Business ed Enterprise (non disponibili per i piani LSP)
Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.
-
Piano Enterprise (legacy)
Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.
Consiglio
Per informazioni sull'integrazione di Contentful in Phrase Strings, consulta Contentful (Strings).
Contentful fornisce un'infrastruttura di gestione dei contenuti headless per creare, gestire e distribuire contenuti su qualsiasi piattaforma o dispositivo. Phrase si integra con Contentful in due modi:
-
Tramite un connettore Contentful dedicato (2.0, Entry-Level, Field-Level)
Il connettore Contentful 2.0 supporta attualmente l'autenticazione solo tramite il Data Center statunitense.
-
Tramite il plugin del Marketplace di Contentful per un'esperienza personalizzata
Nota
Il connettore non supporta la traduzione di oggetti JSON.
Metodi di localizzazione supportati
Contentful supporta molteplici metodi di localizzazione. Consulta la documentazione di Contentful per una descrizione dettagliata dei metodi.
Il connettore Contentful 2.0 è l'integrazione più recente e consigliata e supporta la localizzazione a livello di campo. Offre inoltre:
-
Spazi multipli
-
Alias di ambiente
-
Configurazione dell'URL di anteprima
-
Importazione di riferimenti
-
Filtro dei contenuti basato su tag
-
Configurazione dell'anteprima in tempo reale
Localizzazione a livello di voce (Legacy)
Usa il connettore Contentful (Entry-Level).
Il connettore a livello di voce funziona solo con tipi di contenuto che dispongono di campi di riferimento localizzati (ad esempio, un campo reference denominato Localized abilitato per la localizzazione).
Localizzazione a livello di campo (Legacy)
Usa il connettore Contentful (Field-Level).
Il connettore a livello di campo funziona solo con tipi di contenuto che dispongono di un campo traducibile (ad esempio, un campo Text o Rich Text con localizzazione abilitata) e, facoltativamente, di risorse multimediali. Importa le voci referenziate e i loro campi traducibili (se i campi di riferimento sono localizzati).
Importante
I connettori legacy verranno deprecati il 30 novembre 2026. È possibile creare nuove istanze di questi connettori fino al 17 agosto 2026. Esegui la migrazione al nuovo connettore prima della data di deprecazione.
Consulta Legacy Connector Deprecation per una guida completa alla migrazione.
Ci sono una serie di casi d'uso per il connettore:
-
I project manager possono aggiungere file direttamente ai progetti da un archivio online. Il contenuto è ricercabile tramite l'ID della voce.
-
Configura il portale dei mittenti in modo che i mittenti possano aggiungere file alle richieste direttamente dall'archivio online. Il contenuto è ricercabile tramite l'ID della voce.
-
Usa la creazione automatizzata di progetti (APC) per creare automaticamente nuovi progetti quando viene rilevata una modifica della dimensione del contenuto di documenti monitorati o di una cartella monitorata.
Casi d'uso per l'applicazione:
-
Gli editor di contenuti possono inviare una voce per la localizzazione direttamente da Contentful. In questo modo, gli editor o i responsabili dei contenuti possono controllare l'intero processo di localizzazione e visualizzare aggiornamenti sullo stato in tempo reale mentre consultano una voce.
Una volta completata la voce:
-
Seleziona le lingue di destinazione desiderate per la localizzazione.
-
Invia solo la voce con le lingue selezionate a Phrase TMS o usa la scheda Selezione dei campi per selezionare i campi.
-
Se non viene selezionato alcun campo, tutti i campi localizzabili vengono inviati per la traduzione.
-
Se viene selezionato un campo non localizzabile, tale campo non verrà comunque inviato per la traduzione. Vengono inviati solo i campi localizzabili.
-
Se vengono selezionati solo alcuni campi localizzabili, solo tali campi verranno inviati per la traduzione.
-
-
In base alle impostazioni APC, i lavori vengono creati automaticamente dal contenuto inviato. Durante le esecuzioni APC, solo le voci nello stato inviato vengono selezionate per la creazione dei lavori.
-
Una volta creati i lavori da una voce inviata, lo stato cambia in in corso. Quando le traduzioni vengono reinviate a Contentful, lo stato cambia in completato.
-
Le voci precedentemente tradotte possono essere reinviate dopo modifiche nel testo originale.
-
-
Gli editor di contenuti possono utilizzare la schermata iniziale di Phrase TMS per:
-
Inviare voci in blocco.
-
Specificare le singole lingue di destinazione durante l'invio in blocco.
-
Avere una panoramica dei lavori di traduzione attivi.
-
Impostazioni di Contentful
Se usi l'applicazione Phrase TMS:
-
Scarica l'applicazione Phrase TMS dal marketplace.
-
Installa l'applicazione nello spazio attivo e seleziona i modelli di contenuto in cui vuoi installarla.
-
Inserisci il token di autenticazione Phrase TMS ottenuto durante la creazione del connettore in Phrase TMS.
-
Fai clic su Installa.
Facoltativo: app Launch (deprecata da Contentful)
Se usi il supporto per i flussi di lavoro tramite l'app Launch di Contentful, segui questi passaggi:
-
Installa l'applicazione Launch di Contentful in uno o più spazi.
Nota
È possibile creare un solo flusso di lavoro per spazio. Se all'interno di uno spazio Contentful hai bisogno di approcci diversi per i vari tipi di contenuto, contatta il Customer Success Manager dedicato.
-
Configura il flusso di lavoro di localizzazione richiesto.
-
Seleziona i tipi di contenuto a cui si applica il flusso di lavoro descritto.
Se in un connettore sono configurati flussi di lavoro, la creazione automatizzata di progetti (APC) crea nuovi progetti quando rileva una modifica ai passaggi del flusso di lavoro per gli articoli o i tipi di contenuto monitorati.
I lavori inviati possono essere annullati, consentendo di inviare nuovamente il contenuto dopo aver apportato le modifiche. Questi lavori continueranno a esistere in Phrase e dovranno essere eliminati da un project manager.
Nota
L'app Launch di Contentful non è supportata nel connettore 2.0.
-
Dalla pagina Impostazioni
, scorri verso il basso fino alla sezione .
-
Fai clic su Connettori.
Si apre la pagina .
-
Fai clic su Nuovo connettore.
Si apre la pagina .
-
Imposta Tipo su Contentful 2.0.
-
Fornisci un nome per il connettore.
-
Fai clic su Connetti a Contentful 2.0.
Si apre la finestra di accesso di Contentful.
-
Inserisci i dettagli di accesso e fai clic su Accedi (o utilizza metodi di accesso alternativi). La finestra di accesso si chiude e viene visualizzato .
-
Se usi il connettore con l'app, puoi selezionare la casella di controllo Phrase Contentful App.
-
Fai clic su Genera token.
Si apre la finestra .
-
Fai clic su Genera token.
Viene generato un token che deve essere copiato negli appunti o in un file di testo. Assicurati di copiare il token prima di chiudere la finestra, poiché non sarà più visibile. Questo token verrà utilizzato nelle per connettere l'app.
-
Chiudi la finestra: verrà visualizzato .
-
-
Se usi i tag di Contentful per identificare i contenuti traducibili, inserisci l'ID di un tag e premi Invio.
L'ID viene visualizzato ed è possibile aggiungerne altri. I tag possono essere utilizzati per limitare i contenuti di Contentful visibili al connettore.
-
Se necessario, seleziona .
-
Se necessario, seleziona (contenuti nidificati).
Vengono visualizzate le . Applica i filtri desiderati per controllare con maggiore precisione il modo in cui il sistema attraversa le relazioni tra i contenuti.
-
Limita la profondità con cui Phrase segue i riferimenti alle voci durante l'importazione.
Il valore predefinito è 10.000. Se necessario, seleziona altri valori o specifica un valore intero personalizzato.
-
Seleziona se fermarti alle voci il cui tipo di contenuto corrisponde all'elenco specificato o se seguirle.
-
Escludi le voci il cui tipo di contenuto padre corrisponde all'elenco specificato.
-
Seleziona se fermarti alle voci a cui è associato almeno uno dei tag di contenuto specificati o se seguirle.
-
Seleziona se fermarti alle voci a cui fanno riferimento gli ID dei campi specificati o se seguirle.
-
-
Se necessario, seleziona .
Viene visualizzato il campo . Inserisci un valore per abilitare l'impostazione della tassonomia.
-
Se selezioni questa opzione, il connettore recupera le tassonomie da Contentful e le include nel file .XLIFF. Il riquadro dell'editor CAT elencherà i valori della tassonomia Contentful per ogni segmento. I valori della tassonomia non sono contenuti traducibili. Non possono essere elencati, importati o esportati come lavoro a sé stante, né da soli né insieme a una voce.
-
Se i metadati della tassonomia non sono disponibili o il connettore non è configurato con essi, il riquadro viene semplicemente omesso.
-
Se un progetto non richiede informazioni contestuali sulle funzionalità o sulle schermate, ti consigliamo di lasciare disabilitata la tassonomia per ottimizzare le prestazioni durante l'esportazione del file .XLIFF.
-
-
Se necessario, seleziona .
L'alias viene utilizzato per tutto il monitoraggio APC e per le reimportazioni e le esportazioni dei lavori. Se la destinazione dell'alias cambia, APC monitora il contenuto nella nuova destinazione e i lavori vengono reimportati da tale destinazione ed esportati verso di essa.
Segui alias si applica al monitoraggio APC, alla reimportazione dei lavori e all'esportazione dei lavori. Si applica anche alle voci inviate tramite l'app Phrase Contentful da un URL alias. L'app registra l'alias al momento dell'invio, in modo che il connettore trovi queste voci dopo la modifica della destinazione dell'alias. Le voci inviate mentre l'alias puntava a un ambiente precedente rimangono visibili al connettore. Ogni voce viene comunque esportata e reimportata nell'ambiente da cui è stata inviata.
Un connettore che segue un alias non trova le voci inviate dall'URL dell'ambiente specifico anziché dall'URL dell'alias. Inoltre, non trova le voci inviate tramite l'app prima che venisse aggiunto il supporto per gli alias. Invia nuovamente queste voci da Contentful tramite l'URL dell'alias.
-
(predefinito e consigliato)
Gli APC e i lavori creati sono legati all'ambiente a cui l'alias puntava al momento della creazione del lavoro o dell'APC. Gli APC monitorano solo quell'ambiente e quel contenuto; i lavori vengono esportati e reimportati in esso.
-
Gli APC e i lavori creati sono legati all'alias stesso. Gli APC monitorano solo quell'alias e quel contenuto; i lavori vengono esportati e reimportati in esso.
Se la destinazione dell'alias viene modificata, gli APC monitorano la nuova destinazione dell'alias (ambiente); i lavori verranno ora esportati e reimportati in essa.
Per le voci inviate tramite l'app Phrase Contentful, i lavori vengono esportati e reimportati nell'ambiente da cui la voce è stata inviata.
I ruoli Contentful personalizzati richiedono l'accesso diretto allo specifico ambiente sottostante a cui punta l'alias, non solo all'alias stesso, altrimenti la dashboard dell'app Phrase TMS non verrà caricata. Aggiungi questo accesso in Contentful in , nella sezione del ruolo. Se l'alias viene successivamente reindirizzato a un ambiente diverso, aggiungi l'accesso anche al nuovo ambiente.
-
-
Se necessario, fornisci l'.
Questo è il modello di URL che porta al contenuto renderizzato da Contentful. Sono supportati i seguenti placeholder:
-
{env_id}: ID ambiente -
{entry.id}: ID voce -
{space_id}: ID spazio
Un modello di URL può avere questo aspetto:
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}
Nota
L'URL deve portare a un'applicazione pubblicata che mostra i contenuti di Contentful. Per utilizzare l'anteprima in tempo reale, sostituisci
contentfulapp.tldnel modello di URL con il dominio effettivo dell'applicazione.Consulta la documentazione di Contentful per ulteriori informazioni sulla configurazione dell'anteprima dei contenuti.
Al momento, la lingua non è supportata come placeholder. Per utilizzare la lingua nell'URL, specifica un valore fisso e crea più istanze del connettore.
-
-
Se necessario, utilizza per escludere campi specifici dall'importazione in Phrase. Fornisci i ContentID da escludere dall'importazione.
-
Fornisci e per (obbligatori).
L'API di anteprima richiede un token di accesso Contentful denominato che deve essere configurato nelle impostazioni API dello spazio Contentful.
L'integrazione Contentful 2.0 utilizza questa API per importare contenuti e monitorare le modifiche (APC).
-
Seleziona ogni spazio e ambiente di Contentful da monitorare o da cui importare contenuti.
-
La configurazione e l'accesso sono gestiti all'interno di Contentful stesso.
-
-
Clicca su Salva.
Il connettore viene aggiunto all'elenco nella pagina .
Nota
Il monitoraggio APC ricontrolla l'intero contenuto di una voce monitorata e i suoi riferimenti a ogni esecuzione, poiché Contentful non segnala quale lingua è stata modificata. Le voci a cui si fa riferimento vengono recuperate singolarmente anziché in batch. Negli spazi che contengono molte di queste voci, una singola esecuzione può quindi generare un numero elevato di richieste all'API di anteprima e all'API dei contenuti di Contentful. Per questo motivo, una voce può essere reimportata dopo aver ricevuto una traduzione anche se il suo testo originale non è cambiato. Negli spazi ad alto volume, ciò può rallentare le esecuzioni APC e aumentare significativamente l'utilizzo dell'API di Contentful.
Per ridurre questo problema:
-
Rimuovi il tag di traduzione una volta completata una voce e aggiungilo di nuovo solo se la voce richiede una nuova traduzione.
-
Limita le impostazioni delle alle sole voci che richiedono una traduzione.
-
Usa l'app Phrase Contentful, che monitora solo le voci inviate tramite l'app.
Le voci precedentemente tradotte possono essere reinviate dopo modifiche nel testo originale. Quando usi l'app Phrase Contentful, il reinvio è manuale: un redattore deve aprire la voce in Contentful, aprire la barra laterale dell'app Phrase e fare clic su Ricomincia (oppure reinviare le voci in blocco dalla dashboard dell'app). Solo allora l'APC rileva la voce e aggiorna il testo originale del lavoro esistente. A differenza dei connettori che monitorano file o cartelle, APC rileva automaticamente le modifiche ai contenuti di origine, senza richiedere un nuovo invio manuale.
Un connettore Contentful 2.0 appartiene alla tua organizzazione, non a un singolo utente. Il token OAuth di Contentful utilizzato dal connettore è legato all'utente che lo ha autorizzato.
Per collegare il connettore a un altro utente Contentful, rimuovi il token OAuth esistente in modo che il nuovo utente possa autorizzare nuovamente il connettore:
-
Accedi con l'account Contentful che ha creato il token e apri la pagina dei token API dello spazio interessato (https://app.contentful.com/spaces/{space_id}/api/cma_tokens).
-
Elimina il token denominato "Memsource Connector". Se più token hanno questo nome, verifica quale viene utilizzato dal connettore interessato prima di eliminarlo.
-
Una volta eliminato il token, il connettore viene disattivato finché il nuovo utente non lo riautorizza dalle impostazioni del connettore in Phrase TMS.
Completa questi passaggi prima che l'utente originale perda l'accesso a Contentful, altrimenti il token potrebbe non essere più visibile.
Importante
Se accedi da un dominio personalizzato (es. mydomain.phrase.jp), apri una finestra del browser in incognito e accedi tramite cloud.memsource.com o us.cloud.memsource.com per effettuare l'autenticazione necessaria per creare o salvare il connettore. Dopo il salvataggio, è possibile accedere al connettore tramite il dominio personalizzato.
-
Dalla pagina Impostazioni
-
Fai clic su Connettori.
Si apre la pagina .
-
Fai clic su Nuovo connettore.
Si apre la pagina .
-
Imposta il Tipo su Contentful (Entry-Level) o Contentful (Field-Level) e assegna un nome al connettore.
-
Se usi il connettore con l'app, seleziona facoltativamente la casella di controllo Phrase Contentful App.
-
Token dell'app Contentful
Genera un token dell'app da inserire nell'applicazione Contentful di Phrase TMS. Salva il connettore dopo aver generato il token e averlo copiato nell'app Contentful.
Nota
Una volta salvato, il token non può essere modificato dall'interno di Contentful. Per aggiornarlo, revoca il token dalla configurazione del connettore in Phrase TMS e generane uno nuovo.
-
-
Configura le impostazioni indipendenti dalla lingua.
-
Lingua di origine
Seleziona una lingua sorgente per sovrascrivere la lingua predefinita di Contentful. Il connettore estrarrà quindi i contenuti nella lingua impostata nella configurazione del connettore.
Esempio:
Se EN-US è impostata come lingua predefinita in Contentful, ma DE-DE è richiesta come lingua sorgente per la localizzazione in uno spazio o in un modello di contenuto specifico, la configurazione può essere modificata in modo che lo spazio (cartella remota) estragga i contenuti in DE-DE anziché in EN-US.
Nota
Non applicabile quando si utilizza l'applicazione.
-
-
Seleziona come elaborare i contenuti nidificati tramite Modalità di importazione delle voci. Un contenuto può includere un campo che fa riferimento ad altri contenuti, creando così una gerarchia di entità.
-
Contentful (Entry-Level)
Il connettore a livello di voce attraversa automaticamente l'intera gerarchia dei contenuti nidificati.
-
Contentful (Field-Level)
Seleziona come il connettore a livello di campo deve importare il contenuto nidificato.
-
-
Il contenuto selezionato esplicitamente durante l'aggiunta dal repository viene importato.
-
Le modifiche rilevate da APC vengono importate per la traduzione.
-
-
Importa voci referenziate
-
Il connettore attraversa l'intera gerarchia dei contenuti nidificati e importa tutti i campi traducibili per la traduzione.
-
-
-
-
Crea un elenco separato da virgole in Ometti campi traducibili per escludere dall'importazione in Phrase TMS i campi per i quali è selezionata l'opzione . Usa la seguente struttura:
contentTypeID:fieldID.-
Seleziona Lascia vuoti i campi omessi se i campi elencati devono essere lasciati vuoti. Questa impostazione sarà applicata a tutte le voci elencate.
-
Seleziona Copia sorgente in destinazione se i campi elencati devono contenere i valori sorgente. Questa impostazione sarà applicata a tutte le voci elencate.
-
-
Seleziona se mancano dati per un determinato campo nella lingua sorgente.
Seleziona una dall'elenco a discesa, se necessario. Questa variante linguistica verrà utilizzata se mancano dei dati.
Nota
Non esiste alcuna relazione tra la lingua di fallback di Contentful e questa impostazione.
-
Se necessario, fornisci l' (BETA).
Si tratta del modello di URL che consente di visualizzare i contenuti di Contentful nell'applicazione. Sono supportati i seguenti placeholder:
-
{env_id}: ID ambiente -
{entry.sys.id}: ID voce -
{space_id}: ID spazio
Un modello di URL può avere questo aspetto:
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
Nota
L'URL deve puntare a un'applicazione pubblicata che visualizzi i contenuti di Contentful. Per utilizzare l'anteprima live, sostituisci
contentfulapp.tldnel modello di URL con il dominio effettivo dell'applicazione.Consulta la documentazione di Contentful per ulteriori informazioni sulla configurazione dell'anteprima dei contenuti.
Al momento, la lingua non è supportata come placeholder. Per utilizzare la variante linguistica nell'URL, specifica un valore fisso e crea più istanze del connettore.
-
-
Se il team di supporto tecnico richiede la registrazione delle informazioni di debug, seleziona .
-
Fai clic su Connetti a Contentful.
Se la connessione riesce, nella configurazione del connettore compare un segno di spunta. In caso contrario, appare un punto esclamativo rosso. Passa il cursore sopra l'icona per visualizzare maggiori dettagli.
-
Solo Contentful (Entry-Level):
Imposta la Lingua sorgente.
Nota
Questa lingua deve corrispondere all'impostazione locale predefinita dello spazio Contentful, configurata nelle impostazioni delle lingue di Contentful.
-
Clicca su Salva.
Il connettore viene aggiunto all'elenco nella pagina .
-
Se necessario, modifica il connettore per selezionare .
-
:
Il connettore controlla gli articoli nella fase selezionata (ad esempio "Traduzione"). L'autore può applicare questa etichetta agli articoli quando sono pronti per essere tradotti.
All'importazione da Contentful:
-
Il connettore porta il flusso di lavoro alla fase selezionata (ad es. Traduzione in corso) quando gli articoli di origine vengono scaricati.
All'esportazione in Contentful:
-
Il connettore imposta la fase del flusso di lavoro degli articoli di origine su quella selezionata (ad es. Traduzioni completate) quando la traduzione viene esportata.
Nota
Il supporto per i flussi di lavoro è stato interrotto da Contentful il 1 giugno 2023. L'ulteriore utilizzo non è supportato.
-