Download docx - Manual Import

Transcript
Page 1: Manual Import

Importação de Dados

Page 2: Manual Import

2

Sumário

Introdução................................................................................................................................3

Configuração............................................................................................................................3

Utilização..................................................................................................................................3

Geração do arquivo de importação..........................................................................................9

Consistências na importação..................................................................................................13

Arquivo de Log.......................................................................................................................15

Page 3: Manual Import

3

Introdução

Foi disponibilizada a rotina de importação “IMPORT” para auxiliar no processo de importação de dados para o ambiente protheus, com o intuito de facilitar a implantação do sistema junto a clientes que não possuem bases passíveis de serem importadas eletronicamente.

Através de planilhas Excel, será possível o usuário importar ou digitar dados mais facilmente para efetuar a importação direta dos dados para o protheus.

A atualização dos dados no protheus é feito através das rotinas automáticas padrão protheus de cada função (ExecAuto).

Configuração

Para utilização da rotina de importação é necessário compilar o fonte IMPORT.PRW disponibilizado junto a este manual e adicioná-lo em algum menu de módulo do protheus.

Informações quanto à compilação de fontes e manutenção de menu podem ser encontradas nos manuais padrões Protheus.

Utilização

Acesse a rotina de importação que foi criada no menu desejado.

Page 4: Manual Import

4

Ao acessar a rotina será apresentada a tela inicial de importação com breve descritivo da operação e utilização da rotina.

Clique em Avançar.

Na 2.a tela é apresentada uma listagem das opções de importação:

Page 5: Manual Import

5

Onde:

Clientes (SA1)o Importação de dados cadastrais de clientes na tabela SA1

Produtos (SB1)o Importação de dados cadastrais de produtos na tabela SB1

Fornecedores (SA2)o Importação de dados cadastrais de fornecedores na tabela SA2

Vendedores (SA3)o Importação de dados cadastrais de vendedores na tabela SA3

Contas a Receber – em aberto (SE1)o Importação de dados de títulos em abertos de contas a receber (SE1), com

atualização automática dos acumulados de clientes. Contas a Pagar – em aberto (SE2)

o Importação de dados de títulos em aberto de contas a pagar (SE2), com atualização automática dos acumulados de fornecedores.

Saldos Iniciais – Estoque (SB9)o Atualização dos saldos iniciais de produtos em estoque na tabela SB9 com

atualização automática do saldo atual. Saldos Lote/SubLote (SD5)

o Atualização dos saldos iniciais de lote/sublote de produtos em estoque na tabela SD5

Page 6: Manual Import

6

Selecione a opção desejada e clique em avançar. Será exibida a 3.a tela:

Nesta tela informe o arquivo com os dados a serem importados através do botão , selecione o arquivo desejado e confirme:

Os arquivos de importação devem estar no formato.CSV (separados por vírgulas)

Page 7: Manual Import

7

Outras informações são solicitadas :

Delimitador : “;” [Padrão: Ponto e vírgula]

O delimitador é o caracter responsável pela separação das colunas no arquivo. Maiores detalhes sobre a geração do arquivo de importação podem ser encontradas na pagina XX.

Tipo : Somente Log ou Log + Importação

Somente Log = A rotina irá ler e consistir o arquivo de importação mas não atualizará os dados na base, somente gerará um log no final da rotina.

Log + Importação = A rotina irá ler, consistir o arquivo de importação e atualiza os dados na base e no final gerará um log no final da rotina.

As consistências analisadas nos dois tipos de importação são descritas na página XX.

Informado o arquivo, o caracter delimitador de coluna e o tipo de importação clique em avançar, o sistema apresentará a 4.a tela:

A 4.a tela relaciona as opções de importação utilizadas para confirmar a importação de dados, caso alguma informação esteja incorreta utilize o botão “Voltar” para alterar as configurações.

Para iniciar a importação clique no botão “Avançar”, neste instante será iniciado a importação dos dados podendo visualizar o processamento através da régua de progresso na 5.a tela:

