Contentful (TMS)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Disponibile per

Piani Business ed Enterprise (non disponibili per i piani LSP)

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.

Consiglio

Per informazioni sull'integrazione di Contentful in Phrase Strings, fare riferimento a Contentful (Strings).

Contentful fornisce un'infrastruttura di gestione del contenuto headless per creare, gestire e distribuire contenuto su qualsiasi piattaforma o dispositivo. Phrase si integra con Contentful in due modi:

Tramite un connettore Contentful dedicato (2.0, a livello di voce, a livello di campo)

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. Vedere la documentazione 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 riferimento
Filtro del contenuto basato su tag
Configurazione dell'anteprima live

Localizzazione a livello di voce (Legacy)

Usare il connettore Contentful (Entry-Level).

Il connettore entry-level funziona solo con tipi di contenuto che dispongono di campi di riferimento localizzati (ad esempio, un campo riferimento chiamato Localized abilitato per la localizzazione).

Localizzazione a livello di campo (legacy)

Usare 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 Media Assets. Importa le voci a cui si fa riferimento e i relativi campi traducibili (se i campi di riferimento sono localizzati).

Importante

I connettori legacy saranno deprecati il 30 novembre 2026. È possibile creare nuove istanze di questi connettori fino al 17 agosto 2026. Eseguire la migrazione al nuovo connettore prima della data di deprecazione.

Consultare Legacy Connector Deprecation per una guida completa alla migrazione.

Casi d'uso

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.
Configurare il portale richieste in modo che i richiedenti possano aggiungere file alle richieste direttamente dall'archivio online. Il contenuto è ricercabile tramite ID voce.
Usare 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:

I redattori di contenuto possono inviare direttamente una voce per la localizzazione dall'interno di Contentful. Ciò consente ai redattori o ai manager di contenuto 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 che la voce è stata finalizzata:
- Selezionare le lingue di destinazione desiderate per la localizzazione.
- Inviare solo la voce con le lingue selezionate a Phrase TMS o usare 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 nello stato inviato vengono selezionate per la creazione del lavoro.
- Una volta creati i lavori da una voce inviata, lo stato cambia in in avanzamento. 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 contenuto possono usare la schermata Home di Phrase TMS per:
- Inviare voci in blocco.
- Specificare le lingue di destinazione individuali 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 l'applicazione richiede l'installazione.
Inserisci il token di autenticazione Phrase TMS acquisito durante la creazione del connettore all'interno di Phrase TMS.
Fai clic su Installa.

Opzionale - Avvia app (deprecato da Contentful)

Se si utilizza il supporto del flusso di lavoro tramite la Launch App di Contentful, seguire questi passaggi:

Installare l'applicazione Launch di Contentful in uno o più spazi.

Nota

È possibile creare solo un flusso di lavoro per spazio. Se all'interno di uno spazio Contentful sono richiesti approcci diversi per i tipi di contenuto, contattare il Customer Success Manager dedicato.
Configurare il flusso di lavoro di localizzazione richiesto.
Selezionare il tipo o i tipi di contenuto che seguono il flusso di lavoro descritto.

Se i flussi di lavoro in un connettore sono impostati, l'APC (Automated Project Creation) creerà automaticamente nuovi progetti quando viene rilevata una modifica nei passaggi del flusso di lavoro per articoli o tipi di contenuto monitorati.

I lavori inviati possono essere annullati, consentendo al contenuto di essere reinviato dopo aver apportato le modifiche. Questi lavori esisteranno ancora in Phrase e dovranno essere eliminati da un project manager.

Impostazioni Phrase TMS (Contentful 2.0)

Nota

La Contentful Launch App non è supportata nel connettore 2.0.

Dalla pagina Impostazioni, scorri verso il basso fino alla sezione Integrazioni.
Fai clic su Connettori.

Si apre la pagina Connettori.
Fare clic su Nuovo connettore.

Si apre la pagina Creare connettore.
Modificare il Tipo in Contentful 2.0.
Fornire un nome per il connettore.
Fare clic su Connetti a Contentful 2.0.

Si apre la finestra di accesso di Contentful.
Fornire i dettagli di accesso e fare clic su Accedi (o usare metodi di accesso alternativi). La finestra di accesso si chiude e viene visualizzato Connesso.
Facoltativamente, selezionare la casella di controllo Phrase Contentful App se si usa il connettore con l'app.
1. Fare clic su Genera token.
  
  Si apre la finestra Genera token Contentful.
