-
Gerentes de projetos
-
Planos Team, Ultimate e Enterprise (legado)
Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.
Devido a melhorias constantes, a interface do usuário pode não ser exatamente a mesma que é apresentada no vídeo.
As regras de criação automatizada de projetos permitem a configuração de como o Phrase monitora pastas específicas por meio de um conector de integração e cria novos projetos se conteúdo novo ou atualizado for detectado dentro delas.
-
A maioria das configurações da APC é gerenciada em modelos de projeto. O modelo de projeto define destinos de arquivo, idiomas de origem e destino e etapas de fluxo de trabalho. Detalhes financeiros e de processo também são definidos no modelo de projeto, como provedores e a geração de orçamentos e análises.
-
APCs separadas podem compartilhar o mesmo modelo de projeto, mas cada APC ainda cria seu próprio projeto. Trabalhos de arquivos ou pastas monitorados por diferentes APCs não são combinados em um único projeto.
-
Os projetos criados pela APC são exclusivos da própria APC. A APC só pode importar trabalhos para projetos do TMS que a própria APC criou; ela não pode importar um trabalho para um projeto do TMS separado e pré-existente que tenha sido criado manualmente ou por outro processo.
Exportando traduções de volta para o repositório:
-
Os trabalhos são exportados quando o status do projeto é definido como .
-
Os trabalhos podem ser exportados manualmente escolhendo > . Mesmo arquivos inalterados serão exportados.
-
Cada arquivo de destino é armazenado em um caminho de destino especificado nas configurações da APC.
Reimportação:
-
Os trabalhos podem ser reimportados a partir do menu na tabela de trabalhos.
Pré-requisitos:
-
Pelo menos um conector e um modelo de projeto em um perfil.
-
(Opcional) Um modelo de e-mail com ou selecionado como o tipo.
-
Se estiver usando Job Sync (conector Phrase Strings), várias pastas ou arquivos podem ser definidos para monitoramento.
Para o Job Sync, as opções para marcar o local do trabalho e o trabalho como concluído após a exportação podem ser habilitadas nas configurações do conector Phrase Strings. Essas configurações marcam um local de idioma exportado de um trabalho e, eventualmente, todo o trabalho, como Concluído em Strings assim que o trabalho correspondente do TMS é exportado, para que a APC pare de monitorar esse conteúdo. Se essas opções não estiverem habilitadas, o trabalho no Strings permanece em andamento, e uma atualização de origem desse conteúdo pode ser detectada pela APC e acionar uma reimportação.
Importante
Monitorar mais de 10.000 arquivos por APC pode causar erros de importação de arquivos e problemas de desempenho. Se ocorrer um erro na interface do usuário, recomenda-se reduzir o número de arquivos monitorados e acionar manualmente o monitoramento da APC para tentar a importação novamente.
Um máximo de 10 pastas monitoradas pode ser definido por APC.
Siga estas etapas:
-
Crie uma nova APC
-
Na página Configurações
, clique em Criação automatizada de projetos.
A página é aberta.
-
Clique em Novo.
A página é aberta.
-
Forneça um nome para a APC (canto superior esquerdo).
-
Selecione um modelo de projeto, se necessário.
-
Defina o status ativo/inativo (canto superior esquerdo).
O botão Salvar fica ativo assim que todos os campos obrigatórios forem preenchidos.
-
-
Definir criação e exportação
-
Escolha como o projeto deve ser criado.
-
Selecione se:
-
O APC deve ser um projeto contínuo.
-
Selecione na lista suspensa como um novo projeto é criado com base em quando e onde as alterações são detectadas.
-
-
Selecione um modelo de projeto na lista suspensa.
-
O idioma de origem é definido no modelo de projeto e todos ou um subconjunto dos idiomas de destino podem ser selecionados. Os idiomas de destino selecionados para um APC aplicam-se a todos os arquivos e pastas que o APC monitora. Um APC não pode atribuir um conjunto diferente de idiomas de destino a arquivos ou subpastas diferentes dentro da mesma regra. Para criar trabalhos com conjuntos de idiomas de destino diferentes para arquivos ou subpastas diferentes (por exemplo, um arquivo exigindo apenas alemão e outro exigindo alemão, espanhol e francês), configure um APC separado para cada arquivo ou pasta, com cada APC apontando apenas para os arquivos ou pastas relevantes e configurado apenas com os idiomas de destino necessários para esse conteúdo.
-
Selecione Exibir detalhes do modelo de projeto para visualizar as configurações do modelo de projeto selecionado.
-
A seleção de arquivos em (etapa 2) exibe as entradas no idioma de origem padrão (idioma de origem conforme configurado no conector). Se um modelo de projeto for selecionado, as entradas serão exibidas para o idioma de origem desse modelo. Independentemente das configurações e de possíveis discrepâncias entre o modelo de projeto e os idiomas de origem configurados no conector, o idioma de origem do modelo de projeto é seguido e os trabalhos são criados corretamente.
-
-
Selecione os critérios para exportar traduções.
O comando refere-se ao estado do fluxo de trabalho em que as traduções se encontram quando devem ser exportadas. O usuário pode decidir qual conteúdo exportar; exemplos são traduções da etapa final do fluxo de trabalho ou de uma etapa anterior a essa.
É possível definir até 5 exportações. Configure qual conteúdo deve ser exportado (de qual etapa do fluxo de trabalho) e quando a exportação é acionada.
fornece o evento que aciona a exportação.
-
As traduções serão exportadas quando uma etapa de fluxo de trabalho selecionada for concluída; quando uma etapa de fluxo de trabalho especificada for concluída para um idioma de destino, isso aciona a exportação para esse idioma sem esperar que o restante dos idiomas de destino sejam concluídos.
-
As traduções serão exportadas quando todo o projeto for concluído - isto é, quando todos os trabalhos de todas as etapas do fluxo de trabalho estiverem concluídos.
-
-
-
Monitoramento
-
Clique em Monitorar pasta ou arquivo para escolher uma pasta a ser monitorada quanto a conteúdo novo ou atualizado.
A janela abre com uma lista de todos os conectores configurados para a conta.
Se o conector necessário não estiver listado, ele pode ser adicionado clicando no botão de mais
no canto superior esquerdo da janela.
-
Clique em um conector para abrir a lista de pastas.
-
Selecione a pasta ou arquivo específico a ser monitorado.
Nem todas as opções estão disponíveis em todos os conectores
-
Se nenhum for selecionado, a pasta inteira será monitorada quanto a alterações ou novos arquivos.
-
Inclua subpastas para permitir o monitoramento da pasta selecionada e de suas subpastas.
-
pode ser usado para conectores baseados em arquivos para indicar quais arquivos já foram usados para tradução.
permite que os clientes definam uma expressão regular para filtrar os arquivos a serem monitorados dentro da pasta. Isso não pode ser usado para filtrar pastas.
-
-
Clique em Confirmar.
A pasta ou arquivo selecionado é listado com o nome e o tipo de conector e o caminho para a entidade monitorada. Clique em Procurar para alterar a seleção.
Para alguns conectores, mais pastas ou arquivos podem ser adicionados à lista clicando em Monitorar pasta ou arquivo novamente. Isso está disponível atualmente para as seguintes integrações: Strings, Contentful, WordPress, Kontent.ai, Git, GitHub, GitLab e Zendesk Guide.
-
Várias pastas ou arquivos só podem ser monitorados dentro de um conector.
-
Se forem feitas alterações no conector monitorado, as configurações salvas anteriormente serão excluídas.
Clique em Salvar para confirmar a seleção das pastas e dos arquivos.
-
-
Clique em Adicionar monitor para selecionar um gatilho ou .
Forneça o webhook ou o agendamento (ou ambos) na janela de monitoramento.
Monitoramento com base em webhook
-
O token do webhook é gerado automaticamente ao selecionar o monitoramento e clicar em Adicionar durante a configuração do APC.
-
Cada APC recebe seu próprio token exclusivo. O token não é compartilhado e não pode ser reutilizado em outros APCs.
-
Chamar a URL do webhook aciona a detecção de alterações imediatamente naquele APC específico. Se um APC já estiver executando uma verificação quando o webhook for disparado novamente, o Phrase coloca em fila uma execução adicional. Chamadas adicionais enquanto uma execução já está na fila não criam execuções adicionais; elas confirmam que a única execução pendente prosseguirá.
Nota
Este webhook é um mecanismo separado do recurso de Webhooks de uso geral do Phrase Strings, que envia notificações de eventos de saída para uma URL especificada e não fornece nem aceita o token de webhook do APC. Configure um APC acionado por webhook através das etapas de configuração do APC, não através de um webhook do Strings criado manualmente.
Ao usar o conector Job Sync, configure um APC acionado por webhook através das etapas de configuração do APC, não através de um webhook do Strings criado manualmente.
-
-
-
Defina automações opcionais
-
Selecione as automações necessárias.
-
-
Opções de análises e orçamentos
-
Modelos de e-mail com o ou estarão disponíveis neste menu suspenso.
-
-
Selecione as opções de atualização de origem (apenas habilitadas para projetos contínuos).
-
Se tiver sido selecionado na parte de da configuração do APC, o APC monitora pastas remotas para atualizações de origem, mas uma configuração detalhada não é necessária, porque um novo projeto é criado toda vez que uma alteração é detectada.
-
Para um projeto contínuo, especifique quais etapas do fluxo de trabalho exigem reabertura quando uma atualização da fonte é detectada, se novas análises e orçamentos devem ser gerados e se os proprietários do projeto devem ser notificados sobre uma atualização da fonte.
-
Se estiver selecionado para gerar novas análises a cada atualização da fonte, especifique o que excluir da análise (segmentos confirmados, segmentos bloqueados, números) e como agrupar a contagem de palavras (por provedor, por idioma).
Nota
As configurações padrão das análises contínuas são uma combinação das configurações padrão obrigatórias da Análise de Pós-Edição e da Análise Padrão.
Se necessário, habilite a para inserir um padrão de nomenclatura para análises contínuas usando macros disponíveis.
-
-
-
Selecione as opções de atualização de destino (habilitadas apenas para o conector Phrase Strings se estiver selecionado).
O usuário pode monitorar o repositório online remoto para atualizações de destino. Quaisquer alterações feitas na cópia de destino no repositório online atualizarão automaticamente a memória de tradução.
-
Clique em Gravar.
A é aberta.
Se estiver selecionado, uma simulação da automação cria uma linha de base na primeira iteração e importa apenas arquivos novos/atualizados após essa linha de base para reduzir o uso desnecessário. Esta opção está disponível apenas na primeira iteração.
-
Clique em Confirmar.
O APC é adicionado à lista na página de .
-
Com as regras de automação definidas, o conteúdo agora pode ser criado nas pastas designadas. Com base em verificações de frequência, o Phrase examina a pasta especificada e identifica conteúdo novo ou atualizado (com base em nomes de arquivos, metadados, tamanho, etc.).
O APC usa duas estratégias de detecção de alterações, dependendo do tipo de conector e de sua configuração.
Detecção baseada no histórico de arquivos
Isso é usado pela maioria dos conectores. A cada execução de detecção, o APC lista os arquivos na pasta monitorada e compara cada arquivo com um registro armazenado da execução anterior. Os seguintes campos são comparados:
-
Hash
-
Tamanho do arquivo
-
Última modificação
-
Data de entrega
Quais campos estão realmente disponíveis depende do que o conector fornece, já que nem todos os conectores expõem todos os campos. Todos os campos disponíveis (não nulos) são comparados.
Um arquivo é considerado alterado quando qualquer campo disponível no arquivo de entrada difere do registro armazenado. Se o conjunto de campos disponíveis mudar entre as execuções, por exemplo, um hash se tornando disponível onde não estava antes, o arquivo é tratado como tendo metadados modificados e uma importação é acionada.
O registro armazenado é atualizado após cada ciclo de detecção bem-sucedido.
Detecção Baseada em Diferenças
Usado quando um conector baseado em Git tem monitoramento de subpastas habilitado. Para conectores Git sem monitoramento de subpastas, a detecção baseada no histórico de arquivos é usada em seu lugar.
Em vez de comparar metadados de arquivos, o APC consulta o conector para obter a lista de arquivos que foram alterados desde o último commit processado.
-
Na primeira execução, o APC busca todos os arquivos na pasta e trata todos eles como alterados.
-
Nas execuções subsequentes, o APC solicita apenas os arquivos alterados desde o último commit conhecido.
O ID do último commit processado é armazenado e usado como ponto de partida para a próxima execução de detecção.
Quando uma Importação ou Atualização é Ignorada
O APC ignora o acionamento de uma importação ou atualização sob as seguintes condições:
-
Nenhum arquivo correspondente encontrado
Se a pasta monitorada não retornar arquivos, ou nenhum arquivo corresponder ao filtro de nome de arquivo configurado, a execução é ignorada sem que nenhuma ação seja tomada.
-
O arquivo foi carregado por este APC
Se um arquivo na pasta monitorada foi carregado anteriormente pela mesma instância do APC (por exemplo, um arquivo traduzido gravado de volta na pasta de origem), ele é excluído da detecção de alterações para evitar a reimportação da saída do APC.
-
Nenhuma alteração de conteúdo detectada (conectores baseados em histórico de arquivos)
Se todos os campos disponíveis de um arquivo corresponderem ao registro armazenado, o arquivo é tratado como inalterado e ignorado.
-
Importação seletiva (arquivo não está no conjunto selecionado)
Quando uma execução é configurada para importar apenas arquivos específicos, os arquivos fora do conjunto selecionado são excluídos da execução atual e avaliados no próximo ciclo de detecção.
Quando várias pastas são monitoradas
Quando o APC monitora várias pastas, cada pasta monitorada executa sua própria detecção independente. Os resultados são coletados e mesclados antes de acionar a importação subsequente.
Uma pasta que usa um conector baseado em Git com monitoramento de subpastas ativado usa detecção de diff; todas as outras pastas usam detecção baseada no histórico de arquivos.
Para conectores Job Sync que monitoram trabalhos do Phrase Strings, a detecção de alterações verifica cada trabalho ativo na pasta monitorada a cada execução. Um grande número de trabalhos ativos em uma pasta monitorada pode aumentar significativamente o tempo que uma execução de APC leva para ser concluída, mesmo quando apenas alguns trabalhos precisam ser importados. Para manter a detecção de alterações rápida, marque um trabalho ou a localização do trabalho como Concluído no Phrase Strings assim que ele for finalizado, e mantenha baixo o número de trabalhos ativos em uma pasta monitorada.
Cada arquivo de destino é exportado para uma pasta especificada nas configurações do projeto.
Existem três maneiras de desativar a APC:
-
Desativada manualmente nas configurações.
-
Desativa automaticamente após 90 dias de inatividade.
-
Automaticamente após o perfil da organização ter sido desativado (ao final da assinatura).
Quando um conector usado como parte das regras de Criação Automatizada de Projetos detecta três ou mais instâncias consecutivas de um projeto que não foi criado quando deveria, uma notificação é enviada aos usuários afetados.
-
Vários arquivos ZIP podem ser importados para um projeto.
-
Os arquivos traduzidos são exportados de volta para arquivos ZIP.
-
Se um arquivo ZIP for importado para vários idiomas de destino, os arquivos traduzidos serão exportados para vários arquivos ZIP — um ZIP para cada idioma de destino — usando o código de localidade de destino no nome do ZIP (por exemplo, Pack18.en_us.ZIP).
A página fornece uma visão geral dos APCs disponíveis atualmente.
Os APCs podem ser filtrados por , , , e .
Se um APC específico for selecionado:
-
Editar
Abre o APC selecionado para edição.
-
Clone
Faz uma cópia do APC selecionado.
-
Acionar monitor
Verifica manualmente se há atualizações nos arquivos de origem e atualiza a data e a hora do .
-
Forçar importação
Importa todos os arquivos da pasta remota monitorada pelo APC selecionado, ignorando a detecção de alterações.
Quando a importação forçada está habilitada, todos os arquivos que correspondem ao filtro de pasta são tratados como alterados, independentemente do histórico armazenado. Isso é útil para reprocessar arquivos após alterações de configuração ou quando uma reimportação é necessária.
-
Forçar importação seletiva
Selecione quais arquivos da(s) pasta(s) monitorada(s) importar. Apenas os arquivos selecionados ignoram a detecção de alterações. Os arquivos restantes na pasta não são afetados e são avaliados normalmente na próxima execução de detecção agendada.
-
-
Excluir
APCs associados a projetos ativos não podem ser excluídos.
A exclusão do APC é permanente. Um APC excluído não pode ser restaurado da lixeira nem recriado automaticamente; ele deve ser configurado novamente do zero, se necessário. Isso é diferente de desabilitar manualmente um APC (torná-lo inativo), o que pode ser reabilitado a qualquer momento.
Clicar em um APC específico abre a página de configurações desse APC. A partir da página de configurações, é possível:
-
A partir da guia , revise e atualize as configurações do APC.
-
A partir da guia , rastreie as operações executadas pelo APC e seu status.
-
A partir da guia , visualize e baixe análises contínuas existentes geradas para o APC.
Registro de histórico
O log de histórico do APC detalha todas as operações realizadas por um APC. Ele permite que os gerentes de localização visualizem todos os eventos do APC, pesquisem e filtrem os mesmos e solucionem problemas com um APC específico.
Nota
A barra de pesquisa funciona apenas para consultas em inglês. Todos os dados são armazenados em inglês para que os logs sejam úteis para os engenheiros e equipes de suporte técnico / sucesso do cliente da Phrase.
O log rastreia estes eventos:
-
Projeto
-
Criar
-
Mudança de status
-
-
Trabalho
-
Importar
-
Exportar
-
Atualização do original
-
Atualização da tradução
-
Mudança de status
-
-
Monitoramento
-
Monitoramento de pasta
-
-
APC
-
Criar
-
Desativar
-
O log não rastreia:
-
Operações manuais (importações manuais de arquivos)
-
Operações que não têm impacto no funcionamento do APC (por exemplo, atualizações de configurações de modelo de projeto que não afetam o APC)
-
Operações não relacionadas ao APC
-
Criação de orçamento e análise
-
Atualizações de TM
-
Notificações enviadas
-
Alterações de configuração do APC
O status de um APC é apresentado na página Visão geral do APC.
-
Ativo
O APC está em execução sem problemas
-
Inativo
O APC foi intencionalmente inativado
-
Executando
O APC está processando conteúdo do repositório monitorado. O tempo de processamento depende do tamanho do conteúdo monitorado.
Para manter os tempos de processamento do APC curtos:
-
Acione importações com mais frequência, em lotes menores, em vez de permitir que grandes lotes de arquivos se acumulem.
-
Divida o monitoramento de pastas ou caminhos grandes entre vários APCs (por exemplo, por pasta ou área de produto) para que cada APC processe menos arquivos.
-
Crie um novo APC em vez de reativar um que esteja inativo há muito tempo para evitar a importação de um grande acúmulo de trabalhos elegíveis de uma só vez.
-
-
Requer atenção
O APC está em execução, mas requer a atenção do usuário devido a possíveis alterações ou erros menores que podem afetar o APC.
Os status de erro e aviso em um APC refletem apenas o resultado da execução mais recente. Esses status não são atualizados em tempo real. Um estado de ou erro permanecerá visível até que o APC seja executado novamente com sucesso. Se um problema subjacente tiver sido resolvido, acione o APC manualmente para limpar o status desatualizado.
Motivo
Detalhes
A verificação do APC foi bem-sucedida, mas a importação de arquivos falhou.
A importação de arquivos do conector falhou. Verifique a configuração de arquivos monitorados na página de edição do APC.
Assim que o monitoramento de arquivos for corrigido, acione (ou ) para importar novamente os arquivos que falharam anteriormente.
Várias pastas monitoradas em um APC: algumas das pastas monitoradas falharam.
O APC está monitorando apenas alterações de pastas monitoradas com sucesso. Verifique se todas as pastas monitoradas ainda existem.
Assim que as pastas monitoradas forem corrigidas, acione o monitoramento para processar alterações novas/perdidas.
Uma pasta monitorada em um APC: a pasta monitorada falhou.
Verifique se a pasta monitorada ainda existe.
Assim que as pastas monitoradas forem corrigidas, acione o monitoramento para processar alterações novas/perdidas.
Múltiplas pastas monitoradas em um APC: todas as pastas apresentam alguns problemas, mas na verificação do APC ocorreram falhas apenas uma ou duas vezes,
Valide as configurações de monitoramento de pasta na página de edição do APC. Assim que as pastas monitoradas forem corrigidas, acione o monitoramento para processar alterações novas/perdidas.
Falha no conector
Verifique a configuração do conector.
A etapa do fluxo de trabalho configurada para exportar não existe mais.
O APC ainda está em execução, mas não executará nenhuma exportação. Certifique-se de que o modelo de projeto esteja correto e que as configurações de exportação do APC estejam corretas.
A etapa do fluxo de trabalho configurada para exportar foi modificada.
O APC ainda está em execução e executará exportações a partir da etapa do fluxo de trabalho que possui um número correspondente ao número da etapa do fluxo de trabalho configurado para o APC. Certifique-se de que o modelo de projeto esteja correto e que as configurações de exportação do APC estejam corretas.
Alguns idiomas de destino foram removidos do modelo de projeto.
O APC não usará idiomas removidos em projetos recém-criados.
A exportação de arquivo do APC falhou.
Exporte os arquivos manualmente.
-
Interrompido
O APC foi desativado pelo sistema devido a erros/falhas graves.
Motivo
Detalhes
Todos os idiomas de origem e/ou destino foram removidos do modelo de projeto.
Sem idioma de texto original e/ou tradução. Adicione pelo menos um idioma de origem e pelo menos um idioma de destino no modelo de projeto e, em seguida, defina o status do APC como Ativo. Assim que o APC for reativado, os projetos recém-criados usarão as localidades de origem/destino atualizadas.
A verificação do APC falhou três vezes para todas as pastas monitoradas.
Valide a configuração de monitoramento e as definições do conector, depois reative o APC e acione o monitoramento.
Na localização multilíngue, um idioma pivô pode ser usado como um idioma de ponte para permitir a tradução do idioma de origem para qualquer número necessário de idiomas de destino. A abordagem de idioma pivô é especialmente válida quando há recursos de tradução limitados disponíveis no idioma de origem.
A tradução com idiomas pivô é um caso de uso do APC para automatizar o processo de tradução. O exemplo abaixo resume as etapas necessárias a serem seguidas:
-
Crie uma pasta no repositório online desejado para armazenar o conteúdo do idioma de origem.
Neste exemplo, arquivos de origem no idioma francês são adicionados a uma pasta do Google Drive.
-
Configure as opções de monitoramento do APC para monitorar atualizações de conteúdo no repositório online desejado.
-
Configure o APC para criar um projeto com o idioma de origem necessário e o idioma pivô escolhido para usar como idioma de destino.
Neste exemplo, o APC está configurado para criar um projeto com francês como idioma de origem e inglês como idioma de destino pivô.
-
Configure as definições de exportação do APC para exportar o conteúdo traduzido para a pasta do idioma de destino correspondente no mesmo repositório online.
Neste exemplo, o APC está configurado para exportar as traduções em inglês para uma pasta de destino no mesmo Google Drive.
-
Assim que o projeto for concluído, a exportação aciona o APC para criar outro projeto para traduzir o conteúdo do idioma pivô para o idioma de destino desejado.
Neste exemplo, a exportação aciona o APC para criar outro projeto para traduzir o conteúdo de inglês para alemão.
Nota
Os conectores e os necessários devem ser configurados para aplicar o caso de uso.
Para projetos de grande escala, a tradução com idiomas pivô também pode ser realizada por meio de scripts personalizados via APIs.