Conector do Phrase Strings (Sincronização de Trabalho)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

A integração do Phrase Strings (chamada de Sincronização de Trabalho na interface do Strings) conecta o Phrase TMS ao Phrase Strings. A integração suporta sincronização tanto em nível de trabalho quanto em nível de projeto.

Sincronização de trabalho

Trabalhos criados e iniciados no Strings com estado Em progresso podem ser importados para o TMS para tradução e enviados de volta para o Strings após a tradução.

Recomendado para fluxos de trabalho baseados em lote com controle granular.
Sincronização em nível de projeto

Todas as chaves em um projeto selecionado do Strings são transferidas para o TMS, sem a necessidade de criação de trabalho. Chaves recém-adicionadas ou atualizadas tornam-se disponíveis para sincronização automaticamente.

Recomendado para fluxos de trabalho de localização contínua.

Pré-requisitos

Acesso aos aplicativos TMS e Strings
Os códigos de idioma usados no projeto do TMS devem corresponder aos códigos de local no trabalho do Strings.
O idioma padrão do projeto do Strings deve ser o mesmo que o idioma de origem definido no projeto do TMS.

Importante

Os arquivos Figma podem ser exibidos no Strings como arquivos completos e atualizados em tempo real, mas não são compatíveis com o TMS. O editor CAT do TMS só pode exibir conteúdo traduzido em um frame do Figma específico no formato SVG.

Por padrão, o conteúdo enviado do Strings para o TMS é importado como arquivos XLIFF 2.0. Ao usar o APC, o Tipo de arquivo nas configurações de importação de arquivos do modelo de projeto do TMS deve ser definido como XLIFF 2.0 ou Detecção automática.

Os estados de tradução das chaves do Strings não são suportados. A Sincronização de Trabalho envia o texto de destino atualmente armazenado no Strings para o TMS, independentemente de a chave estar verificada ou não. Chaves que estão marcadas como não verificadas no Strings antes da importação para o TMS podem ser retornadas ao Strings como verificadas em caso de traduções de destino inalteradas.

A configuração de projeto do Strings Usar fallback para traduções não verificadas não é aplicada pela Sincronização de Trabalho. A substituição de fallback não ocorre em nenhuma das direções entre o Strings e o TMS, portanto, o texto da localidade de fallback não substitui as traduções não verificadas.

O número de segmentos criados no TMS após importar um trabalho do Strings pode ser diferente do número original de chaves nos seguintes casos:

As chaves são marcadas como excluídas no Strings. As chaves excluídas não são importadas.
A opção Segmentar XLIFF foi habilitada nas configurações de importação de arquivos para XLIFF 2.0 ao criar o trabalho no TMS. Neste caso, o número de segmentos pode ser maior do que o número de chaves no Strings.

As chaves do Strings podem conter entidades HTML. Ao configurar o conector no TMS, ative a opção Incluir conteúdo HTML em CDATA para preservar entidades HTML em vez de mostrar os caracteres correspondentes no TMS.

Espaços no início e no fim presentes no texto de origem de uma chave do Strings não são exibidos no editor CAT do TMS. Esses espaços são preservados no esqueleto e reinseridos tanto na origem quanto no destino quando o trabalho é sincronizado de volta para o Strings. Isso pode afetar as validações de limite de caracteres configuradas no Strings, já que a contagem de espaços não é refletida no editor do TMS durante a tradução.

Usando o conector, vários projetos e arquivos podem ser monitorados no APC. Cada projeto requer monitoramento individual em um único APC.

Quando o APC processa um gatilho de Sincronização de Trabalho, ele cria um trabalho no TMS para cada localidade do Strings. A ordem de importação desses trabalhos não é garantida e não pode ser configurada por meio do modelo de projeto atribuído à regra do APC. Nenhum mecanismo de ordenação é aplicado em nenhuma etapa desse processo. Para aplicar um tratamento diferente a cada grupo de localidades, configure regras de APC separadas, cada uma apontando para um modelo de projeto diferente.

