Release Linxetl 101

Linx ETL

M anual do U surio

Todos os direitos reservados. Nenhuma parte deste material pode ser reproduzida por qualquer forma ou meio -grfico, eletrnico, ou mecnico, incluindo fotocpias, fotos ou sistemas de armazenamento e recuperao dedados - sem a autorizao prvia do Grupo Linx.

Todas precaues foram tomadas na preparao deste documento, no entanto, o Grupo Linx no assumenenhuma responsabilidade por erros ou omisses, ou problemas resultantes do uso das informaes nelecontidas . Em caso de alguma ocorrncia, solicitamos a comunicao rea de Formao e Documentao doGrupo Linx, para esclarecimento ou correo.

Impresso: maio 2012 em So Paulo - Brasil.

Linx ETL

2012 Linx Sistemas

Rua Cenno Sbrighi, 170 - Torre IIgua Branca - So Paulo - SP

CEP 05036-010Tel.: +55.11.2103-2400

www.linx.com.br

Grupo Linx

3Linx ETL

3

ContedoLinxETL

.................................................................................................................................................... 5Introduo

.................................................................................................................................................... 6Entenda o processo

.................................................................................................................................................... 7Informaes tcnicas.................................................................................................................................................... 12Pr-requisitos.................................................................................................................................................... 14Procedimentos de instalao

LinxETL

Manual Linx ETL

Manual Operacional

LinxETL

2012 Linx Sistemas

5

Viso GeralLinxETL V erso 1.0.1

Linx ETL - Extract, Transform and Load - Envio de Movimentao de Loja

O Linx ETL um software especialmente desenvolvido para sincronizar a movimentao delojas. Basicamente, realiza o mesmo processo que o Datasync porm de forma maisabrangente.

Tem como objetivo criar um novo meio de atualizao dos bancos de dados Linx atravs detroca de mensagens via web. Para isso, ser utilizado o novo fram ework Linx UX para a criaodos servios, que estaro disponveis no servidor da retaguarda. Dessa forma, a loja receberum novo servio do W indows.

Este novo processo permite a aplicao para quem utiliza o ambiente SAAS e servidor deretaguarda prprios.

Manual Operacional

Linx ETL

2012 Linx Sistemas

6

Entenda o processoLinxETL V erso 1.0.1

O servio do W indows (W indows Se rv ice) monitorar as movimentaes de Loja (LinxPOS)fragmentado por tipo (Ex: LojaVendaPgto, LojaSaida, LojaEntrada e etc) e por operao(Lanamento de caixa, Romaneio Produto, etc).

O pacote ser enviado compactado, criptografado e transmitido via servio de inte rne t (Serviode Inte rne t WCF) e disponibilizado em um repositrio no banco de dados da Retaguarda. Oservidor de retaguarda ir monitorar o repositrio atravs de um servio do W indows eatualizar as informaes na base de dados do Linx ERP.

Diagrama do processo

Manual Operacional

LinxETL

2012 Linx Sistemas

7

Informaes tcnicasLinxETL V erso 1.0.1

Verifique, a seguir, as informaes tcnicas que precisam ser consideradas na instalao eutilizao do Linx ETL:

Tabelas de loja modificadas

Tabelas ETL

Execuo scripts Loja

Execuo scripts Retaguarda

Atualizao Linx ETL Verso 1.0.1

Tabelas de loja modificadas

As tabelas principais de loja receberam uma nova coluna para controle do status de envio.Verifique a lista de tabela modificadas:

Tabela Coluna

LOJAS_VAREJO LX_STATUS_LOJA

LOJA_VENDEDORES LX_STATUS_VENDEDOR

LOJA_IMPRESSORAS_FISCAIS LX_STATUS_IMPRESSORA

LJ_DOCUMENTO_ECF LX_STATUS_DOCUMENTO_ECF

LOJA_ENTRADAS LX_STATUS_ENTRADA

LOJA_VENDA_PGTO LX_STATUS_VENDA

LOJA_SAIDAS LX_STATUS_SAIDA

LOJA_CONTROLE_FISCAL LX_STATUS_CFISCAL

LOJA_CAIXA_LANCAMENTOS LX_STATUS_CAIXA

LOJA_PEDIDO LX_STATUS_PEDIDO

FATURAMENTO_SEQUENCIAIS LX_STATUS_SEQUENCIAL

Manual Operacional

Linx ETL

2012 Linx Sistemas

8

INVENTARIO LX_STATUS_INVENTARIO

