Mostrar código-fonte de Formato de Importação de B.D. de reconciliação via excel

== Formato do Excel ==
O excel a importar deve obedecer às seguintes regras:

* A primeira linha tem de ter os nomes dos campos, a 2º linha e seguintes os dados;
* Não podem existir campos com o mesmo nome;
* Não podem existir campos sem nome indicado;
* O separador com os dados deve ter o nome "DADOS";
* O Excel deve estar no formato XLSX (excel 2007 ou superior). O formato XLS (excel 2003 ou anterior) não é suportado.

A importação atualiza registos que já existem e cria novos quando não existem, não apaga registos. O excel é importado a segundo plano, deverá receber um excel com o resultado (ok ou falha) alguns minutos depois deste upload.

== Nomes dos campos suportados ==
Os campos são ''case sensitive'', ou seja, as maiúsculas são diferentes das minúsculas. Os campos não mencionados em baixo são guardados nos registos, não são eliminados.

Os primeiros 3 campos são importantes: estes têm de existir e a combinação dos 3 tem de ser única:
* '''Proprietário''' Código do proprietário (máx 10 chars). Não pode estar vazio. Se existe só um Proprietário colocar na Tabela de Proprietários, nos Bens Próprios, um código (pode ser 1) 
* '''Imobilizado''' Nº de imobilizado no sistema externo (máx 30 chars)
* '''Subnº''' sub número (não pode estar vazio, se não existe colocar zero. (máx 10 chars)

O campo Proprietário é alfa-numérico

O nº de caractéres do nome dos campos do cabeçalho tem que ser inferior a 40 caractéres.

Os seguintes campo são opcionais, devem ser preenchidos quando o registo foi transferido de proprietário, e devem indicar qual o proprietário, nº imo, e subnº que o ativo tinha na entidade de origem
* '''origemProprietário''' Código do proprietário de origem (máx 10 chars)
* '''origemImobilizado''' Nº de imobilizado de origem no sistema externo (máx 30 chars)
* '''origemSubnº''' sub número de origem. (máx 10 chars)

Restantes, opcionais, que também são interpretados:
* '''Denominação do imobilizado''' descrição (máx 100 chars)
* '''TIPO''' denominação do tipo (máx 100 chars)
* '''Ação Rec.''' campo informativo com acção para reconciliar - pode ser preenchido no excel para auxiliar a reconciliação
* '''CAP atuais''' valor levado a imobilizado (numérico)
* '''Depr.acumulada''' amortizações acumuladas (numérico) - não é utilizado ao copiar ou reconciliar com os bens no fams
* '''Descr.Localiz''' campo de texto que descreve a localização. Se não existir no excel, o sistema tenta preencher a partir da tabela auxiliar de códigos utilizando os campos do excel '''Proprietário''' e '''Localização'''.
* '''Descr.CCusto''' campo de texto que descreve o centro de custo. Se não existir no excel, o sistema tenta preencher a partir da tabela auxiliar de códigos utilizando os campos do excel '''Proprietário''' e '''Centro custo'''.
* '''Deprec.do ano''' amortizações do exercício (numérico)
* '''Incorporação em''' data de início de utilização - deve ser uma data em formato excel, ou, caso esteja em formato texto, deve estar no formato "aaaa/mm/dd"
* '''Desativado em''' data de abate/desativação - deve ser uma data em formato excel, ou, caso esteja em formato texto, deve estar no formato "aaaa/mm/dd"
* '''ValCon.atual''' Valor líquido
* '''Vida útil''' Vida útil (anos)
* '''Conta''' Conta, tem de existir no plano de contas
* '''Código DGCI''' classificador: últimos digitos do classificador. O classificador só é importado caso não exista mais do que um classificador encontrado que termine neste nº de digitos.
* '''Centro cst''' centro de custo