O conector usa anotações das localidades dos trabalhos para anexar metadados sobre o projeto correspondente do Phrase TMS aos trabalhos e às localidades dos trabalhos do Strings. O endpoint da API do Phrase Strings para listar as anotações das localidades dos trabalhos recupera esses metadados. O endpoint para listar as localidades de destino dos trabalhos também inclui esses metadados quando o parâmetro include_annotations é definido como true. Trabalhos anotados contêm campos como tms_project_id e tms_in_progress, que permitem o rastreamento do status de um trabalho do Strings em seu projeto do Phrase TMS vinculado.

O TMS não oferece suporte ao uso da mesma localidade tanto para o idioma de origem quanto para o de destino em um projeto. Por exemplo, se um trabalho do Strings usa en-US como localidade de origem e de destino, a localidade de destino en-US não pode ser importada para o TMS, e o trabalho como um todo não pode ser marcado como concluído. Não selecione a localidade de origem como localidade de destino ao criar trabalhos no Strings que serão sincronizados com o TMS.

Mensagens ICU e formas plurais CLDR

Ao enviar trabalhos do Strings contendo mensagens ICU ou formas plurais ao TMS para tradução, ative a opção Analisar mensagens ICU nas configurações de importação de arquivos XLIFF 2.0 ou nos modelos de projeto do TMS.

Casos de uso

Existem vários casos de uso para o conector:

Os gerentes de projetos do TMS podem adicionar arquivos diretamente a projetos do TMS a partir de um repositório online.
Configure o portal do solicitante do Phrase TMS para permitir que os solicitantes adicionem arquivos às solicitações diretamente do Phrase Strings.
Use a criação de projeto automatizado (ACP) do o TMS para ter novos projetos criados automaticamente quando uma alteração na última data de modificação for detectada para arquivos monitorados ou uma pasta.
- Para sincronização em nível de trabalho, configure o local monitorado pelo APC para apontar para a subpasta de trabalhos do projeto (por exemplo, All projects / [project name] / [branch] / jobs).
- Para sincronização em nível de projeto, configure o local monitorado pelo APC para apontar apenas para o caminho do projeto e da ramificação, sem a subpasta de trabalhos (por exemplo, All projects / [project name] / [branch]). Use o monitoramento baseado em agendamento em vez do monitoramento baseado em webhook, porque a sincronização em nível de projeto não inicia um trabalho do Strings e o evento de webhook jobs:start nunca é disparado.
- Para sincronizações de trabalho, o APC é acionado pelas seguintes atualizações de trabalho:
  - Chaves recém-adicionadas ou alterações em chaves existentes
  - Data de entrega de trabalho modificada no Strings
  Nota
  
  Reabrir trabalhos não conta como atualização para APC.
- Para sincronizações em nível de projeto, o APC é acionado por:
  - Chaves recém-adicionadas
  - Alterações em chaves existentes
- Se Criar um novo projeto a cada vez for selecionado ao configurar o APC, o repositório online remoto poderá ser monitorado não apenas para atualizações de texto original, mas também para atualizações de tradução.
  
  Se você optar por monitorar as atualizações da tradução, qualquer alteração feita no texto original da tradução no repositório online atualizará automaticamente a memória de tradução no Phrase TMS.
- Se a opçãoas atualizações de tradução feitas na entidade remota são gravadas automaticamente na memória de tradução for selecionada, as alterações de chave no idioma de tradução do Strings serão atualizadas automaticamente nas memórias de tradução do TMS usadas no projeto APC relevante.
A API do conector do TMS pode ser usada para automatizar etapas que, de outra forma, seriam realizadas manualmente por meio da interface do usuário. Os webhooks podem ser usados para fazer com que sistemas de terceiros sejam notificados sobre determinados eventos (por exemplo, uma alteração do estado do trabalho). Webhooks podem ser acionados para o evento jobs:start para sincronizações em nível de trabalho.

Página de sincronizações de trabalho

A página Sincronizações de trabalho fornece uma visão centralizada de todas as configurações de sincronização de trabalho (APCs) que usam o conector Phrase Strings. Inclui tanto as sincronizações criadas diretamente no Strings quanto aquelas configuradas no TMS, com informações relevantes.