Page 8: Manual Import

8

Ao término da importação é gerado um arquivo de log contendo as informações de importação :

É criada uma pasta chamada IMPORT na pasta configurada como “StartPath” do seu ambiente (default: pasta SYSTEM do Protheus_Data), nesta pasta estarão todos os logs de importação. As informações contidas neste arquivo de log são discriminadas na pagina XX.

Para fechar a importação clique no botão Finalizar.

Page 9: Manual Import

9

Geração do arquivo de importação

O arquivo de importação deverá ser um arquivo plano (Texto) com colunas separadas por um delimitador (;) com a extensão .csv

A primeira linha deverá conter os nomes dos campos a serem atualizados.

A partir da segunda linha as colunas contêm o conteúdo de cada campo.

A seguir detalharemos o processo de geração de arquivo de importação a partir de planilha Excel tendo como exemplo a importação da tabela de clientes (SA1).

A quantidade mínima de campos/colunas que iremos configurar depende da quantidade de campos obrigatórios configurados no sistema.

Os campos obrigatórios são identificados através da cor Azul na tela de cadastro :

Para identificar o nome do campo na tabela , posicione o cursor no campo desejado e pressione F1 será apresentado o help de campo padrão :

Page 10: Manual Import

10

No exemplo acima o nome do campo “Código” é A1_COD.

Portanto é este nome que utilizaremos para preencher os nomes das colunas no Excel.

Abra uma nova planilha no Excel e configure a primeira linha com os nomes dos campos a serem importados:

Para correta importação dos dados sugerimos configurar todas as colunas do Excel em formato TEXTO para evitar incompatibilidade de dados.

Page 11: Manual Import

11

Colunas de campos numéricos devem ser configuradas em formato TEXTO sem separadores de milhar e o separador de decimal deverá ser o ponto (.) para a correta importação no protheus. Ex: Coluna de limite de crédito A1_LC

Colunas de campos Data devem ter seu conteúdo no formado AAAAMMDD:AAAA = Ano com 4 dígitosMM = Mês com 2 dígitos e zero à esquerdaDD = Dia com 2 dígitos e zero à esquerda

Ex: 05/06/10 o conteúdo deverá estar : 20100605

Atente para o conteúdo de códigos no protheus em campos tipo caracter. A maioria utiliza preenchimento de zeros à esquerda, Ex: Código do cliente A1_COD e loja A1_LOJA. Mas nada impede a utilização de numeração normal.

Finalizado o preenchimento das colunas salve a planilha como formato CSV (separado por vírgulas)

Page 12: Manual Import

12

O arquivo gerado ficará com extensão .CSV . Arquivos CSV estão em formato texto podendo ser abertos também pelo bloco de notas:

Page 13: Manual Import

13

Consistências na importação

Antes da importação dos dados, a rotina IMPORT faz algumas análises no arquivo que está sendo importado:

Campos específicos de cada tabela: Além da importação de campos obrigatórios os seguintes campos de cada tabela são checados antes da importação (devem ser informados e com conteúdo preenchido):

o Clientes (SA1) A1_LOJA A1_NOME A1_NREDUZ A1_END A1_TIPO A1_EST

o Produtos (SB1) B1_COD B1_DESC B1_TIPO B1_UM B1_LOCPAD

o Fornecedores (SA2) A2_LOJA A2_NOME A2_NREDUZ A2_END A2_MUN A2_EST A2_TIPO

o Vendedores (SA3) A3_NOME

o Contas a Receber (SE1) E1_NUM E1_TIPO E1_NATUREZ E1_CLIENTE E1_LOJA E1_EMISSAO E1_VENCTO E1_VENCREA E1_VALOR E1_VLCRUZ

o Contas a Pagar (SE2) E2_NUM

Page 14: Manual Import

14

E2_TIPO E2_NATUREZ E2_FORNECE E2_LOJA E2_EMISSAO E2_VENCTO E2_VENCREA E2_VALOR E2_VLCRUZ

