You are on page 1of 25

Configurao dos mdulos de tecnologia mobile

Contedo:
Introduo....................................................................................................................... 3 Conceitos......................................................................................................................... 4 Arquitetura Organizacional Configurao de Inis.......................................................................................... 6 Diretrios/Arquivos............................................................................................. 8 Criao do Ambiente Menu.................................................................................................................... 9 Patches..................................................................................................................9 Configurao do Mdulo Parmetros...........................................................................................................10 Tabelas/ Campos..................................................................................................11 Utilizao do Mdulo Wizard................................................................................................................. 13 Monitor............................................................................................................... 15 Tabelas.................................................................................................... 16 Servios................................................................................................... 17 Usurios.................................................................................................. 18 Grupos de Usurios................................................................................. 20 Recriao de Base................................................................................... 22 Controle................................................................................................... 23 Auditor.................................................................................................... 25

Introduo
Este documento tem como objetivo esclarecer os procedimentos para implementao da retaguarda dos mdulos que utilizam a tecnologia mobile (SFA ou FDA), descrevendo passo a passo como fazer esta implementao para que o mdulo possa estar integrado com o sistema utilizado no PC do usurio. Os mdulos SFA e FDA permitem uma maior liberdade para o usurio, pois este poder se locomover ate o cliente e coletar informaes, cadastrar novos clientes, incluir pedidos ou ate mesmo efetuar uma venda, emitindo nota fiscal, atravs do modulo FDA. Mas para garantir a integridade das informaes, tanto na importao do mobile para a retaguarda, quando no processo inverso, importante que o mdulo esteja devidamente configurado.

Conceitos
Reservamos este capitulo para esclarecer alguns conceitos que sero amplamente utilizados neste manual. O primeiro deles o da retaguarda: Retaguarda: Em muitos momentos ser utilizado o termo retaguarda ou background, importante esclarecer que aqui tratamos o esse termo como o sistema que est por trs da utilizao do mobile, ou seja, o local de onde sairo os dados que alimentaro o dispositivo Hand-Held e para onde iro os dados coletados externamente atravs do mesmo dispositivo. Neste caso, estaremos documentando a configurao do modulo Faturamento do sistema Protheus, portanto, nossa retaguarda ser o SIGAFAT. Mas importante mencionar que os mdulos de tecnologia Mobile podem estar integrados com qualquer outro sistema, basta que este esteja configurado para receber os dados vindos do mobile, e que esteja preparado para fazer a exportao tambm. Espelhamento: Outro conceito muito importante o de espelhamento. O espelhamento nada mais que uma base paralela, das tabelas que sero utilizadas no mobile. Ou seja, o sistema ir manter uma base semelhante base padro que ser atualizada em tempo real, atravs dos gatilhos, um outro conceito que ser explicado mais adiante. Para facilitar a identificao, foi criado um padro de nomenclatura nas tabelas. O nome de todas as tabelas do mobile so iniciados com H, e em seguida os outros caracteres do nome da tabela padro. No caso da tabela de clientes, a tabela padro SA1, sua tabela correspondente (espelho) a HA1. importante observar que os campos correspondentes em cada tabela devem estar com o mesmo formato (tipo e tamanho), se for feita alguma alterao em alguma tabela padro, o mesmo dever ser feito na tabela espelho. Recriao de Base: Existe um processo denominado Recriar Base que responsvel por montar as tabelas espelho dentro do banco de dados, e criar o arquivo script. Ele deve ser executado quando se est configurando o ambiente para a utilizao de um mdulo de tecnologia mobile. Esse processo tambm chamado de Carga Total, e ser explicado mais detalhadamente mais adiante. Gatilhos: Os gatilhos (ou Trigger) so um dispositivo criado para atualizar a tabela espelho, garantindo que os dados que iro para o mobile estejam condizentes com os da retaguarda. Eles so disparados a cada incluso, alterao ou excluso de registros. Exemplo, quando algum cliente novo cadastrado, o gatilho ir verificar para qual vendedor este cliente foi cadastrado e automaticamente ir incluir esse cliente na tabela espelho. Para que os gatilhos funcionem corretamente, necessrio configurar no ini do server para ativer os gatilhos, esse procedimento ser explicado mais adiante.

