A integração do Phrase Strings (chamada de na interface do Strings) conecta o Phrase TMS e o Phrase Strings. A integração suporta sincronização em nível de trabalho e 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. Por padrão, os trabalhos enviados do Strings para o TMS são importados como arquivos XLIFF 2.0.
Recomendado para fluxos de trabalho baseados em lotes 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 exigir a criação de um 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
Arquivos Figma podem ser exibidos no Strings como um arquivo completo ao vivo, mas não são suportados no TMS. O editor CAT do TMS só pode exibir conteúdo traduzido em um frame específico do Figma no formato SVG.
Os estados de tradução das chaves do Strings não são suportados. Chaves que estão marcadas como no Strings antes da importação para o TMS podem ser retornadas ao Strings como em caso de traduções de destino inalteradas.
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 para preservar entidades HTML em vez de exibir 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 do TMS por 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 classificação é aplicado em qualquer estágio deste processo. Para aplicar um tratamento diferente por grupo de localidade, configure regras de APC separadas, cada uma apontando para um modelo de projeto diferente.
O conector usa anotações de localidade de trabalho para anexar metadados sobre o projeto Phrase TMS correspondente a trabalhos e localidades de trabalho do Strings. O endpoint da API do Phrase Strings para listar anotações de localidade de trabalho recupera esses metadados. O endpoint para listar localidades de destino de trabalho 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 Phrase TMS vinculado.
O TMS não oferece suporte ao uso da mesma localidade como idioma de origem e de destino em um projeto. Por exemplo, se um trabalho do Strings usa en-US como idioma de origem e de destino, o destino en-US não pode ser importado para o TMS, e o trabalho geral não pode ser marcado como concluído. Não selecione a localidade de origem como uma 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 para o TMS para tradução, ative a opção nas configurações de importação de arquivo XLIFF 2.0 ou nos modelos de projeto do TMS.
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ções em nível de trabalho e em nível de projeto, o caminho do projeto monitorado deve ser selecionado até a pasta de jobs (por exemplo, space/project/main/jobs).
-
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 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çã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).
A página 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 , usuários Administradores e 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 . 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 é acessível a partir dos menus de navegação à esquerda e .
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 , selecione Configurar ao lado da integração .
A página é exibida.
-
Clique em + Nova sincronização de trabalho.
A janela é exibida.
-
Forneça um e selecione o(s) projeto(s) do Strings para conectar ao TMS no menu suspenso .
Apenas projetos com as mesmas combinações de idiomas podem ser incluídos.
-
Opcionalmente, selecione o a ser usado. O modelo de projeto TMS selecionado deve corresponder ao conjunto de idiomas definido no(s) projeto(s) do Strings atribuído(s).
Trabalhos sincronizados serão adicionados ao projeto do TMS criado a partir do modelo selecionado.
-
Se for selecionado, um modelo de projeto TMS será criado automaticamente com base nos projetos do Strings selecionados.
-
-
Selecione o de projeto a ser criado no TMS.
-
Opção padrão.
-
Um novo projeto TMS é criado toda vez que mudanças são detectadas nos trabalhos do Strings.
-
-
Na seção , 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.
-
Atualiza traduções de destino existentes no Strings.
-
Marca automaticamente o trabalho como concluído 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.
-
Marca um local específico como concluído uma vez que suas traduções sejam sincronizadas de volta.
-
Garante que novas chaves do TMS sejam criadas no Strings e que as existentes sejam atualizadas.
-
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 com estado inativo. Use o interruptor na coluna 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 qualquer 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 importação/exportação automatizada de trabalhos. O APC deve ser configurado separadamente no 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 antes de criar um manualmente. O conector criado automaticamente autentica no lado do servidor usando a identidade conectada, não um token de acesso inserido manualmente.
O conector mostra o status enquanto conclui sua sincronização inicial após a criação e, em seguida, muda para . O estado 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 mostrar , ele não poderá ser usado como origem para a criação de trabalhos no Phrase TMS. Aguarde até que o status mude para antes de criar trabalhos com esse conector.
-
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 e forneça um nome para o conector.
-
Insira o ID da conta e o token de acesso obtidos do Strings.
-
Clique em Testar conexão.
-
Se bem-sucedido, uma pequena marca de seleção aparecerá ao lado do botã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 mais segmentado se Segmentar XLIFF for selecionado em para arquivos XLIFF 2.0.
-
Ative ou desative as opções avançadas de importação conforme necessário:
-
O idioma de origem do projeto do TMS é aplicado independentemente do idioma padrão no projeto do Strings.
-
Ative esta opção para evitar a criação de trabalhos do TMS duplicados para locais já em progresso. Quando ativado, 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.
-
-
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:
-
Desabilite para evitar que traduções existentes sejam atualizadas com o conteúdo do arquivo.
-
Desabilite para evitar a criação de novas chaves e atualizações em chaves existentes.
-
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.
-
Chaves marcadas como serão automaticamente verificadas no Strings no caso de traduções de destino inalteradas. Quando ativado, cada tradução retornada do TMS é marcada como no Strings, independentemente de o texto ter sido editado ou 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 .
-
Marca um local específico como concluído uma vez que suas traduções sejam sincronizadas de volta.
-
Se selecionado, o trabalho será marcado como concluído somente quando o último locale for carregado.
-
-
-
Se especificado, selecione uma pasta padrão (possível apenas após salvar).
-
O é apresentado e pode ser personalizado, se necessário. Certifique-se de que cada locale do Strings tenha apenas uma entrada de mapeamento para um único locale 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 .
Excluir um conector
Para excluir um conector:
-
Na página , selecione o conector a ser excluído.
-
Clique em Excluir.
A janela é aberta.
-
Digite "delete" e clique em Excluir.
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 estão na Lixeira. Tentar excluir tal conector retorna um erro de "Falha ao excluir conector".
Resolução: Abra o projeto associado ao conector e conclua ou exclua quaisquer trabalhos restantes. Vá para e esvazie-a para remover quaisquer trabalhos ainda vinculados ao conector. Tente excluir o conector novamente.
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 (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 dos editores CAT do TMS:
-
Ative a opção na seção Acesso e Segurança das configurações do projeto TMS.
-
Selecione o formato de texto no painel .
-
-
Metadados personalizados em formatos de arquivo aceitos:
-
.XLSX
-
.CSV
-
.XLIFF 2.0
-
Para monitorar atualizações de tradução feitas no Strings por meio do APC, execute estas etapas:
-
Ao configurar um APC, selecione .
Isso permite o monitoramento do repositório online para atualizações de tradução feitas no Strings.
-
Na seção da configuração APC, selecione .
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
Excluir 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 única. Esse trabalho permanece inalterado até que seja reimportado manualmente.
Quando o monitoramento APC está ativo, o Phrase compara um hash de conteúdo em 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 , a ressincronização atualiza o projeto ou trabalho existente do Phrase TMS para corresponder ao conteúdo atual no Strings, portanto, o conteúdo da chave excluída é removido desse trabalho.
-
No modo , a ressincronização cria uma nova versão do trabalho do Phrase TMS refletindo o conteúdo pós-exclusão, enquanto as versões de trabalho criadas anteriormente permanecem inalteradas.
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 |
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:
|
|
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:
|
|
|
Erro |
Reduzir o número de CPAs e diminuir a frequência de monitoramento. |
|
|
A chave existente no projeto Strings está ausente no trabalho 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 criado automaticamente \"created by Phrase Strings\" |
Crie um novo conector 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 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 do trabalho ao lado de seu idioma no Strings para confirmar se ele já foi importado para o TMS antes de continuar a solução de problemas. 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 |
|
A sincronização de trabalho falha ao salvar, com o erro \" |
A sincronização de trabalho valida os idiomas de destino no projeto Strings diretamente em relação à lista de idiomas suportados nativamente pelo TMS no momento do salvamento. Essa validação não leva em conta os mapeamentos de idioma do conector personalizado. |
Para um projeto Strings com um idioma de destino não suportado nativamente pelo TMS, utilize o conector Strings diretamente no TMS, em vez de acessá-lo a partir do Strings, e configure o mapeamento de idioma personalizado. |
|
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 força os trabalhos para o status de entregue sem executar a etapa de exportação para o Strings, portanto, 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 Automação de status do projeto do modelo de projeto, defina em vez de . Para trabalhos criados manualmente, exporte manualmente o trabalho 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 estiverem definidos como delivered, o projeto é automaticamente marcado como completed. |