-
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 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. Consultare 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.
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 submitter portal in modo che i submitter 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 documenti monitorati o per una cartella.
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 progress. Quando le traduzioni vengono reinviate a Contentful, lo stato cambia in completed.
-
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.
Nota
La Contentful Launch App non è supportata nel connettore 2.0.
-
Dalla pagina
Impostazioni, scorri verso il basso fino alla sezione .
-
Fai clic su Connettori.
Si apre la pagina .
-
Fare clic su Nuovo connettore.
Si apre la pagina .
-
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 .
-
Facoltativamente, selezionare la casella di controllo Phrase Contentful App se si usa il connettore con l'app.
-
Fare clic su Genera token.
Si apre la finestra .
-
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.
-
Chiudi la finestra; verrà visualizzato .
-
-
Se Contentful Tags vengono utilizzati per identificare il contenuto traducibile, inserire l'ID del tag e premere Invio.
L'ID viene presentato e ne possono essere aggiunti altri. I tag possono essere utilizzati per limitare quale contenuto di Contentful è visibile al connettore.
-
Se necessario, selezionare .
-
Se necessario, selezionare (contenuto nidificato).
Vengono visualizzate le . Applicare i filtri desiderati per stabilire un controllo più granulare su come il sistema attraversa le relazioni tra i contenuti.
-
Limita quanto lontano Phrase segue le voci referenziate 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.
-
Escludere le voci il cui tipo di contenuto principale corrisponde all'elenco specificato.
-
Selezionare se interrompere o seguire le voci che hanno uno dei tag di contenuto specificati.
-
Selezionare se interrompere o seguire le voci a cui fanno riferimento gli ID dei campi specificati.
-
-
Se necessario, seleziona .
Viene visualizzato il campo . Inserire 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 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 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 importazioni/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.
-
(predefinito e consigliato)
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.
-
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.
I ruoli Contentful personalizzati richiedono 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 sotto , nella sezione del ruolo. Se l'alias viene successivamente reindirizzato a un ambiente diverso, aggiungi l'accesso anche al nuovo ambiente.
-
-
Se richiesto, 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 potrebbe apparire così:
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 Contentful. Per usare 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 contenuto.
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 richiesto, usa per escludere determinati campi dall'importazione in Phrase. Fornisci gli ID del contenuto che devono essere esclusi dall'importazione.
-
Fornisci e per (richiesto).
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 usa questa API per importare contenuto 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 il contenuto completo di una voce tracciata e i relativi riferimenti ad ogni esecuzione, poiché Contentful non segnala quale locale sia cambiato. Per questo motivo, una voce può essere reimportata dopo aver ricevuto una traduzione anche se la sua origine non è stata modificata. Su spazi ad alto volume, questo può rallentare le esecuzioni APC.
Per ridurre questo:
-
Rimuovere il tag di traduzione una volta completata una voce e riaggiungerlo solo se necessita di una ritraduzione.
-
Limitare le impostazioni solo alle voci che necessitano di traduzione.
-
Usare l'app Phrase Contentful, che monitora solo le voci inviate tramite essa.
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 il salvataggio, il connettore sarà accessibile tramite il dominio personalizzato.
-
Dalla pagina
-
Fai clic su Connettori.
Si apre la pagina .
-
Fai clic su Nuovo connettore.
Si apre la pagina .
-
Modificare il Tipo in Contentful (Livello voce) oppure Contentful (Livello campo) e fornire un nome per il connettore.
-
Facoltativamente, selezionare la casella di controllo Phrase Contentful App se si utilizza il connettore con l'app.
-
Token dell'app Contentful
Generare un token dell'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 è 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.
-
-
Selezionare come elaborare il contenuto nidificato tramite modalità di importazione delle voci. Il contenuto può utilizzare un campo di riferimento per collegarsi ad altri contenuti, consentendo la creazione di una gerarchia di entità.
-
Contentful (Entry-Level)
Il connettore a livello di voce attraversa automaticamente l'intera gerarchia di contenuti nidificati.
-
Contentful (Field-Level)
Selezionare come il connettore a livello di campo deve importare i contenuti nidificati.
-
-
Il contenuto che viene selezionato esplicitamente durante l'aggiunta dal repository viene importato.
-
Le modifiche rilevate da APC vengono importate per la traduzione.
-
-
Importare le voci di riferimento
-
Il connettore attraversa l'intera gerarchia di contenuti nidificati e importa tutti i campi traducibili per la traduzione.
-
-
-
-
Creare un elenco separato da virgole in Omit translatable fields per omettere dall'importazione in Phrase TMS i campi selezionati per . Usare la seguente struttura:
contentTypeID:fieldID.-
Selezionare Leave omitted fields empty se i campi elencati devono essere lasciati vuoti. Questa impostazione sarà applicata a tutte le voci elencate.
-
Selezionare Copy source to target se i campi elencati devono contenere i valori di origine. Questa impostazione sarà applicata a tutte le voci elencate.
-
-
Selezionare se mancano dati per un particolare campo nella lingua di origine.
Selezionare una dall'elenco a discesa, se necessario. Questa lingua locale verrà usata in caso di dati mancanti.
Nota
Non esiste alcuna relazione tra la lingua di fallback di Contentful e questa impostazione.
-
Se necessario, fornire 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 potrebbe apparire così:
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 Contentful. Per usare 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 contenuto.
Al momento, la lingua non è supportata come placeholder. Per usare il locale nell'URL, specifica un valore fisso e crea istanze multiple del connettore.
-
-
Se il team di supporto tecnico richiede la registrazione delle informazioni di debug, selezionare .
-
Fai clic su Connect to 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 dei 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 avanza il flusso di lavoro alla fase selezionata (ad es. Translation in Progress) quando gli articoli di origine vengono scaricati.
All'esportazione su Contentful:
-
Il connettore imposta la fase del flusso di lavoro degli articoli di origine alla fase selezionata (ad es. Translations Completed) quando la traduzione viene esportata.
Nota
Il supporto del flusso di lavoro è stato interrotto da Contentful il 1 giugno 2023. L'uso continuato non è supportato.
-
Eliminare un connettore
Per eliminare un connettore:
-
Dalla pagina , seleziona il connettore da eliminare.
-
Fai clic su Delete.
Si apre la finestra .
-
Digita \"delete\" e fai clic su Delete.
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 eventuali lavori rimanenti. Vai alla pagina e svuotala per rimuovere eventuali lavori ancora collegati al connettore. Riprova a eliminare il connettore.