Importar registos a partir de CSV

O importador de CSV transforma uma folha de cálculo em Registos — um Registo por linha. Encontra-se em Registos → Importar registos e orienta-o na escolha de um modelo, no mapeamento de colunas para campos, na seleção de uma pasta de destino e na execução da importação com o progresso em tempo real.

Formato CSV

Prepare uma linha de cabeçalho, um Registo por linha, e mantenha uma coluna para o nome do Registo. O painel Formato CSV da barra lateral sugere colunas de exemplo (Nome, Descrição, Estado, Proprietário) e Transferir CSV de exemplo fornece-lhe um ficheiro inicial. Apenas são aceites ficheiros .csv («Apenas ficheiros CSV») e «este importador pressupõe que cada linha do ficheiro CSV representa um único registo».

Mais duas sugestões de formatação:

• Uma coluna fornece o nome do Registo e tem de conter um valor em todas as linhas que pretende importar. O DICE sugere uma coluna Nome/Título quando encontra uma; caso contrário, seleciona a primeira coluna.
• Os tipos das colunas (texto, data, número) são detetados automaticamente a partir dos dados ao gerar um modelo, por isso mantenha os valores de cada coluna consistentes.

Escolher um modo de importação

A secção Modo de importação oferece duas opções:

• Criar um novo modelo e importar — «Carregue um CSV, gere automaticamente um modelo, reveja-o e, em seguida, importe.» É a melhor opção para uma primeira importação: o DICE infere um modelo a partir das suas colunas.
• Importar para um modelo existente — «Escolha primeiro um modelo e, em seguida, mapeie os campos e importe os registos.» Fica disponível assim que tiver pelo menos um modelo; Transferir exemplo produz um CSV correspondente aos campos do modelo selecionado.

Importar com um novo modelo

1. Carregar CSV — clique para carregar ou arraste e largue. O ficheiro é analisado no local e é apresentada a contagem de linhas («N linhas prontas para mapear»).
2. Rever o Criador de modelos — o modelo inferido é apresentado com o Nome do modelo e a Descrição do modelo previamente preenchidos a partir do nome do ficheiro, juntamente com os Campos de dados detetados.
3. Em Nome e descrição do registo, confirme a Coluna do nome e a Coluna da descrição opcional. Essas colunas são apresentadas em Campos de dados como Nome do registo / Descrição do registo e assinaladas como Não criado como campo, porque cada Registo já contém esses dados.
4. Clique em Criar modelo. O modelo é guardado na sua Equipa e avança para o destino e a importação («Modelo criado. Continue para o destino e a importação.»).

Como o modelo foi gerado a partir do seu CSV, o mapeamento de colunas é aplicado automaticamente («Este modelo foi gerado a partir do CSV carregado, pelo que o mapeamento de campos é aplicado automaticamente.»). O painel Mapeamento automático de colunas volta a indicar as origens do nome e da descrição; utilize Voltar ao modelo para as alterar.

Importar para um modelo existente

1. Em Selecionar modelo, escolha o modelo que deverá receber as linhas importadas.
2. Carregar CSV — «Carregue um ficheiro CSV para iniciar o mapeamento e a importação.» O painel apresenta as suas Linhas do CSV junto dos Campos do modelo selecionado.
3. Clique em Continuar para o mapeamento de campos.

Destino e mapeamento de campos

O passo Destino e mapeamento de campos permite-lhe controlar o que é criado:

• Pasta — a pasta de destino de todos os Registos importados. O seletor é previamente preenchido com a pasta que utilizou mais recentemente; tem de selecionar uma antes de importar.
• Mapeamento de campos — «Mapeie cada campo do modelo para a coluna do CSV que deverá preenchê-lo.» Os mapeamentos sugeridos são aplicados através da correspondência dos nomes das colunas; os campos deixados como Sem coluna simplesmente não são preenchidos. (Este passo é ignorado quando o modelo foi gerado automaticamente a partir do CSV.)
• Nome e descrição do registo — a coluna do CSV da qual cada Registo obtém o respetivo nome (obrigatório) e, opcionalmente, a respetiva descrição. Estas são propriedades do Registo, pelo que as colunas não são armazenadas como dados de campos.
• Armazenar também estas colunas como campos — desativado por predefinição. Ative esta opção para manter também os valores do nome e da descrição nos dados dos campos de cada Registo. Um campo mapeado que seja ignorado apresenta essa indicação por baixo do respetivo nome, incluindo um campo Obrigatório — o nome e a descrição do próprio Registo contêm o valor em alternativa.

Por baixo do mapeamento, a Pré-visualização dos registos importados apresenta as primeiras linhas tal como serão importadas, uma contagem de prontidão («N linhas prontas para importar») e assinala as linhas que falhariam («N linhas estão atualmente a falhar») — normalmente, linhas às quais falta um valor obrigatório. Corrija o CSV ou o mapeamento até que as linhas que lhe interessam apresentem o estado Pronto.

Cada linha da pré-visualização tem o mesmo aspeto da página do Registo em que se transformará: o nome, o modelo, a descrição e, em seguida, a organização, a equipa e a pasta às quais pertencerá. Vale a pena verificar esta última linha antes de importar — uma pasta partilhada consigo pertence a outra equipa e os Registos nela criados pertencem a essa equipa, não à sua.

Executar a importação

Clique em Importar N registos. A importação é executada em lotes com um Estado da importação em tempo real («A processar X de Y linhas. Lote A de B.») e, em seguida, apresenta um resumo: «N registos importados.» e, se aplicável, «N linhas falharam.»

Nota

A importação de CSV é feita linha a linha, não segundo uma lógica de tudo ou nada: as linhas que falham são indicadas no resumo, enquanto as linhas processadas com êxito são criadas na mesma. Se tudo for concluído com êxito, é encaminhado diretamente para a pasta de destino.

Uma importação bem-sucedida também regista um grupo de atividade Registo importado por Registo no feed de atividade, e o modelo criado permanece disponível para futuras importações.

Importar um pacote de conjuntos

Independentemente da importação de CSV, o DICE pode importar um Pacote de importação de conjuntos — um ficheiro JSON que descreve Registos, conjuntos, anexos de peças e ligações de relações numa única estrutura. Encontra-se em Conjuntos → Importar pacote de conjuntos.

Nota

A disponibilidade da importação de pacotes de conjuntos depende da configuração da sua organização — se não a vir na navegação, significa que não está ativada (consulte as Perguntas frequentes).

1. Cole o JSON do pacote ou selecione Carregar ficheiro.
2. Clique em Validar pacote. É efetuada uma simulação do pacote para criar um Plano de importação: contagens de Registos, Conjuntos, Registos que não são conjuntos, Anexos de registos e Ligações de registos a criar, bem como quaisquer Problemas impeditivos e Avisos. As pastas, categorias e relações referenciadas são comparadas com as que já existem e assinaladas como reutilizar existente, criar novo ou como ambíguas.
3. Quando o plano indicar «Este pacote está pronto para ser importado.», clique em Confirmar importação.

Ao contrário da importação de CSV, a importação de pacotes de conjuntos é transacional: «nada é gravado até confirmar e a importação segue uma lógica de tudo ou nada». Resolva todos os problemas impeditivos antes de confirmar. Consulte Conjuntos para saber o que são conjuntos e peças.

Páginas relacionadas

RegistosModelos e campos que as importações preenchem.

PastasOnde são colocados os Registos importados.

ConjuntosConjuntos, peças e posições.