LOJA_RESERVA LX_STATUS_RESERVA

PARAMETROS_LOJA LX_STATUS_PARAMETRO

LOJA_CONSERTO LX_STATUS_CONSERTO

LOJA_NOTA_FISCALLX_STATUS_NOTA_FISCAL

Estas colunas tero trs status, so eles:

1 Pendente: Este valor ser atualizado automaticamente ao inserir ou alterar um registrono banco de dados.

2 Enviando: Este valor ser atualizado automaticamente ao iniciar o processo de envio.

3 Enviado: Indica que os registros foram transmitidos com sucesso para a retaguarda.

Sero monitorados todos os pacotes com status 1 e 2, para garantirque qualquer pacote interrompido durante o processamento seja

enviado novamente.

Tabelas ETL

Verifique, a seguir, as informaes sobre tabelas ETL:

I. Tipos de pacotes monitorados - LJ_LX_ETL_TIPO

ID_ETL_TIPO Seqencial de pacotes. O seqencial no deve ser alterado em hiptesealguma.

DESC_ETL_TIPO Descrio do tipo de pacote.

INATIVO Indica o tipo de pacote que deve ser monitorado.

EXCLUI_PROCESSO_CONCLUIDO Indica o pacote deve ser excludo ou no aps oprocessamento. Ser vlido somente em pacotes processados com sucesso.

Manual Operacional

LinxETL

2012 Linx Sistemas

9

II. Tabela principal onde sero despejados os pacotes de Lojas - LJ_ETL_ARQUIVO

ID_ETL_TIPO Tipo de pacote recebido.

CODIGO_FILIAL Cdigo da filial que enviou o pacote.

ID_ETL_ARQUIVO Sequencial de arquivo, criado automaticamente durante a inserodo registro na tabela.

DATA_HORA_CRIACAO Data e hora que o arquivo foi recebido.

XML_ARQUIVO Arquivo de movimento, zipado e criptografado.

PROCESSADO Status de processamento na retaguarda:

1 Indica que o arquivo est pendente para processamento

2 Indica que o arquivo est em processamento.

3 Indica que o arquivo foi processado. Este arquivo s ser mantido caso o parmetroEXCLUI_PROCESSO_CONCLUIDO da tabela LJ_LX_ETL_TIPO esteja igual a "0" ou o arquivoesteja.

DATA_HORA_PROXIMO_PROCESSO Indica que houve algum problema noprocessamento do arquivo e seu processamento foi postergado.

III. Log de crticas ou erros - LJ_ELT_PROCESSO

ID_ETL_PROCESSO Seqencial de processamento, criado automaticamente durante ainsero do registro na tabela.

CRITICA_PROCESSO Informa a descrio da crtica ou erro.

ID_ETL_ARQUIVO Indica qual arquivo foi processado.

COD_RETORNO Indica o cdigo do retorno.

"0" - Arquivo processado com sucesso. Este processo s ser mantido caso o parmetroEXCLUI_PROCESSO_CONCLUIDO da tabela LJ_LX_ETL_TIPO esteja igual a "0".

"-1" Erro.

"-2" Observao.

DATA_HORA_PROCESSO Indica a data e hora que o arquivo foi processado.

Sero monitorados todos os pacotes com status 1 e 2, para garantirque qualquer pacote interrompido durante o processamento seja

enviado novamente.

Manual Operacional

Linx ETL

2012 Linx Sistemas

10

IV. Estatstica de processamento de movimentaes na retaguarda - LJ_ETL_ESTATISTICA

CODIGO_FILIAL Indica o cdigo da filial.

DATA_ESTATISTICA Indica a data da estatstica.

ID_ETL_TIPO Indica o tipo de pacote.

QTDE_PROCESSADA Indica a quantidade de registros processados com sucesso.

QTDE_ERRO Indica a quantidade de registros processados com erro.

DATA_HORA_ULTIMO_PROCESSO Indica a data e hora do ltimo processamento.

Execuo scripts Loja

I. Script ETL EDM (Lojas).sql

Criao de tabelas de apoio, tipos de pacote e validao e criao de colunas necessrias.

II. Atualizao Trigger Linx POS

Este script atualiza todas as tr igge rs do banco de loja para funcionarem com o Linx ETL. Aatualizao de trigge rs no causa impacto no funcionamento do LinxPOS.

Execuo scripts Retaguarda

I. LX_PAINEL_ETL_ESTATISTICA.sql

Responsvel pela consulta dos dados da tela 300119.

II. Script ETL EDM (Lojas).sql