Sincronismo: O Sincronismo o processo onde os dados so passados do mobile para a retaguarda e vice-versa. Para isso existe a tabela espelho, ela ir indicar quais registros devem ser includos, alterados ou deletados, alem de identificar para qual vendedor dever ir essa informao. Para fazer esse sincronismo necessrio estar com o Server do Protheus e o MCS abertos. MCS: O MCS, ou Mobile Connectivity Studio, um produto da Microsiga que tem como objetivo prover o suporte conectividade de dispositivo mvel com a retaguarda. Em outras palavras ele uma espcie de ponte entre a retaguarda e o dispositivo, garantindo e controlando a troca de dados entre os dois bancos, por isso ele deve estar sempre ativado ao executar o sincronismo. Ele deve estar instalado na mquina onde est sendo executada a retaguarda, e devidamente configurado atravs do arquivo MCS.ini. Para ser utilizado o MCS precisa de uma chave de acesso, que gerada pelo departamento de Tecnologia Mobile da Microsiga. Para maiores informaes sobre esse produto existe um manual exclusivamente dedicado sua instalao, configurao e utilizao. Script: Sempre que se cria uma base para um determinado HandHeld gerado um arquivo de script. Esse arquivo ir conter todas as informaes necessrias para a montagem das tabelas dentro do dispositivo, no momento em que for feito o sincronismo. Como ele contm as informaes de campos e tabelas, sempre que for feita alguma alterao na estrutura do dicionrio, e que se deseja ser passada para o HandHeld, esse arquivo deve ser apagado para ser criado novamente com a nova estrutura. Para localizar esse arquivo v ate o diretrio HHTRG localizado no RoothPath do Protheus, o nome do arquivo script formado pela palavra script + o cdigo da empresa + o cdigo do vendedor, e de extenso mscr. Monitor: O Monitor o programa onde se relaciona os vendedores com os HandHelds e onde se determina qual servio ser utilizado em cada HandHeld. nele tambm que se faz o processo de Recriao de Base.

Arquitetura Organizacional

Arquivos de Parmetros de Configurao (INIs) Para o funcionamento correto dos servios utilizados nos mdulos de tecnologia mobile, necessrio acertar alguns parmetros, atravs do arquivo ini do Server do Protheus. Vamos utilizar como exemplo a verso 811 do Protheus. No padro, o arquivo que estamos procurando estar no diretrio \BIN\SERVER\mp8srv.ini. Para a utilizao do Mobile ser necessrio acrescentar duas linhas no final do ambiente onde ser instalado esse mdulo. O HHTRIGGERON, que a chave para indicar a ativao dos gatilhos, podendo ter seu valor entre 0 (No utiliza gatilho), 1 (Sempre utiliza gatilho), 2 (Verifica gatilho por Empresa) e 3 (Verifica o gatilho por Empre/Filial). A segunda linha o HHTRIGGERINTERVAL, que indica o tempo em minutos que um segundo gatilho ir aguardar caso dois ou mais gatilhos sejam disparados simultaneamente para um mesmo servio. Existe tambm a linha HHTRIGGERLOG que determina se ser gerado Log no caso de falhas no sincronismo. Caso seja selecionado 1 (Sim) os logs sero gerados dentro da pasta HHTRG/LOGS. [EnvTopR4] -> Ambiente onde ser utilizado o Mobile. SourcePath=C:\MP8\APO\R4\ RootPath=C:\MP8\ StartPath=\SYSTEM\ IncludePath=C:\VER811;C:\MP8\INCLUDE x2_path=\SYSTEM\ RpoDb=Top RpoLanguage=Portuguese RpoInterface=Windows RpoVersion=811 Cisasync=0 LocalFiles=ADS Trace=0 HHTRIGGERON=1 HHTriggerInterval=120 HHTRIGGERLOG=1