2. Fare clic su Genera token.
  
  Viene generato un token che deve essere copiato negli appunti o in un file di testo. Assicurarsi che il token venga copiato prima di chiudere la finestra, poiché non sarà più visibile. Questo token verrà utilizzato durante la connessione all'app.
3. Chiudere la finestra e viene visualizzato Token generato.
Se i tag Contentful vengono utilizzati per identificare il contenuto traducibile, inserire un ID tag e premere Invio.

L'ID viene presentato ed è possibile aggiungerne altri.
- Seleziona strategia di elenco
  - Con tutti i tag
    
    Visualizza il contenuto all'interno di Contentful con tutti i tag elencati.
  - Con almeno un tag
    
    Visualizza il contenuto da Contentful con almeno uno dei tag elencati.
Se necessario, selezionare per Includere risorse.
Se necessario, selezionare Includere entità di riferimento (contenuto nidificato).

Vengono visualizzate le impostazioni entità di riferimento. Applicare i filtri desiderati per stabilire un controllo più granulare su come il sistema attraversa le relazioni del contenuto.
- Imposta la profondità di importazione per le voci collegate
  
  Limita la profondità con cui Phrase segue le entità di riferimento durante l'importazione.
  
  Il valore predefinito è 10.000. Se necessario, selezionare altri valori o specificare un valore intero Personalizzato.
- Tipo di contenuto
  
  Selezionare se interrompere o seguire le entità il cui tipo di contenuto corrisponde all'elenco specificato.
- Tipi di contenuto principale
  
  Escludere le entità il cui tipo di contenuto dell'entità principale corrisponde all'elenco specificato.
- Tag
  
  Seleziona se interrompere o seguire le voci che presentano uno dei tag di contenuto specificati.
- ID campo
  
  Seleziona se interrompere o seguire le voci a cui fanno riferimento gli ID campo specificati.
Se richiesto, seleziona Include taxonomy.

Viene visualizzato il campo Contentful Organization ID. 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 nota di contesto del CAT Editor 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 nota di contesto 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'esportare .XLIFF.
Se richiesto, seleziona Follow aliases.

L'alias viene utilizzato per tutto il monitoraggio APC e per le reimportazioni/esportazioni dei lavori. Se la destinazione dell'alias viene modificata in futuro, APC monitora il contenuto nella nuova destinazione e i lavori verranno reimportati/esportati da/verso la nuova destinazione dell'alias.
- Disabled (impostazione predefinita e consigliata)
  
  Gli APC e i lavori creati sono legati all'ambiente a cui l'alias puntava al momento della creazione del lavoro/APC. Gli APC monitorano solo quell'ambiente e quel contenuto; i lavori vengono esportati e reimportati in esso.
- Abilitato
  
  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.
Se richiesto, fornisci l'Preview URL.

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ò apparire così:

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}

Nota

L'URL deve condurre a un'applicazione distribuita che esegue il rendering del contenuto Contentful. Per usare l'anteprima dal vivo, Sostituisci contentfulapp.tld nel modello di URL con il dominio effettivo dell'applicazione.

Consultare la documentazione di Contentful per ulteriori informazioni sulla configurazione dell'anteprima contenuto.

Al momento, la lingua non è supportata come placeholder. Per usare le impostazioni locali nell'URL, specificare un valore fisso e Crea istanze di connettore multiple.
Se richiesto, fornire gli ID contenuto che devono essere omessi dall'importare in Phrase.
Fornire ID spazio e token per mappa token anteprima spazio (obbligatorio).

L'API di anteprima richiede un token di accesso Contentful denominato Content Preview API – access token che deve essere configurato nelle impostazioni API dello spazio Contentful.

L'integrazione Contentful 2.0 usa questa API per importare contenuto e monitorare le modifiche (APC).
- Selezionare ogni spazio e ambiente da monitorare/importare da Contentful.
- La configurazione e l'accedere sono gestiti all'interno di Contentful stesso.
Clicca su Salva.

Il connettore viene aggiunto all'elenco nella pagina Connettori.

Impostazioni Phrase TMS

Importante

Se si accede da un dominio Personalizzato (es. mydomain.phrase.jp), aprire una finestra del browser in incognito e accedere tramite cloud.memsource.com o us.cloud.memsource.com per applicare l'autenticazione richiesta per la creazione o il salvataggio del connettore. Dopo aver salvato, è possibile accedere al connettore tramite il dominio Personalizzato.