A partir da página Sincronizações de trabalho, usuários com perfil de Administrador ou Gerente de Projetos no Strings podem configurar novas sincronizações de trabalho, editar sincronizações de trabalho existentes (incluindo seu estado ativo/inativo) ou excluí-las.

Sincronizações de trabalho existentes podem ser editadas ou excluídas usando as opções relevantes no menu Mais . Todas as alterações são sincronizadas entre o Strings e o TMS. Excluir uma sincronização de trabalho remove o APC correspondente no TMS.

A página Sincronizações de trabalho é acessível a partir dos menus de navegação à esquerda Integrações e Trabalhos.

Configurar sincronizações de trabalho no Strings

Nota

Se os campos personalizados necessários forem definidos no TMS, a configuração de sincronização de trabalho a partir do Strings não será suportada.

Para configurar uma nova sincronização de trabalho entre Strings e TMS com configuração básica, siga estas etapas na interface do usuário do Strings:

Na página Integrações, selecione Configurar ao lado da integração Sincronização de trabalho.

A página Sincronizações de trabalho é exibida.
Clique em + Nova sincronização de trabalho.

A janela Criar nova sincronização de trabalho é exibida.
Forneça um Nome de sincronização e selecione o(s) projeto(s) do Strings para conectar ao TMS no menu suspenso Projetos do Strings atribuídos.

Apenas projetos com as mesmas combinações de idiomas podem ser incluídos.
Opcionalmente, selecione o modelo de projeto TMS a ser usado. O modelo de projeto do TMS selecionado deve corresponder ao conjunto de idiomas definido em cada projeto do Strings atribuído.

Trabalhos sincronizados serão adicionados ao projeto do TMS criado a partir do modelo selecionado.
- Se Padrão for selecionado, um modelo de projeto TMS será criado automaticamente com base nos projetos do Strings selecionados.
Selecione o Tipo de projeto a ser criado no TMS.
- Projeto contínuo
  
  Opção padrão.
- Novo projeto
  
  Um novo projeto TMS é criado toda vez que mudanças são detectadas nos trabalhos do Strings.
Na seção Exportar de volta para o Strings, especifique as configurações de exportação do Strings para controlar como as traduções do TMS são exportadas de volta para o Strings.
- Substituir traduções existentes
  
  Atualiza traduções de destino existentes no Strings.
- Marcar o trabalho como concluído
  
  Marca automaticamente o trabalho como concluído no Strings.
- Verificar traduções inalteradas no Strings
  
  Chaves marcadas como não verificadas serão automaticamente verificadas no Strings caso as traduções de destino não tenham sido alteradas.
Se necessário, clique em Opções avançadas para exibir opções de exportação adicionais.
- Marcar o local como concluído
  
  Marca um local específico como concluído uma vez que suas traduções sejam sincronizadas de volta.
- Criar novas chaves e atualizar as existentes
  
  Garante que novas chaves do TMS sejam criadas no Strings e que as existentes sejam atualizadas.
- Aplicar tradução apenas se o texto original corresponder à versão armazenada
  
  Evita sobrescrever traduções se o texto original tiver sido alterado no Strings desde a exportação.
Clique em Gravar.

A nova configuração de sincronização de trabalho é adicionada à lista de Sincornizações de trabalho do TMS com estado inativo. Use o interruptor na coluna Ativo para ativar a sincronização de trabalho.

Dica

Para configurações mais avançadas, configure o conector usando as configurações do Phrase TMS.

Sempre que o mapeamento personalizado for usado, se alguma alteração for necessária, ela deve ser aplicada ao conector no TMS.

A criação do conector do Strings no Phrase TMS não cria automaticamente o APC para a importação e exportação automatizadas de trabalhos. O APC deve ser configurado separadamente no TMS.

Configurações do Phrase TMS