Alm desta configurao feita no ambiente de utilizao do Mobile, ser necessrio adicionar uma linha na configurao do TCPSERVER, ainda no arquivo mp8srv.ini. Esta seo ir indicar a porta a ser utilizada pelo MCS para comunicar-se com o Protheus. Observe o exemplo: [TCPSERVER] Enable=1 Port=9100 ResponseJob=HHTCPSERVER [HHTCPSERVER] Type=TCP Environment=EnvTopR4 ONSTART=HHINIT ONCONNECT=HHCONNECT INSTANCES=2,4 Alm desse arquivo, existe outro ini que deve ser observado antes de se iniciar operaes com o mdulo. o ini do MCS, ferramenta responsvel pelo sincronismo entre o HandHeld e o Protheus. Para maiores informaes quanto configurao consulte a documentao do MCS disponibilizada no FTP da Microsiga.

Diretrios e Arquivos Este captulo reserva-se esclarecer a estrutura de pastas e arquivos necessrios e como eles devem estar organizados para a utilizao dos mdulos aqui tratados. O primeiro diretrio a ser observado o HHTRG. Dentro do RoothPath do Protheus ser criado o diretrio HHTRG. Nesta pasta ficaro gravadas todas as tabelas referentes ao monitor do mobile, l tambm que ser criado o arquivo script. Este diretrio criado automaticamente pelo sistema. Relao de tabelas do monitor: Tabela hcadgrp.dbf hcadhh.dbf hcadsrv.dbf hcadsys.dbf hcadtbl.dbf hgrphh.dbf hgrpsrv.dbf hhlog.dbf hhtime.dbf hhtrg.dbf hsrvtbl.dbf Script O script um arquivo que utilizado como um roteiro para o MCS na hora de efetuar o sincronismo. Nele esto informaes necessrias para o MCS acessar o banco de dados, e fazer as operaes solicitadas, como cdigos de acesso ao banco, configuraes, e uma relao das tabelas, campos e filtros das mesmas. importante lembrar que esse arquivo criado automaticamente e somente quando se recria a base pela primeira vez. Caso haja alteraes estruturais no banco, ele deve ser apagado, e assim ser recriado corretamente quando recriar a base. Por ser um arquivo que contem um formato especifico para ser lido pelo MCS, no deve sofrer alteraes manuais. Descrio Cadastro dos grupos de vendedores Cadastro de HandHelds Cadastro de servios Cadastro de sistemas Cadastro de tabelas Amarrao de Grupo x HandHeld Amarrao de Grupo x Servios Arquivo de Log Tabela de Controle de tempo Tabela de Controle de gatilho Amarrao de Servios x Tabela

Criao do Ambiente
Menu Por padro, os programas que fazem parte do Mobile esto no menu do SIGAFAT, dentro do dentro do grupo CRM Mobile. Caso no exista essa opo pode ser colocado, atravs do arquivo SIGAFAT.xnu. Em atualizaes inclua o grupo CRM Mobile, e abaixo desta opo inclua a opo Monitor, chamando a funo CFGW061.prw. Inclua tambm a opo Wizard SFA, chamando a funo HHWIZSFA.prw. O menu ficar dessa forma:

Projeto/Patch/Atualizaes Os fontes da retaguarda do Mobile esto agrupados no projeto Mobile.prj. Para se acessar o monitor e utilizar os servios de atualizao das tabelas espelhos deve-se compilar esse projeto, ou solicitar para o HelpDesk uma patch completa do projeto mobile. J a parte do dispositivo mesmo, o programa que roda dentro do HandHeld utiliza outra tecnologia, portanto no h projeto ou patches, apenas o prprio arquivo executvel e as dlls que deve ser copiado para dentro o dispositivo. Caso o dispositivo seja um Palm arquivos tero extenso prc, caso seja um PocketPc a exteno ser exe.

