-
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 plugin do Marketplace do Contentful 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 solicitante para que os Solicitantes possam adicionar arquivos a solicitações diretamente do repositório online. O conteúdo pode ser pesquisado pelo ID da entrada.
-
Use a Criação Automatizada de Projetos (APC) para que novos projetos sejam 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 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 Phrase TMS Auth token adquirido ao criar o conector dentro do Phrase TMS.
-
Clique em Instalar.
Opcional - Iniciar aplicativo (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 é exibido.
-
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 nas .
-
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 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 tags de conteúdo especificadas.
-
Selecione se deseja parar ou seguir as 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 arquivo .XLIFF. 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, recomenda-se 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 monitora o conteúdo no novo destino e os trabalhos serão reimportados/exportados do/para o novo destino do alias.
Seguir aliases aplica-se apenas ao monitoramento de APC, reimportação de trabalho e exportação de trabalho do conector padrão. Isso não se aplica a entradas enviadas por meio do aplicativo Phrase Contentful. Quando o aplicativo é usado, uma entrada permanece vinculada ao ambiente específico do qual foi enviada no momento do envio. Isso permanece válido mesmo se esse ambiente for posteriormente excluído ou substituído por trás de um alias estável. Se o ambiente original for excluído ou substituído, o conector não detecta a entrada no novo ambiente, mesmo com ativado. Reenvie a entrada do Contentful enquanto o novo ambiente estiver ativo para que o conector possa detectá-la.
-
(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.
-
APCs e trabalhos criados estão vinculados ao próprio alias. 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 monitoram 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 este acesso no Contentful em , na seção da função. Se o alias for posteriormente redirecionado para um ambiente diferente, adicione acesso ao novo ambiente também.
-
-
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 para o Phrase.
-
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 do 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 mudado. 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 estiver concluída e adicione-a novamente apenas se precisar de retradução.
-
Limite 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.
Entradas traduzidas anteriormente podem ser reenviadas após alterações na cópia original. O reenvio é manual ao usar o aplicativo Phrase Contentful: um editor deve abrir a entrada no Contentful, abrir a barra lateral do aplicativo Phrase e clicar em Recomeçar (ou usar o reenvio em massa no painel do aplicativo) antes que o APC a detecte e atualize a fonte do trabalho existente. Isso difere dos conectores de monitoramento de arquivos ou pastas, onde o APC detecta alterações na fonte automaticamente sem exigir reenvio manual.
Importante
Se estiver acessando de um domínio personalizado (ex. mydomain.phrase.jp), abra uma janela anônima do navegador 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 via 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 Type para seja Contentful (Entry-Level) ou Contentful (Field-Level) 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 para ser inserido no aplicativo Contentful dentro 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 de dentro do Contentful. Para atualizá-lo, revogue o token na 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 extrairá 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 por meio de Entry import mode. O conteúdo pode usar um campo de referência para referenciar outros conteúdos, 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 Omit translatable fields para omitir da importação para o Phrase TMS os campos que estão marcados para . Use a seguinte estrutura:
contentTypeID:fieldID.-
Selecione Leave omitted fields empty se os campos listados devem ser deixados vazios. Esta configuração será aplicada a todas as entradas listadas.
-
Selecione Copy source to target 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á configurada 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 continuado não é suportado.
-