Criao das tabelas de repositrio, validao e criao de colunas necessrias e criaoda transao do Linx (Manual).

Manual Operacional

LinxETL

2012 Linx Sistemas

11

Atualizao Linx ETL Verso 1.0.1

Para facilitar a atualizao do Linx ETL, foi gerado um pacote para download, conformeprocedimento:

1. Encerre o servio do Linx ETL j iniciado;

2. Extraia o contedo do pacote (aplicativo Winzip) no diretrio de instalao do Linx ETL;

3. Inicie o servio novamente.

Manual Operacional

Linx ETL

2012 Linx Sistemas

12

Pr-requisitosLinxETL V erso 1.0.1

Verifique, a seguir, os pr-requisitos necessrios para utilizao do Linx ETL na loja e naretaguarda:

Pr-requisitos de software

Pr-requisitos gerais - Loja e Retaguarda

Pr-requisitos Loja

Pr-requisitos Retaguarda

Pr-requisitos de software

Componente Verso necessria

Verso do LinxPOS 6.2.3 ou superior

Verso do LinxERP ou LinxERPFranquias

8.0.6 ou superior

Verso do SQL Serve r 2005 SP2 ou superior

Verso do W indows (no cliente) W indows XP com SP2, W indows Vista ou W indows 7

Observao: .NET Fram ework 4 completo

Verso do W indows Se rve r W indows 2008 Serve r ou superior

IIS 7 ou superior

.ENT Fram ework 4 completo -

Manual Operacional

LinxETL

2012 Linx Sistemas

13

Pr-requisitos gerais - Loja e Retaguarda

Instalao do Microsoft NET Framework 4.0

Desativar agendamento do Datasync - Observao: O Datasync ainda pode ser utilizadoem contingncia.

Pr-requisitos Loja

Realize o processo de envio do Datasync da Loja para a Retaguarda antes deiniciar a instalao e configurao do Linx ETL.

Execuo Scripts Loja

Instalao do gerenciador do Linx ETL

Pr-requisitos Retaguarda

Necessrio somente em clientes com servidor de retaguarda prprio.Ambiente SAAS j contm pr-requisitos instalados e configurados.

Configurao e Instalao IIS (Gerenciador dos Servios de Informaes da Internet) -Retaguarda

O IIS possui vrias verses. O Linx ETL suporta apenas o IIS verso 7 ou superior.

Execuo Scripts Retaguarda

Instalao do gerenciador de instncias do Linx ETL

Criao de Instncias Linx ETL (Windows Service) Retaguarda

Manual Operacional

Linx ETL

2012 Linx Sistemas

14

Procedimentos de instalaoLinxETL V erso 1.0.1

Verifique, a seguir, os procedimentos para instalao dos seguintes componentes, parautilizao do Linx ETL:


Desativar agendamento do Datasync

Configurao e Instalao IIS (Gerenciador dos Servios de Informaes da Internet) -Retaguarda



Criao de Instncias Linx ETL (Windows Service) Retaguarda


O fram ework necessrio para o funcionamento do Linx ETL. O se tup estar disponvel nodiretrio informado pelo cliente.

Execute o se tup e siga o passo a passo a seguir:

1. A primeira tela do instalador ser exibida. Selecione os check box:

"Eu li e aceitei os termos do contrato."

"Sim, enviar informaes sobre minhas experincias de instalao Microso ft Corpora tion."

Manual Operacional

LinxETL

2012 Linx Sistemas

15

Manual Operacional

Linx ETL

2012 Linx Sistemas

16

2. Clique no boto Instalar.

3. Aguarde enquanto o Fram ework instalado:

4. Em seguida, clique em Finalizar.

Desativar agendamento do Datasync

Realize o procedimento a seguir para desativar o Datasync j configurado:

Remova na configurao de tarefas agendadas os envios de Datasync para a retaguarda;

Solicite ao SAAS (caso o servidor seja hospedado no SAAS), a remoo dosagendamentos de importao de Datasync da Loja.

No remova o agendamento de recebimentos.

Manual Operacional

LinxETL

2012 Linx Sistemas

17

Configurao e Instalao IIS (Gerenciador dos Servios de Informaes da Internet) - Retaguarda

Verifique, a seguir, os procedimentos para instalao do IIS na retaguarda:

1. Extraia o contedo da pasta "Linx.ETL.IIS" em "\LinxETL".

2. No W indows Explore r, acesse os m enus:

Meu Computador;

Painel de Controle;

Ferramentas Administrativas;

