MIT072 – Manual de Operação do Protótipo

Cliente:
Projeto: NUCLEO
Módulo: Backoffice Data: 02/07/18

1. Roteiro
Módulo: Todos
Faturamento

Fontes a Atualizar/Compilar
Tipo Nome Descrição
PATCH tttp120_Templ_Imp.ptm Patch da rotina
TRPIMPOR.PRW
PRODXFUN.PRW Rotinas envolvidas

Descrição dos Processos

Visando a agilidade e acompanhamento dos dados que geralmente necessitam serem importados ou analisados no
ERP, foi criado essa rotina onde a mesma além da importação de novos dados, analise de dados já cadastrados no
ERP também irá gerenciar as execuções e poderá ser pré configurada com regras de acordo com cada cliente.

IMPORTANTE:
1. Para que o protheus aceite arquivos muito grande deverá ser adicionado no appserver.ini a configuração:
[General]
MAXSTRINGSIZE=15
Onde 15 refere-se ao máximo de MegaBytes o protheus suportará.

A rotina contempla atualmente as seguintes rotinas:

1. Clientes
2. Produtos
3. Fornecedores
4. Títulos A Receber
5. Títulos a Receber – Baixas
6. Títulos A Pagar
7. Saldo Inicial (Lote, SubLote, Endereço)
8. TES
9. Grupo Produto
10. Vendedor
11. Natureza
12. Produto x Fornecedor
13. Tipo Movimentação estoque
14. Transportadora
15. Bancos
16. Condição Pagamento
17. Títulos A Pagar – Baixas
18. Movimentos internos
19. Recursos do Projeto

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 1 de 21
 MIT072 – Manual de Operação do Protótipo
20 Estrutura de Produto
99. Genéricos (sem execauto – via RecLock)

Especificações de Tabelas e Campos

CRIAR PARAMETROS
Nome Var: MV_X_TABMO
Tipo: Caracter
Descrição: Informe qual tabela será criada para gerenciamento das execuções da rotina
Ex conteúdo: SZ0

Nome Var: MV_X_TABRE

Conteudo: Caracter
Descricao: Informe qual tabela será criada para gerenciamento da regras das importações/analises
Ex Conteudo: SZ1

CRIAR CONSULTA PADRAO

Tipo: Especifica
Consulta: SX3IMP
Descricao: Campos Sistema
Expressão: U_TelaSx3()
Retorno: U_RetTelX3()

CRIAR TABELAS e CAMPOS

Prefixo: SZ0
Descrição: IMPORTACAO/ANALISE CADASTROS
Ac Filial: Compartilhado
Ac. Unidade: Compartilhado
Ac. Empresa: Compartilhado

Campo: Z0_MODELO
Tipo: Caracter
Tamanho: 2
Contexto: Real
Propriedade: Visualizar
Titulo: Modelo
Formato: 99
Lista Opções: #U_ModInt()
Usado: Sim
Browse: Sim
Obrigatorio: Sim

Campo: Z0_STATUS
Tipo: Caracter

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 2 de 21
 MIT072 – Manual de Operação do Protótipo
Tamanho: 1
Contexto: Real
Propriedade: Visualizar
Titulo: Status
Formato: @BMP
Usado: Sim
Browse: Sim
Obrigatorio: Não

Campo: Z0_TABELA
Tipo: Caracter
Tamanho: 3
Contexto: Real
Propriedade: Visualizar
Titulo: Tabela
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z0_SEQ
Tipo: Caracter
Tamanho: 3
Contexto: Real
Propriedade: Visualizar
Titulo: Sequencial
Formato: 999
Usado: Sim
Browse: Sim
Obrigatório: Sim

Campo: Z0_TIPO
Tipo: Caracter
Tamanho: 1
Contexto: Real
Propriedade: Visualizar
Titulo: Tipo
Lista Opções: I=Importacao;E=Dados ERP
Usado: Sim
Browse: Sim
Obrigatorio: Sim

Campo: Z0_DATA
Tipo: Data
Tamanho: 8
Contexto: Real
Propriedade: Visualizar

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 3 de 21
 MIT072 – Manual de Operação do Protótipo
Titulo: Data
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z0_HORA
Tipo: Caracter
Tamanho: 5
Contexto: Real
Propriedade: Visualizar
Titulo: Hora
Formato: 99:99
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z0_TOTIMPE
Tipo: Numerico
Tamanho: 8
Decimal: 0
Contexto: Real
Propriedade: Visualizar
Titulo: Tot.Reg Impe
Usado: Sim
Browse: Sim
Obrigatório: Nao