Configurao do Mdulo
Parmetros Abaixo sero listados alguns parmetros que devem ser criados/observados para o funcionamento correto dos mdulos de tecnologia mobile. Nome da Var. Tipo Exemplo/ Contedo MV_MCSDSN Caracter mp8,sa, Pasta Descrio Informe o Banco de dados, usurio e senha separados por virgula ",". Ex.: NomedoBanco,Usuario,Senha. MV_DTSYNC Caracter 7 Pasta Descrio Este parmetro determina o prazo que o vendedor tem para se conectar com a empresa. Caso o vendedor no se conecte no prazo de dias determinado, o sistema bloqueia a conexo.

Descrio Nome da Var. Tipo Exemplo/ Contedo

Descrio

Tabelas/Campos Abaixo sero listados as tabelas e campos utilizados pelo mdulo Mobile. Como j foi dito anteriormente, as tabelas do mobile so espelhos das tabelas padro, portanto na maioria dos casos o nome do alias e dos campos ser o mesmo do padro, diferenciando-se apenas pelo fato de na tabela espelho o primeiro caracter ser sempre H. Somente em alguns casos o nome ser diferente. Por exemplo, no campo A1_NATUREZ. O seu campo de espelhamento o HA1_NATURE, nesse caso o nome no pode ser o mesmo devido limitao do tamanho do nome do campo. Ou ainda no caso da tabela DA1 (tabelas de preo). A tabela de espelhamento desta tabela HPR, pois no se poderia utilizar HA1, uma vez que esta tabela espelha o SA1 (cadastro de clientes) Relao das tabelas do Mobile: Padro
SM0 SA3 SCT AD7 SA1 SU5 SE1 SA5 ACU ACV SBM SB1 DA0 DA1 SB2 SA4 SE4 SF4 SZXXX SC5 SC6 AD5 ACO ACP ACQ ACR ACS ACT SX5 SX5 (24) SX6 SX2 SX3 SIX

Espelho
HM0 HA3 HMT HD7 HA1 HU5 HE1 HA5 HCU HCV HBM HB1 HTC HPR HB2 HA4 HE4 HF4 HMV HC5 HC6 HD5 HCO HCP HCQ HCR HCS HCT HX5 HTP HCF ADV_TBL ADV_COLS ADV_IND

Descrio
Empresa Vendedor Metas Roteiros - Agenda Clientes Contatos Ttulos Relacionamento Produto x Fornecedor Categorias de Produtos Relacionamento Categoria x Produto Grupo de Produtos Produtos Cabealho da Tabela de Preos Itens da Tabela de Preos Estoque de Produtos Saldo Fsico e Financeiro Transportadoras Condio de Pagamento TES Mensagens Cabealho do Pedido de Venda Itens do Pedido de Venda Apontamentos Cabealho da Regra de Desconto Itens da Regra de Desconto Cabealho da Regra de Bonificao Itens da Regra de Bonificao Cabealho da Regra de Negcios Itens da Regra de Negcios Tabelas Formas de Pagamento Parmetros/Configuraes Tabelas do Sistema Colunas das Tabelas do Sistema ndices

Antes de se iniciar a utilizao do modulo preciso verificar se as tabelas do mobile esto no dicionrio (SX2, SX3 e SIX). Caso eles no existam deve ser feita uma atualizao manual. Neste caso deve-se entrar em contato com o HelpDesk solicitando os arquivos de atualizao, e tambm instrues detalhadas para esse procedimento. Aps essa atualizao do dicionrio aconselhvel verificar se todas as tabelas listadas acima foram lanadas no SX2 e os respectivos ndices no SIX. Verificar tambm se os campos espelho tm o mesmo tamanho do campo padro, pois isso pode gerar um problema caso o tamanho de algum campo tenha sido alterado no padro. Exemplo: o campo A1_NOME por padro tem 40 caracteres, logo o campo HA1 tambm possui 40 caracteres. Caso esse tamanho tenha sido alterado no dicionrio do SA1 por alguma necessidade especifica, a mesma alterao deve ser repassada para o campo HA1_NOME no dicionrio (SX3).

