===== Exportação e Importação de Produtos =====


Esta versão traz uma nova funcionalidade que permite ao usuário exportar tabelas de produtos já cadastrados para os formatos Excel(*.xls) e Texto(*.txt) com a formatação "csv". Além disso é possível fazer o caminho inverso, ou seja, importar arquivos nestes mesmos formatos para sua base de dados, sendo restrito, evidentemente, aos dados já existentes em seu banco de dados. Sendo assim para que a importação seja executada com sucesso, é necessário que os dados estejam coerentes com os já cadastrados como por exemplo o fabricante, unidade, seção, grupo, etc. Outra característica importante é que o usuário poderá configurar a ordem em que as colunas serão lidas nos arquivos ou serão exportadas. Caso a ordem das colunas não estejam coerentes com os arquivos lidos, a importação não sucederá com sucesso.

Se na importação o código do produto ainda não estiver cadastrado no banco de dados, um novo produto será cadastrado com os dados da tabela, por isso é importante verificar a consistência dos dados da tabela.


A ferramenta é acessível em **Gerenciamento -> Ferramentas -> Exportar/Importar Produtos**.

{{ :intellicash:atualizacoes:eip1.png?nolink |}}  



=== Tipo de Arquivo ===

Esta é uma caixa de opções que se diferencia entre as abas Importação e Exportação, onde para Exportar podemos selecionar tanto o formato "*.xls", quanto o formato "*.txt", enquanto que para Importar só podemos escolher um dos tipos de cada vez.

A opção de **Exportar para Texto** permite escolher o sinal separador de colunas, sendo eles **";"** ou **"|"**.

Na aba de Exportação podemos ainda definir se queremos carregar produtos **//Ativos//, //Inativos// ou //Ambos//**.


=== Configuração de Layout de Tabelas ===

Caso não haja um //Layout de Tabela// configurado, uma mensagem é exibida: **"Não há Layout de Exportação/Importação!"**
{{ :intellicash:atualizacoes:eip12.png |}}
 e em seguida vemos a aba de **Configuração**, que será a primeira aba, onde podemos criar os //"Layouts"// de importação e exportação. Estes "layouts" servem para definir a ordem de leitura dos campos nos arquivos a serem importados ou quais campos do banco de dados serão exportados.

<note important>Na Exportação, a ordem dos campos no arquivo gerado serão de acordo com a ordem de cadastro na tabela da interface.</note>


Exemplo:

Supondo que temos uma planilha do Excel com a seguinte configuração:

{{ :intellicash:atualizacoes:eip2.png?nolink |}}

Neste caso devemos configurar as colunas de importação selecionando a aba **Configuração** e dentro dela a aba **Importação**. Então podemos criar um novo layout clicando no botão //Novo//.

=== Janela de Configuração de Tabelas ===

A janela de configuração se abrirá conforme a imagem abaixo mostra.

Após darmos um nome ao nosso layout e definir se ele será padrão, ou seja, se ele será carregado preferencialmente sempre que eu abrir a ferramenta,  podemos registrá-lo, e a partir deste ponto podemos inserir as colunas selecionando-as no box **"Nome do Campo"** e em seguida pressionando **Adicionar**.

A opção **"Campo Editável"** permite que edições sejam feitas na interface do software antes de fazer a importação.

O **Índice** das colunas é quem define a ordem em que estas aparecerão. O índice das colunas ainda não inseridas é mostrado no campo **índice** abaixo do nome das colunas. Podemos alterar o índice de uma coluna inserida utilizando as setas "para cima" e "para baixo" no canto superior direito da janela.

{{ :intellicash:atualizacoes:eip3.png?nolink |}}


==== Inclusão e Exclusão de Campos ====

Além dos botões **"Adicionar"** e **"Remover"** podemos utilizar o facilitador clicando com o botão direito na tabela de campos onde termos três opções: 

  *  Remover Todos: Remove todos os campos; 
  *  Remover Seleção: Remove todos os campos selecionados; 
  *  Adicionar Todos: Adiciona todos os Campos.

{{ :intellicash:atualizacoes:eip5.png?nolink |}}


=== Campo Vazio ===

O campo **"VAZIO"** é muito importante para fazer importação de tabelas que possuem colunas que não fazem parte do nosso banco de dados.
Como no exemplo acima, temos os campos **CÓDIGO**(1) que poderia ser um código de catálogo, e o segundo campo que se refere ao **CÓDIGO** de barras, **fundamental** para a importação de um produto. Neste caso, o primeiro campo "Código" não nos interessa e por isso, ao colocar uma coluna "VAZIO" em sua posição este campo será ignorado no momento da importação.

Podemos observar o mesmo com o campo **"COR"**, que não existe nos registros do sistema.

=== Editar Configuração ===

O Botão **"Editar"**, assim como o botão **"Novo"**, abrirá a janela de **"Configuração de Tabelas"** onde podemos fazer a devidas modificações utilizando os mesmos recursos disponíveis para se criar um novo layout.

==== Duplicar Configuração ====

