Importante

Esta funcionalidade de importação está disponível no nosso ramo Dev.

Importar pacotes de trabalho a partir de um ficheiro CSV

Pode criar vários pacotes de trabalho de uma só vez ao carregar um ficheiro CSV. Os pacotes de trabalho existentes nunca são alterados por uma importação, e não são enviadas notificações relativamente aos pacotes de trabalho que esta cria.

Sinopse

Tópico Conteúdo
Antes de começar A autorização de que necessita e o modelo a partir do qual deve começar.
Importar um ficheiro Como verificar um ficheiro primeiro e depois importá-lo.
Referência da coluna Todas as colunas que podem ser importadas e como os respetivos valores são correspondidos.
Limites Qual é o tamanho máximo que um ficheiro pode ter?
O que não é importado O que a importação CSV ainda não abrange.

Antes de começar

Nota

É necessária a permissão Importar pacotes de trabalho para importar pacotes de trabalho para um projeto. Pode ser atribuída a uma função na administração de funções e permissões, com a permissão Adicionar pacotes de trabalho de que necessita.

Para aceder à página de importação, aceda a Definições do projeto no seu projeto e selecione Importador de pacotes de trabalho na barra lateral.

Começar pelo modelo. A ligação Descarregar o modelo na página de importação disponibiliza um ficheiro CSV com os cabeçalhos de coluna exatos que este projeto aceita e duas linhas de exemplo. Substitua os exemplos pelos seus próprios, mantenha a linha de cabeçalho e guarde o ficheiro como CSV UTF-8.

Deve ser um ficheiro .csv codificado em UTF-8 ou UTF-16. A vírgula, o ponto e vírgula e a tabulação são todos aceites como separadores, e o separador é detetado a partir da linha de cabeçalho, pelo que um ficheiro exportado por uma aplicação de folha de cálculo em qualquer configuração regional pode ser carregado tal como está. Um valor que contenha o separador, uma quebra de linha ou uma aspa deve ser colocado entre aspas, o que as aplicações de folha de cálculo fazem automaticamente por si.

Importar um ficheiro

  1. Selecione o ficheiro na secção Ficheiro CSV.
  2. Deixe a opção Verificar primeiro o ficheiro, sem importar selecionada. Cada linha é então validada e registada, mas nada é criado.
  3. Selecione Verificar ficheiro.
  4. Leia o relatório. Caso o ficheiro apresente problemas, cada um deles é indicado com a linha em que se encontra, a coluna, o valor e a natureza do problema. Um ficheiro com muitos problemas apresenta os primeiros 500 na página; o ficheiro CSV para descarregar, ao lado da lista, contém sempre todos eles, pelo que pode analisá-los na sua aplicação de folha de cálculo.”
  5. Corrija o ficheiro e verifique-o novamente, até o relatório não apresentar problemas.
  6. Selecione o botão Importar, que indica o número de pacotes de trabalho por criar, para os criar.

O resumo apresentado após uma verificação bem-sucedida indica-lhe quantas linhas foram lidas, quantas contas o ficheiro menciona nas colunas Assignee, Accountable e Author, e que tipos, estados, prioridades e categorias são utilizados nas linhas, para que possa verificar se o ficheiro foi interpretado da forma que pretendia antes de se criar qualquer elemento.

Assim que a importação tiver sido executada, o relatório apresenta ligações para os pacotes de trabalho que criou. A ligação abre uma vista denominada Importação CSV a data e hora da execução, guardada de forma privada para si, que também aparece na secção das suas próprias vistas, na barra lateral do módulo dos pacotes de trabalho. Elimine-a tal como faria com qualquer outra vista, assim que já não precisar dela.

Limpar remove o relatório e devolve o formulário em branco. Esta opção está disponível ao lado do botão em todos os passos, pelo que um relatório que já tenha concluído ou um ficheiro que tenha sido rejeitado nunca terá de ficar na página.

Dica

O ficheiro verificado é mantido durante algumas horas, pelo que não é necessário carregá-lo novamente aquando da importação. Se voltar ao relatório mais tarde e o ficheiro tiver expirado, carregue-o novamente. É verificado mais uma vez antes de se criar qualquer coisa.

Pode desmarcar a caixa de seleção Verificar primeiro o ficheiro, sem importar para proceder à importação imediatamente. O botão apresenta então a indicação Importar ficheiro, pelo que indica sempre o que irá acontecer.

Uma importação é tudo ou nada. Se não for possível criar alguma linha, nada é criado e o relatório enumera todos os problemas presentes no ficheiro, em vez de parar no primeiro. Será registado como autor de cada pacote de trabalho criado pela importação, a menos que o ficheiro indique outra pessoa na coluna ‘Autor’.

Referência da coluna

A linha de cabeçalho determina o que é importado. A ordem das colunas é livre e só precisa de preencher as colunas que desejar. Um cabeçalho que não conste na tabela abaixo interrompe a importação antes de qualquer linha ser lida, tal como acontece se o mesmo atributo aparecer duas vezes.

