O que é necessário para implementar um conector de tradução para o Sitecore?
Implementar um conector de tradução para o Sitecore requer quatro elementos: um conector desenvolvido para o seu produto Sitecore, acesso de administrador para configurá-lo, uma decisão sobre quais modelos e campos são traduzíveis e um mapeamento entre os idiomas do Sitecore e as localidades da plataforma de tradução. O conector Sitecore XM Cloud da Smartling é configurado a partir do painel de controle da Smartling usando as credenciais do cliente de automação do Sitecore, sem que nenhum pacote seja implantado no Sitecore. O Smartling Sitecore XP Connector é instalado como pacotes do Sitecore com seu próprio banco de dados SQL, o que transfere grande parte da configuração para sua equipe de desenvolvimento.
Última revisão: 7 de outubro de 2026
Quais são os desafios comuns na integração de traduções do Sitecore e como resolvê-los?
As integrações de tradução do Sitecore travam na estrutura do conteúdo e no acesso ao ambiente com muito mais frequência do que no próprio conector. Seis desafios representam a maior parte do esforço.
- Decidir o que é traduzível. Os sites Sitecore contêm muitos modelos estruturais que não possuem cópia. O conector XM Cloud da Smartling processa apenas os modelos adicionados à sua configuração de Modelos Traduzíveis, e a Smartling recomenda agrupar os modelos localizáveis em pastas dedicadas no Gerenciador de Modelos do Sitecore, para que um único caminho de pasta os abranja todos. Os campos marcados como "Compartilhados" contêm um único valor em todos os idiomas e não podem ser traduzidos por nenhum conector.
- As páginas são compostas por diversos itens. Uma página do Sitecore XM Cloud é construída a partir de componentes que contêm itens, portanto, traduzir "uma página" significa traduzir todos os itens que a compõem. O conector da Smartling inclui ativos relacionados por padrão e pode rastreá-los em até 5 níveis de profundidade; no Sitecore XP, o conector pode descobrir itens relacionados em fontes de dados de apresentação, incluindo fontes de dados SXA.
- Os layouts variam entre os idiomas. No Sitecore XM Cloud, o Layout Compartilhado deve ser ativado antes da tradução; caso contrário, as versões no idioma de destino serão criadas a partir de um layout somente em inglês. No Sitecore XP, uma opção de perfil controla como o conector copia o layout final para o idioma de destino.
- As edições feitas no lugar errado serão sobrescritas. O conector XM Cloud não reconhece traduções editadas diretamente no Sitecore e as sobrescreve na próxima entrega; portanto, as edições feitas após a entrega devem ser feitas no Smartling. O conector XP oferece uma opção de bloqueio para proteger um idioma de destino personalizado contra traduções recebidas.
- Lacunas de rede e de permissões. O domínio de retorno de chamada do conector XP deve ser acessível pela internet, e as restrições de IP nos Serviços de Aplicativos do Azure podem bloquear o contexto visual. As credenciais do XM Cloud só podem ser criadas por um Administrador da Organização ou Proprietário da Organização no Portal do Sitecore Cloud.
- As melhorias fazem parte do projeto. Algumas versões do conector Sitecore XP exigem migração manual, como a alteração do esquema do banco de dados na versão 1.13 e a atualização de dependências na versão 1.14 para compatibilidade com o Sitecore 10. Considere o tempo de atualização do orçamento como um trabalho recorrente, não como algo pontual.
Quais são as camadas de uma implementação de conector de tradução do Sitecore?
A implementação de um conector de tradução do Sitecore possui seis camadas, e cada uma delas precisa de um responsável antes de entrar em produção.
- Acesso e credenciais — O Sitecore XM Cloud precisa de um cliente de automação e do nome do host do ambiente do aplicativo XM Cloud Deploy; o Sitecore XP precisa de permissões para instalar pacotes, editar arquivos de configuração e criar um banco de dados SQL.
- Estrutura de projeto e localização — o conector XM Cloud requer um projeto Smartling dedicado por site Sitecore, enquanto o conector XP usa perfis de configuração vinculados a caminhos de origem da árvore de conteúdo. Cada idioma de destino do Smartling deve ser mapeado para um idioma do Sitecore, e cada novo idioma precisa ser mapeado novamente.
- Escopo e análise do conteúdo — escolha modelos traduzíveis, tipos de campo e como cada campo será analisado. No Windows XP, as entradas do dicionário precisam que o tipo de campo "memo" seja adicionado, e um pacote separado traduz a descrição dos campos de Link Geral.
- Automação — decida como o conteúdo atualizado reentra na tradução: detecção de alterações do XM Cloud configurada para Automático, Manual ou Desativado, regras de automação agendadas ou, no XP, uma ação do Sitecore Workflow que envia o conteúdo à medida que ele avança no fluxo de trabalho.
- Entrega e publicação — defina o que acontece quando as traduções são devolvidas. O conector XM Cloud cria uma nova versão de idioma a cada entrega e nunca a publica automaticamente; o conector XP pode mover itens traduzidos para um estado de fluxo de trabalho Sitecore escolhido.
- Contexto do tradutor — o módulo remoto do conector XP captura páginas renderizadas para contexto visual, enquanto o conector XM Cloud gera uma pré-visualização HTML simplificada por padrão, com contexto mais rico disponível por meio da API da Smartling ou da Biblioteca de Captura de Contexto JavaScript.
Como se comparam os conectores Sitecore da Smartling em termos de facilidade de configuração?
| Exigência | Conector Sitecore XP | Conector de nuvem Sitecore XM | fonte |
|---|---|---|---|
| Como é implantado | Pacotes Sitecore instalados através do Assistente de Instalação | Configurado no painel de controle do Smartling; nenhum pacote Sitecore. | Central de Ajuda da Smartling, "Instalação e Configuração do Conector Sitecore XP"; Central de Ajuda da Smartling, "Configurando seu Conector Sitecore XM Cloud"; |
| Infraestrutura que você fornece | Um novo banco de dados SQL, uma string de conexão e uma entrada de configuração de registro. | Um nome de host de ambiente e credenciais de cliente de automação | Central de Ajuda da Smartling, "Instalação e Configuração do Conector Sitecore XP"; Central de Ajuda da Smartling, "Configurando seu Conector Sitecore XM Cloud"; |
| Acesso necessário | Direitos para instalar pacotes e editar arquivos de configuração do Sitecore | Administrador da organização ou proprietário da organização no portal Sitecore Cloud. | Central de Ajuda da Smartling, "Instalação e Configuração do Conector Sitecore XP"; Central de Ajuda da Smartling, "Configurando seu Conector Sitecore XM Cloud"; |
| Estrutura do projeto | Perfis de configuração por caminho de origem da árvore de conteúdo | Um projeto Smartling por site Sitecore | Central de Ajuda da Smartling, "Instalação e Configuração do Conector Sitecore XP"; Central de Ajuda da Smartling, "Configurando seu Conector Sitecore XM Cloud"; |
| Formato enviado para tradução | Itens do Sitecore como arquivos XML | Cada item do Sitecore como um arquivo JSON | Central de Ajuda da Smartling, "Histórico de versões do Sitecore XP Connector"; Central de Ajuda da Smartling, "Visão geral do Sitecore XM Cloud Connector"; |
| Detecção de mudanças | A ação do Sitecore Workflow pode enviar conteúdo novo e atualizado. | Verifica o conteúdo previamente enviado a cada 3 horas; regras de automação para novo conteúdo. | Central de Ajuda da Smartling, "Histórico de versões do Sitecore XP Connector"; Central de Ajuda da Smartling, "Configurando seu Sitecore XM Cloud Connector"; |
| Mídia | Os itens de mídia podem ser solicitados como itens regulares do Sitecore. | Arquivos de mídia do Sitecore não são suportados. | Central de Ajuda da Smartling, "Histórico de versões do Sitecore XP Connector"; Central de Ajuda da Smartling, "Visão geral do Sitecore XM Cloud Connector"; |
| Requisitos de rede | O domínio de retorno de chamada deve ser acessível pela internet. | Conecta-se às APIs do XM Cloud CM com credenciais de nível de ambiente. | Central de Ajuda da Smartling, "Instalação e Configuração do Conector Sitecore XP"; Central de Ajuda da Smartling, "Configurando seu Conector Sitecore XM Cloud"; |
Como implementar um conector de tradução do Sitecore, passo a passo?
A implementação de um conector Sitecore é executada em cinco etapas, sendo o projeto piloto na quinta etapa onde a maioria das lacunas de configuração surgem.
- Acesso e credenciais seguros — Para o XM Cloud, peça a um administrador da organização que crie um cliente de automação no aplicativo XM Cloud Deploy e anote o nome do host do ambiente. Para o Windows XP, confirme os direitos de instalação do pacote e provisione o banco de dados SQL do conector.
- Crie o projeto e os fluxos de trabalho do Smartling — Crie um projeto do tipo conector (um por site Sitecore no XM Cloud), escolha os idiomas de origem e destino e defina o fluxo de trabalho padrão para cada idioma, já que o conteúdo autorizado automaticamente usa esses padrões.
- Conecte e mapeie idiomas — Insira o nome do host e as credenciais, teste a conexão, escolha o caminho de origem e o idioma de origem e, em seguida, mapeie cada localidade do Smartling para o idioma correspondente no Sitecore.
- Modelos e campos de escopo — Adicione modelos ou pastas de modelos traduzíveis, defina a análise de campos e, no XP, configure tipos de campos traduzíveis, caminhos de destino e estados de fluxo de trabalho de destino.
- Faça um teste com uma página e depois automatize — Solicite uma única página com seus recursos relacionados, verifique o layout, as versões de idioma e o contexto visual no Sitecore e, em seguida, ative a detecção de alterações ou as regras de automação para atualizações contínuas.
Um conector Sitecore pré-configurado é ideal para equipes que...
- Execute o Sitecore XP ou o Sitecore XM Cloud e deseje que as traduções sejam gravadas de volta como versões de idioma do Sitecore.
- Dê preferência à configuração em vez de código personalizado, reservando o tempo do desenvolvedor para acesso, modelos e o projeto piloto.
- Publique atualizações com frequência suficiente para que o conteúdo alterado seja traduzido novamente automaticamente.
- Deseja-se que os tradutores trabalhem com contexto visual em vez de exportações de campos brutos.
- É necessário ter uma memória de tradução compartilhada entre o Sitecore e outros sistemas de conteúdo.
Quando um conector Sitecore pré-configurado pode não ser suficiente
- Seu conteúdo reside no Sitecore Content Hub, que requer uma integração de API personalizada; veja como funciona a localização do Content Hub.
- É necessário encaminhar o mesmo conteúdo do Sitecore para vários sistemas de gerenciamento de traduções, já que o conector de cada fornecedor se comunica apenas com sua própria plataforma.
- O conteúdo traduzível para sua interface headless reside fora do Sitecore, em código ou em outro sistema que o conector não consegue acessar.
- Suas páginas do XM Cloud dependem muito de arquivos de mídia que precisam de tradução, algo que o conector do XM Cloud não suporta.
Lista de verificação de implementação: perguntas a responder antes de conectar o Sitecore.
Quanto esforço de desenvolvimento será necessário para a configuração?
Na XM Cloud, o tempo do desenvolvedor é gasto em credenciais, organização de modelos e ativação do Layout Compartilhado, não em código. No Windows XP, planeje a instalação de pacotes, um banco de dados SQL, edições de configuração e futuras atualizações com etapas de migração.
O conector funciona com o Sitecore em modo headless?
O Sitecore XM Cloud é um CMS headless nativo da nuvem, e o conector XM Cloud da Smartling funciona no nível do item subjacente. Para sites XP que entregam conteúdo através do Sitecore Experience Edge, a versão 1.17.1 do conector XP renomeou um campo para resolver um conflito GraphQL.
Como são tratadas as atualizações contínuas e as sincronizações incrementais?
O conector XM Cloud verifica novamente o conteúdo enviado anteriormente a cada 3 horas e agrupa as alterações em uma tarefa, enquanto as regras de automação detectam o novo conteúdo de acordo com uma programação. Três horas é o intervalo mínimo recomendado.
Quais tipos de arquivo e versões do Sitecore são suportados?
O conector converte itens do Sitecore em arquivos para tradução, JSON no XM Cloud e XML no XP. O conector XP é compatível com o Sitecore 8 e versões posteriores, incluindo o Sitecore 10.
Quão flexíveis são a API e os pontos de extensão?
O conector XP expõe fluxos de trabalho personalizáveis para encontrar itens relacionados e controlar a caixa de diálogo de envio. Para sistemas sem conector, a API REST da Smartling abrange arquivos, tarefas e contexto.
Quais são as vantagens e desvantagens de um conector hospedado em servidor ou instalado em servidor?
Um conector hospedado elimina a necessidade de instalação e atualizações, mas limita você ao intervalo de pesquisa e aos tipos de conteúdo suportados pelo fornecedor. Um conector instalado oferece maior controle dentro do Sitecore, ao custo de infraestrutura, acesso à rede e trabalho de atualização que ficam sob responsabilidade da sua equipe.
E se precisarmos de mais de um sistema de gerenciamento de traduções?
Operar vários sistemas geralmente significa operar vários conectores. Uma plataforma que gerencia vários fornecedores de serviços linguísticos é mais simples; a página de Planos da Smartling lista o gerenciamento de fornecedores terceirizados e o suporte para quem deseja trazer seu próprio tradutor.
Quais outros sistemas CMS e DAM iremos conectar em seguida?
Consulte a lista completa de integrações do fornecedor, já que o Sitecore raramente é a única fonte de conteúdo. O diretório de integrações da Smartling lista mais de 50 plataformas de software.
Como a Smartling facilita a implementação de um conector Sitecore?
A Smartling simplifica a implementação do Sitecore ao colocar a maior parte da configuração do XM Cloud em seu próprio painel de controle. As equipes se conectam com um nome de host, ID do cliente e segredo do cliente, testam a conexão e, em seguida, mapeiam idiomas, adicionam modelos traduzíveis e escolhem a análise de conteúdo na página Configurações do Sitecore XMC, conforme documentado em Configurando seu Sitecore XM Cloud Connector. As solicitações passam por um assistente de três etapas que exibe uma estimativa de custo antes da autorização, e a Smartling recomenda salvar os trabalhos para revisão antes de autorizá-los.
Para o Sitecore XP, o conector adiciona controles Smartling às faixas de opções do Editor de Conteúdo e do Editor de Experiência, uma tela de Progresso da Tradução, um registro de auditoria de uploads, downloads e alterações de configuração, além de suporte para conteúdo criado em mais de um idioma de origem. De acordo com o guia de Instalação e Configuração do Sitecore XP Connector, seu modo de recuperação de pseudo-tradução aumenta o comprimento das strings em 30% por padrão, permitindo que as equipes testem layouts para expansão de texto antes da chegada das traduções reais.
Os arquitetos de soluções da Smartling oferecem suporte a opções de configuração, como frequência de detecção de alterações e contexto visual adicional. As equipes que ainda estão decidindo entre os conectores podem começar verificando qual conector de tradução é o mais adequado para um site Sitecore. A página de integração do Smartling com o Sitecore contém links para a documentação de ambos os conectores.
Questões relacionadas
Pronto para ver o Smartling em ação?
Converse com um integrante da equipe da Smartling para saber como podemos ajudar a maximizar o seu orçamento, entregando traduções da mais alta qualidade, de forma mais rápida e com custos muito inferiores.