Utilizando o Mdulo
Nesse captulo ser apresentado o mdulo em si, as suas rotinas principais e sua utilizao. importante que todos os processos citados anteriormente estejam concludos , e que o ambiente esteja configurado de maneira correta, para evitar complicaes. A utilizao desse modulo permitira uma integrao com o dispositivo mobile utilizado, e dessa forma garantindo o funcionamento dos mdulos SFA e FDA que rodam inteiramente dentro do seu dispositivo mvel. Wizard O Wizard SFA um assistente que foi criado para auxiliar a configurao de alguns parmetros importantes, ele ser utilizado raramente, provavelmente apenas na primeira vez em que o mdulo for acessado. Aps isso no ser mais necessrio executar esse programa. Primeiramente ser apresentado uma tela de servios. Aqui devem ser marcados os servios que o usurio ir utilizar dentro do dispositivo.

A segunda tela um roteiro de configurao de parmetros, mostrando os parmetros mais importantes utilizados no SFA.

Ao clicar em finalizar as alteraes sero aplicadas ao sistema.

Monitor O monitor o dispositivo que gerencia os cadastros de vendedores, dispositivos, servios, grupos, etc. Alm desse gerenciamento, no monitor que so feitas as cargas totais, ou recriao de base. Por padro ele acessado pelo menu do faturamento, mas ele pode ser colocado em qualquer outro mdulo, a funo chamada a cfgx061a. Quando se acessa o monitor do HandHeld pela primeira vez todas as tabelas so criadas dentro do diretrio HHTRG j com o contedo padro, sendo necessrio cadastrar apenas os usurios e grupos de venda. interessante no modificar os demais cadastros, acessando-os somente se houver necessidade de alterao ou criao de alguma tabela/servio customizado.

Tabelas O cadastro de tabelas guarda todas as tabelas utilizadas no mobile, contendo informaes do seu funcionamento. Seu contedo j vem preenchido com o padro do sistema.

Cdigo Cdigo de controle, usado internamente; Descrio Descrio resumida da tabela; Alias Alias utilizado no Mobile; Genrico Informa se a tabela genrica ou no, entenda-se por genrica tabelas que so comuns a vrios vendedores (exemplo: Produtos); Verso Campo de controle para o MCS; Campo ID Informa qual campo ir o diferenciar o vendedor (deve ser informado apenas se a tabela for No Genrica); Retorna Informa se a tabela pode ser atualizada no HandHeld e se essas informaes ser retornadas retaguarda; Filtrar Empresa Indica se deve se feito filtro por empresa nesta tabela; Compartilhada Entre Empresas Indica se a tabela ser compartilhada entre empresas, caso exista mais de uma utilizando o Mobile.

Servios Os servios so as funes responsveis pelo espelhamento da tabela, tanto do padro para o espelho como o inverso. Neste cadastro deve ser informada a funo, o alias padro e o alias espelho relacionados. Seu contedo j vem preenchido com o padro do sistema.

Cdigo Cdigo de controle, usado internamente; Descrio Descrio resumida do servio; Funo Funo do RPO que ir executar este servio (todos os servios j vm com a funo padro, mas possvel customizar este servio e chamar uma User Function nesse campo); Alias Alias utilizado no Padro; Tipo Tipo do servio (Origem/Destino dos dados); Tabelas Relao das tabelas espelho que esto relacionadas no processo, variando de 1 a N.

Usurios O cadastro de usurios guarda as informaes de cada HandHeld cadastrado. A chave principal deste cadastro o numero de srie do equipamento, este nmero de srie a licena para utilizao do mdulo fornecido pela Microsiga. Esta licena ser fornecida atravs de um arquivo com extenso lic, no caso de Pocket PC, ou de extenso prc, no caso de Palm. Este arquivo deve ser copiado para o equipamento, junto com os executveis do programa Mobile, e pode-se visualizar o numero da licena acessando o mdulo, na opo Sync, como na imagem abaixo: O numero de srie o campo Ident.

