Automatização

Criação Automatizada de Projeto - APC (TMS)

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

Disponível para

  • Todos os planos pagos

Disponível para

  • 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.

Configurar Criação Automatizada de Projeto

As regras de criação automatizada de projeto 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.

Modelos de projeto:

  • A maioria das configurações do APC é tratada nos modelos de projeto. O modelo de projeto define destinos de arquivo, texto original e idiomas de tradução e etapas do fluxo de trabalho. Processos e detalhes financeiros também são definidos no modelo de projeto, como provedores e a geração de orçamentos e análises.

  • APCs separados 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.

Exportando traduções de volta para o repositório:

  • Os trabalhos são exportados quando o estado do projeto é definido como Concluído.

  • Os trabalhos podem ser exportados manualmente escolhendo Download > Exportar para repositório online. Mesmo arquivos inalterados serão exportados.

  • Cada arquivo de tradução é armazenado em um caminho de tradução especificado nas configurações do APC.

Reimportação:

Configuração do APC

Pré-requisitos:

  • Pelo menos um conector e um modelo de projeto em um perfil.

  • (Opcional) Um modelo de e-mail com Novo projeto via Criação automatizada de projeto ou Atualização de texto original via Criação automatizada de projeto 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 trabalho exportado, e eventualmente todo o trabalho, como Concluído no Strings assim que o trabalho de TMS correspondente é exportado, para que o APC pare de monitorar esse conteúdo. Se essas opções não estiverem habilitadas, o trabalho no Strings permanece em progresso, e uma atualização de texto original nesse conteúdo pode ser detectada pelo 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, recomenda-se reduzir o número de arquivos monitorados e acionar manualmente o monitoramento do APC para tentar a importação novamente.

Um máximo de 10 pastas monitoradas pode ser definido por APC.