o Saldos Iniciais (SB9) B9_COD B9_LOCAL B9_QINI

o Saldos Lote/SubLote (SD5) D5_PRODUTO D5_LOCAL D5_DATA D5_QUANT D5_LOTECTL D5_DTVALID

Os seguintes campos, caso não sejam informados, terão seu conteúdo criado automaticamente através do controle de numeração seqüencial (GetSXENum()):

A1_COD = Código do cliente A2_COD = Código do fornecedor A3_COD = Código do vendedor

Além das consistências acima, quando o tipo de importação for “Log + Importação” o sistema utiliza a validação padrão das rotinas através de ExecAuto, portanto todas as validações padrões e específicas serão analisadas e caso ocorra algum problema as mensagens padrões serão especificadas no arquivo de Log.

Page 15: Manual Import

15

Arquivo de Log

Após o término da importação é gerado um arquivo de log no diretório IMPORT que será criado automaticamente na raiz do sistema (StartPath Protheus_data\System\ , esta nomenclatura pode mudar dependendo da configuração do sistema).

O conteúdo do arquivo de log esta dividido em 3 partes:

1. Informações genéricas2. Validação de linhas3. Resumo de importação

Informações genéricas

É a primeira parte do arquivo de log.

Contém informações do ambiente que foi feita a importação, a tabela que esta sendo importada, o arquivo e as configurações informados pelo usuário:

================================================================================

INICIANDO O LOG - I M P O R T A C A O D E D A D O S

--------------------------------------------------------------------------------

DATABASE...........: 25/02/10

DATA...............: 25/02/10

HORA...............: 16:00:13

ENVIRONMENT........: environment

PATCH..............: \system\

ROOT...............: C:\Jonas\Protheus10\Protheus_Data

VERSÃO.............: P10 MSSQL7 Environment

MÓDULO.............: SIGAFAT

EMPRESA / FILIAL...: 99/01

NOME EMPRESA.......: Teste

NOME FILIAL........: Matriz

USUÁRIO............: Administrador

TABELA IMPORT......: SA1

Page 16: Manual Import

16

ARQUIVO IMPORT.....: c:\lixo\importsa1.csv

DELIMITADOR........: ;

MODO PROCESSAMENTO.: Atualizacao

::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::

Validação de Linhas

Para cada linha do arquivo é feita a validação identificando se o registro foi incluído corretamente ou não.

Caso não tenha sido importado é exibida a critica.

Import = INICIO - Data 25/02/10 as 16:00:13

Import = Linha 000000000002 = LOG = NO MOT: CAMPOS OBRIGATORIOS - REGISTRO IGNORADO - CNPJ/CPF ja existente no cadastro

Import = Linha 000000000003 = LOG = NO MOT: PROBLEMAS NA GRAVACAO ROTINA AUTOMATICA - MATA030 - HELP: CPFINVALID

Código C.P.F. inválido.

Tabela SA1 25/02/10 16:00:15

Codigo - A1_COD :=

Loja - A1_LOJA := 1

Nome - A1_NOME := IMPORTACAO 2

N Fantasia - A1_NREDUZ := IMP2

Endereco - A1_END := END 2

Tipo - A1_TIPO := F

Estado - A1_EST := SP

Municipio - A1_MUN := SÃO PAULO

E-Mail - A1_EMAIL := [email protected]

CNPJ/CPF - A1_CGC := 06178310000187 < -- Invalido

Fisica/Jurid - A1_PESSOA := J

Codigo - A1_COD := 000015

Page 17: Manual Import

17

Filial - A1_FILIAL :=

--------------------------------------------------------------------------------

Import = Linha 000000000004 = LOG = OK MOT:REGISTRO INCLUIDO

Resumo de importação

Descreve os totais e o resultado da importação:

Import = Total de Registros = 3

Import = Registros Nao importados = 2

Import = Registros importados = 1

Import = FIM Data 07/03/10 as 11:00:02