Gerenciador dos Servios de Informaes da Internet (IIS);

3. Abra o IIS;

4. Clique com o boto direito na opo Site s em destaque;

Manual Operacional

Linx ETL

2012 Linx Sistemas

18

5. Clique na opo Adicionar s ite. A seguinte tela ser exibida:

6. Preencha as seguintes informaes:

Nome do site: Informar "LinxETL(#NomeCliente#)"

Diretrio de Contedo / Caminho fsico: Informar o caminho do contedo extradoconforme orientado anteriormente.

Ligao - Item "Porta": Informar uma porta com permisso de acesso externo.

7. Clique em OK;

8. Aps a criao do site, a seguinte tela ser exibida:

Manual Operacional

LinxETL

2012 Linx Sistemas

19

9. Clique com o boto direito na opo Poo ls de Aplicativos;

10. A seguinte tela ser exibida. Localize o s ite criado e d duplo clique para abrir;

Manual Operacional

Linx ETL

2012 Linx Sistemas

20

11. Em "Verso do .NET Fram ework", informe a verso V4.0.30319. Confirme no boto OK;

12. Na opo Site s, localize o s ite criado e clique com o boto direito do m ouse em Editarpermisses;

13. Em "Propriedades do #Nome Site#", aba Segurana - Nomes de Grupo ou de Usurio,clique em Editar;

Manual Operacional

LinxETL

2012 Linx Sistemas

21

14. Em seguida, clique em Adicionar;

15. A seguinte tela ser exibida. Clique em Locais:

Manual Operacional

Linx ETL

2012 Linx Sistemas

22

16. Ao selecionar a opo, a tela seguinte ser exibida:

17. Informe o diretrio local (nome do servidor), e confirme em OK;

Manual Operacional

LinxETL

2012 Linx Sistemas

23

18. Na opo "Selecionar Usurios ou Grupos", clique em Avanado;

19. Em "Selecionar Usurios ou Grupos", clique em Localizar agora, em seguida Localizar"IIS_IUSRS", "IUSR" e "SISTEMA" e confirme em OK.

Manual Operacional

Linx ETL

2012 Linx Sistemas

24

20. Em "Selecionar Usurios ou Grupos", clique em OK;

Manual Operacional

LinxETL

2012 Linx Sistemas

25

21. Em "Permisses para #Nome Site#", aplique a configurao e clique em OK;

22. Em "Propriedades de #Nome Site#", confirme em OK.

23. Em "Sites", localizar o s ite criado. Na opo "Pgina Inicial #Nome Site#", d um duploclique em Cadeias de Conexo.

Manual Operacional

Linx ETL

2012 Linx Sistemas

26

Manual Operacional

LinxETL

2012 Linx Sistemas

27

24. Em Cadeias de Conexo, d duplo clique no nome POS9502.

25. Na opo: Editar Cadeias de Conexo, no item "Personalizar", localize "LinxPOS-Srv" esubstitua pelo servidor de banco de dados que ser usado. Em seguida, localize"LinxERPXXX", substitua pelo nome da base de dados.

Caso a conexo com o banco de dados no utilize "Autenticao do Windows", localize "Integra ted Security=SSPI" e substitua por "Use r Id=m yUsernam e;Password=m yPassword;".

Manual Operacional

Linx ETL

2012 Linx Sistemas

28

26. Na opo Sites, localize o s ite criado. Na opo Gerenciar Site Reiniciar.

27. Abrir navegador de Internet, informar o endereo:

http://#NomeServidor#:#Porta:XX#/Services/Linx-POS9502-BO-LjEtl-LjEtlDomainService.svc

28. Abrindo esta inte rface, significa que o servidor foi configurado corretamente e est prontopara ser utilizado.


A instalao deve ser feita por um usurio com acesso administrativo.

Para instalar o gerenciador de instncias do Linx ETL, execute o arquivo Linx.ETL.Instance.Manager.Setup.msi fornecido no kit de instalao e siga os passos apresentados a seguir.

A instalao deve ser feira por um usurio com acesso administrativo.

1. A primeira tela do arquivo de instalao do Linx ETL Manager ser exibida. Clique no botoAvanar:

Manual Operacional

LinxETL

2012 Linx Sistemas

29

2. Selecione o diretrio para instalao:

3. Informe o tipo de banco de dados conectado: Loja. Em seguida, clique em Avanar.

Manual Operacional

Linx ETL

2012 Linx Sistemas

30

4. Clique em Avanar para confirmar a Instalao.

