-
Planos Business e Enterprise (não disponíveis para planos LSP)
Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.
-
Plano Enterprise (legado)
Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.
Dica
Para obter informações sobre a integração do Contentful no Phrase Strings, consulte Contentful (Strings).
O Contentful fornece uma infraestrutura de gerenciamento de conteúdo headless para criar, gerenciar e distribuir conteúdo para qualquer plataforma ou dispositivo. O Phrase integra-se ao Contentful de duas maneiras:
-
Via um conector dedicado do Contentful (2.0, Entry-Level, Field-Level)
O conector Contentful 2.0 atualmente suporta autenticação apenas via Data Center dos EUA.
-
Via o plugin do Contentful Marketplace para uma experiência personalizada
Nota
O conector não suporta a tradução de objetos JSON.
Métodos de localização suportados
O Contentful suporta vários métodos de localização. Consulte a documentação do Contentful para obter uma descrição detalhada.
O conector Contentful 2.0 é a integração atual e preferencial que suporta a localização em nível de campo. Ele também oferece:
-
Vários espaços
-
Aliases de Ambiente
-
Configuração de URL de Visualização
-
Importação de Referência
-
Filtragem de Conteúdo Baseada em Tags
-
Configuração de Visualização ao Vivo
Localização em nível de entrada (Legado)
Use o conector Contentful (Entry-Level).
O conector de nível de entrada funciona apenas com tipos de conteúdo que possuem campos de referência localizados (por exemplo, um campo de referência chamado Localized que esteja habilitado para localização).
Localização em nível de campo (Legado)
Use o conector Contentful (Field-Level).
O conector de nível de campo funciona apenas com tipos de conteúdo que possuem um campo traduzível (por exemplo, um campo de Texto ou Rich Text com localização habilitada) e, opcionalmente, Ativos de Mídia. Ele importa entradas referenciadas e seus campos traduzíveis (se os campos de referência estiverem localizados).
Importante
Os conectores legados serão descontinuados em 30 de novembro de 2026. Novas instâncias desses conectores podem ser criadas até 17 de agosto de 2026. Migre para o novo conector antes da data de descontinuação.
Consulte Descontinuação de Conector Legado para obter um guia de migração completo.
Existem vários casos de uso para o conector:
-
Os gerentes de projetos podem adicionar arquivos diretamente a projetos a partir de um repositório online. O conteúdo pode ser pesquisado pelo ID da entrada.
-
Configure o portal do remetente para que os Remetentes possam adicionar arquivos a solicitações diretamente do repositório online. O conteúdo pode ser pesquisado pelo ID da entrada.
-
Use criação de projeto automatizado (APC) para ter novos projetos criados automaticamente quando uma alteração no tamanho do conteúdo for detectada para documentos monitorados ou uma pasta.
Casos de uso para o aplicativo:
-
Os editores de conteúdo podem enviar diretamente uma entrada para localização de dentro do Contentful. Isso permite que editores ou gerentes de conteúdo tenham controle total sobre o fluxo de localização e recebam atualizações de status em tempo real ao visualizar uma entrada.
Assim que a entrada for finalizada:
-
Selecione os idiomas de destino desejados para a localização.
-
Envie apenas a entrada com os idiomas selecionados para o Phrase TMS ou use a guia Seleção de campo para selecionar campos.
-
Se nenhum campo for selecionado, todos os campos localizáveis serão enviados para tradução.
-
Se um campo não localizável for selecionado, esse campo ainda não será enviado para tradução. Apenas campos localizáveis são enviados.
-
Se apenas alguns campos localizáveis forem selecionados, apenas esses campos serão enviados para tradução.
-
-
Com base nas configurações de APC, os trabalhos são criados automaticamente a partir do conteúdo enviado. Durante as execuções de APC, apenas as entradas no status enviado são selecionadas para a criação de trabalho.
-
Assim que os trabalhos de uma entrada enviada são criados, o status muda para em andamento. Quando as traduções são enviadas de volta para o Contentful, o status muda para concluído.
-
Entradas traduzidas anteriormente podem ser reenviadas após alterações na cópia original.
-
-
Editores de conteúdo podem usar a tela inicial do Phrase TMS para:
-
Enviar entradas em massa.
-
Especificar idiomas de destino individuais durante o envio em massa.
-
Ter uma visão geral dos trabalhos de tradução ativos.
-
Configurações do Contentful
Ao trabalhar com o aplicativo Phrase TMS:
-
Baixe o aplicativo Phrase TMS no marketplace.
-
Instale o aplicativo no espaço ativo atual e selecione os modelos de conteúdo onde o aplicativo requer instalação.
-
Insira o token de autenticação do Phrase TMS adquirido ao criar o conector dentro do Phrase TMS.
-
Clique em Instalar.
Opcional - Launch App (descontinuado pelo Contentful)
Se estiver usando suporte a fluxo de trabalho via Launch App by Contentful, siga estas etapas:
-
Instale o aplicativo Launch do Contentful em um ou mais espaços.
Nota
Apenas um fluxo de trabalho pode ser criado por espaço. Se forem necessárias abordagens diferentes para tipos de conteúdo dentro de um espaço do Contentful, entre em contato com o Gerente de Sucesso do Cliente dedicado.
-
Configure o fluxo de trabalho de localização necessário.
-
Selecione o tipo ou tipos de conteúdo que seguem o fluxo de trabalho descrito.
Se os fluxos de trabalho em um conector estiverem definidos, a Criação Automatizada de Projetos (APC) criará automaticamente novos projetos quando uma alteração nas etapas do fluxo de trabalho for detectada para artigos ou tipos de conteúdo monitorados.
Trabalhos enviados podem ser cancelados, permitindo que o conteúdo seja reenviado após as alterações serem feitas. Esses trabalhos ainda existirão no Phrase e precisarão ser excluídos por um gerente de projeto.
Nota
O Contentful Launch App não é compatível com o conector 2.0.
-
Na página de configurações
role para baixo até a seção de .
-
Clique em Conectores.
A página é aberta.
-
Clique em Novo conector.
A página é aberta.
-
Altere o Tipo para Contentful 2.0.
-
Forneça um nome para o conector.
-
Clique em Connect to Contentful 2.0.
A janela de login do Contentful é aberta.
-
Forneça os detalhes de login e clique em Log in (ou use métodos de login alternativos). A janela de login é fechada e é exibida.
-
Opcionalmente, marque a caixa de seleção Phrase Contentful App se estiver usando o conector com o aplicativo.
-
Clique em Generate token.
A janela é aberta.
-
Clique em Generate token.
Um token é gerado e deve ser copiado para a área de transferência ou para um arquivo de texto. Certifique-se de que o token seja copiado antes de fechar a janela, pois ele não ficará visível novamente. Este token será usado ao conectar-se ao aplicativo, na seção .
-
Feche a janela e será exibido.
-
-
Se Tags do Contentful forem usadas para identificar conteúdo traduzível, insira um ID de tag e pressione Enter.
O ID é apresentado e mais podem ser adicionados. As tags podem ser usadas para limitar qual conteúdo do Contentful fica visível para o conector.
-
Se necessário, selecione para .
-
Se necessário, selecione (conteúdo aninhado).
As configurações de são exibidas. Aplique os filtros desejados para estabelecer um controle mais granular sobre como o sistema percorre os relacionamentos de conteúdo.
-
Limita até onde o Phrase segue as entradas referenciadas durante a importação.
O valor padrão é 10.000. Se necessário, selecione outros valores ou especifique um valor inteiro personalizado.
-
Selecione se deseja parar ou seguir entradas cujo tipo de conteúdo corresponda à lista especificada.
-
Exclua entradas cujo tipo de conteúdo pai corresponda à lista especificada.
-
Selecione se deseja parar ou seguir entradas que possuam qualquer uma das tag(s) de conteúdo especificadas.
-
Selecione se deseja parar em ou seguir entradas que são referenciadas pelos IDs de campo especificados.
-
-
Se necessário, selecione .
O campo é exibido. Insira um valor para ativar a configuração de taxonomia.
-
Quando selecionado, o conector busca taxonomias do Contentful e as inclui no .XLIFF file. O painel do CAT editor listará os valores de taxonomia do Contentful para cada segmento.
-
Se os metadados de taxonomia não estiverem disponíveis ou se o conector não estiver configurado com eles, o painel será simplesmente omitido.
-
Se um projeto não exigir contexto de recurso/tela, é recomendável deixar a taxonomia desativada para otimizar o desempenho na exportação de .XLIFF.
-
-
Se necessário, selecione .
O alias é usado para todo o monitoramento de APC e reimportações/exportações de trabalho. Se o destino do alias for alterado no futuro, o APC monitorará o conteúdo no novo destino e os trabalhos serão reimportados/exportados do/para o novo destino do alias.
-
(padrão e recomendado)
Os APCs e os trabalhos criados estão vinculados ao ambiente para o qual o alias apontava no momento da criação do trabalho/APC. Os APCs monitoram apenas esse ambiente e conteúdo; os trabalhos são exportados e reimportados para ele.
-
Os APCs e os trabalhos criados estão vinculados ao próprio alias. Os APCs monitoram apenas esse alias e conteúdo; os trabalhos são exportados e reimportados para ele.
Se o destino do alias for alterado, os APCs monitorarão o novo destino do alias (ambiente); os trabalhos agora serão exportados e reimportados para ele.
Funções personalizadas do Contentful exigem acesso direto ao ambiente subjacente específico para o qual o alias aponta, não apenas ao próprio alias, ou o painel do aplicativo Phrase TMS não será carregado. Adicione esse acesso no Contentful em , na seção da função. Se o alias for posteriormente apontado para um ambiente diferente, adicione acesso ao novo ambiente.
-
-
Se necessário, forneça a .
Este é o modelo de URL que leva ao conteúdo renderizado do Contentful. Os seguintes marcadores de posição podem ser utilizados:
-
env_id: ID do ambiente
-
ID de entrada ID de entrada
-
ID de espaço ID de espaço
Um modelo de URL pode ser assim:
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}
Nota
A URL deve levar a um aplicativo implantado que renderiza o conteúdo do Contentful. Para usar a visualização ao vivo, substitua
contentfulapp.tldno modelo de URL pelo domínio real do aplicativo.Consulte a documentação do Contentful para obter mais informações sobre como configurar a visualização de conteúdo.
O local não pode ser usado como marcador de posição no momento. Para usar a localidade na URL, especifique um valor fixo e crie várias instâncias de conector.
-
-
Se necessário, use para excluir campos específicos da importação para o Phrase. Forneça os ContentIDs que devem ser omitidos da importação.
-
Forneça o e o para o (obrigatório).
A API de visualização requer um token de acesso do Contentful chamado que deve ser configurado nas configurações de API do espaço do Contentful.
A integração 2.0 do Contentful usa esta API para importar conteúdo e monitorar alterações (APC).
-
Selecione cada espaço e ambiente para monitorar/importar do Contentful.
-
A configuração e o acesso são gerenciados dentro do próprio Contentful.
-
-
Clique em Gravar.
O conector está adicionado à lista na página de .
Nota
O monitoramento APC verifica novamente o conteúdo completo de uma entrada rastreada e suas referências a cada execução, já que o Contentful não informa qual localidade foi alterada. As entradas referenciadas são buscadas individualmente em vez de em lotes, portanto, em espaços com muitas entradas referenciadas, uma única execução pode gerar um alto número de solicitações para a API de visualização e a API de conteúdo do Contentful. Por causa disso, uma entrada pode ser reimportada após receber uma tradução, mesmo que sua fonte não tenha sido alterada. Em espaços de alto volume, isso pode tornar as execuções do APC mais lentas e aumentar significativamente o uso da API do Contentful.
Para reduzir isso:
-
Remova a tag de tradução assim que uma entrada for concluída e adicione-a novamente apenas se precisar de retradução.
-
Restrinja as configurações de apenas às entradas que precisam de tradução.
-
Use o aplicativo Phrase Contentful, que monitora apenas as entradas enviadas por meio dele.
Importante
Se estiver acessando de um domínio personalizado (ex. mydomain.phrase.jp), abra uma janela de navegador anônima e faça login via cloud.memsource.com ou us.cloud.memsource.com para aplicar a autenticação necessária para a criação ou salvamento do conector. Após salvar, o conector pode ser acessado pelo domínio personalizado.
-
Na página de configurações
-
Clique em Conectores.
A página é aberta.
-
Clique em Novo conector.
A página é aberta.
-
Altere o Tipo para Contentful (Nível de entrada) ou Contentful (Nível de campo) e forneça um nome para o conector.
-
Opcionalmente, marque a caixa de seleção Phrase Contentful App se estiver usando o conector com o aplicativo.
-
Token do App Contentful
Gere um token de aplicativo a ser inserido no aplicativo Contentful do Phrase TMS. Salve o conector após gerar o token e copiá-lo para o aplicativo Contentful.
Nota
Uma vez salvo, o token não pode ser alterado dentro do Contentful. Para atualizá-lo, revogue o token da configuração do conector no Phrase TMS e gere um novo.
-
-
Configure as definições agnósticas de idioma.
-
Idioma do texto original
Selecione um idioma de origem para substituir o idioma padrão do Contentful. O conector então importará o conteúdo do idioma configurado na configuração do conector.
Exemplo:
Nota
Não aplicável ao usar o aplicativo.
-
-
Selecione como processar conteúdo aninhado através do Modo de importação de entrada. O conteúdo pode usar um campo de referência para referenciar outro conteúdo, permitindo a criação de uma hierarquia de entidades.
-
Contentful (nível de entrada)
O conector de nível de entrada percorre automaticamente toda a hierarquia de conteúdo aninhado.
-
Contentful (nível de campo)
Selecione como o conector de nível de campo deve importar conteúdo aninhado.
-
-
O conteúdo que é selecionado explicitamente ao adicionar a partir do repositório é importado.
-
As alterações detectadas pelo APC são importadas para tradução.
-
-
Importar entradas referenciadas
-
O conector percorre toda a hierarquia de conteúdo aninhado e importa todos os campos traduzíveis para tradução.
-
-
-
-
Crie uma lista separada por vírgulas em Omitir campos traduzíveis para omitir campos que estão marcados para da importação para o Phrase TMS. Use a seguinte estrutura:
contentTypeID:fieldID.-
Selecione Deixar campos omitidos vazios se os campos listados devem ser deixados vazios. Esta configuração será aplicada a todas as entradas listadas.
-
Selecione Copiar origem para destino se os campos listados devem conter valores de origem. Esta configuração será aplicada a todas as entradas listadas.
-
-
Selecione se faltarem dados para um campo específico no idioma de origem.
Selecione um na lista suspensa, se necessário. Esta localidade de idioma será usada no caso de dados ausentes.
Nota
Não há relação entre o idioma de fallback do Contentful e esta configuração.
-
Se necessário, forneça a (BETA).
Este é o modelo de URL que leva ao conteúdo renderizado do Contentful. Os seguintes marcadores de posição podem ser utilizados:
-
env_id: ID do ambiente
-
entry.sys.id: ID de entrada
-
ID de espaço ID de espaço
Um modelo de URL pode ser assim:
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
Nota
A URL deve levar a um aplicativo implantado que renderiza o conteúdo do Contentful. Para usar a visualização ao vivo, substitua
contentfulapp.tldno modelo de URL pelo domínio real do aplicativo.Consulte a documentação do Contentful para obter mais informações sobre como configurar a visualização de conteúdo.
O local não pode ser usado como marcador de posição no momento. Para usar a localidade na URL, especifique um valor fixo e crie várias instâncias de conector.
-
-
Se o registro de informações de depuração for solicitado pela equipe de suporte técnico, selecione .
-
Clique em Conectar ao Contentful.
Uma marca de seleção aparecerá na configuração do conector se a conexão for bem-sucedida. Um ponto de exclamação vermelho aparecerá se não houver. Passe o cursor acima do ícone para ver detalhes adicionais.
-
Apenas Contentful (Nível de entrada):
Defina o Idioma de origem.
Nota
Este idioma deve corresponder à localidade padrão do espaço do Contentful que está configurado nas configurações de Localidades do Contentful.
-
Clique em Gravar.
O conector está adicionado à lista na página de .
-
Opcionalmente, edite o conector para selecionar .
-
Traduzir artigos de
O conector monitora artigos na etapa selecionada (por exemplo: para traduzir). O autor pode colocar esta etiqueta nos artigos quando estiverem prontos para tradução.
Ao importar do Contentful
-
O conector avança o fluxo de trabalho para o estágio selecionado (por exemplo, Tradução em Andamento) quando os artigos de origem são baixados.
Ao exportar ao Contentful
-
O conector define o estágio do fluxo de trabalho dos artigos de origem para o estágio selecionado (por exemplo, Traduções Concluídas) quando a tradução é exportada.
Nota
O suporte ao fluxo de trabalho foi descontinuado pelo Contentful em 1 de junho de 2023. O uso contínuo não é suportado.
-
Excluir um conector
Para excluir um conector:
-
Na página , selecione o conector a ser excluído.
-
Clique em Delete.
A janela é aberta.
-
Digite "delete" e clique em Delete.
O conector é excluído e a lista de conectores é exibida.
Nota
Um conector não pode ser excluído enquanto ainda estiver vinculado a trabalhos incompletos em um projeto, incluindo trabalhos que estejam na Lixeira. Tentar excluir esse conector retorna um erro "Falha ao excluir conector".
Resolução: Abra o projeto associado ao conector e conclua ou exclua quaisquer trabalhos restantes. Vá para e esvazie-o para remover quaisquer trabalhos ainda vinculados ao conector. Tente excluir o conector novamente.