-
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 diversi 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 dell'URL di anteprima
-
Importazione di riferimenti
-
Filtro dei contenuti basato su tag
-
Configurazione dell'anteprima dal vivo
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 di riferimento 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 ID voce.
-
Configura il portale richieste in modo che i richiedenti possano aggiungere file alle richieste direttamente dall'archivio online. Il contenuto è ricercabile tramite 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 Field selection 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 con lo stato inviato vengono prelevate 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:
-
Inviare 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:
-
Scaricare l'applicazione Phrase TMS dal marketplace.
-
Installare l'applicazione nello spazio attivo corrente e selezionare i modelli di contenuto in cui l'applicazione richiede l'installazione.
-
Inserire il token di autenticazione Phrase TMS acquisito durante la creazione del connettore all'interno di Phrase TMS.
-
Fare clic su Installa.
Opzionale - Avvia app (deprecato da Contentful)
Se utilizzi il supporto al flusso di lavoro tramite Launch App 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 necessari 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 la modifica. 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 .
-
Facoltativamente, seleziona la casella di controllo Phrase Contentful App se utilizzi il connettore con l'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. Assicurarsi di copiare il token prima di chiudere la finestra, poiché non sarà più visibile. Questo token verrà utilizzato durante la connessione all'app.
-
Chiudi la finestra e verrà visualizzato .
-
-
Se si utilizzano Contentful Tags per identificare i contenuti traducibili, inserire l'ID del tag e premere Enter.
L'ID viene presentato ed è possibile aggiungerne altri. I tag possono essere utilizzati per limitare i contenuti di Contentful visibili al connettore.
-
Se necessario, selezionare .
-
Se necessario, selezionare (contenuto nidificato).
Vengono visualizzate le . Applicare i filtri desiderati per stabilire un controllo più granulare sul modo in cui 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, selezionare altri valori o specificare 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 dell'entità principale 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 a cui fanno riferimento gli 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 .XLIFF file. Il riquadro dell'CAT Editor elencherà i valori della tassonomia di 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 degli APC e per la reimportazione ed esportazione dei lavori. Se in futuro la destinazione dell'alias viene modificata, gli APC monitoreranno il contenuto nella nuova destinazione e i lavori verranno reimportati/esportati verso la nuova destinazione dell'alias.
Follow aliases si applica solo al monitoraggio degli APC, alla reimportazione e all'esportazione dei lavori del connettore standard. Non si applica alle voci inviate tramite l'app Phrase Contentful. Quando si utilizza l'app, una voce rimane vincolata all'ambiente specifico da cui è stata inviata al momento dell'invio. Ciò vale anche se tale ambiente viene successivamente eliminato o sostituito dietro un alias stabile. Se l'ambiente originale viene eliminato o sostituito, il connettore non rileva la voce nel nuovo ambiente, anche con abilitato. Invia nuovamente la voce da Contentful mentre il nuovo ambiente è attivo in modo che il connettore possa rilevarla.
-
(impostazione predefinita e consigliata)
Gli APC e i lavori creati sono associati all'ambiente a cui l'alias puntava al momento della loro creazione. 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 esso.
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. Aggiungi questo accesso in Contentful in , nella sezione del ruolo. Se l'alias viene successivamente reindirizzato a un ambiente diverso, aggiungere l'accesso anche al nuovo ambiente.
-
-
Se necessario, fornire la .
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 distribuita che renderizza il contenuto di Contentful. Per utilizzare l'anteprima dal vivo, sostituire
contentfulapp.tldnel modello di URL con il dominio effettivo dell'applicazione.Consultare la documentazione di Contentful per ulteriori informazioni sulla configurazione dell'anteprima del contenuto.
Al momento, la lingua non è supportata come placeholder. Per utilizzare le impostazioni locali nell'URL, specificare un valore fisso e creare più istanze del connettore.
-
-
Se necessario, usa per escludere campi specifici da importare in Phrase. Fornisci i ContentID che devono essere esclusi dall'importazione.
-
Fornisci e per (obbligatorio).
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 da monitorare/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 è cambiato. Le voci referenziate vengono recuperate singolarmente anziché in batch, quindi negli spazi con molte voci referenziate, una singola esecuzione può generare un numero elevato di richieste all'API di anteprima e all'API di contenuto 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 fenomeno:
-
Rimuovi il tag di traduzione una volta completata una voce e riaggiungilo solo se necessita di una nuova traduzione.
-
Limita le impostazioni di 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 reinvio è 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 Start over (o utilizzare il reinvio in blocco dalla dashboard dell'app) prima che APC la rilevi e aggiorni l'origine del lavoro esistente. Ciò differisce dai connettori di monitoraggio di file o cartelle, in cui APC rileva automaticamente le modifiche all'origine senza richiedere un reinvio 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 Contentful (Entry-Level) oppure Contentful (Field-Level) e fornisci un nome per il connettore.
-
Selezionare facoltativamente la casella di controllo Phrase Contentful App se si utilizza il connettore con l'app.
-
Token dell'app Contentful
Genera un token dell'app da inserire nell'applicazione Contentful 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 è impostato come lingua predefinita in Contentful, ma DE-DE è richiesto 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 Modalità di importazione delle voci. Il contenuto può utilizzare un campo di riferimento per fare riferimento ad altro contenuto, consentendo la creazione di una gerarchia di entità.
-
Contentful (a livello di 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 dall'archivio 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 escludere dall'importazione in Phrase TMS i campi per cui è abilitata la localizzazione (). 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 origine in 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.
Se necessario, seleziona una dall'elenco a discesa. Questa impostazione locale 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 l' (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 -
{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 portare a un'applicazione distribuita che renderizza il contenuto di Contentful. Per utilizzare l'anteprima live, sostituisci
contentfulapp.tldnel modello di URL con il dominio effettivo dell'applicazione.Consultare la documentazione di Contentful per ulteriori informazioni sulla configurazione dell'anteprima dei contenuti.
Al momento, la lingua non è supportata come placeholder. Per utilizzare il locale 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 ha avuto esito positivo, nella configurazione del connettore apparirà 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 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 .
-
:
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 fa avanzare 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.
-