Algumas organizações já possuem um conector do Phrase Strings criado automaticamente, usando a identidade da plataforma Phrase da organização. Verifique a lista de conectores na página Conectores antes de criar um manualmente. O conector criado automaticamente se autentica no servidor usando a identidade do usuário conectado, não um token de acesso inserido manualmente.

O conector exibe o status Pendente enquanto conclui sua sincronização inicial após a criação e depois muda para Ativo. O estado Pendente também é acionado sempre que qualquer alteração é feita na configuração do conector ou quando a página de configurações do conector é salva, mesmo sem alterações significativas. Enquanto um conector exibe Pendente, ele não pode ser usado como fonte para a criação de trabalho no Phrase TMS. Aguarde o status mudar para Ativo antes de criar trabalhos com esse conector.

Na página de configurações role para baixo até a seção de Integrações.
Clique em Conectores.

A página Conectores é aberta.
Clique em Novo conector.

A página Criar conector é aberta.
Altere o Tipo para Phrase Strings e forneça um nome para o conector.
Insira o ID da conta e o token de acesso obtidos no Strings.
Clique em Testar conexão.
- Se a conexão for bem-sucedida, uma pequena marca de seleção aparecerá ao lado do botão Testar conexão.
Selecione os itens para importar para o TMS.

Se as chaves de destino não forem importadas, o arquivo XLIFF 2.0 poderá ser segmentado ainda mais se Segmentar XLIFF for selecionado em Configurações de importação de arquivos para arquivos XLIFF 2.0.
- Ative ou desative as opções avançadas de importação conforme necessário:
  - Aplicar o idioma de origem do projeto do TMS na importação
    
    O idioma de origem do projeto do TMS é aplicado independentemente do idioma padrão no projeto do Strings.
  - Criar um trabalho do TMS para cada idioma
    
    Ative esta opção para evitar a criação de trabalhos do TMS duplicados para locais já em progresso. Quando ativada, as alterações em chaves que já fazem parte de um trabalho ativo do TMS não são reimportadas até que o trabalho original seja concluído. Recomendado para mais controle em trabalhos com múltiplos idiomas.
  - Envolver conteúdo HTML em CDATA
    
    A opção garante que entidades HTML envoltas em CDATA sejam preservadas durante a transferência entre o Strings e o TMS.
    
    A opção permite importar conteúdo que combine a sintaxe ICU e elementos HTML em linha.
Selecione um modo de exportação.
- Ative ou desative as seguintes opções de exportação conforme necessário:
  - Substituir traduções
    
    Desabilite para evitar que traduções existentes sejam atualizadas com o conteúdo do arquivo.
  - Criar novas chaves ou atualizar as existentes
    
    Desabilite para evitar a criação de novas chaves e atualizações em chaves existentes.
  - Aplicar a tradução apenas se o texto de origem corresponder
    
    Traduções que não estão alinhadas com o conteúdo mais recente do texto original são excluídas durante a sincronização. Isso ajuda a manter a consistência entre o texto original e as traduções, evitando traduções desatualizadas ou incorretas.
  - Verificar apenas se a tradução não tiver sido alterada
    
    Chaves marcadas como não verificadas serão automaticamente verificadas no Strings no caso de traduções de destino inalteradas. Quando ativada, cada tradução retornada do TMS é marcada como verificada no Strings, independentemente de o texto ter sido editado ou apenas retornado sem alterações. Apenas as chaves cujo texto de origem foi alterado no Strings enquanto o trabalho estava aberto são excluídas e permanecem não verificadas.
  - Marcar idioma como concluído
    
    Marca um local específico como concluído uma vez que suas traduções sejam sincronizadas de volta.
  - Marcar o trabalho como concluído
    
    Se selecionada, o trabalho será marcado como concluído somente quando a última localidade for carregada.
Se especificado, selecione uma pasta padrão (possível apenas após salvar).
O mapeamento de idioma é apresentado e pode ser personalizado, se necessário. Certifique-se de que cada localidade do Strings tenha apenas uma entrada de mapeamento para uma única localidade do TMS na configuração do conector. As alterações no mapeamento de idioma não afetarão trabalhos existentes.