5. Aguarde a instalao do aplicativo:

Manual Operacional

LinxETL

2012 Linx Sistemas

31

6. Durante o processo de instalao sero solicitada as configuraes do servio, conforme telaa seguir:

7. Clique no boto Alterar configuraes e informe:

Nome do servidor de loja;

Tipo de autenticao do SQL;

Banco de dados LinxPOS;

Identificao da Filial;

Para identificar o computador local, utilize a sequencias de caracteres ".\" antes dousurio. Exemplo: ".\Administrador".

Manual Operacional

Linx ETL

2012 Linx Sistemas

32

Informe o IP ou endereo do repositrio de retaguarda, porta e intervalo de sincronizao(Tempo de inatividade aps processamento de pacotes pendentes).

8. Ao confirmar configuraes, o servio ser instalado. Caso o parmetro "Fazer logoncomo:" esteja como "Usurio", ser necessrio informar a conta de usurio com perfil deadministrador da mquina:

9. Aps o preenchimento de todas as informaes, a instalao ser concluda:

Manual Operacional

LinxETL

2012 Linx Sistemas

33

10. Depois de concluda a instalao, o Linx ETL j estar configurado e iniciado na Loja e ainterface Linx ETL Manager estar disponvel no diretrio de instalao para manuteno.


Verifique, a seguir, os procedimentos para instalao do gerenciador de instncias do Linx ETL.Execute o arquivo Linx.ETL.Instance.Manager.Setup.msi fornecido no kit de instalao e siga opasso a passo:

Manual Operacional

Linx ETL

2012 Linx Sistemas

34

A instalao deve ser feita por um usurio com acesso administrativo.

1. Selecione o diretrio para instalao do aplicativo:

2. Selecione o tipo de banco de dados conectado: Retaguarda.

Manual Operacional

LinxETL

2012 Linx Sistemas

35

3. Depois de concluda a instalao, o gerenciador de instancias do Linx ETL estar disponvelno diretrio de instalao para criao e configurao da instncia.

Manual Operacional

Linx ETL

2012 Linx Sistemas

36

4. Clique no boto Fechar e o sistema estar pronto para utilizao.

Criao de instncias Linx ETL (Windows Service) Retaguarda

Verifique, a seguir, os procedimentos para a criao de instncias do Linx ETL:

1. Clique no menu Iniciar;

2. Execute o aplicativo "Linx ETL Instance Manager" na linha de comando de pesquisa.

A configurao deve ser feita por um usurio com acessoadministrativo.

Se, ao executar o procedimento acima a tela for iniciada com o boto de criao de instnciadesabilitado, inicie o aplicativo novamente, porm executando como administrador (com a tecla shift pressionada, clique com o boto direito do m ouse e selecione a opo "executar comoadministrador").

3. Ao executar o aplicativo, a seguinte tela ser exibida:

Manual Operacional

LinxETL

2012 Linx Sistemas

37

4. Na aba em destaque Criar instncia Linx ETL, informe o nome da instncia. Comopadro, pode-se utilizar o nome do cliente: Exemplo: ClienteXXXXXX.

Clique em Criar Instncia.

Manual Operacional

Linx ETL

2012 Linx Sistemas

38

5. Em "Lista de instncias", selecione a instncia criada e clique no boto Alterarconfiguraes;

6. No tpico Configurador de Instncia, informe:

a) Tipo de banco de dados conectado: Retaguarda.

b) Nome do servidor;

c) Tipo de autenticao no SQL;

d) Banco de dados;

e) Intervalo de sincronizao (Tempo de inatividade aps processamento de pacotespendentes)

Em seguida, clique em Confirmar alteraes.

Manual Operacional

LinxETL

2012 Linx Sistemas

39

7. Aps confirmar as alteraes, clique em Iniciar Sincronizao (Instalar). Caso oparmetro "Fazer logon como:" esteja como Usurio, ser solicitada uma conta de usurioadministrador do computador.

Para identificar o computador local, utilize a seqncias de caracteres ".\" antes do usurio.Ex: ".\Administrador".

Manual Operacional

Linx ETL

2012 Linx Sistemas

40

8. Aps confirmao, o Linx ETL ser instalado e iniciar a sincronizao da movimentao deLoja.

Manual Operacional

LinxETL

2012 Linx Sistemas

41

LinxETLIntroduoEntenda o processoInformaes tcnicasPr-requisitosProcedimentos de instalao

Release Linxetl 101

Documents

Transcript of Release Linxetl 101