Numero de Srie Numero de srie do equipamento; Nome do Usurio Identificao do vendedor que ir utilizar o equipamento; Cdigo Usurio Cdigo do usurio do sistema Protheus; Dispositivo Identifica o tipo do dispositivo (Palm/Pocket e verso do processador);

Grupos de Usurios Neste cadastro possvel criar grupos de vendedores separados e diferentes entre si, facilitando o controle dos vendedores. Aqui tambm feito o relacionamento dos grupos com os servios que sero utilizados.

Cdigo Cdigo de controle, usado internamente; Descrio Descrio resumida do grupo; Sistema Informa qual o sistema utilizado por este grupo; Empresa/Filial Informa a qual empresa e filial pertence este grupo; Freqncia Freqncia com que ser executado o JOB de espelhamento da base (no h necessidade de rodar o JOB caso os gatilhos estejam ativados.); Script Nome do arquivo de script. Campo no obrigatrio. Pasta Servios Pasta para seleo dos servios que sero utilizados neste grupo. Pasta HandHeld Pasta para seleo dos usurios que faro parte deste grupo.

Ao se marcar um usurio ser aberta uma janela para selecionar qual vendedor est relacionado a este HandHeld, ser disponibilizada uma consulta aos vendedores cadastrados (SA3):

Recriao de base Ainda no cadastro de grupos, pode-se notar no canto direito o boto de recriar base. Este boto recria a base do vendedor selecionado, necessrio recriar ao menos uma vez a base para cada vendedor, pois neste momento sero gravadas as informaes na tabela de controle (HHCTR) e ser gerado o script para este usurio. O processo de recriao de base pode ser repetido varias vezes, porm no h necessidade, uma vez que a base ser espelhada atravs dos gatilhos. Quando feita um recriao de base o sistema trata a operao como uma Carga Total, e quando for feito o sincronismo todas as tabelas sero transportadas para o HandHeld. Quando h apenas atualizaes ocasionadas por gatilho, trata-se de uma Carga Parcial, nesse caso apenas os registros que sofrerem alterao so posicionados e repassados ao HandHeld. O boto Recriar Todos Recria a base de todos os vendedores selecionados. O boto Importao executa a importao de dados das tabelas de espelho para o padro. O processo de importao s necessrio casa ocorra algum problema no sincronismo e algum registro fique preso na tabela espelho (algum pedido, por exemplo), caso contrrio todas as informaes so importadas tambm via gatilho logo aps o sincronismo.

Controle A rotina de controle foi criada no monitor para proporcionar diversas informaes sobre a situao dos HandHelds, e estatsticas de gatilhos e sincronismos. Ao acessar o boto de controle a primeira pasta disponvel HandHeld, que traz todos os dispositivos cadastrados com os respectivos nmeros de sries e cdigo de vendedor associado e uma coluna informando o status do HandHeld, podendo ser: 1 Livre (Nenhuma operao est sendo executada para este dispositivo) 2 JOB (Est sendo executado JOB para este dispositivo) 3 HandHeld (O dispositivo est em comunicao) 4 Processando (Est sendo processada recriao de base) 5 Bloqueado (O dispositivo est bloqueado) 6 Parcial (O dispositivo foi sincronizado parcialmente) Caso esteja com status 2, 4 ou 5 no ser possvel conectar.

Alm dessas informaes pode-se obter na rotina de controle um historio das conexes, logs de erro, listagem dos gatilhos e quadros estatsticos:

Auditor O monitor conta ainda com uma rotina de auditoria que auxilia a implantao do mdulo. Ela traz um resumo das operaes que devem ser observadas, como configuraes de campos, tabelas e parmetros.

Estas so as funcionalidades do monitor do HandHeld. O primeiro passo para a implantao so os procedimentos contidos neste documento. Aps verificadas todas as configuraes descritas, cadastradas as informaes no monitor, criadas as bases de cada vendedor, e configurada a ferramenta MCS, possvel fazer o sincronismo da retaguarda com o dispositivo mvel. E a partir da o sistema estar pronto para coletar pedidos e outras informaes e repass-los ao Protheus.