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 APC ou Atualização de texto original via APC selecionado como o tipo.

  • Se estiver usando Job Sync (conector Phrase Strings), várias pastas ou arquivos podem ser definidos para monitoramento.

Importante

Monitorar mais de 10.000 arquivos por APC pode causar erros de importar 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 importar 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 Configurações<1> Setup_gear.png<1>, clique em Criação de projeto automatizada.

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

    2. Clique em Novo.

      A página Criação é aberta.

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

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

    5. Defina o estado ativo/inativo (canto 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.

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

    3. Selecione 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 diferentes conjuntos de idiomas de tradução para diferentes arquivos ou subpastas (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 apontado apenas para os arquivos ou pastas relevantes e configurado apenas com os idiomas de tradução necessários para esse conteúdo.

      • Selecione Ver detalhes do modelo de projeto para visualizar as 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 serão exibidas para o local do texto original desse modelo. Independentemente das configurações e de possíveis discrepâncias entre o modelo de projeto e os locais do texto original de um conector, o local do texto original do modelo de projeto é seguido e os trabalhos são criados corretamente.

    4. Selecione 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 final do fluxo de trabalho ou de uma etapa anterior.

      Podem ser definidas até 5 exportações por. Configure 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 concluídos.

  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 listado, 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 o arquivo específico a ser monitorado.

      Nem todas as opções estão disponíveis em todos os connectors

      • Se nenhum for selecionado, a pasta inteira será 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 regular expression para filtrar arquivos a serem monitorados dentro da pasta. Isso não pode ser usado para filtrar pastas.

    4. Clique em Confirm.

      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 serão excluídas.

      Clique em Save 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 Add 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 alterar 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 confirmar 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.

  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 Novo projeto via Criação Automatizada de Projeto ou Atualizar texto original via Criação Automatizada de Projeto estarão disponíveis neste menu suspenso.

    2. Selecionar opções de atualizar texto original (apenas ativado para projetos contínuos).

      • Se Criar um novo projeto toda vez tiver sido selecionado na parte de Criação e Exportar da configuração do APC, o APC monitora pastas Remote para atualizações de texto original, mas uma configuração detalhada não é necessária, porque um novo projeto é criado toda vez que uma alterar é detectada.

      • Para um projeto contínuo, especifique quais etapas do fluxo de trabalho exigem reabertura quando uma atualizar 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 atualizar texto original.

        • Se Análises contínuas estiver selecionado para gerar novas análises a cada atualizar texto original, especifique o que Excluir da análise (segmentos confirmado, segmentos bloqueado, 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 e obrigatórias da Análise de pós-edição e da Análise padrão.

          Se necessário, Ativar a Nomenclatura de análises assistida por macro para inserir um padrão de nomenclatura para análises contínuas usando macros disponíveis.

    3. Selecionar opções de atualizar tradução (apenas ativado para conector Phrase Strings se Criar um novo projeto toda vez estiver selecionado).

      O usuário pode monitorar o repositório online Remote para atualizações de tradução. Quaisquer alterações 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 simulação 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 Confirm.

      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 de 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 alterado quando qualquer campo disponível no arquivo recebido difere do registro armazenado. Se o conjunto de campos disponíveis for alterado entre as execuções, por exemplo, um hash se tornando disponível onde não estava antes, o arquivo é tratado como metadado modificado e uma importação é 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 habilitado. Para conectores Git sem monitoramento de subpasta, a detecção baseada no 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 alterar 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 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 importar ou atualizar é ignorada

O APC ignora o acionamento de uma importar ou atualizar sob as seguintes condições:

  • Nenhuma correspondência de arquivos encontrada

    Se a pasta monitorada não retornar arquivos, ou nenhum arquivo corresponder à filtrar de nome de arquivo configurada, a execução será ignorada sem que nenhuma ação seja tomada.

  • 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 alterar para evitar importar novamente a saída do APC.

  • Nenhuma correspondência de conteúdo detectada (conectores baseados no 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.

  • Importar 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 importar downstream.

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 no histórico de arquivos.

Definir nomes de caminho 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 (no 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, Última ativação, Seguinte agendamento 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 os arquivos de texto original em busca de atualizações e atualiza a data e hora de Última ativação.

  • Forçar importação

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

    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 nas configurações ou quando uma reimportação é necessária.

    • Importação forçada seletiva

      Selecione 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 conectados a projetos ativos, bem como projetos arquivados, mas não finalizados, que não podem ser excluídos.

Configurações do APC

Clicar em um APC específico abre a página de configurações para esse APC. A partir da página de configurações, é possível:

  • Na aba Configurações, revise e atualize as configurações do APC.

  • Na aba Registro de histórico, acompanhe as operações executadas pelo APC e seu estado.

  • Na aba Financeiro, visualize e faça o download das análises contínuas existentes geradas para o APC.

Registro de histórico

O registro 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-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 registros sejam úteis para os engenheiros da Phrase e para as equipes de suporte técnico / sucesso do cliente.

O registro 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 do 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 da memória de tradução

  • Notificações<1> enviadas

  • Alterações na configuração 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 tornado inativo intencionalmente

  • 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 Requer 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 importação do arquivo falhou.

    A importação 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 seletivo) 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 para 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 têm 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 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 exportar do APC estejam corretas.

    Algumas traduções foram removidas do modelo de projeto.

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

    A exportar de arquivos do APC falhou.

    Exportar os arquivos manualmente.

  • Interrompido

    O APC foi desativado pelo sistema devido a erros/falhas críticas.

    Motivo

    Detalhes

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

    Sem idioma de texto original e/ou tradução. Adicionar pelo menos um idioma de texto original e pelo menos um idioma de tradução no modelo de projeto, então definir o estado do APC como ativo. Assim que o APC for reativado, 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.

    Validar a configuração de monitoramento e as configurações de conector, então reativar o APC e acionar o monitoramento.

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 usar do APC para automatizar o processo de tradução. O exemplo abaixo resume as etapas necessárias a seguir:

  1. Criar 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. Configurar as configurações de exportar do APC para exportar conteúdo traduzido 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 é concluído, a exportar aciona o APC para criar outro projeto para traduzir conteúdo do idioma pivô para o idioma de tradução desejado.

    Neste exemplo, a exportar 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 usar.

Para projetos de grande escala, a tradução com idiomas pivô também pode ser realizada 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.