A lista divide em páginas cinco projetos por vez, com os projetos sendo classificados alfabeticamente; primeiro de A a Z (em maiúsculas) e depois de a a z (minúsculas).
Clique em Gravar.

O conector está adicionado à lista na página de conectores.

Aceitos na integração:

Modelos de projeto do TMS
Fluxos de trabalho do TMS
Briefing do trabalho (não aplicável ao usar sincronização em nível de projeto)
Data de entrega do trabalho (não aplicável ao usar sincronização em nível de projeto)

A data de entrega definida no Strings atualizará o prazo final do projeto no TMS. Se houver mais de uma data de entrega, a mais remota será aplicada ao projeto TMS.

Transferido do Strings para o TMS como referência de projeto:

Nomes de chave

Transferido do Strings e exibido como chave de contexto no painel nota de contexto dos editores CAT do TMS.

Descrições de chave

Transferido do Strings e exibido como nota de contexto no painel Nota de contexto dos editores CAT do TMS.

Tamanho máximo de caracteres de chave

Transferido do Strings e exibido no painel Nota de contexto dos CAT Editors do TMS.

Capturas de tela

Para exibir capturas de tela do Strings no painel nota de contexto dos editores CAT do TMS:
- Ative a opção Permitir carregamento de conteúdo externo no editor Phrase CAT na seção Acesso e Segurança das configurações do projeto do TMS.
- Selecione o formato de texto Rich no painel nota de contexto.
Metadados personalizados em formatos de arquivo aceitos:
- .XLSX
- .CSV
- .XLIFF 2.0

Monitorando atualizações da tradução feitas no Strings por meio do APC

Para monitorar atualizações de tradução feitas no Strings por meio do APC, execute estas etapas:

Ao configurar um APC, selecione Criar um novo projeto a cada vez.

Isso permite o monitoramento do repositório online para atualizações de tradução feitas no Strings.
Na seção Automações da configuração APC, selecione As atualizações de tradução feitas na entidade remota são gravadas automaticamente na memória de tradução.

As alterações feitas no conteúdo do idioma de tradução no Strings serão gravadas automaticamente na memória de tradução do Phrase TMS quando o monitoramento APC for acionado.

É possível substituir as atualizações da memória de tradução modificando os segmentos de tradução no Phrase TMS editor. Essas atualizações serão exportadas de volta ao Strings quando o trabalho do Phrase TMS for concluído.

Comportamento de exclusão de chave com APC

A exclusão de uma chave no Strings após ela ter sido incluída em um trabalho não afeta um trabalho do Phrase TMS que foi criado por meio de uma importação manual pontual. Esse trabalho permanece inalterado até ser reimportado manualmente.

Quando o monitoramento APC está ativo, o Phrase compara um hash de conteúdo a cada sondagem ou gatilho de webhook e trata qualquer alteração, incluindo uma exclusão de chave, como uma atualização que aciona uma ressincronização.

No modo de projeto contínuo, a ressincronização atualiza o projeto ou trabalho existente do Phrase TMS para corresponder ao conteúdo atual no Strings, de modo que o conteúdo da chave excluída é removido desse trabalho.
No modo de criar um novo projeto a cada vez, a ressincronização cria uma nova versão do trabalho do Phrase TMS que reflete o conteúdo após a exclusão, enquanto as versões de trabalho criadas anteriormente permanecem inalteradas.

Solução de problemas para Job Sync

A tabela abaixo esboça problemas comuns que os usuários podem encontrar ao usar a integração com o Strings. Fornece possíveis causas e soluções para o diagnóstico de problemas.