Coluna Conteúdo Obrigatório Formato e correspondência
Assunto O nome do pacote de trabalho Sim Texto
Descrição A descrição Não Texto. Um valor que contenha quebras de linha tem de ser colocado entre aspas.
Tipo Tarefa, Marco, Fase, etc. Não Correspondência por nome, sem distinção entre maiúsculas e minúsculas. O tipo tem de estar ativado neste projeto.
Estado O estado Não Correspondência por nome, sem distinção entre maiúsculas e minúsculas. O estado deve existir.
Prioridade A prioridade Não Correspondência por nome, sem distinção entre maiúsculas e minúsculas. A prioridade deve existir e estar ativa.
Categoria A categoria Não Correspondência pelo nome, sem distinção entre maiúsculas e minúsculas. A categoria tem de existir neste projeto.
Versão A versão Não Correspondência por nome, sem distinção entre maiúsculas e minúsculas. A versão deve estar aberta e disponível neste projeto. Apenas uma versão é suportada na célula.
Encarregado O encarregado Não A correspondência é feita com base no endereço de e-mail com que o utilizador inicia sessão, independentemente das maiúsculas e minúsculas. O utilizador deve ter permissão para lhe serem atribuídos pacotes de trabalho neste projeto.
Responsável O responsável Não A correspondência é feita da mesma forma que em Encarregado.
Autor Quem criou o pacote de trabalho Não Correspondência por endereço de e-mail. Se deixar em branco ou omitir a coluna, será registado como autor.
Data de início A data de início Não YYYY-MM-DD, por exemplo, 2026-03-17.
Data de conclusão A data de conclusão Não YYYY-MM-DD.
Trabalho O trabalho estimado Não Horas expressas como número, por exemplo, 8 ou 7.5, ou como uma duração, como 1h 30m.
Trabalho restante O trabalho que ainda há por fazer Não Escrito como Trabalho. Não está disponível enquanto o progresso estiver a ser calculado a partir do estado.
% Concluído O progresso Não Um número inteiro compreendido entre 0 e 100, com ou sem o símbolo de percentagem. Não está disponível enquanto o progresso estiver a ser calculado a partir do estado.
Criado em Quando o pacote de trabalho foi criado Não YYYY-MM-DDTHH:MM:SSZ, por exemplo, 2025-11-04T09:30:00Z. Não no futuro.
Atualizado em Quando foi atualizado pela última vez Não YYYY-MM-DDTHH:MM:SSZ. Nem no futuro, nem antes da data Criado em.

Um valor que não pode ser validado é indicado na linha em que se encontra, e o relatório apresenta os valores que teriam sido aceites, pelo ser fácil corrigir um erro ortográfico no tipo ou no estado.

Os campos Criado em e Atualizado em destinam-se a pacotes de trabalho provenientes de outro sistema, e devem manter as respetivas datas. A opção Criado em também altera a data de criação na atividade do pacote de trabalho, pelo que uma comparação com a linha de base relativa a um período anterior à importação funciona tal como teria funcionado naquela altura.

Nota

Os títulos das colunas também são aceites no idioma em que utiliza o OpenProject. Um ficheiro criado com cabeçalhos em alemão, tais como ‘Thema’ e ‘Zugewiesen an’, é importado enquanto o seu idioma estiver definido como alemão. No entanto, não é garantido que as traduções sejam estáveis, pelo que um ficheiro importado numa versão do OpenProject poderá não ser aceite noutra. Os títulos em inglês na tabela acima funcionam sempre, independentemente do idioma definido, razão pela qual o modelo transferível os utiliza.

Tudo o que o formulário do pacote de trabalho rejeitaria é também rejeitado aqui, linha a linha: um assunto em falta, uma data de conclusão anterior à data de início, um tipo que não possui esse estado no seu fluxo de trabalho.

Uma célula em branco significa “não indicado”, e o pacote de trabalho é criado com os valores que o projeto e o tipo lhe atribuíssem. Não há forma de indicar “explicitamente vazio” num ficheiro CSV, pelo que um valor definido por predefinição não pode ser apagado deixando a respetiva célula em branco.

Limites

Um ficheiro pode conter até 5.000 linhas e, por predefinição, pode ter um tamanho máximo de 5 MB. Divida uma importação de grande dimensão em vários ficheiros. A página de importação indica os limites que se aplicam à sua instância.

Ambos os limites são configuráveis. O limite de tamanho do ficheiro é aquele que se aplica a todos os anexos, pelo que um administrador pode alterá-lo em Administração, Ficheiros, Anexos. O limite de linhas não se encontra na administração: é definido para a instância através da variável de ambiente OPENPROJECT_WORK__PACKAGE__IMPORT__MAX__ROWS, que requer acesso ao servidor em que a instância está a ser executada.

O que não é importado

Uma importação CSV cria pacotes de trabalho. Atualmente, não realiza nenhuma das seguintes ações.

  • Alterar pacotes de trabalho existentes: Cada linha cria um novo pacote de trabalho. Não há forma de se referir a um que já exista.
  • Criar hierarquias: É necessário definir os elementos pai e filho após a importação.
  • Criar relações: Os predecessores, sucessores e os outros tipos de relações não são lidos.
  • Preencha os campos personalizados: Apenas as colunas acima indicadas são aceites.
  • Definir observadores ou anexos:
  • Ler ficheiros de folha de cálculo: Guarde primeiro um ficheiro .xlsx ou .ods como CSV.