Documentação de software

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
====== Exportação e Importação de Produtos ======

----

Esta ferramenta tem uma função 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 as ordens 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.

----

Para entrar nesta ferramenta basta entrar no menu em:

||Gerenciamento→Ferramentas→Exportar/Importar Produtos||

Ao clicar neste botão aparecerá a seguinte interface:

{{ :manuais:intellicash:ferramentas:configuracao_exportar_importar_arquivos.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!”.**

{{ :manuais:intellicash:information_exportacao_importacao_produtos.png?nolink |}}

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, as ordens 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:

{{ :manuais:intellicash:excel_exportacao_importacao_produtos.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.

{{ :manuais:intellicash:config_exportacao_importacao_produtos.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.

{{ :manuais:intellicash:config2_exportacao_importacao_produtos.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 **“CODIGO (coluna A do Excel)”**, , 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.

{{ :manuais:intellicash:confirm_exportacao_importacao_produtos.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:

{{ :manuais:intellicash:ferramentas:exportacao_exportar_importar_arquivos.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:

{{ :manuais:intellicash:ferramentas:exportacao_exemplo_exportar_importar_arquivos.png?nolink |}}

Há ainda um facilitador de seleção que pode ser utilizado clicando com o botão direito na tabela onde teremos as opções Marcar Todas, Desmarcar Todas e Inverter Seleção.

{{ :manuais:intellicash:botoes_exportacao_importacao_produtos.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.

{{ :manuais:intellicash:save_as_exportacao_importacao_produtos.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.
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:
 
{{ :manuais:intellicash:error_importar_exportar_produtos.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!
Verifique se o arquivo não está bloqueado para edições, isto impedirá o programa de ler seu arquivo.</note>
Documentação de software

Ferramentas do usuário

Ferramentas do site

Ferramentas da página
