Importao de Dados

Sumrio

Introduo ................................................................................................................................. 3 Configurao ............................................................................................................................. 3 Utilizao ................................................................................................................................... 3 Gerao do arquivo de importao .......................................................................................... 9 Consistncias na importao .................................................................................................. 13 Arquivo de Log ........................................................................................................................ 15

Introduo
Foi disponibilizada a rotina de importao IMPORT para auxiliar no processo de importao de dados para o ambiente protheus, com o intuito de facilitar a implantao do sistema junto a clientes que no possuem bases passveis de serem importadas eletronicamente. Atravs de planilhas Excel, ser possvel o usurio importar ou digitar dados mais facilmente para efetuar a importao direta dos dados para o protheus. A atualizao dos dados no protheus feito atravs das rotinas automticas padro protheus de cada funo (ExecAuto).

Configurao
Para utilizao da rotina de importao necessrio compilar o fonte IMPORT.PRW disponibilizado junto a este manual e adicion-lo em algum menu de mdulo do protheus. Informaes quanto compilao de fontes e manuteno de menu podem ser encontradas nos manuais padres Protheus.

Utilizao
Acesse a rotina de importao que foi criada no menu desejado.

4 Ao acessar a rotina ser apresentada a tela inicial de importao com breve descritivo da operao e utilizao da rotina.

Clique em Avanar. Na 2.a tela apresentada uma listagem das opes de importao:

Onde: Clientes (SA1) o Importao de dados cadastrais de clientes na tabela SA1 Produtos (SB1) o Importao de dados cadastrais de produtos na tabela SB1 Fornecedores (SA2) o Importao de dados cadastrais de fornecedores na tabela SA2 Vendedores (SA3) o Importao de dados cadastrais de vendedores na tabela SA3 Contas a Receber em aberto (SE1) o Importao de dados de ttulos em abertos de contas a receber (SE1), com atualizao automtica dos acumulados de clientes. Contas a Pagar em aberto (SE2) o Importao de dados de ttulos em aberto de contas a pagar (SE2), com atualizao automtica dos acumulados de fornecedores. Saldos Iniciais Estoque (SB9) o Atualizao dos saldos iniciais de produtos em estoque na tabela SB9 com atualizao automtica do saldo atual. Saldos Lote/SubLote (SD5) o Atualizao dos saldos iniciais de lote/sublote de produtos em estoque na tabela SD5

6 Selecione a opo desejada e clique em avanar. Ser exibida a 3.a tela:

Nesta tela informe o arquivo com os dados a serem importados atravs do boto selecione o arquivo desejado e confirme:

Os arquivos de importao devem estar no formato.CSV (separados por vrgulas)

7 Outras informaes so solicitadas : Delimitador : ; [Padro: Ponto e vrgula] O delimitador o caracter responsvel pela separao das colunas no arquivo. Maiores detalhes sobre a gerao do arquivo de importao podem ser encontradas na pagina XX. Tipo : Somente Log ou Log + Importao Somente Log = A rotina ir ler e consistir o arquivo de importao mas no atualizar os dados na base, somente gerar um log no final da rotina. Log + Importao = A rotina ir ler, consistir o arquivo de importao e atualiza os dados na base e no final gerar um log no final da rotina. As consistncias analisadas nos dois tipos de importao so descritas na pgina XX. Informado o arquivo, o caracter delimitador de coluna e o tipo de importao clique em avanar, o sistema apresentar a 4.a tela:

A 4.a tela relaciona as opes de importao utilizadas para confirmar a importao de dados, caso alguma informao esteja incorreta utilize o boto Voltar para alterar as configuraes. Para iniciar a importao clique no boto Avanar, neste instante ser iniciado a importao dos dados podendo visualizar o processamento atravs da rgua de progresso na 5.a tela:

Ao trmino da importao gerado um arquivo de log contendo as informaes de importao :

criada uma pasta chamada IMPORT na pasta configurada como StartPath do seu ambiente (default: pasta SYSTEM do Protheus_Data), nesta pasta estaro todos os logs de importao. As informaes contidas neste arquivo de log so discriminadas na pagina XX. Para fechar a importao clique no boto Finalizar.

Gerao do arquivo de importao

O arquivo de importao dever ser um arquivo plano (Texto) com colunas separadas por um delimitador (;) com a extenso .csv A primeira linha dever conter os nomes dos campos a serem atualizados. A partir da segunda linha as colunas contm o contedo de cada campo. A seguir detalharemos o processo de gerao de arquivo de importao a partir de planilha Excel tendo como exemplo a importao da tabela de clientes (SA1). A quantidade mnima de campos/colunas que iremos configurar depende da quantidade de campos obrigatrios configurados no sistema. Os campos obrigatrios so identificados atravs 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 padro :

