Boletim Tcnico

1
MILE
Importao de dados via MILE
Produto : Microsiga Protheus verso 11.8
Data da publicao : 21/01/13 Pas(es) : Todos

Aplicabilidade Rotina de Importao de Dados para ser usada na implantao do produto Srie 3










Objetivo
Auxiliar na carga inicial de dados para o sistema Protheus. Para isso, essa rotina permite:
Importar os dados fornecidos em arquivo texto (CSV) usando rotina automtica, o que garante a consistncia
do dado importado

Restrio
Esta rotina encontra-se em verso beta, portanto a configurao deve ser restringida a analistas TOTVS e no
ao cliente
No existe suporta para esta rotina at o lanamento da verso 11.8, as dvidas e ocorrncias podero ser
atendidas pelas comunidades do ByYou (Serie 3)
A rotina utiliza o conceito de rotina automtica, portanto ser executada para cada filial onde devam ser
importados os dados
Somente disponvel para analistas TOTVS (necessria ativar uma vez para cada cliente a partir do portal
http://t2kc.totvs.com.br ). Siga as instrues na tela quando descompactar as estruturas pr-cadastradas.


Pr-requisitos
Preparar uma planilha em Excel, ou arquivo texto (CSV) que poder conter (ou no) em sua primeira linha o
nome dos campos do sistema Protheus. As demais linhas representam os dados a serem importados.
O processo de importao realizado, utilizando-se rotinas automticas, ou seja, EXECAUTO. Por esse motivo
os dados devem estar compatveis com os padres do Protheus, pois todos sero verificados no momento da
incluso.
Importar primeiro as tabelas precedentes e depois as dependentes, ou seja, se for executar a importao dos
cadastros de clientes e de transportadoras, primeiro ser necessrio importar as transportadoras e depois os
clientes, pois no cadastro de clientes existe o campo de transportadora (que j dever estar importada).

Rotina especfica para carga de dados no sistema Protheus
Boletim Tcnico


2 MILE
PROCEDIMENTO PARA INSTALAO
Atualizao do sistema.
Utilizar build 7.00.120420A com liberao posterior a 10/2012
Atualizar com a ltima verso de LIBS do portal
Aplicar pacote de Acelerador de importao MILE (hastag MILE) disponvel no portal
http://t2kc.totvs.com.br/home
Se a PYMEFUN.PRW anterior a 11/12/2012, aplicar o pacote do chamado TGGWRV para habilitar as rotinas
para serem usadas no Srie 3
Copiar o arquivo xmile.mile para a pasta SYSTEM, colocar a rotina U_EXTMILE() no menu e executar para criar as
estruturas.
o Ser necessria a ativao do pacote com o seu usurio e senha TOTVS.
o Descompactar o arquivo MILE.RAR criado na pasta MILE

Contedo do pacote
Segmento do menu (menu.xnu)
Patch de atualizao do MILE
Estruturas pr-cadastradas por segmento (xmile.mile)
o Estruturas ERP (*_E.XML)
o Estruturas Varejo (*_V.XML)
o Estruturas Transportes (*_T.XML)
o Estruturas Servios (*_S.XML)
Contedos padres de tabela de condio de pagamento
Exemplos de arquivos de importao monocanal e multicanal
Configuraes de relatrios customizados (treport.spf)
o Existem 3 layouts que podem ser utilizados para documentar a estrutura, que incluem informao
com o HELP do campo, combos disponveis, obrigatoriedade e tabela de referencia (SF3)
o Caso o arquivo \profile\treport.spf no exista, copie o disponvel no pacote
o Caso exista, ele contm as configuraes de relatrios j feitas no sistema, se desejar substituir,
apague a pasta \profile\ctreeint\ que contm o ndice do arquivo
o Depois de substituir/copiar o arquivo, ter estas opes nos layouts do relatrio:

o Caso no seja possvel substituir, pode criar seus prprios layouts utilizando as seguintes frmulas:
Boletim Tcnico
3
MILE


Opes (combo)
CCAMPO := CELL(A1)
CCOMBO := Posicione("SX3",2,CCAMPO,"X3CBOX()")
RETURN CCOMBO
Referencia (consulta SF3)
CCAMPO:=CELL(A1)
CF3:=POSICIONE("SX3",2,CCAMPO,"X3_F3")
IF !Empty(CF3) .AND. LEN((ALLTRIM(CF3)))>2
SXB->(DBSEEK(CF3))
CRETORNO:= XBDescri()
ELSE
CRETORNO:=POSICIONE("SX5",1,XFILIAL("SX5")+"00"+CF3,"X5DESCRI()")
ENDIF
RETURN CRETORNO
Help do campo:
cCampo:=CELL(A1)
CRETORNO := ap5getHeLP(CCAMPO)
CRETORNO := Strtran(cRETORNO, CHR(10),"")
CRETORNO := Strtran(cRETORNO, CHR(13),"")
RETURN CRETORNO
Obrigatrio:
CCAMPO := CELL(A1)
CDESCRI:= CELL(A2)
CRETORNO:=IF(X3Obrigat(CCAMPO).OR. SUBSTR(CDESCRI,1,3)=="(*)","*","")
RETURN CRETORNO
Boletim Tcnico


4 MILE
PROCEDIMENTOS PARA UTILIZAO

Importar e ajustar os layouts e imprimir a documentao.

Acessar a rotina Layouts (CFGA600) e importar as estruturas que deseje utilizar:


As estruturas estaro na pasta MILE do rootpath (por default SYSTEM\MILE) depois de terem sido descompactadas desde o
arquivo MILE.RAR, que foi criado pela execuo da rotina U_EXTMILE() conforme indicado nas instrues de atualizao.

Selecione a estrutura e confirme.

Acerte os layouts caso ache necessrio

Esta verso foi somente validada utilizando ponto e vrgula como separador, o campo ORIGEM DADO determina a coluna onde
est o dado e somente este tipo de importao ter suporte pelo ByYou.

Caso deseje usar outros formatos, faa a alterao do layout criado de acordo com as suas necessidades.

Se acerditar que pode ser til em outra implementao, compartilhe no portal http://t2kc.totvs.com.br com a hastag MILE.

Imprima a documentao dos layouts (recomendvel exportar para Excel)


Estruturas monocal e multicanal:

Existem dois tipos de estruturas pr-definidas, as monocanal (ou sem canal) e as multicanal.
As que so multicanal podem ser identificadas pelos campos ORIGEM e MULTICANAL do cabealho da estrutura. Quando o
campo Origem est preenchido, ele representa a coluna onde dever ser informado o canal na estrutura que ser utilizada para
importao.
Boletim Tcnico
5
MILE

Veja o exemplo abaixo de uma estrutura monocanal:


O arquivo de importao somente ter os dados da tabela ACU, um registro por linha


Neste caso, temos 3 linhas para serem importadas, e somente foram informados os campos obrigatrios, que so os dois
primeiros

Veja o exemplo abaixo de uma estrutura multicanal:
Aqui pode-se perceber que a Origem do canal estar na posio 1 e que os dados do canal DA0 comeam na 2da posio do
arquivo de texto
Boletim Tcnico


6 MILE


Na prxima figura pode-se perceber que os dados do canal DA1 comeam na 2da posio do arquivo de texto.


Como o canal DA1 filho (detalhe) do canal DA0 (cabealho), devero ser informados os dados do canal cabealho (DA0) em
uma linha e os dados do canal detalhe (DA1) nas linhas posteriores, quando finalizados os dados do detalhe (canal DA1)
correspondentes ao cabealho (canal DA0), deve se informar novamente um item do cabealho (canal DA0) e os detalhe na
sequncia.

Veja o exemplo com duas tabelas de preo, cada uma com trs itens:

Boletim Tcnico
7
MILE


Pode-se observar que os canal est informado na primeira posio, de acordo com a configurao do layout


Fazer a importao



Reparar o campo Linha TXT que indica em qual linha comeam os dados.


Exemplo de finalizao com sucesso:


Exemplo de finalizao com ocorrncias:
Boletim Tcnico


8 MILE


Conferir as ocorrencias no log.


Ser aberta uma tela com um browse com as ocorrncias, com a data e hora do processamento, o usurio que processou, os
dados recebidos e a mensagem de erro que retornou o sistema para cada uma das ocorrncias:


Detalhes da ocorrncia: