-
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 US Data Center.
-
Via um 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 da URL de pré-visualização
-
Importação de referência
-
Filtragem de conteúdo baseada em tags
-
Configuração da pré-visualização em tempo real
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 Text ou Rich Text com a 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 às 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 for detectada uma alteração no tamanho do conteúdo de documentos monitorados ou de uma pasta.
Casos de uso para o aplicativo:
-
Os editores de conteúdo podem enviar uma entrada para localização diretamente no 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 com o status enviado são selecionadas para a criação de trabalhos.
-
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 no texto 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 do marketplace.
-
Instale o aplicativo no espaço ativo atual e selecione os modelos de conteúdo nos quais o aplicativo precisa ser instalado.
-
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 por meio do Launch App do 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 um ou mais tipos de conteúdo que seguem o fluxo de trabalho descrito.
Se houver fluxos de trabalho definidos em um conector, a criação automatizada de projetos (APC) criará novos projetos automaticamente quando for detectada uma alteração nas etapas do fluxo de trabalho de artigos ou tipos de conteúdo monitorados.
Os trabalhos enviados podem ser cancelados, permitindo que o conteúdo seja reenviado após as alterações. 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 Type 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, o qual 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. Esse token será usado na para conectar o aplicativo.
-
Feche a janela e é exibido.
-
-
Se Tags do Contentful forem usadas para identificar conteúdo traduzível, insira um ID de tag e pressione Enter.
O ID é exibido, e outros IDs 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 .
-
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 tenham qualquer uma das tags de conteúdo especificadas.
-
Selecione se deseja parar nas entradas referenciadas pelos IDs de campo especificados ou segui-las.
-
-
Se necessário, selecione .
O campo é exibido. Insira um valor para habilitar a configuração de taxonomia.
-
Quando selecionado, o conector busca taxonomias do Contentful e as inclui no arquivo .XLIFF. O painel do editor CAT listará os valores de taxonomia do Contentful para cada segmento. Os valores de taxonomia não são conteúdo traduzível. Eles não podem ser listados, importados ou exportados como um trabalho independente, seja isoladamente ou junto com uma entrada.
-
Se os metadados de taxonomia não estiverem disponíveis ou 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 em todo o monitoramento do APC e em todas as reimportações e exportações de trabalhos. Se o destino do alias for alterado no futuro, o APC monitorará o conteúdo no novo destino, e os trabalhos serão reimportados desse destino e exportados para ele.
Seguir aliases aplica-se ao monitoramento do APC, à reimportação de trabalhos e à exportação de trabalhos. Também se aplica a entradas enviadas por meio do Phrase Contentful App a partir de uma URL de alias. O aplicativo registra o alias no envio, para que o conector encontre essas entradas após a alteração do destino do alias. As entradas enviadas enquanto o alias apontava para um ambiente anterior permanecem visíveis para o conector. Cada entrada ainda é exportada e reimportada para o ambiente do qual foi enviada.
Um conector que segue um alias não encontra entradas enviadas pela URL do ambiente específico em vez da URL do alias. Ele também não encontra entradas enviadas por meio do aplicativo antes da adição do suporte a alias. Reenvie estas entradas do Contentful através da URL de alias.
-
(padrão e recomendado)
APCs e trabalhos criados estão vinculados ao ambiente para o qual o alias estava apontando no momento da criação do trabalho/APC. APCs monitoram apenas esse ambiente e conteúdo; 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; 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.
Para entradas enviadas através do Phrase Contentful App, os trabalhos são exportados e reimportados para o ambiente do qual a entrada foi enviada.
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 redirecionado posteriormente 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 -
{entry.id}: ID de entrada -
{space_id}: 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 Contentful 2.0 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 grande 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 seu conteúdo original não tenha sido alterado. 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 Phrase Contentful App, que monitora apenas as entradas enviadas por meio dele.
Entradas traduzidas anteriormente podem ser reenviadas após alterações no texto original. O reenvio é manual ao usar o Phrase Contentful App: um editor deve abrir a entrada no Contentful, abrir a barra lateral do Phrase App e clicar em Recomeçar (ou usar o reenvio em massa no painel do aplicativo) antes que o APC a identifique e atualize o texto de origem do trabalho existente. Isso difere dos conectores de monitoramento de arquivos ou pastas, nos quais o APC detecta automaticamente alterações no conteúdo original, sem exigir reenvio manual.
Um conector Contentful 2.0 pertence à sua organização, e não a um usuário individual. O token OAuth do Contentful que o conector usa está vinculado ao usuário que o autorizou.
Para vincular o conector a um usuário diferente do Contentful, o token OAuth existente deve ser removido para que outro usuário possa autorizar o conector novamente:
-
Usando a conta do Contentful que criou o token, abra a página de tokens de API para o espaço relevante (https://app.contentful.com/spaces/{space_id}/api/cma_tokens).
-
Exclua o token chamado "Memsource Connector". Se vários tokens compartilharem este nome, confirme qual deles é usado pelo conector afetado antes de excluí-lo.
-
Uma vez que o token seja excluído, o conector é desativado até que o novo usuário o reautorize nas configurações do conector no Phrase TMS.
Conclua estas etapas antes que o acesso do usuário original ao Contentful seja removido, ou o token poderá não estar mais visível.
Importante
Se estiver acessando por um domínio personalizado (por exemplo, mydomain.phrase.jp), abra uma janela anônima do navegador e faça login por meio de cloud.memsource.com ou us.cloud.memsource.com para realizar a autenticação necessária para criar ou salvar o 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 (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 aplicativo Contentful
Gere um token de aplicativo para 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 na configuração do conector no Phrase TMS e gere um novo.
-
-
Configure as definições independentes do 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 no idioma definido em sua configuração.
Exemplo:
Nota
Não aplicável ao usar o aplicativo.
-
-
Selecione como processar conteúdo aninhado por meio de Modo de importação de entradas. O conteúdo pode usar um campo de referência para fazer referência a outro conteúdo, permitindo a criação de uma hierarquia de entidades.
-
Contentful (Entry-Level)
O conector de nível de entrada percorre automaticamente toda a hierarquia de conteúdo aninhado.
-
Contentful (Field-Level)
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 da importação para o Phrase TMS os campos que estão marcados para . 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. Essa localidade será usada caso faltem dados.
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 -
{space_id}: 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 pré-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 (Entry-Level):
Defina o Idioma de origem.
Nota
Esse idioma deve corresponder à localidade padrão do espaço do Contentful, definida 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 .
-
:
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.
Após a importação 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.
Após a exportação para o 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 a fluxo de trabalho foi descontinuado pelo Contentful em 1 de junho de 2023. O uso contínuo não é suportado.
-