10

No exemplo acima o nome do campo Cdigo 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 importao dos dados sugerimos configurar todas as colunas do Excel em formato TEXTO para evitar incompatibilidade de dados.

11

Colunas de campos numricos devem ser configuradas em formato TEXTO sem separadores de milhar e o separador de decimal dever ser o ponto (.) para a correta importao no protheus. Ex: Coluna de limite de crdito A1_LC Colunas de campos Data devem ter seu contedo no formado AAAAMMDD: AAAA = Ano com 4 dgitos MM = Ms com 2 dgitos e zero esquerda DD = Dia com 2 dgitos e zero esquerda Ex: 05/06/10 o contedo dever estar : 20100605 Atente para o contedo de cdigos no protheus em campos tipo caracter. A maioria utiliza preenchimento de zeros esquerda, Ex: Cdigo do cliente A1_COD e loja A1_LOJA. Mas nada impede a utilizao de numerao normal. Finalizado o preenchimento das colunas salve a planilha como formato CSV (separado por vrgulas)

12

O arquivo gerado ficar com extenso .CSV . Arquivos CSV esto em formato texto podendo ser abertos tambm pelo bloco de notas:

13

Consistncias na importao
Antes da importao dos dados, a rotina IMPORT faz algumas anlises no arquivo que est sendo importado: Campos especficos de cada tabela: Alm da importao de campos obrigatrios os seguintes campos de cada tabela so checados antes da importao (devem ser informados e com contedo 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 E2_TIPO

14 E2_NATUREZ E2_FORNECE E2_LOJA E2_EMISSAO E2_VENCTO E2_VENCREA E2_VALOR E2_VLCRUZ Saldos Iniciais (SB9) B9_COD B9_LOCAL B9_QINI Saldos Lote/SubLote (SD5) D5_PRODUTO D5_LOCAL D5_DATA D5_QUANT D5_LOTECTL D5_DTVALID

Os seguintes campos, caso no sejam informados, tero seu contedo criado automaticamente atravs do controle de numerao seqencial (GetSXENum()): A1_COD = Cdigo do cliente A2_COD = Cdigo do fornecedor A3_COD = Cdigo do vendedor

Alm das consistncias acima, quando o tipo de importao for Log + Importao o sistema utiliza a validao padro das rotinas atravs de ExecAuto, portanto todas as validaes padres e especficas sero analisadas e caso ocorra algum problema as mensagens padres sero especificadas no arquivo de Log.

15

Arquivo de Log
Aps o trmino da importao gerado um arquivo de log no diretrio IMPORT que ser criado automaticamente na raiz do sistema (StartPath Protheus_data\System\ , esta nomenclatura pode mudar dependendo da configurao do sistema). O contedo do arquivo de log esta dividido em 3 partes: 1. Informaes genricas 2. Validao de linhas 3. Resumo de importao

Informaes genricas
a primeira parte do arquivo de log. Contm informaes do ambiente que foi feita a importao, a tabela que esta sendo importada, o arquivo e as configuraes informados pelo usurio: ============================================================================= === 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 VERSO.............: P10 MSSQL7 Environment MDULO.............: SIGAFAT EMPRESA / FILIAL...: 99/01 NOME EMPRESA.......: Teste NOME FILIAL........: Matriz USURIO............: Administrador TABELA IMPORT......: SA1

16 ARQUIVO IMPORT.....: c:\lixo\importsa1.csv DELIMITADOR........: ; MODO PROCESSAMENTO.: Atualizacao ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::

Validao de Linhas
Para cada linha do arquivo feita a validao identificando se o registro foi includo corretamente ou no. Caso no 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 Cdigo C.P.F. invlido.

Tabela SA1 25/02/10 16:00:15 Codigo Loja Nome N Fantasia Endereco Tipo Estado Municipio E-Mail CNPJ/CPF Fisica/Jurid Codigo - A1_COD - A1_LOJA := := 1 := IMPORTACAO 2

- A1_NOME

- A1_NREDUZ := IMP2 - A1_END - A1_TIPO - A1_EST - A1_MUN - A1_EMAIL - A1_CGC := END 2 := F := SP := SO PAULO := IMP2@IMP2.COM := 06178310000187 < -- Invalido

- A1_PESSOA := J - A1_COD := 000015

17 Filial - A1_FILIAL :=

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

Resumo de importao
Descreve os totais e o resultado da importao: Import = Total de Registros = 3 Import = Registros Nao importados = 2 Import = Registros importados = 1 Import = FIM Data 07/03/10 as 11:00:02