Dalla pagina Impostazioni, scorri verso il basso fino alla sezione Integrazioni.
Fai clic su Connettori.

Si apre la pagina Connettori.
Fare clic su Nuovo connettore.

Si apre la pagina Creare connettore.
Modificare il Tipo in o Contentful (Livello voce) o Contentful (Livello campo) e fornire un nome per il connettore.
Facoltativamente, selezionare la casella di controllo Phrase Contentful App se si usa il connettore con l'app.
- Token app Contentful
  
  Generare un token app da inserire nell'applicazione Contentful di Phrase TMS. Salvare il connettore dopo aver generato il token e averlo copiato nell'app Contentful.
Nota

Una volta salvato, il token non può essere modificato da Contentful. Per aggiornarlo, revocare il token dalla configurazione del connettore in Phrase TMS e generarne uno nuovo.
Configurare le impostazioni indipendenti dalla lingua.
- Lingua di origine
  
  Selezionare una lingua di origine per sovrascrivere la lingua predefinita di Contentful. Il connettore estrarrà quindi il contenuto dalla lingua configurata 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 Remote) estragga il contenuto da DE-DE invece che da EN-US.
Nota

Non applicabile quando si usa l'applicazione.
Selezionare come elaborare il contenuto nidificato tramite Modalità importazione voce. Il contenuto può usare un campo di riferimento per fare riferimento ad altro contenuto, consentendo la creazione di una gerarchia di entità.

Nota

Non applicabile quando si usa l'applicazione.
- Contentful (a livello di voce)
  
  Il connettore a livello di voce attraversa automaticamente l'intera gerarchia del contenuto nidificato.
- Contentful (a livello di campo)
  
  Selezionare come il connettore a livello di campo deve importare il contenuto nidificato.
  - Solo voce selezionata
    
    Il contenuto selezionato esplicitamente durante l'aggiunta dall'archivio viene importato.
    
    Le modifiche rilevate da APC vengono importate per la traduzione.
  - Importare le voci di riferimento
    
    Il connettore attraversa l'intera gerarchia del contenuto nidificato e importa tutti i campi traducibili per la traduzione.
Creare un elenco separato da virgole in Ometti campi traducibili per omettere dall'importazione in Phrase TMS i campi selezionati per Abilita localizzazione di questo campo. Usare la seguente struttura: contentTypeID:fieldID.
- Selezionare Lascia vuoti i campi omessi se i campi elencati devono essere lasciati vuoti. Questa impostazione sarà applicata a tutte le voci elencate.
- Selezionare Copia origine in destinazione se i campi elencati devono contenere valori di origine. Questa impostazione sarà applicata a tutte le voci elencate.
Selezionare Usare lingua di fallback se mancano dati per un determinato campo nella lingua di origine.

Selezionare una lingua di origine di fallback dall'elenco a discesa, se necessario. Queste impostazioni locali della lingua verranno utilizzate in caso di dati mancanti.

Nota

Non esiste alcuna relazione tra la lingua di fallback di Contentful e questa impostazione.
Se necessario, fornire l'URL di anteprima live (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ò apparire così:

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}

Nota

L'URL deve condurre a un'applicazione distribuita che esegue il rendering del contenuto Contentful. Per usare l'anteprima dal vivo, Sostituisci contentfulapp.tld nel modello di URL con il dominio effettivo dell'applicazione.

Consultare la documentazione di Contentful per ulteriori informazioni sulla configurazione dell'anteprima contenuto.

Al momento, la lingua non è supportata come placeholder. Per usare le impostazioni locali nell'URL, specificare un valore fisso e Crea istanze di connettore multiple.
Se il supporto tecnico del Team richiede la registrazione delle informazioni di debug, selezionare Registra informazioni di debug.
Fare 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 (a livello di voce):

Impostare la lingua di origine.

Nota

Questa lingua deve corrispondere alle impostazioni locali predefinite dello spazio Contentful configurato nelle impostazioni delle impostazioni locali di Contentful.
Clicca su Salva.

Il connettore viene aggiunto all'elenco nella pagina Connettori.
Facoltativamente, modificare il connettore per selezionare i flussi di lavoro Contentful.
- Tradurre 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:
- Imposta gli articoli di origine su
  
  Il connettore avanza il flusso di lavoro alla fase selezionata (ad es. Traduzione in avanzamento) quando gli articoli di origine vengono scaricati.
All'esportazione verso Contentful:
- Imposta gli articoli di origine su
  
  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.