Problema	Causa(s)	Solução
Mensagem de advertência relacionada ao `NMTOKEN` em trabalhos do TMS	Nomes de chaves contêm caracteres indesejados (p.ex. espaços)	Os usuários ainda podem processar o conteúdo da tradução e exportá-lo de volta para Strings, apesar da mensagem de advertência.
As chaves no TMS estão vazias	Trabalho contém chaves sem texto original no idioma do texto original	Ou: Ignorar os segmentos. Remova as chaves do trabalho Strings e reimporte o texto original do repositório on-line.
APC não está criando projetos/processando novos trabalhos	Inconsistência de códigos idiomas	Certifique-se de que os códigos do idioma no Strings correspondência aos do projeto do TMS. Quando a APC é definida como projeto contínuo, qualquer alteração feita no modelo de projeto após a criação do projeto não será aplicada a projetos existentes. Portanto, as alterações precisam ser feitas diretamente nos projetos contínuos.
	O APC considera o trabalho/local como processado	Se as configurações de modelo de projeto/APC forem modificadas após iniciar o trabalho, elas podem ser consideradas processadas no histórico do APC. Portanto, pode ser necessário atualizar o trabalho para qualificá-lo para a seguinte iteração. Ou: Adicionar uma nova chave ao trabalho ou atualizar uma chave existente no trabalho Alterar a data de entrega do trabalho no Strings
	Erro `"429 Too many requests"` (Limite de strings de API)	Reduzir o número de CPAs e diminuir a frequência de monitoramento.
Chave existente no projeto Strings está ausente no trabalho do TMS	A chave específica não foi adicionada ao trabalho do Strings	Adicione a chave ao trabalho do Strings e reimporte o trabalho do repositório online no TMS
O erro "Could not authenticate" aparece ao tentar importar/exportar trabalhos.	Token de acesso expirado ou revogado no conector "created by Phrase Strings" criado automaticamente	Crie um novo conector do Phrase Strings no TMS, vincule novamente os APCs existentes ao novo conector e acione o monitor.
O trabalho do Strings não pode ser encontrado para importação ou reimportação via APC ou manualmente, embora não seja exibido como concluído.	O trabalho já foi importado para um projeto do TMS que foi posteriormente movido para a lixeira sem ser concluído ou excluído permanentemente. Como o projeto tecnicamente ainda está em andamento, o trabalho não é liberado para reimportação.	Verifique as Annotations do trabalho ao lado de sua localidade no Strings para verificar se ele já foi importado para o TMS antes de solucionar problemas adicionais. Se o projeto vinculado for encontrado na lixeira, restaure o projeto e continue trabalhando nele diretamente ou, se o projeto não for necessário, cancele os trabalhos e o projeto, ou exclua permanentemente o projeto via API usando o parâmetro `purge=true` para que o APC não o considere mais uma versão ativa.
A sincronização de trabalho falha ao salvar, com o erro "`Locales are not supported by Phrase TMS: x`", mesmo que o conector do TMS tenha um mapeamento de localidade personalizado configurado.	A sincronização de trabalho valida as localidades de destino no projeto do Strings diretamente em relação à lista de localidades com suporte nativo no TMS no momento do salvamento. Essa validação não leva em conta os mapeamentos personalizados de localidades do conector.	Para um projeto do Strings com uma localidade de destino não suportada nativamente pelo TMS, use o conector do Strings diretamente no TMS, em vez de usá-lo a partir do Strings, e configure um mapeamento personalizado de idiomas.
As traduções não são exportadas de volta para o Strings, mesmo que os trabalhos mostrem um status delivered no TMS.	O projeto ou modelo possui uma configuração de automação de status de projeto que marca o projeto (e seus trabalhos) como concluído/entregue assim que todos os trabalhos são pré-traduzidos, em vez de quando são entregues. Isso faz com que os trabalhos recebam o status de entregue sem executar a etapa de exportação para o Strings. Assim, o serviço de automação nunca agenda a exportação e nenhuma tradução é enviada de volta para o Strings.	Nas configurações de Project status automation do modelo de projeto, defina Mark project as 'completed' once all jobs are" para "delivered in all their workflow steps em vez de completed in all their workflow steps. Para trabalhos criados manualmente, exporte o trabalho manualmente de volta para o Strings e altere manualmente o status do trabalho para delivered, já que exportações manuais não atualizam o status do trabalho automaticamente. Assim que todos os trabalhos no projeto forem definidos como delivered, o projeto é marcado automaticamente como completed.