Campo: Z0_TOTNIMP
Tipo: Numerico
Tamanho: 8
Decimal: 0
Contexto: Real
Propriedade: Visualizar
Titulo: Tot.Reg N Im
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z0_TOTOK
Tipo: Numerico
Tamanho: 8
Decimal: 0
Contexto: Real
Propriedade: Visualizar
Titulo: Tot.Reg OK
Usado: Sim

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 4 de 21
 MIT072 – Manual de Operação do Protótipo
Browse: Sim
Obrigatorio: Nao

Campo: Z0_TOTGER
Tipo: Numerico
Tamanho: 8
Decimal: 0
Contexto: Real
Propriedade: Visualizar
Titulo: Tot.Registro
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z0_DURACAO
Tipo: Caracter
Tamanho: 5
Contexto: Real
Propriedade: Visualizar
Titulo: Durac(hh:mm)
Picture: 99:99
Usado: Sim
Browse: Sim
Obrigatorio: Não

Prefixo: SZ1
Descrição: REGRA IMPORTACAO/ANALISE
Ac Filial: Compartilhado
Ac. Unidade: Compartilhado
Ac. Empresa: Compartilhado

Campo: Z1_MODELO
Tipo: Caracter
Tamanho: 2
Contexto: Real
Propriedade: Visualizar
Titulo: Modelo
Lista Opções: #U_ModInt()
Usado: Sim
Browse: Sim
Obrigatorio: Sim

Campo: Z1_TABELA
Tipo: Caracter

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 5 de 21
 MIT072 – Manual de Operação do Protótipo
Tamanho: 3
Contexto: Real
Propriedade: Visualizar
Titulo: Tabela
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z1_CAMPO
Tipo: Caracter
Tamanho: 10
Contexto: Real
Propriedade: Alterar
Titulo: Campo
Cons.Padrao: SX3IMP
ValidUser: NaoVazio().And.U_VldCpSZ1()
Usado: Sim
Browse: Sim
Obrigatorio: Sim

Campo: Z1_OBRIGAT
Tipo: Caracter
Tamanho: 1
Contexto: Real
Propriedade: Alterar
Titulo: Obrigatorio
ValidUser: NaoVazio().And.U_VldCpSZ1()
Lista Opções: N=Nao;S=Sim
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z1_COMPAT
Tipo: Caracter
Tamanho: 1
Contexto: Real
Propriedade: Alterar
Titulo: Compatibilizar
Lista Opções: N=Nao;S=Sim
Usado: Sim
Browse: Sim
Obrigatorio: Sim

Campo: Z1_TAMANHO
Tipo: Numerico
Tamanho: 3

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 6 de 21
 MIT072 – Manual de Operação do Protótipo
Contexto: Real
Propriedade: Alterar
Titulo: Tamanho
ValidUser: NaoVazio().And.U_VldCpSZ1()
Usado: Sim
Browse: Sim
Obrigatorio: Sim

Campo: Z1_TIPOVLD
Tipo: Caracter
Tamanho: 1
Contexto: Real
Propriedade: Alterar
Titulo: Tp Validacao
ValidUser: NaoVazio().And.U_VldCpSZ1()
Lista Opções: B=Base;E=Excel;A=Ambos

Usado: Sim
Browse: Sim
Obrigatorio: Sim

Campo: Z1_ATIVO
Tipo: Caracter
Tamanho: 1
Contexto: Real
Propriedade: Alterar
Titulo: Ativa
ValidUser: NaoVazio().And.U_VldCpSZ1()
Lista Opções: N=Nao;S=Sim
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z1_IMPEDE
Tipo: Caracter
Tamanho: 1
Contexto: Real
Propriedade: Alterar
Titulo: Impede Imp.
ValidUser: NaoVazio().And.U_VldCpSZ1()
Lista Opções: N=Nao;S=Sim
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z1_REGRA

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 7 de 21
 MIT072 – Manual de Operação do Protótipo
Tipo: Caracter
Tamanho: 200
Contexto: Real
Propriedade: Alterar
Titulo: Regra
ValidUser: U_VldCpSZ1()
Usado: Sim
Browse: Sim
Obrigatorio: Nao

Campo: Z1_CHAVE
Tipo: Caracter
Tamanho: 1
Contexto: Real
Propriedade: Alterar
Titulo: Chave
Lista Opções: N=Nao;S=Sim
ValidUser: U_VldCpSZ1()
Inic.Padrao: ‘N’
Usado: Sim
Browse: Sim
Obrigatorio: Não

CRIAR INDICES
Ordem: 1
Campos: Z0_FILIAL+Z0_MODELO+DTOS(Z0_DATA)+Z0_HORA+Z0_SEQ
Mostra Pesq.: Sim

Ordem: 1
Campos: Z1_FILIAL+Z1_MODELO+Z1_CAMPO
Mostra Pesq.: Sim