A função deste botão (**Dupl.**) é permitir a reprodução de um Layout de Exportação na aba de Importação e vice-versa. O propósito é facilitar a troca de dados respeitando um determinado padrão.
Sendo assim, quando duplicamos um layout de Importação, este mesmo layout estará disponível em Exportação, com o mesmo nome seguido do numero 1, indicando que se trata de uma cópia.

=== Excluir Layout ===

Esta função possibilita excluir um layout selecionado, logo que a mensagem de confirmação é aceita.

{{ :intellicash:atualizacoes:eip4.png?nolink |}}

==== Exportando ====

Para exportar uma tabela, uma vez que já temos configurado nosso layout de Exportação configurado, podemos carregar uma lista de produtos selecionando um filtro de produtos:

{{ :intellicash:atualizacoes:eip6.png?nolink |}}

Podemos também definir o diretório onde será salvo o arquivo de exportação.

Os botões **"Aplicar"** e **"Recarregar"** fazem o mesmo papel de aplicar os filtros e recarregar a lista de produtos de acordo com as configurações.

Antes de Exportar podemos definir quais produtos serão exportados selecionando a coluna **"Expt."** como mostra a figura abaixo:

{{ :intellicash:atualizacoes:eip7.png?nolink |}} 

Há ainda um facilitador de seleção que pode ser utilizado clicando com o botão direito na tabela onde teremos três opções: -Marcar Todas; -Desmarcar Todas; -Inverter Seleção.

{{ :intellicash:atualizacoes:menu.png?nolink |}}


O botão **"Exportar"** abrirá uma caixa de dialogo perguntando qual será o nome do arquivo a ser salvo e o diretório, que a princípio será o escolhido na barra **Destino** que se encontra na parte superior da janela de exportação.

{{ :intellicash:atualizacoes:eip8.png?nolink |}} 

<note tip>Caso queira importar um arquivo do tipo Excel, é importante lembrar que existem dois tipos de extensão **(Excel *.xls, Excel 2010 *.xlsx)**, que podem ser escolhidos no campo **Files of Type** na caixa de diálogo.</note>

<note tip>Quando há um layout configurado a aba Exportação passa a ser a primeira.</note>


==== Importação ====

Após termos configurado um layout de Importação e o formato do arquivo, podemos escolher um diretório de arquivo que será chamado quando clicarmos no botão **Recarregar**. Caso não tenha sido escolhido um arquivo especificamente, ao clicar em **Recarregar** a caixa de diálogo abrirá perguntado qual arquivo deseja-se abrir.
Ao carregar o arquivo de importação a barra de "**Origem**" será limpa.

<note important>É fundamental que todas as planilhas de importação contenham a coluna com o código do produto, pois será através do código(EAN) que os demais dados da tabela serão validados!</note>

=== Erro de Tipo ===

É fundamental que a configuração da tabela que escolhermos seja condizente com o arquivo que estamos importando, pois caso tenhamos uma coluna de //"Preço"// no arquivo e na configuração a coluna correspondente for de //"Descrição"// por exemplo, o preço será carregado como a descrição do produto. No sentido oposto, quando temos uma coluna com um texto no arquivo e a coluna correspondente for uma coluna numérica como o preço o seguinte erro será disparado:

{{ :intellicash:atualizacoes:eip9.png?nolink |}}

O que significa que um campo de texto tenta ser importado numa coluna de valor numérico.
Para corrigir este problema é necessário que o usuário revise a ordem das colunas do arquivo e configure os índices do layout de acordo com esta ordem.


<note warning>Evite importar arquivos com colunas completamente vazias! Isto pode gerar eventuais erros de leitura do arquivo!</note>

<note warning>Verifique se o arquivo não está bloqueado para edições, isto impedirá o programa de ler seu arquivo.</note>


=== Inconsistência de Dados ===

Quando tentamos importar uma tabela com campos preenchidos com valores desconhecidos pelo banco de dados, a linha correspondente ao produto ficará destacada em vermelho, e podemos ler qual foi o erro encontrado no campo de texto que surge na parte inferior da tela, como mostra a figura abaixo.

{{ :intellicash:atualizacoes:eip10.png?nolink |}}

Caso queiramos que a importação tenha sucesso, devemos cadastrar o campo referido no programa para que ele reconheça o tipo a ser importado.

No exemplo acima tentamos importar um produto de tamanho //"Inexiste"// que não está cadastrado no banco de dados. Sendo assim a inconsistência é destacada e, caso queiramos corrigi-la, será necessário que o tamanho "Inexiste" seja cadastrado no programa antes da importação.

<note important>Verifique se não há colunas trocadas entre a configuração e o arquivo, pois isso ocasionaria inconsistência em todas as linhas. Exemplo: Carregar o **Tamanho** na coluna de **Seção**.

{{ :intellicash:atualizacoes:eip11.png?nolink |}}
</note>


==== Imprimir ====

O botão **Imprimir** permite tanto imprimir o que está na tela, ou seja, a aba selecionada, quanto exportar este conteúdo para um arquivo no formato //*.pdf//.