Siga estas etapas:

  1. Criar um novo APC

    1. Na página de Setup_gear.png<1> configurações, clique em Criação automatizada de projeto.

      A página Criação automatizada de projeto<1> é aberta.

    2. Clique em Novo.

      A página Criação<1> é aberta.

    3. Forneça um nome para o APC (superior esquerdo).

    4. Selecione um modelo de projeto, se necessário.

    5. Defina o estado ativo/inativo (superior esquerdo).

      O botão<1> Gravar fica ativo assim que todos os campos obrigatórios forem preenchidos.

  2. Definir criação e exportar

    1. Escolha como o projeto deve ser criado.

    2. Selecione se:

      • O APC deve ser um projeto contínuo.

      • Selecionar na lista suspensa como um novo projeto é criado com base em quando e onde as alterações são detectadas.

    3. Selecionar um modelo de projeto na lista suspensa.

      • O idioma do texto original é definido no modelo de projeto e todos ou um subconjunto dos idiomas de tradução podem ser selecionados. Os idiomas de tradução 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 tradução a arquivos ou subpastas diferentes dentro da mesma regra. Para Criar trabalhos com conjuntos de idiomas de tradução diferentes para arquivos ou subpastas diferentes (por exemplo, um arquivo exigindo apenas alemão e outro exigindo alemão, espanhol e francês), configurar um APC separado para cada arquivo ou pasta, com cada APC apontado apenas para os arquivos ou pastas relevantes e configurado apenas com os idiomas de tradução necessários para esse conteúdo.

      • Selecionar Visualizar detalhes do modelo de projeto para visualizar a prévia das configurações do modelo de projeto selecionado.

      • A seleção de arquivos em Monitoramento (etapa 2) exibe as entradas no local do texto original padrão (local do texto original conforme configurado no conector). Se um modelo de projeto for selecionado, as entradas são exibidas para o idioma do texto original desse modelo. Independentemente das configurações e de possíveis discrepâncias entre o modelo de projeto e os idiomas do texto original de um conector, o idioma do texto original do modelo de projeto é seguido e os trabalhos são criados corretamente.

    4. Selecionar critérios para exportar traduções.

      Exportar traduções de é o estado do fluxo de trabalho<2> em que as traduções estão quando devem ser exportadas. O usuário pode decidir qual conteúdo exportar; exemplos são traduções da etapa do fluxo de trabalho final ou de uma etapa anterior a essa.

      Podem ser definidas até 5 exportações por. Configurar qual conteúdo deve ser exportado (de qual etapa do fluxo de trabalho) e quando a exportação é acionada.

      Ao concluir fornece o evento que aciona a exportação.

      • As traduções serão exportadas quando uma etapa do fluxo de trabalho selecionada for concluída; quando uma etapa do fluxo de trabalho especificada for concluída para um idioma de tradução, isso aciona a exportação para esse idioma sem esperar que o restante dos idiomas de tradução sejam concluídos

      • As traduções serão exportadas quando todo o projeto for concluído - ou seja, quando todos os trabalhos de todas as etapas do fluxo de trabalho estiverem Concluir.

  3. Monitoramento

    1. Clique em Monitorar pasta ou arquivo para escolher uma pasta para monitorar quanto a conteúdo novo ou atualizado.

      A janela Conectores abre com uma lista de todos os conectores configurados para a conta.

      Se o conector necessário não estiver na lista, ele pode ser adicionado clicando no botão de mais Plus_connector.png no canto superior esquerdo da janela.

    2. Clique em um conector para abrir a lista de pastas.

    3. 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 é monitorada quanto a uma alteração ou novos arquivos.

      • Inclua subpastas para Ativar o monitoramento da pasta selecionada e de suas subpastas.

      • Move processed files to specified folder pode ser usado para conectores baseados em arquivo para indicar quais arquivos já foram usados para tradução.

      Filter by filename pattern (regex) permite que os clientes definam uma expressão regular para filtrar arquivos a serem monitorados dentro da pasta. Isso não pode ser usado para filtrar pastas.

    4. 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 Browse para alterar a seleção.

      Para alguns conectores (Strings, Contentful), mais pastas ou arquivos podem ser adicionados à lista clicando em Monitor folder or file novamente.

      • Múltiplas pastas ou arquivos só podem ser monitorados dentro de um conector.

      • Se alterações forem feitas no conector monitorado, as configurações gravadas anteriormente são excluídas.

      Clique em Gravar para confirmar a seleção de pasta e arquivo.

    5. Clique em Add monitor para selecionar um gatilho Schedule-based ou Webhook-based.

      Forneça o webhook ou agendamento (ou ambos) na janela de monitoramento.

      Monitoramento baseado em webhook:

      • O token do webhook é gerado automaticamente ao selecionar o monitoramento Webhook-based 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ção imediatamente naquele APC específico. Se um APC já estiver executando uma verificação quando o webhook disparar 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. Configurar 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, configurar 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.

  4. Definir automações opcionais

    1. Selecionar automações necessárias.

      • Atribuir responsáveis a partir do modelo

      • Opções de análises e orçamentos

      • Tabelas de datas de entrega

      • Notificações

        Modelos de e-mail com a New Project via Automated Project Creation ou Source update via Automated Project Creation estarão disponíveis neste menu suspenso.

    2. Selecionar opções de atualização do texto original (apenas ativado para projetos contínuos).

      • Se Create a new project everytime tiver sido selecionado na parte de Creation & Export da configuração do APC, o APC monitora pastas Remote para atualizações do texto original, 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 do texto original é 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 do texto original.

        • Se Continuous analyses estiver selecionado para gerar novas análises a cada atualização do texto original, especifique o que Excluir da análise (segmentos confirmados, segmentos bloqueados, números) e como agrupar a contagem de palavras (por responsável, 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 pós-edição Análise e da Análise Padrão.

          Se necessário, Ativar a Macro-Assisted Analyses naming para inserir um padrão de nomenclatura para análises contínuas usando macros<2> disponíveis.

    3. Selecionar opções de atualização da tradução (apenas ativado para conector Phrase Strings se Create a new project everytime estiver selecionado).

      O usuário pode monitorar o repositório Remote online para atualizações de tradução. Quaisquer alterar feitas na cópia de tradução no repositório online atualizarão automaticamente a memória de tradução.

    4. Clique em Gravar.

      O Importar arquivos de pastas monitoradas abre.

      Se Apenas arquivos novos e atualizados estiver selecionado, uma execução de teste da automatizaçã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.

    5. Clique em Confirmar.

      O APC é adicionado à lista na página Criação de projeto automatizada.

Com as regras de automatização definidas, o conteúdo agora pode ser criado nas pastas designadas. Com base em verificações de frequência, o Phrase analisa a pasta especificada e identifica conteúdo novo ou atualizado (com base em nomes de arquivo, metadados, tamanho, etc.).

Detecção de alterar

O APC usa duas estratégias de detecção de alterar dependendo do tipo de conector e sua configuração.

Detecção baseada no histórico de arquivos

Isso é usado pela maioria dos conectores. Em 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 alterar quando qualquer campo disponível no arquivo recebido difere do registro armazenado. Se o conjunto de campos disponíveis alterar entre as execuções, por exemplo, um hash se tornando disponível onde não estava antes, o arquivo é tratado como modificado por metadados e uma importar é acionada.

O registro armazenado é atualizado após cada ciclo de detecção bem-sucedido.

Detecção baseada em diferença

Usado quando um conector baseado em Git tem monitoramento de subpasta ativado. Para conectores Git sem monitoramento de subpasta, a detecção baseada em histórico de arquivos é usada em vez disso.

Em vez de comparar metadados de arquivo, 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.

  • Em 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 Seguinte execução de detecção.

Quando uma importação ou atualizar é ignorada

O APC ignora o acionamento de uma importação ou atualização nas seguintes condições:

  • Nenhum arquivo com correspondência encontrado

    Se a pasta monitorada não retornar arquivos, ou se nenhum arquivo corresponder ao filtro de nome de arquivo configurado, a execução é ignorada sem que nenhuma ação seja tomada.

  • O arquivo foi enviado por este APC

    Se um arquivo na pasta monitorada foi enviado anteriormente pela mesma instância do APC (por exemplo, um arquivo traduzido gravado de volta na pasta de texto original), ele é excluído da detecção de alteração 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 para um arquivo corresponderem ao registro armazenado, o arquivo será 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 um 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 a jusante.

Uma pasta que usa um conector baseado em Git com monitoramento de subpasta habilitado usa detecção de diff; todas as outras pastas usam detecção baseada em histórico de arquivos.

Definir caminhos de arquivo de tradução

Cada arquivo de tradução é exportado para uma pasta especificada nas configurações do projeto.

Desabilitar Automated Project Creation

Existem três maneiras de desabilitar o APC:

  • Desabilitado manualmente nas configurações.

  • Desabilita 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 Automated Project Creation detecta três ou mais instâncias consecutivas de um projeto não sendo criado quando deveria, uma notificação é enviada aos usuários afetados.

Suporte a arquivos ZIP

  • 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árias traduções, os arquivos traduzidos serão exportados para vários arquivos ZIP — um ZIP para cada idioma de tradução — usando o código de local de tradução no nome do ZIP (por exemplo, Pack18.en_us.ZIP).

Página de visão geral do APC

A página Automated project creation fornece uma visão geral dos APCs disponíveis atualmente.

Os APCs podem ser filtrados por Tipo, estado, Último acionamento, Seguinte agendado e versão do APC.

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 do texto original e atualiza a data e hora de Last triggered.

  • Forçar importação

    Importar todos os arquivos da pasta Remote monitorada pelo APC selecionado, ignorando a detecção de alteração.

    Quando a importação forçada está ativada, todos os arquivos que correspondem ao filtro da pasta são tratados como alterados, independentemente do seu histórico armazenado. Isso é útil para reprocessar arquivos após alterações nas configurações ou quando uma nova importação é necessária.

    • Importação forçada seletiva

      Selecionar quais arquivos da(s) pasta(s) monitorada(s) importar. Apenas os arquivos selecionados ignoram a detecção de alteração. 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 ativo não podem ser excluídos.

    Excluir o 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 desativar manualmente um APC (torná-lo inativo), o que pode ser reativado a qualquer momento.

Configurações do APC

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 aba Configuration, revise e atualize as configurações do APC.

  • A partir da aba History log, acompanhe as operações executadas pelo APC e seu estado.

  • A partir da aba Financials, visualize e faça download das continuous analyses existentes geradas para o APC.

Histórico de operações

O histórico de operações do APC detalha todas as operações realizadas por um APC. Isso permite que os gerentes de localização visualizem todos os eventos do APC, pesquisem e filtrem-nos, 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

    • Alteração de estado

  • Trabalho

    • Importar

    • Exportar

    • Atualização do original

    • Atualização da tradução

    • Alteração de estado

  • 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 das 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 memória de tradução

  • Notificações enviadas

  • Alterações nas configurações do APC

Estado do APC

O estado 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.

  • 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 estados de erro e advertência em um APC refletem apenas o resultado da execução mais recente. Esses estados não são atualizados em tempo real. Um estado Precisa de atenção ou de 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 estado desatualizado.

    Motivo

    Detalhes

    A verificação do APC foi bem-sucedida, mas a importar do arquivo falhou.

    A importar de arquivo do conector falhou. Verifique a configuração do arquivo monitorado na página Editar do APC. 

    Assim que o monitoramento de arquivos for corrigido, acione Forçar importar (ou Forçar importar seletiva) 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.

    Várias pastas monitoradas em um APC: todas as pastas apresentam alguns problemas, mas na verificação do APC falharam apenas uma ou duas vezes,

    Valide as configurações de monitoramento de pasta na página Editar 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 exportar 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 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 exportar do APC estejam corretas.

    Alguns idiomas de tradução foram removidos do modelo de projeto.

    O APC não usará idiomas removidos em projetos recém-criados.

    A exportar de arquivo do APC falhou.

    Exportar os arquivos manualmente.

  • Interrompido

    O APC foi desativado pelo sistema devido a erros/falhas graves.

    Motivo

    Detalhes

    Todos os idiomas de texto original e/ou de tradução foram removidos do modelo de projeto.

    Sem idioma de texto original e/ou tradução. Adicione pelo menos um idioma de texto original e pelo menos um idioma de tradução no modelo de projeto, então defina o estado do APC como ativo. Assim que o APC for reativado, os projetos recém-criados usarão as localidades de texto original/tradução atualizadas.

    A verificação do APC falhou três vezes para todas as pastas monitoradas.

    Valide a configuração de monitoramento e as configurações do conector, então reative o APC e acione o monitoramento.

  • Executando

    O APC está processando conteúdo do repositório monitorado. O tempo de processamento depende do tamanho do conteúdo monitorado.

Tradução com idiomas pivô através do APC

Na localização multilíngue, um idioma pivô pode ser usado como um idioma de ponte para ativar a tradução do idioma de texto original para qualquer número necessário de idiomas de tradução. A abordagem de idioma pivô é especialmente válida quando há recursos de tradução limitados disponíveis no idioma de texto original.

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 seguir:

  1. Crie uma pasta no repositório online desejado para armazenar o conteúdo do idioma de texto original.

    Neste exemplo, arquivos de texto original no idioma francês são adicionados a uma pasta do Google Drive.

  2. Configurar opções de monitoramento do APC para monitorar atualizações de conteúdo no repositório online desejado.

  3. Configurar o APC para criar um projeto com o idioma de texto original necessário e o idioma pivô escolhido para usar como idioma de tradução.

    Neste exemplo, o APC está configurado para criar um projeto com francês como idioma de texto original e inglês como idioma de tradução pivô.

  4. Configure as configurações de exportação do APC para exportar conteúdo de tradução para a pasta de idioma de tradução correspondente no mesmo repositório online.

    Neste exemplo, o APC está configurado para exportar as traduções em inglês para uma pasta de tradução no mesmo Google Drive.

  5. Assim que o projeto for concluído, a exportação aciona o APC para criar outro projeto para traduzir conteúdo do idioma pivô para o idioma de tradução desejado.

    Neste exemplo, a exportação aciona o APC para criar outro projeto para traduzir conteúdo de inglês para alemão.

Nota

Conectores e modelos de projeto 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 alcançada por meio de script Personalizado via APIs.

Esse artigo foi útil?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.