Validação
1. Aplicar o patch
2. Incluir no menu, via configurador, a nova rotina de Importar/Analisar Dados (TRPIMPOR.PRW)
3. Configurador os parâmetros
4. Realizar as analise e importações

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 8 de 21
 MIT072 – Manual de Operação do Protótipo

Exemplo de importação e analise de dados de um CSV para importação de Cliente:

Caso ainda não tenha em mãos o modelo do CSV, confira as regras pre cadastradas clicando no botão “Regras”:

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 9 de 21
 MIT072 – Manual de Operação do Protótipo

A rotina já irá pre cadastrar os campos obrigatórios, podendo também ser cadastrados qualquer outros campos e suas
devidas regras:

No exemplo acima, foi informado que antes de importar a rotina deverá compatibilizar os conteúdos campos campos
A1_COD com tamanho de 6 dígitos e A1_LOJA com tamanho de 2 dígitos. Com isso, caso no CSV essas colunas
estiverem com tamanhos menores serão complementadas com ZEROS a esquerda.
Ex: A1_COD = 1 -> 000001

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 10 de 21
 MIT072 – Manual de Operação do Protótipo

Já no caso acima, foi adicionado um novo campo customizado, onde podemos configurar se a regra será utilizada na
importação do CSV (Excel), na validação dos dados já contidos no ERP (Base) ou em ambos.
Também podemos configurar uma regra (ADVPL) para cada campos, no exemplo foi criado uma validação se caso o
Clientes seja do tipo Revendedor, o campo de Comissão deverá ser maior que ZERO.
A coluna “Impede Imp.” Definirá se após validar o campo, o registro poderá ser importado gerando apenas um alerta
ou não.

Também poderá ser selecionado qual campos serão parte da CHAVE de pesquisa para identificaçãoda operação a ser
realizada (INCLUSÃO ou ALERAÇÃO)
A rotina irá trazer por padrão os campos CHAVE do PROTHEUS e caso deseje altera-la basta marcar/desmarcar os
campos desejados, como no exemplo:
Cad.Produtos -> campo CHAVE padrão -> Codigo B1_COD

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 11 de 21
 MIT072 – Manual de Operação do Protótipo

CHAVE alterada para o campo ‘Descrição – B1_DESC’, com isso a rotina irá pesquisa se já existe o registro não mais
pelo código e sim pela descrição contida no CSV.

Caso deseje voltar aos campos CHAVE padrões, basta selecionar a ‘Outras ações/Restaurar campos Chave’:

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 12 de 21
 MIT072 – Manual de Operação do Protótipo

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 13 de 21
 MIT072 – Manual de Operação do Protótipo

Após salvo as regras do campos poderá ser gerado o MODELO CSV padrão:

Preenchido e salvo o modelo em um drive local, esses dados contidos no CSV, poderão ser analisados e/ou importados:
• Analisar: nessa rotina será analisado os dados contidos no CSV x suas regras preestabelecidas, gerando sempre
um log do resultado obtido

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 14 de 21
 MIT072 – Manual de Operação do Protótipo

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 15 de 21
 MIT072 – Manual de Operação do Protótipo

• Importar: nessa rotina será importado os dados (ExecAuto) onde caso haja alguma informação inválida será
apresentado um relatório como o resultado da importação.

A importação será realizada sempre na Empresa/Filial logada:

Exemplo de importação inconsistências:

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 16 de 21
 MIT072 – Manual de Operação do Protótipo

Relatório contendo a linha do CSV e o motivo da inconsistência, podendo ser exportado para o excel.

A outra funcionalidade da rotina, é a analise dos dados já cadastrado no ERP em relação as regras previamente
configuradas:

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 17 de 21
 MIT072 – Manual de Operação do Protótipo

Apresentação da inconsistências contidas na base, mostrando a chave do registro e qual regra gerou a inconsistência:

Gerando sempre o Log do resultado geral da execução:

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 18 de 21
 MIT072 – Manual de Operação do Protótipo

Para tabela que não estejam na listagem de importação, as mesmas poderão ser importadas, sem a utilização de
execuato, através da opção 18.Genericos:
- Selecione a Tabela que deseja importar
- Clique em Regras e informe todos os campos que estiver na planilha
- Marque quais os campos serão a chave para pesquisa se será uma Inclusão ou Alteração.
- Execute a analise e depois a importação do arquivo.

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 19 de 21
 MIT072 – Manual de Operação do Protótipo

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 20 de 21
 MIT072 – Manual de Operação do Protótipo
Aprovação:
Aprovador por: Assinatura Data
Daniel Peixoto da Silva (Consultor Desenvolvimento
TOTVS) ___/___/___

MIT072- Manual de Operacao - Template Importação de dados.docx

Página 21 de 21