-
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, fare riferimento a 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 Contentful Marketplace 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.
Il connettore Contentful 2.0 è l'integrazione attuale e preferita che supporta la localizzazione a livello di campo. Offre inoltre:
-
Spazi multipli
-
Alias di ambiente
-
Configurazione URL di anteprima
-
Importazione di riferimenti
-
Filtro dei contenuti basato su tag
-
Configurazione dell'anteprima dal vivo
Localizzazione entry-level (Legacy)
Usa il connettore Contentful (Entry-Level).
Il connettore entry-level funziona solo con tipi di contenuto che dispongono di campi di riferimento localizzati (ad es. 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 es. un campo Text o Rich Text con localizzazione abilitata) e, facoltativamente, di risorse multimediali. Importa le voci referenziate e i relativi campi traducibili (se i campi di riferimento sono localizzati).
Importante
I connettori legacy verranno dismessi 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 dismissione.
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 per ID voce.
-
Configura il portale dei mittenti in modo che i mittenti possano aggiungere file alle richieste direttamente dall'archivio online. Il contenuto è ricercabile per ID voce.
-
Usa la creazione di progetti automatizzata (APC) per creare automaticamente nuovi progetti quando si rileva una modifica nella dimensione del contenuto per i documenti o le cartelle monitorati.
Casi d'uso per l'applicazione:
-
Gli editor di contenuti possono inviare direttamente una voce per la localizzazione dall'interno di Contentful. Ciò consente agli editor o ai manager di contenuti di avere il pieno controllo sul flusso di localizzazione e di ricevere aggiornamenti di stato in tempo reale durante la visualizzazione di una voce.
Una volta finalizzata 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 campo 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 del lavoro.
-
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 nella copia originale.
-
-
Gli editor di contenuti possono utilizzare la schermata iniziale di Phrase TMS per:
-
Invia le voci in blocco.
-
Specificare le singole lingue di destinazione durante l'invio in blocco.
-
Avere una panoramica dei lavori di traduzione attivi.
-
Impostazioni Contentful
Quando si lavora con l'applicazione Phrase TMS:
-
Scarica l'applicazione Phrase TMS dal marketplace.
-
Installa l'applicazione nello spazio attivo corrente e seleziona i modelli di contenuto in cui è richiesta l'installazione.
-
Inserisci il token di autenticazione Phrase TMS acquisito durante la creazione del connettore all'interno di Phrase TMS.
-
Fare clic su Installa.
Opzionale - Avvia l'app (deprecata da Contentful)
Se utilizzi il supporto al flusso 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 sono richiesti approcci diversi per i tipi di contenuto, contatta il Customer Success Manager dedicato.
-
Configura il flusso di lavoro di localizzazione richiesto.
-
Seleziona il tipo o i tipi di contenuto che seguono il flusso di lavoro descritto.
Se i flussi di lavoro in un connettore sono impostati, la Creazione automatica di progetti (APC) creerà automaticamente nuovi progetti quando viene rilevata una modifica nei 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 .
-
Cambia il Tipo in 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.
-
Fornisci i dettagli di accesso e fai clic su Accedi (o utilizza metodi di accesso alternativi). La finestra di accesso si chiude e viene visualizzato .
-
Seleziona facoltativamente la casella di controllo Phrase Contentful App se utilizzi il connettore con l'app.
-
Fai clic su Generate token.
Si apre la finestra .
-
Fai clic su Generate token.
Viene generato un token che deve essere copiato negli appunti o in un file di testo. Assicurati che il token sia copiato prima di chiudere la finestra, poiché non sarà più visibile. Questo token verrà utilizzato durante la connessione all'app.
-
Chiudi la finestra e vedrai .
-
-
Se si utilizzano Contentful Tags per identificare i contenuti traducibili, inserire un ID tag e premere Enter.
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 (contenuto nidificato).
Vengono visualizzate le . Applica i filtri desiderati per avere un controllo più granulare su come il sistema attraversa le relazioni tra i contenuti.
-
Limita la profondità con cui Phrase segue le voci di riferimento durante l'importazione.
Il valore predefinito è 10,000. Se necessario, seleziona altri valori o specifica un valore intero personalizzato.
-
Seleziona se interrompere o seguire le voci il cui tipo di contenuto corrisponde all'elenco specificato.
-
Escludi le voci il cui tipo di contenuto padre corrisponde all'elenco specificato.
-
Seleziona se interrompere o seguire le voci che hanno uno qualsiasi dei tag di contenuto specificati.
-
Seleziona se interrompere o seguire le voci che sono referenziate dagli ID campo specificati.
-
-
Se necessario, seleziona .
Viene visualizzato il campo . Inserisci un valore per abilitare l'impostazione della tassonomia.
-
Quando selezionato, 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.
-
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 il contesto di funzionalità/schermata, si consiglia di lasciare la tassonomia disabilitata per ottimizzare le prestazioni durante l'esportazione .XLIFF.
-
-
Se necessario, seleziona .
L'alias viene utilizzato per tutto il monitoraggio APC e per le reimportazioni/esportazioni dei job. Se la destinazione dell'alias viene modificata in futuro, APC monitora il contenuto nella nuova destinazione e i job verranno reimportati/esportati da/verso la nuova destinazione dell'alias.
-
(predefinito e consigliato)
Gli APC e i job creati sono legati all'ambiente a cui l'alias puntava al momento della creazione del job/APC. Gli APC monitorano solo quell'ambiente e quel contenuto; i job vengono esportati e reimportati in quell'ambiente.
-
Gli APC e i job creati sono legati all'alias stesso. Gli APC monitorano solo quell'alias e quel contenuto; i job vengono esportati e reimportati in quell'alias.
Se la destinazione dell'alias viene modificata, gli APC monitorano la nuova destinazione dell'alias (ambiente); i job verranno ora esportati e reimportati in quella destinazione.
I ruoli personalizzati di Contentful 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. Aggiungere 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 richiesto, fornisci il .
Questo è il modello di URL che porta al contenuto renderizzato da Contentful. Sono supportati i seguenti placeholder:
-
env_id: ID ambiente
-
ID voce ID voce
-
ID spazio 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 distribuita che renderizza il contenuto di Contentful. Per utilizzare l'anteprima dal vivo, 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 le impostazioni locali nell'URL, specifica un valore fisso e crea più istanze del connettore.
-
-
Se necessario, utilizza per escludere campi specifici dall'importazione in Phrase. Fornisci gli ID contenuto (ContentID) da omettere dall'importazione.
-
Fornisci e per (obbligatorio).
L'API di anteprima richiede un token di accesso di 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).
-
Selezionare ogni spazio e ambiente da monitorare/da cui importare da Contentful.
-
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 tracciata e i suoi riferimenti a ogni esecuzione, poiché Contentful non segnala quale locale è stato modificato. Le voci referenziate vengono recuperate singolarmente anziché in batch, pertanto negli spazi con molte voci referenziate, una singola esecuzione può 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 la sua origine non è cambiata. Negli spazi ad alto volume, ciò può rallentare le esecuzioni di 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 riaggiungilo solo se necessita di una nuova traduzione.
-
Limita le impostazioni solo alle voci che necessitano di traduzione.
-
Utilizza l'app Phrase Contentful, che monitora solo le voci inviate tramite essa.
Le voci precedentemente tradotte possono essere reinviate dopo modifiche nella copia originale. Il re-invio è manuale quando si utilizza l'app Phrase Contentful: un editor deve aprire la voce in Contentful, aprire la barra laterale dell'app Phrase e fare clic su Ricomincia (o utilizzare il re-invio in blocco dalla dashboard dell'app) prima che APC la rilevi e aggiorni l'origine del job esistente. Questo differisce dai connettori di monitoraggio di file o cartelle, in cui APC rileva automaticamente le modifiche all'origine senza richiedere un re-invio manuale.
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 applicare l'autenticazione richiesta per la creazione o il salvataggio del 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 .
-
Modifica il Tipo in uno tra Contentful (a livello di voce) oppure Contentful (a livello di campo) e fornisci un nome per il connettore.
-
Seleziona facoltativamente la casella di controllo Phrase Contentful App se si utilizza il connettore con l'app.
-
Token per 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 di origine per sovrascrivere la lingua predefinita di Contentful. Il connettore estrarrà quindi il contenuto dalla lingua impostata nella configurazione del connettore.
Esempio:
Se EN-US è impostata come lingua predefinita in Contentful, ma DE-DE è richiesta come lingua di origine per la localizzazione in uno spazio o modello di contenuto specifico, la configurazione può essere regolata in modo che lo spazio (cartella remota) estragga il contenuto da DE-DE invece che da EN-US.
Nota
Non applicabile quando si utilizza l'applicazione.
-
-
Seleziona come elaborare il contenuto nidificato tramite Entry import mode. Il contenuto può utilizzare un campo di riferimento per fare riferimento ad altro contenuto, consentendo la creazione di una gerarchia di entità.
-
Contentful (livello voce)
Il connettore a livello di voce attraversa automaticamente l'intera gerarchia del contenuto nidificato.
-
Contentful (a livello di campo)
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 del contenuto nidificato e importa tutti i campi traducibili per la traduzione.
-
-
-
-
Crea un elenco separato da virgole in Ometti campi traducibili per omettere dall'importazione in Phrase TMS i campi selezionati per . Utilizza 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 origine nella destinazione se i campi elencati devono contenere i valori di origine. Questa impostazione sarà applicata a tutte le voci elencate.
-
-
Seleziona se mancano dati per un determinato campo nella lingua di origine.
Seleziona una dall'elenco a discesa, se necessario. Questa impostazione locale della lingua verrà utilizzata in caso di dati mancanti.
Nota
Non esiste alcuna relazione tra la lingua di fallback di Contentful e questa impostazione.
-
Se necessario, fornisci il (BETA).
Questo è il modello di URL che porta al contenuto renderizzato da Contentful. Sono supportati i seguenti placeholder:
-
env_id: ID ambiente
-
entry.sys.id: ID voce
-
ID spazio 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 portare a un'applicazione distribuita che renderizza il contenuto di Contentful. Per utilizzare l'anteprima live, sostituire
contentfulapp.tldnel modello di URL con il dominio effettivo dell'applicazione.Consultare la documentazione di Contentful per ulteriori informazioni sulla configurazione dell'anteprima contenuti.
Al momento, la lingua non è supportata come placeholder. Per utilizzare il locale nell'URL, specificare un valore fisso e creare più istanze del connettore.
-
-
Se il team di supporto tecnico richiede la registrazione delle informazioni di debug, seleziona .
-
Fai clic su Connetti a Contentful.
Un segno di spunta apparirà nella configurazione del connettore se la connessione è riuscita. 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 di origine.
Nota
Questa lingua deve corrispondere al locale predefinito dello spazio Contentful configurato nelle impostazioni locali di Contentful.
-
Clicca su Salva.
Il connettore viene aggiunto all'elenco nella pagina .
-
Facoltativamente, modifica il connettore per selezionare i .
-
Traduci articoli da
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 avanza 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 alla fase selezionata (ad es. Traduzioni completate) quando la traduzione viene esportata.
Nota
Il supporto per il flusso di lavoro è stato interrotto da Contentful il 1 giugno 2023. L'uso continuato non è supportato.
-
Elimina un connettore
Per eliminare un connettore:
-
Dalla pagina , seleziona il connettore da eliminare.
-
Fai clic su Elimina.
Si apre la finestra .
-
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 tale connettore restituisce un errore "Impossibile eliminare il connettore".
Risoluzione: Apri il progetto associato al connettore e completa o elimina tutti i lavori rimanenti. Vai in e svuotalo per rimuovere eventuali lavori ancora collegati al connettore. Riprova a eliminare il connettore.