LOJA BT Carga de Ambiente TFS768 PDF

Boletim Tcnico
Carga de Ambiente
Produto
: Microsiga Protheus Controle de Lojas verso 10
Chamado
: TFS768
Data da publicao
: 18/12/12
Pas(es)
: Todos
Banco(s) de Dados
: Todos
Esta melhoria depende de execuo do update de base UPDLO105, conforme Procedimentos para
Implementao.
Criada a rotina Carga de Ambiente (LOJA1158), para transferncia de tabelas entre ambientes (terminais, caixas, servidores),
tornando seu uso prtico e gerencivel. A rotina apresenta as seguintes funcionalidades:
Transferncia dos dados das tabelas entre ambientes;
Utilizao de uma hierarquia de transferncia;
Facilidade na gerncia dos ambientes envolvidos;
Execuo da carga de modo automtico e com replicao na hierarquia;
Dois modos de gerao de carga (inteira ou incremental)
Gerenciamento de mltiplas cargas disponveis (permite manter diversasL cargas disponveis para os ambientes e permite
gerenciar o status de carregamento delas em cada ambiente).
Substituio, em diversos cenrios, do uso da carga existente no Front Loja (SIGAFRT).
A Carga de Ambiente composta pelas seguintes rotinas:
Assistente de configurao do servidor de arquivos do mdulo Controle de Lojas (LOJA0047);
Assistente de gerao de carga (LOJA1156);
Assistente de carregamento de carga (LOJA1157);
Assistente de excluso de carga (LOJA1176) e
Monitor de carga (LOJA1158).
Definio dos modos de carga:
Carga Inteira: Na gerao de carga, exporta a tabela inteira. No carregamento da carga, limpa a tabela local e em seguida
importa todos os registros da carga.
Carga Incremental: Na gerao de carga, exporta apenas registros novos ou registros alterados (registros que ainda no foram
exportados). No carregamento da carga, inclui os registros novos e altera os registros j existentes para o contedo atualizado da carga.
SIGALOJA Carga de Ambiente
Boletim Tcnico
Para a carga incremental, obrigatrio que a tabela exportada possua um ndice nico.
A Carga Inteira deve ser usada para atualizao inicial de um ambiente (atualizando completamente um ambiente) ou para
casos onde alguma carga incremental necessria para o ambiente j foi apagada (neste caso necessrio gerar uma carga inteira
para carregar os registros contidos na carga incremental perdida).
A Carga Incremental deve ser usada para atualizaes peridicas de volumes menores, exportando apenas os registros novos
ou alterados. Aumentando a eficincia de gerao e carregamento das cargas para atualizao dos ambientes.
Dessa forma, para as atualizaes automticas e para definir se um ambiente est atualizado, so consideradas apenas as
cargas incrementais (as cargas inteiras so apenas para auxiliar o carregamento inicial de um ambiente).
Para controlar a exportao incremental (apenas de registros novos ou alterados) so usados os campos de controle MSEXP e
HREXP em cada tabela utilizada na carga. Esses campos so manipulados apenas pelas cargas incrementais ou, excepcionalmente,
pela primeira carga inteira da tabela.
Para garantir a integridade dos dados, a carga incremental utiliza um campo Ordem (MBU_ORDEM) para definir a sequncia das
cargas incrementais. Quando for selecionado um carregamento de carga automtico (via job), um carregamento Express ou a opo
Atualizar Tudo, essa sequncia ser avaliada de forma a garantir que nenhuma carga seja ignorada. Caso alguma carga seja excluda e o
ambiente necessite dela para aplicar as cargas sequencialmente, a atualizao ser abortada e um aviso (ou log) ser exibido solicitando
que seja feita uma atualizao manual (preferencialmente de uma carga inteira seguida das incrementais), pois a sequncia foi quebrada
e a integridade da atualizao est comprometida.
Quando um novo ambiente for inserido na rede, deve-se gerar e aplicar uma carga inteira das tabelas e em seguida aplicar
manualmente todas as incrementais disponveis (atualizar o nvel de atualizao do ambiente novo em relao aos demais). Neste caso,
importante aplicar as cargas incrementais disponveis manualmente para atualizar o controle sequencial das cargas incrementais no
ambiente novo e prepar-lo para receber atualizaes automticas.
Para tabelas que possuam campos do tipo Memo (utilizando a tabela SYP) deve ser gerada, alm da carga da tabela normal, uma
carga da tabela SYP, pois os campos do tipo Memo no so enviados nas cargas.
Campos de controle MSEXP e HREXP

Cada tabela utilizada na Carga de Ambiente deve conter os campos MSEXP e HREXP criados (tanto no ambiente gerador de cargas
quanto nos ambientes que iro importar as cargas).
Caso seja necessrio utilizar alguma tabela diferente das utilizadas no padro, necessrio criar os campos atravs do seguinte
procedimento:
1. Para criar o campo MSEXP, utilize o assistente de criao de campos reservados no configurador, e selecione a opo Ident.
Exp. Dados.
2. No Configurador (SIGACFG), acesse Base de Dados/Dicionrio/Base de Dados e edite a tabela a ser exportada.
3. Selecione o item Campos (para visualizar os campos) e a opo Campos reservados.
4. O campo HREXP deve ser criado manualmente
5. Para cria-lo manualmente utilize as informaes descritas sobre esse campo no item Atualizao do Compatibilizador deste
boletim.
Boletim Tcnico
O campo MSEXP padro do configurador e por isso pode ser utilizado em outras rotinas. Portanto importante avaliar a
utilizao do MSEXP antes de implantar a Carga de Ambiente, pois para utilizao da carga necessrio que nenhuma outra rotina
manipule o valor do campo MSEXP das tabelas exportadas na carga.
Exemplo de cenrio de utilizao:

Considerando o seguinte cenrio: um servidor Microsiga Protheus que represente a Matriz da empresa envia a carga aos
PDVs.
Matriz
Ambiente 001
PDV A
Ambiente 003
Filial 02
Filial 01
PDV B
Ambiente 004
Filial 02
Essa transferncia e comunicao pode ser iniciada e acompanhada diretamente no Monitor de Carga da Matriz ou, se for
necessrio, pode ser iniciada e acompanhada diretamente pelo PDV por meio do assistente de carregamento de carga.
Quando a carga for do tipo inteira, para que ocorra a carga de dados, o sistema tenta abrir a tabela que ser substituda de
modo exclusivo. Para evitar que Jobs ou at mesmo um cliente Microsiga Protheus esteja conectado, h um sistema de travas
interno que possibilita a pausa dos Jobs e o encerramento de um cliente Microsiga Protheus, caso o servidor necessite importar
os dados da carga. Quando a carga for incremental a abertur no ser em modo exclusivo.
O sistema de travas interno para Jobs padro ativado pelo parmetro MV_LJILJLO.
O sistema de travas interno para a pausa da execuo de uma Venda Assistida ativado pelo parmetro MV_LJILVLO.
importante ressaltar que esse parmetro s deve ser ativado nos ambientes do tipo Stand-Alone, ou seja, ambientes em que o
Boletim Tcnico
servidor e o cliente Microsiga Protheus so executados na mesma mquina e no h nenhuma conexo externa exceto a conexo
da prpria mquina.
H ainda a possibilidade criar um intermediador entre o ponto de origem (Matriz) e o ponto de destino da carga (PDVs).
Muitas vezes a Matriz ligada Loja por uma rede privada que passa pela internet. Para evitar que todos os PDVs baixem a carga
da Matriz, esta primeiramente solicita que um PDV especfico centralizador baixe a carga e, em seguida, de modo automtico, este
PDV centralizador solicita que os outros PDVs baixem a carga dele. Para isso basta configurar os PDVs com dependentes do PDV
centralizador no Cad. Ambiente (LOJA1107) do PDV centralizador.
A Carga de Ambiente depende diretamente tambm da aplicao do pacote de atualizaes (Patch), da execuo do
compatibilizador e da leitura do boletim PAF-ECF Programa Aplicativo Fiscal Emissor de Cupom Fiscal, referente ao chamado
SCJXDW.
importante obter as ltimas verses dos cdigos-fonte da Lib do Framework.
Todos os ambientes envolvidos devem ter o dicionrio de dados compatveis, incluindo o modo de compartilhamento das tabelas.
A carga de dados para a tabela genrica SX5 feita parcialmente, enviando somente a tabela 23.
Assistente de configurao do servidor de arquivos do mdulo Controle de Lojas
O servidor de arquivos do Controle de Lojas (SIGALOJA) composto por:
Servidor HTTP: Responsvel por hospedar e efetuar a comunicao entre servidores Microsiga Protheus;
Web Function: Responsvel por atender a solicitao e o envio do arquivo;
Classes: Responsveis pelas solicitaes e gerenciamento do arquivo baixado.
O funcionamento do servidor de arquivos do Controle de Lojas necessita que o Microsiga Protheus tenha a configurao do
HTTP e a configurao do servidor de arquivos do Controle de Lojas informados no INI.
Para auxiliar nessa configurao, a rotina intitulada Assistente de configurao do servidor de arquivos (LOJA0047) pode ser
utilizada. possvel informar o ambiente e a porta para a configurao do servidor HTTP, o endereo IP da mquina e caminho do
repositrio dos arquivos que sero servidos, para o servidor de arquivos do LOJA. Tambm permite efetuar o teste de conexo.
Todos os ambientes que forem servidores de arquivos (retaguarda e PDVs replicadores) devem ter configurado o sevidor HTTP
atravs do Assistente de configurao do servidor de arquivos (LOJA0047).
Todos os ambientes devem ter cadastradas as configuraes de ambiente e comunicao de si mesmo e ajustado o valor do
parmetro MV_LJAMBIE. Os ambientes que possurem dependentes devem ter tambm a configurao para comunicao com cada
dependente. Para procedimentos de configurao vide item Resumo dos processos de configurao.
Assistente de gerao de cargas
O assistente de gerao de carga utilizado para auxiliar a disponibilizao das tabelas e filiais para que outros servidores
Microsiga Protheus possam baix-las e import-las para suas bases locais.
No assistente possvel cadastrar a configurao de grupos de tabelas e filiais para gerar cargas. Alm disso, possvel iniciar
e acompanhar o processo de gerao de cargas.
Nesse cadastro definido o modo da gerao da carga (inteira ou incremental).
Para cada tabela exportada h 3 opes de tipos de transferncia:
Completa exportao padro da tabela.
Parcial permite filtrar registros especficos da tabela.
Boletim Tcnico
Especial Utilizada para exportao da SBI (juno das tabelas SB0 e SB1).
Informaes complementares:
As cargas geradas so disponibilizadas no caminho do repositrio do servidor de arquivos do Controle de Lojas, sendo
separadas por pastas de acordo com o cdigo da carga gerada;
Os arquivos so separados por tabela+filial, quando a tabela trabalha em modo exclusivo, ou somente por tabela, quando a
tabela trabalha em modo compartilhado;
Os arquivos gerados so compactados para diminuir seu tamanho;
A tabela SBI gerada dinamicamente utilizando os dados da Tabela de Produtos (SB1) e da Tabela de Preos (SB0).
Para gerao de cargas, avaliado o parmetro MV_LJILQTD que determina a quantidade mxima de cargas permitida. Caso o
limite seja atingido, ser necessrio apagar alguma carga para gerar a prxima. Este bloqueio existe, pois a lista de cargas ativas
trafegada entre os ambientes, e no pode ultrapassar o limite de 1 MB. Dessa forma, recomenda-se que utilize o limite mximo de 200
cargas disponveis.
Para efetuar a gerao de carga sem a interao do usurio, est disponvel a funo LOJA1156Job em
http://tdn.totvs.com/display/mp/LOJA1156Job. aconselhavl que o job de gerao de carga esteja programado para gerar no
mximo 2 cargas por dia, a fim de evitar o estouro do limite de cargas rapidamente.
A gerao pode ser acompanhada pelo console ou log do servidor. Para filtrar os dados durante a gerao da tabela, utilize o
ponto de entrada LJ1146Ex, disponvel em http://tdn.totvs.com/display/mp/LJ1146Ex+-+Filtro+de+dados+exportados
Para a gerao de carga incremental, necessrio que a tabela tenha pelo menos um ndice e que possua os campos
de controle MSEXP e HREXP.
Assistente de carregamento de cargas

O assistente de carregamento de carga utilizado para auxiliar a baixa e importao das tabelas e filiais vindas de outro
servidor Microsiga Protheus.
No assistente, necessrio informar o IP, a porta, o ambiente, a empresa e a filial do servidor que est disponibilizando a
carga por meio do servidor de arquivos do LOJA. possvel efetuar o teste de conexo, selecionar as cargas a serem carregadas e
acompanhar o progresso da baixa e da importao.
Para selecionar as cargas a serem carregadas existem 2 opes:
Atualizar Tudo - Seleciona automaticamente todas as cargas incrementais que ainda no foram aplicadas no ambiente.
Selecionar Cargas Exibe tela para selecionar manualmente as cargas a serem aplicadas (com opo de aplicar tambm as
cargas inteiras). Nessa tela tambm possvel visualizar informaes sobre cada carga (tabelas geradas, quantidade de registros, filiais) e
qual o status da carga no ambiente (pendente, baixada ou importada).
Atualizar Senhas atualiza o arquivo de senhas (sigapss) com os dados de senhas do servidor pai.
Para atualizao do arquivo de senhas so utilizados alguns arquivos temporrios na pasta system do ambiente que recebe a
atualizao. Quando se copia manualmente o sigapss.spf de uma ambiente para outro, esses arquivos temporrios ficam desatualizados.
Por isso, caso haja alguma no conformidade na atualizao de senhas, sugere-se tentar apagar os arquivos temporrios pswid.sinc,
pswtemp.sinc e pswready.sinc da pasta system e tentar realizar o carregamento das senhas novamente.
Boletim Tcnico
Apesar das cargas inteiras possurem a mesma classificao de status que as cargas incrementais (pendente, baixada e importada),
para avaliar se um ambiente est atualizado so consideradas apenas as cargas incrementais.
Para automatizar o processo de carga dos dados, o prprio assistente tambm pode solicitar que os dependentes do ambiente
atual iniciem a carga de dados de modo automtico.
Informaes complementares:
A carga baixada no caminho configurado no parmetro MV_LJILTPA, dentro de uma pasta com seu cdigo de identificao;
Para efetuar a carga dos dados sem a interao do usurio, est disponvel a funo LOJA1157Job disponvel em
http://tdn.totvs.com/display/mp/LOJA1157Job
Quando for utilizado essa funo, sero atualizadas todas as cargas incrementais pendentes para o ambiente. Alm disso
pode ser passado por parmetro um array com cdigos de cargas inteiras para serem aplicadas.
A gerao pode ser acompanhada pelo console ou log do servidor. Para filtrar os dados durante a importao da tabela,
utilize o ponto de entrada LJ1144Im, disponvel em http://tdn.totvs.com/display/mp/LJ1144Im+-+Filtro+de+dados+importados
Assistente de carregamento de cargas Express
O assistente de carregamento Express utilizado para iniciar automaticamente o modo de carregamento na primeira
inicializao do sistema e obrigar a aplicao das cargas pendentes para entrar no sistema.
Para ativa-lo, deve-se configurar o parmetro MV_LJILOLE com o valor 1.
possvel iniciar o carregamento automaticamente (atravs do parmetro MV_LJILAUT = .T.)
O carregamento atravs desse assistente valida a integridade na ordem das cargas, e aborta o carregamento caso alguma
carga esteja faltando. Nesse caso ser necessrio atualizar o sistema manualmente (preferencialmente atravs de uma carga
inteira seguida das incrementais pendentes).
Para que seja possvel carregar manualmente as cargas em caso de inconsistncia, caso o sistema seja iniciado pelo ADMIN, o
modo de carregamento Express no ser exibido.
Para conexo e configurao de opes de Baixa/Importao so utilizados os parmetros descritos no item anterior
(Assistente de carregamento de cargas).
O carregamento Express importa no ambiente apenas as cargas incrementais (as cargas inteiras so ignoradas).
Assistente de excluso de cargas
O assistente de excluso de cargas s poder ser executado em um ambiente que gerou as cargas.
Para as cargas incrementais h duas opes de excluso:
Excluso simples Apaga o registro da carga e os arquivos fsicos da carga. Quando os ambientes filhos solicitarem uma nova
lista de cargas disponveis ser verificado que a carga apagada no existe mais e ento sero apagados os arquivos fsicos da carga em
cada ambiente. Esta opo deve ser executada para apagar uma carga que j foi aplicada em algum ambiente (quando a excluso for
apenas para limpar a lista de cargas ativas e eliminar cargas velhas). Nessa opo a sequncia de cargas (definida pelo campo ordem
Boletim Tcnico
(MBU_ORDEM)) se mantm a mesma. Por exemplo, a ltima carga foi apagada e sua ordem era 10, a prxima carga a ser gerada ser a
de ordem 11 (mesmo no existindo mais a 10).
Excluso com retorno do MSEXP (funcionalidade apenas para cargas incrementais) Esta opo faz uma anlise dos registros
existentes na carga e restaura o valor do campo de controle de carga incremental (MSEXP) para que numa prxima exportao os
campos desta cargas sejam gerados novamente. Para isso ser necessrio apagar todas as cargas incrementais posteriores a carga
selecionada, e a restaurao do campo MSEXP de forma decrescente (da carga mais recente para a mais antiga). Esta opo no deve
ser usada caso a carga j tenha sido aplicada em algum ambiente. Nessa opo a sequncia de cargas (definida pelo campo ordem)
alterada para considerar como ltima ordem o valor da ordem da ltima carga existente. Por exemplo, a carga apagada era de ordem 10,
todas as cargas de ordem posterior sero apagadas e a prxima carga a ser gerada ser novamente de ordem 10. Esta opo deve ser
usada caso alguma carga tenha sido gerada por engano ou com algum problema e deseja-se anular essa carga.
Monitor de cargas
O monitor de carga utilizado para monitorar, acompanhar e iniciar a carga nos ambientes dependentes do ambiente
monitorado.
No monitor, possvel visualizar e/ou executar:
A lista dos ambientes dependentes;
O status de cada ambiente (atualizado ou desatualizado)
O status detalhado de cada ambiente (visualizando o status de cada carga para o ambiente selecionado)
O progresso da baixa da carga (caso esteja acontecendo);
O estado do servidor de arquivos do LOJA;
A solicitao da baixa de carga para um ambiente ou um grupo de ambientes ( possvel optar por atualizar completamente os
ambientes ou selecionar manualmente quais cargas sero aplicadas);
Os eventos que ocorreram durante a carga;
O acesso ao monitor de ambientes dependentes.
Acessar a rotina de excluso de cargas.
Atualizar o arquivo de senhas (sigapss) dos ambientes dependentes.
Quando apenas um ambiente estiver selecionado, e for selecionada a opo Iniciar Carga, Selecionar Carga, exibido o status de
cada carga no ambiente selecionado. Caso mais de um ambiente seja selecionado, o status individual das cargas no exibido na tela de
seleo manual das cargas.
Para definir o status geral do ambiente (atualizado ou desatualizado), so avaliadas apenas as cargas incrementais (as cargas
inteiras no so consideradas).
O monitor de carga utiliza o conceito de troca de mensagens, ou seja, quando solicitado que um determinado ambiente ou um
grupo de ambientes iniciem a carga, o monitor solicita via RPC que o ambiente dependente inicie a carga. O ambiente dependente inicia
uma nova thread para executar a carga e o controle de execuo voltar ao usurio que fez a solicitao. Para acompanhar o progresso,
necessrio atualizar a tela para que novamente, por troca de mensagens, o monitor receba as informaes atualizadas de como est o
progresso da carga no ambiente.
Quando a carga em um ambiente dependente finalizada, o sistema automaticamente solicita a todos os dependentes
daquele ambiente o incio da carga.
Boletim Tcnico
Gerenciador de mensagens
No desenvolvimento das rotinas de carga, foi utilizado o conceito de troca de mensagens entre funes e classes. Isso
significa que dificilmente ocorrer erros do tipo no conformidade. Se alguma no conformidade ocorrer, tanto por problemas de
Banco de Dados, quanto por problemas de configurao, a informao desse erro ser visualizada como um evento.
Esse evento apresentado em forma de janela, em que a descrio amigvel da informao apresentada, sendo possvel
ver os detalhes da informao, por meio da opo Detalhes.
PROCEDIMENTOS PARA IMPLEMENTAO
imprescindvel que o fonte FWSERIALIZE da lib seja igual ou superior a data 28/09/2012.
Para viabilizar essa melhoria, necessrio aplicar o pacote de atualizaes (Patch) deste chamado.
Antes de aplicar o update verifique se no atalho do smartclient no h parmetros.

No atalho do smartclient possvel passar alguns parmetros como o M, -A, -P, etc.
Conforme o TDN (http://tdn.totvs.com/pages/viewpage.action?pageId=6066051), parmetro A utilizado para passagem de
parmetros ao programa inicial.
Por exemplo, se tivermos no atalho A=001, -A=002 e executarmos como programa inicial a funo U_PROGTESTE,
a chamada feita pelo smartcliente ser a seguinte: U_PROGTESTE(001,002)
Por padro, o update deste chamado tem 2 formas de fazer a seleo da empresa que ser aplicado:
1) Selecionando a empresa pela telinha do update
2) Passando a empresa e filial como parmetro da User Function do update
Com isso, caso no atalho do smartclient exista o parmetro A , o que estiver nesse parmetro ser passado como parmetro da
User Function do Update, e a mesma entender que esses parmetros so a empresa e filial na qual o update deve ser aplicado.
Para evitar erros ao aplicar o update, utilize sempre um atalho novo sem o parmetro -A.
Antes de executar o update/compatibilizador U_UPDLO105 imprescindvel:

a)
Realizar o backup da base de dados do produto que ser executado o U_UPDLO105 (diretrio \PROTHEUS_DATA\DATA) e
dos dicionrios de dados SXs (diretrio \PROTHEUS_DATA\SYSTEM). Os diretrios acima mencionados correspondem instalao
padro do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
b)
Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usurio deve estar utilizando o sistema.
c)
Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar o compatibilizador,
certifique-se de que esto identificados pelo nickname. Caso o compatibilizador necessite criar ndices, ir adicion-los a partir da ordem
original instalada pelo Protheus, o que poder sobrescrever ndices personalizados, caso no estejam identificados pelo nickname.
d)
O compatibilizador deve ser executado com a Integridade Referencial desativada*.
Boletim Tcnico
O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de
Dados (DBA) ou equivalente!
A ativao indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no
banco de dados. Portanto, antes de utiliz-la, observe atentamente os procedimentos a seguir:
i.
No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opo
Integridade/Verificao (APCFG60A).
ii.
Se no h Integridade Referencial ativa, so relacionadas em uma nova janela todas as empresas e filiais
cadastradas para o sistema e nenhuma delas estar selecionada. Neste caso, E SOMENTE NESTE, no necessrio qualquer
outro procedimento de ativao ou desativao de integridade, basta finalizar a verificao e aplicar normalmente o
compatibilizador, conforme instrues.
iii.
Se h Integridade Referencial ativa em todas as empresas e filiais, exibida uma mensagem na janela
Verificao de relacionamento entre tabelas. Confirme a mensagem para que a verificao seja concluda, ou;
iv.
Se h Integridade Referencial ativa em uma ou mais empresas, que no na sua totalidade, so relacionadas
em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade
estar(ro) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotao
para posterior consulta na reativao (ou ainda, contate nosso Help Desk Framework para informaes quanto a um
arquivo que contm essa informao).
v.
Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, necessrio desativar tal integridade,
selecionando a opo Integridade/Desativar (APCFG60D).
vi.
Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instrues.
vii.
Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido
desativada, atravs da opo Integridade/Ativar (APCFG60). Para isso, tenha em mos as informaes da(s) empresa(s)
e/ou filial(is) que possua(m) ativao da integridade, selecione-a(s) novamente e confirme a ativao.
Contate o Help Desk Framework EM CASO DE DVIDAS!
1. Em Microsiga Protheus TOTVS Smart Client, digite U_UPDLO105 no campo Programa Inicial.
Para a correta atualizao do dicionrio de dados, certifique-se que a data do U_UPDLO105 seja igual ou superior a 27/08/2012
2. Clique em Ok para continuar.
3. Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser modificado. Selecione
a empresa desejada.
4. Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo exclusivo.
5. Clique em Processar para iniciar o processamento. O primeiro passo da execuo a preparao dos arquivos, conforme
mensagem explicativa apresentada na tela.
Boletim Tcnico
6. Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes processadas. Nesse log
de atualizao so apresentados somente os campos atualizados pelo programa. O update/compatibilizador cria os campos que ainda
no existem no dicionrio de dados.
7. Clique em Gravar para salvar o histrico (log) apresentado.
8. Clique em Ok para encerrar o processamento.
ATUALIZAES DO UPDATE/COMPATIBILIZADOR
1. Criao Arquivos no arquivo SX2 Arquivos:
10
Prefixo
MBU
Descrio
GRUPOS DE TABELAS DA CARGA
Ac. Filial
Compartilhado
Prefixo
MBV
Descrio
TABELAS DA CARGA
Ac. Filial
Compartilhado
Prefixo
MBW
Descrio
REGISTROS DA CARGA DA TABELA
Ac. Filial
Compartilhado
Prefixo
MBX
Descrio
FILIAIS DA CARGA DA TABELA
Ac. Filial
Compartilhado
Prefixo
MBY
Descrio
STATUS DA CARGA
Ac. Filial
Compartilhado
Prefixo
MD3
Descrio
Configurao de Comunicao
Ac. Filial
Compartilhado
Prefixo
MD4
Descrio
Ambientes Replicao
Ac. Filial
Compartilhado
Boletim Tcnico
Prefixo
MDF
Descrio
Controle Ordem Carga
Ac. Filial
Compartilhado
2. Criao de Campos no arquivo SX3 Campos:

Campo
MBU_FILIAL
Tipo
Caractere
Tamanho
Decimal
Formato
@!
Ttulo
Filial
Descrio
Filial do Sistema
Nvel
Usado
No
Obrigatrio
No
Browse
No
Help
Filial do Sistema
Campo
MBU_CODIGO
Tipo
Caractere
Tamanho
Decimal
Ttulo
Cod. Grp Tab
Descrio
Cdigo do grp de tabela
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Cdigo do grupo de tabela
Campo
MBU_NOME
Tipo
Caractere
Tamanho
60
Decimal
Ttulo
Nome Grupo
11
Boletim Tcnico
12
Descrio
Cdigo do grp de tabela
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Nome do grupo
Campo
MBU_DESCRI
Tipo
Caractere
Tamanho
100
Decimal
Ttulo
Descrio
Descrio
Descrio do grupo
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Descrio do grupo
Campo
MBU_TIPO
Tipo
Caractere
Tamanho
Decimal
Formato
@!
Ttulo
Tipo
Descrio
Tipo do Grupo
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Tipo do grupo: 1 - Template / 2 - Carga
Campo
MBU_CODTPL
Tipo
Caractere
Tamanho
Boletim Tcnico
Decimal
Ttulo
Cod. Templ.
Descrio
Cod.Template
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Cdigo do template que originou a carga (apenas quando o grupo de

tabelas for do tipo 2 - Carga)
Campo
MBU_DATA
Tipo
Data
Tamanho
Decimal
Ttulo
Data
Descrio
Data
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Data da gerao da carga
Campo
MBU_HORA
Tipo
Caractere
Tamanho
Decimal
Ttulo
Hora
Descrio
Hora
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Hora da gerao da carga
Campo
MBU_ORDEM
13
Boletim Tcnico
Tipo
Caractere
Tamanho
10
Decimal
Ttulo
Ordem
Descrio
Ordem da carga
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Campo
MBU_INTINC
Tipo
Caractere
Tamanho
Decimal
Ttulo
Int / Inc
Descrio
Inteira / Incremental
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
14
Ordem da carga. Sequncia utilizada pelas cargas incrementais para

garantir a integridade nas atualizaes de cargas no ambiente.
Determina se a carga inteira ou incremental (1 = carga inteira, 2 =

carga incremental)
Campo
MBV_FILIAL
Tipo
Caractere
Tamanho
Decimal
Formato
@!
Ttulo
Filial
Descrio
Filial do Sistema
Nvel
Usado
No
Boletim Tcnico
Obrigatrio
No
Browse
No
Help
Filial do Sistema
Campo
MBV_CODGRP
Tipo
Caractere
Tamanho
Decimal
Ttulo
Cdigo Grupo
Descrio
Cdigo do Grupo
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
Help
Cdigo do Grupo
Campo
MBV_TABELA
Tipo
Caractere
Tamanho
Decimal
Ttulo
Tabela
Descrio
Tabela
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
Help
Tabela
Campo
MBV_TIPO
Tipo
Caractere
Tamanho
Decimal
Ttulo
Tipo Transf.
Descrio
Tipo da Transferncia
15
Boletim Tcnico
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
Opes
Val. Sistema
Help
Vazio() .Or. Pertence("123")

Tipo da Transferncia (1=Transferncia completa; 2=Transferncia
parcial; 3=Transferncia especial)
Campo
MBV_FILTRO
Tipo
Caractere
Tamanho
200
Decimal
Ttulo
Filtro
Descrio
Filtro Tabela
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Filtro Tabela
Campo
MBV_QTDREG
Tipo
Numrico
Tamanho
10
Decimal
Formato
@E 9,999,999,999
Ttulo
Qtde Reg
Descrio
Qtde registros
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
16
1=Transferencia completa;2=Transferencia parcial;3=Transferencia

especial
Quantidade de registros exportados quando a tabela for do tipo

parcial
Boletim Tcnico
Campo
MBW_FILIAL
Tipo
Caractere
Tamanho
Decimal
Formato
@!
Ttulo
Filial
Descrio
Filial do Sistema
Nvel
Usado
No
Obrigatrio
No
Browse
No
Help
Filial do Sistema
Campo
MBW_CODGRP
Tipo
Caractere
Tamanho
Decimal
Ttulo
Cod. Grupo
Descrio
Cdigo Grupo de Tabelas
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
Help
Cdigo Grupo de Tabelas
Campo
MBW_TABELA
Tipo
Caractere
Tamanho
Decimal
Ttulo
Cod. Tabela
Descrio
Cdigo Tabela
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
17
Boletim Tcnico
18
Help
Cdigo Tabela
Campo
MBW_INDICE
Tipo
Numrico
Tamanho
Decimal
Ttulo
ndice Tab.
Formato
Descrio
ndice Tabela
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
Help
ndice Tabela
Campo
MBW_SEEK
Tipo
Caractere
Tamanho
200
Decimal
Ttulo
Seek Tab.
Descrio
Seek Tabela
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
Help
Seek Tabela
Campo
MBX_FILIAL
Tipo
Caractere
Tamanho
Decimal
Formato
@!
Ttulo
Filial
Descrio
Filial do Sistema
Nvel
Boletim Tcnico
Usado
No
Obrigatrio
No
Browse
No
Help
Filial do Sistema
Campo
MBX_CODGRP
Tipo
Caractere
Tamanho
Decimal
Ttulo
Cdigo Grupo
Descrio
Cdigo do Grupo Tabelas
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
Help
Cdigo do Grupo Tabelas
Campo
MBX_TABELA
Tipo
Caractere
Tamanho
Decimal
Ttulo
Cod. Tabela
Descrio
Cdigo da Tabela
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
Help
Cdigo da Tabela
Campo
MBX_FIL
Tipo
Caractere
Tamanho
Decimal
Ttulo
Filial Carga
Descrio
Filial Carga
19
Boletim Tcnico
20
Nvel
Usado
Sim
Obrigatrio
Sim
Browse
No
Help
Filial Carga
Campo
MBX_QTDREG
Tipo
Numrico
Tamanho
10
Decimal
Formato
@E 9,999,999,999
Ttulo
Qtd Reg
Descrio
Qtde Registros
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Qtde de registros exportados
Campo
MBY_FILIAL
Tipo
Caractere
Tamanho
Decimal
Formato
@!
Ttulo
Filial
Descrio
Filial do Sistema
Nvel
Usado
No
Obrigatrio
No
Browse
No
Help
Filial do Sistema
Campo
MBY_CODGRP
Tipo
Caractere
Tamanho
Boletim Tcnico
Decimal
Ttulo
Cod. Carga
Descrio
Cdigo da Carga
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Cdigo da carga
Campo
MBY_STATUS
Tipo
Caractere
Tamanho
Decimal
Ttulo
Status
Descrio
Status
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Status da carga no ambiente. 1 = baixada / 2 = importada / Em branco

= pendente
Campo
MBY_ORDEM
Tipo
Caractere
Tamanho
10
Decimal
Ttulo
Ordem da Car
Descrio
Ordem da Carga
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Ordem da Carga. Sequncia utilizada nas cargas incrementais para

manter a
integridade das atualizaes incrementais.
21
Boletim Tcnico
Campo
MBY_INTINC
Tipo
Caractere
Tamanho
Decimal
Ttulo
Int/ inc
Descrio
tipo da carga
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
22
Determina se a carga inteira ou incremental (1 = carga inteira, 2 =

carga incremental)
Campo
MD3_FILIAL
Tipo
Caractere
Tamanho
Decimal
Ttulo
Filial
Descrio
Filial
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Filial do sistema
Campo
MD3_CODAMB
Tipo
Caractere
Tamanho
Decimal
Ttulo
Cod.Ambiente
Descrio
Codigo Ambiente
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Boletim Tcnico
When
INCLUI
Help
Nome do ambiente destino na comunicao.
Campo
MD3_IP
Tipo
Caractere
Tamanho
15
Decimal
Ttulo
Endereco IP
Descrio
Endereco IP
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
IP do ambiente destino na comunicao.
Campo
MD3_PORTA
Tipo
Caractere
Tamanho
Decimal
Ttulo
Porta Comun.
Descrio
Communic.Port
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Porta do ambiente destino na comunicao.
Campo
MD3_DESCRI
Tipo
Caractere
Tamanho
15
Decimal
Ttulo
Descrio
Descrio
Descrio
23
Boletim Tcnico
24
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Descrio do ambiente.
Campo
MD3_TIPO
Tipo
Caractere
Tamanho
Decimal
Ttulo
Tipo Comunic
Descrio
Tipo Comunicao
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Opes
I=Integrao;E=Conexo Especfica;R=RPC
When
INCLUI
Help
Tipo de comunicao.
Campo
MD3_NOMAMB
Tipo
Caractere
Tamanho
60
Decimal
Ttulo
Nome amb.
Descrio
Nome do ambiente
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Nome do ambiente destino na comunicao.
Campo
MD3_EMP
Boletim Tcnico
Tipo
Caractere
Tamanho
Decimal
Ttulo
Empresa
Descrio
Empresa
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Cdigo da empresa do ambiente destino na comunicao.
Campo
MD3_FIL
Tipo
Caractere
Tamanho
Decimal
Ttulo
Filial
Descrio
Filial
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Cdigo da filial do ambiente destino na comunicao.
Campo
MD4_FILIAL
Tipo
Caractere
Tamanho
Decimal
Ttulo
Filial
Descrio
Filial
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
25
Boletim Tcnico
26
Help
Filial do sistema
Campo
MD4_CODIGO
Tipo
Caractere
Tamanho
Decimal
Ttulo
Cod.Ambiente
Descrio
Cdigo Ambiente
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
When
INCLUI
Help
Cdigo do ambiente
Campo
MD4_DESCRI
Tipo
Caractere
Tamanho
15
Decimal
Ttulo
Descricao
Descrio
Descricao
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Help
Descrio do ambiente
Campo
MD4_AMBPAI
Tipo
Caractere
Tamanho
Decimal
Ttulo
Amb. Pai
Descrio
Ambiente pai
Boletim Tcnico
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Val. Sistema
Vazio() .Or. ExistCPO( "MD4", M->MD4_AMBPAI )
Help
Ambiente que este ambiente depende
Campo
MDF_FILIAL
Tipo
Caractere
Tamanho
Decimal
Formato
@!
Ttulo
Filial
Descrio
Filial do Sistema
Nvel
Usado
No
Obrigatrio
No
Browse
No
Help
Filial do sistema
Campo
MDF_ORDEM
Tipo
Caractere
Tamanho
10
Decimal
Ttulo
Ordem da Car
Descrio
Ordem da Carga
Nvel
Usado
No
Obrigatrio
No
Browse
No
Help
Ordem de gerao da carga
Campo
XX_MSEXP
27
Boletim Tcnico
Tipo
Caractere
Tamanho
Decimal
Ttulo
Ident.Exp.
Descrio
Ident.Exp.Dados
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Campo
XX_HREXP
Tipo
Caractere
Tamanho
Decimal
Ttulo
Hora Exp
Descrio
Hora da Exportacao
Nvel
Usado
Sim
Obrigatrio
No
Browse
No
Esses campos so criados nas seguintes tabelas:

SB1 - Descrio Genrica do Produto;
SB0 - Dados Adicionais - Loja ;
SLH - Log de Modificaes;
SBZ - Indicadores de Produtos;
SM2 - Moedas do Sistema ;
SA1 Clientes;
SA3 Vendedores;
SA6 Bancos;
SAE - Administrao Financeira;
SAF - Fatores para Financiamento;
SBI - Produtos x Preos;
SB2 - Saldos Fsico e Financeiro;
SE4 - Condies de Pagamento;
SED Naturezas;
SF4 - Tipos de Entrada e Sada;
SF7 - Grupo de Tributao;
28
Boletim Tcnico
SFB - Impostos Variveis;

SFC - Amarrao Tes x Impostos;
SFE - Retenes de Impostos;
SFF Plano IVA;
SFP - Controle de Formulrios;
SFH Ingressos Brutos;
SFZ Sujeito Fiscal x Imposto;
SLF Perfil/Acessos do Caixa;
SLG Estaes;
SLK Cdigos de Barra por Produto;
SFM Tes Inteligente;
ACO Regras de Desconto;
ACP Itens da Regra de Desconto;
DA0 Tabela de Preos;
DA1 Itens da Tabela de Preos;
ACQ Regras de Bonificao;
ACR Itens da Regra de Bonificao;
SL6 Reserva de Serie por Estao;
SL8 Itens dos Menus dos Produtos;
SLD Botes de Pagamento;
SL7 Cabealho de Menus dos Produtos;
SUG Acessrios;
SUH Mdias;
SU1 Itens do Acessrio;
MDE Admin. Cartes SITEF;
MBS Cabealho de Regra Negociao;
MBT Itens de Cab de Reg de Negocia;
MEN Itens Adm Financeira;
MEK Produtos Multi Negociao;
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
3. Criao de ndices no arquivo SIX ndices:
ndice
MBU
Ordem
Chave
MBU_FILIAL+MBU_CODIGO
Descrio
Cod. Grp Tab
29
Boletim Tcnico
30
ndice
MBU
Ordem
Chave
MBU_FILIAL+MBU_TIPO
Descrio
Tipo (Template ou Carga)
ndice
MBV
Ordem
Chave
MBV_FILIAL+MBV_CODGRP+MBV_TABELA
Descrio
Codigo Grupo+Tabela
ndice
MBW
Ordem
Chave
MBW_FILIAL+MBW_CODGRP+MBW_TABELA
Descrio
Cod. Grupo+Cod. Tabela
ndice
MBX
Ordem
Chave
MBX_FILIAL+MBX_CODGRP+MBX_TABELA+MBX_FIL
Descrio
Codigo Grupo+Cod. Tabela + Filial
ndice
MBY
Ordem
Chave
MBY_FILIAL+MBY_CODGRP
Descrio
Filial + GrupoCarga
ndice
MBY
Ordem
Chave
MBY_FILIAL+MBY_INTINC+MBY_ORDEM+MBY_CODGRP
Descrio
Filial +int/inc + ordem + carga
ndice
MD3
Ordem
Chave
MD3_FILIAL+MD3_CODAMB+MD3_TIPO
Descrio
Cod.Ambiente + Tipo Comunic
ndice
MD4
Boletim Tcnico
Ordem
Chave
MD4_FILIAL+MD4_CODIGO
Descrio
Cod.Ambiente
ndice
MDF
Ordem
Chave
MDF_FILIAL+MDF_ORDEM
Descrio
Filial + Ordem
4. Criao de Parmetros no arquivo SX6 Parmetros:

Nome da Varivel
MV_LJAMBIE
Tipo
Caractere
Descrio
Determina o cdigo de cada ambiente, no pode se repetir para a

mesma empresa e mesma filial.
001 a 999
Nome da Varivel
MV_LJILAUT
Tipo
Lgico
Descrio
Determina se o carregamento de cargas express ira iniciar

automaticamente
Valor Padro
.F.
Nome da Varivel
MV_LJILJLO
Tipo
Caractere
Descrio
Se utilizar sistema de travas nos Jobs FRTA020, LOJA1115 e

LJGrvBatch. (0=No, 1=Sim)
Nome da Varivel
MV_LJILLAC
Tipo
Caractere
Descrio
Se replicar as aes nos dependentes. (0=No, 1=Sim
Nome da Varivel
MV_LJILLBR
Tipo
Caractere
Descrio
Filial utilizada no assistente de importao e carga de dados
31
Boletim Tcnico
Nome da Varivel
MV_LJILLCO
Tipo
Caractere
Descrio
Empresa utilizada no assistente de importao e carga de dados.
Nome da Varivel
MV_LJILLDO
Tipo
Caractere
Descrio
Se far a baixa dos dados. (0=No, 1=Sim)
Nome da Varivel
MV_LJILLEN
Tipo
Caractere
Descrio
Nome da Varivel
MV_LJILLIM
Tipo
Caractere
Descrio
Se fara a importacao dos dados. (0=Nao, 1=Sim)
Nome da Varivel
MV_LJILLIP
Tipo
Caractere
Descrio
IP utilizado no assistente de importacao e carga de dados.
Nome da Varivel
MV_LJILLKT
Tipo
Caractere
Descrio
Se derrubar os outros processos . (0=No, 1=Sim)
Nome da Varivel
MV_LJILLPO
Tipo
Caractere
Descrio
Porta utilizada no assistente de importao e carga de dados.
Nome da Varivel
MV_LJILOLE
Tipo
Caractere
Descrio
32
Nome do ambiente utilizado no assistente de importao e carga

de dados.
Se abre ou no o assistnte de carregamento de carga na

inicializao dos mdulos Front-Loja e Venda Ass. quando houver uma
carga mais atual. (0=No, 1=Sim)
Nome da Varivel
MV_LJILQTD
Tipo
Numrico
Boletim Tcnico
Descrio
Qtde limite de cargas incrementais ativas. Para evitar estouro de 1

MB no xml com a lista de cargas
Valor Padro
200
Nome da Varivel
MV_LJILTPA
Tipo
Caractere
Descrio
Caminho temporario onde sera armazenado os arquivos da carga.
Valor Padro
\Temp\
Nome da Varivel
MV_LJILVLO
Tipo
Caractere
Descrio
Se utilizar sistema de travas na venda. (S utilizar em sistema de

venda Stand-Alone) (0=No, 1=Sim)
PROCEDIMENTOS PARA CONFIGURAO

Menus
1. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opo de menu do SIGALOJA,
conforme instrues a seguir:
Menu
Atualizaes->Off-Line
Submenu
Carga
Nome da Rotina
Ass. Serv. Arq.
Programa
LOJA0047
Mdulo
SIGALOJA
Tipo
Funo Protheus
Tabelas
Nenhuma
Menu
Submenu
Carga
Nome da Rotina
Ass. Ger. Carga
Programa
LOJA1156
Mdulo
SIGALOJA
Tipo
Funo Protheus
Tabelas
SX5
33
Boletim Tcnico
Menu
Submenu
Carga
Nome da Rotina
Ass. Car. Carga
Programa
LOJA1157
Mdulo
SIGALOJA
Tipo
Funo Protheus
Tabelas
Nenhuma
Menu
Submenu
Carga
Nome da Rotina
Ass. Exc. Carga
Programa
LOJA1176
Mdulo
SIGALOJA
Tipo
Funo Protheus
Tabelas
Nenhuma
Menu
Submenu
Carga
Nome da Rotina
Monitor
Programa
LOJA1158
Mdulo
SIGALOJA
Tipo
Funo Protheus
MD3 Configurao de comunicao
Tabelas
MD4 Ambientes replicao

SX5 Tabelas genricas
PROCEDIMENTOS PARA UTILIZAO

Pr requisito:
Resumo dos Processos de Configurao dos Ambientes
Possua campos MSEXP e HREXP (criados pelo update, ou manualmente) nas tabelas utilizadas na gerao e carregamento
das cargas;
Apenas para ambientes replicadores de carga (retaguarda e PDVs com dependentes), acesse Atualizaes/OffLine/Carga/Ass. Ser. Arq. (LOJA0047), e configure o servidor de arquivos com os dados do prprio ambiente;
Acesse Atualizaes/Off-line/Integraes/Cad. Ambiente (LOJA1107), e cadastre o prprio ambiente e seus ambientes
dependentes (filhos);
34
Boletim Tcnico
Acesse Atualizaes/Off-line/Integraes/Config. Comunicao (LOJA1106), e cadastre os dados para comunicao do tipo

RPC, informando o IP, a porta, o nome do ambiente, a empresa e a filial do ambiente. Realizar esse cadastro para todos os ambientes
cadastrados na rotina Cad. Ambiente;
Configure o parmetro MV_LJAMBIE com o cdigo do ambiente atual (cadastrado na rotina Cad. Ambiente);
Caso seja atualizado um ambiente que j possua as rotinas de carga, verifique na pasta system o arquivo
ljcinitialloadmakerresult.xml e exclua-o caso existir.
Apenas para o ambiente gerador de cargas:
Configure o parmetro MV_LJILQTD com a quantidade limite de cargas ativas (recomenda-se o valor de 200 cargas). Limite
necessrio para evitar que o tamanho da lista de cargas chegue a 1 MB.
Apenas para os ambientes que recebero as cargas:
Habilite o carregamento Express, configure os parmetros MV_LJILOLE e MV_LJILAUT.
Para demonstrar o uso da carga, o exemplo abaixo apresenta um cenrio especfico. Adapte esse cenrio de acordo com a
estrutura existente em sua empresa.
Nesse exemplo, necessria a criao de trs ambientes distintos (Dicionrios, Banco de Dados e System). Desses trs
ambientes, o primeiro representa a Matriz, o segundo, a Loja e o terceiro, um PDV.
Preparao dos ambientes
Processo cadastral executado na Matriz:
1. No Controle de Lojas (SIGALOJA), acesse Atualizaes\Cadastros\Produtos (MATA010), e cadastre alguns produtos;
2. Acesse Atualizaes\Cadastros\Clientes (MATA030), cadastre uma srie de clientes;
3. Acesse Atualizaes\Off-line\Integrao\Cad. Ambiente (LOJA1107) cadastre o Ambiente da Matriz (por exemplo, 001) e o
ambiente da Loja (por exemplo, 002), informando que o ambiente-pai o ambiente Matriz 001;
4. Acesse Atualizaes\Off-line\Integrao\Config. Comunicao (LOJA1106) cadastre uma nova comunicao para o
ambiente 001 do Tipo RPC, informando o IP, a porta, o nome do ambiente, a empresa e a filial do ambiente 001;
5. Cadastre uma nova comunicao para o ambiente 002 do Tipo RPC, informando o IP, a porta, o nome do ambiente, a
empresa e a filial do ambiente 002;
6. No Configurador (SIGACFG), opo Ambientes/Cadastros/Parmetros (CFGX017), e configure o parmetro MV_LJAMBIE
com o cdigo do ambiente atual, nesse caso, 001.
Passos cadastrais executados na Loja
1. No Controle de Lojas (SIGALOJA), acesse Atualizaes\Off-line\Integrao\Cad. Ambiente (LOJA1107), e cadastre o
Ambiente da Loja (por exemplo, 002) e o ambiente do PDV, por exemplo, 003, informando que o ambiente-pai o ambiente Loja 002;
2. Acesse Atualizaes\Off-line\Integrao\Config. Comunicao (LOJA1106) cadastre uma nova comunicao para o
3. Cadastre uma nova comunicao para o ambiente 003 do Tipo RPC, informando o IP, a porta, o nome do ambiente, a
empresa e a filial do ambiente 003;
35
Boletim Tcnico
4. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parmetros (CFGX017), e configure o parmetro MV_LJAMBIE

com o cdigo do ambiente atual, nesse caso, 002.
Passos cadastrais executados no PDV
1. No Controle de Lojas (SIGALOJA), acesse Atualizaes\Off-line\Integrao\Cad. Ambiente (LOJA1107), e cadastre o
Ambiente do PDV (por exemplo, 003);
2. Acesse Atualizaes\Off-line\Integrao\Config. Comunicao (LOJA1106), cadastre uma nova comunicao para o
3. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parmetros (CFGX017), e configure o parmetro MV_LJAMBIE
com o cdigo do ambiente atual, no caso, 003.
Configurao do servidor de arquivos do SIGALOJA
1. No Controle de Lojas (SIGALOJA), acesse Atualizaes\Off-line\Carga\ Ass. Serv. Arq. (LOJA0047);
2. Informe a porta e o nome do ambiente para a configurao do servidor HTTP. Informe tambm o IP e o caminho do
repositrio para o servidor de arquivos do SIGALOJA;
3. Reinicie o servidor do Microsiga Protheus, acesse novamente a rotina e confirme por meio da opo Testar, o
funcionamento do servidor de arquivos do SIGALOJA;
Disponibilizao da carga na Matriz
1.
No Controle de Lojas (SIGALOJA), acesse Atualizaes\Off-line\Carga\ Ass. Ger. Carga (LOJA1156);
2.
Inclua um grupo de cargas do tipo incremental, selecione as tabelas SA1 (Clientes) e SB1 (Produtos), selecione o tipo
de exportao completa. Selecione tambm as filiais que deseja enviar e inicie a gerao da carga.
Utilizao do monitor de carga
1. No Controle de Lojas (SIGALOJA), acesse Atualizaes\Off-line\Carga\Monitor (LOJA1158);
2. Verifique que so exibidos os ambientes dependentes do ambiente Matriz, que, nesse caso, somente o ambiente Loja;
3. Verifique tambm que, direita, so exibidos os status do servidor de arquivos, alm do progresso de baixa de arquivo e a
importao do ambiente posicionado na linha;
4. Para solicitar que o ambiente Loja inicie a baixa e importao da carga, clique em Iniciar Carga, selecione a opo
Selecionar Cargas para selecionar manualmente a carga a ser aplicada. Selecione a carga incremental criada e clique em executar;
5. Em seguida, o progresso da carga no ambiente pode ser acompanhado, clicando-se em Atualizar;
6. Se houver algum erro ou informao durante o processo de carga, verifique as informaes, clicando em Detalhes;
7. Para acessar o monitor de um determinado ambiente dependente, selecione a linha no ambiente e clique em Dependentes.
Utilizao do assistente de carregamento de carga
1. No Controle de Lojas (SIGALOJA), acesse Atualizaes\Off-line\Carga\ Ass. Car. Carga (LOJA1157);
2. No assistente, informe o IP, a porta, o nome do ambiente, a empresa e a filial do servidor de arquivos e teste a conexo;
O assistente grava as informaes nos seguintes parmetros:
36
MV_LJILLIP IP utilizado no Wizard de importao e carga de dados;
Boletim Tcnico
MV_LJILLPO Porta utilizada no Wizard de importao e carga de dados;
MV_LJILLEN Nome do ambiente utilizado no Wizard de importao e carga de dados;
MV_LJILLCO Empresa utilizada no Wizard de importao e carga de dados;
MV_LJILLBR Filial utilizada no Wizard de importao e carga de dados;
MV_LJILLIM Opo para importao da carga de dados;
MV_LJILLDO Opo para download da carga de dados;
MV_LJILLAC Opo para rplica das aes nos dependentes;
MV_LJILLKT Opo para eliminao dos outros processos que esto em execuo, caso no seja possvel abrir as tabelas
exclusivamente.
3. Clique em Atualizar Tudo para que o ambiente baixe e importe as cargas incrementais pendentes para o ambiente que est
em uso.
INFORMAES TCNICAS
MD3 Configurao de comunicao,
MD4 Ambientes replicao,
SX5 Tabelas genricas,
MBU Grupos de tabelas da carga,
Tabelas Utilizadas
MBV Tabela da carga,

MBW Registros da carga da tabela,
MBX Filiais da carga da tabela,
MBY Status da carga,
MDF Controle da ltima carga
37
Boletim Tcnico
Funes Envolvidas
Sistemas Operacionais
38
LOJA0041 Classe abstrata responsvel pela comunicao do

baixador de arquivos; LOJA0042 - Implementao do baixador de
arquivos por HTTP; LOJA0043 - Representativo do progresso da baixa do
arquivo; LOJA0044 - Classe que exibe informaes da baixa do arquivo
pelo console; LOJA0045 - Classe com os dados de configurao do
servidor de arquivos do loja; LOJA0046 - Assistente de configurao do
servidor de arquivos do loja; LOJA0047 - Cria e chama o assistente de
configurao do servidor de arquivos; LOJA0048 - Classe que representa
uma mensagem; LOJA0049 Gerenciamento das mensagens; LOJA0050 Classe visual para a exibio de painis separado por abas; LOJA1140 Classe responsvel por efetuar a requisio de execuo da carga nos
clientes filhos; LOJA1141 - Classe que representa um terminal,
denominado tambm como cliente; LOJA1142 - Classe que representa as
configurao da carga; LOJA1143 - Classe que representa o progresso do
carregar da carga; LOJA1144 - Classe responsvel por efetuar a baixa,
descompactao e importao das tabelas disponibilizadas pelo servidor
de carga; LOJA1145 - Classe assistente do processo de carregar a carga;
LOJA1146 - Classe responsvel por gerar e disponibilizar a carga;
LOJA1147 - Classe que representa o progresso da gerao de carga;
LOJA1148 - Classe que representa o resultado da gerao de carga;
LOJA1149 - Assistente de gerao de carga; LOJA1150 - Classe
responsvel por efetuar a comunicao entre terminais; LOJA1151 Monitor e gerenciador de carga; LOJA1152 - Classe que representa o
progresso de carregamento de carga; LOJA1153 - Classe que representa
uma requisio de carga; LOJA1154 - Classe que representa o progresso
da importao da carga; LOJA1155 - Monitor do loja off-line; LOJA1156 Abre o assistente de gerao de carga; LOJA1157 - Abre o assistente de
carregamento de carga; LOJA1158 - Inicia o monitor da venda assistida
off-line; LOJA1159 - Recebe as solicitaes de chamada RPC da carga;
LOJA1160 - Classe que representa as tabelas e suas configuraes
transferidas pela carga; LOJA1161 - Classe que representa uma tabela de
transferncia completa; LOJA1162 - Classe que representa uma tabela de
transferncia parcial; LOJA1163 - Classe que representa uma tabela de
transferncia especial; LOJA1164 - Classe com os arquivos de carga
gerados; LOJA1165 - Classe que fabrica os objetos de uma tabela especial;
LOJA1166 - Exportador da tabela especial SBI; LOJA1167 - Importador da
tabela especial SBI; LOJA1168 - Configurador da tabela especial SBI;
LOJA1169 - Classe com o arquivo a ser transferido na carga; LOJA1170 Classe com dados utilizados para criar a tabela temporria usada na
exportao dos dados da carga; LOJA1171 - Classe para o status da carga;
LOJA1172 - Classe com os grupos de cargas; LOJA1173 - Classe para
seleo das cargas que sero importadas na requisio; LOJA1174 - Grupo
de objetos de status das cargas; LOJA1175 - Classe para controlar a
excluso das cargas; LOJA1176 - Rotina de excluso de cargas; LOJXFUNA
- Contem funes especificas do SigaLoja I e II; LOJXFUNB Funes
auxiliares do SigaLoja; LOJXFUNF Menus (SigaLoja)
Windows/Linux

LOJA BT Carga de Ambiente TFS768 PDF

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

LOJA BT Carga de Ambiente TFS768 PDF

Enviado por

Direitos autorais:

Formatos disponíveis

Boletim Tcnico

: Microsiga Protheus Controle de Lojas verso 10

Transferncia dos dados das tabelas entre ambientes;

Utilizao de uma hierarquia de transferncia;

Facilidade na gerncia dos ambientes envolvidos;

Execuo da carga de modo automtico e com replicao na hierarquia;

Dois modos de gerao de carga (inteira ou incremental)

gerenciar o status de carregamento delas em cada ambiente).

Substituio, em diversos cenrios, do uso da carga existente no Front Loja (SIGAFRT).

A Carga de Ambiente composta pelas seguintes rotinas:

Assistente de configurao do servidor de arquivos do mdulo Controle de Lojas (LOJA0047);

Assistente de gerao de carga (LOJA1156);

Assistente de carregamento de carga (LOJA1157);

Assistente de excluso de carga (LOJA1176) e

Monitor de carga (LOJA1158).

Definio dos modos de carga:

importa todos os registros da carga.

SIGALOJA Carga de Ambiente

Campos de controle MSEXP e HREXP

SIGALOJA Carga de Ambiente

Exemplo de cenrio de utilizao:

SIGALOJA Carga de Ambiente

Web Function: Responsvel por atender a solicitao e o envio do arquivo;

Classes: Responsveis pelas solicitaes e gerenciamento do arquivo baixado.

Completa exportao padro da tabela.

Parcial permite filtrar registros especficos da tabela.

SIGALOJA Carga de Ambiente

separadas por pastas de acordo com o cdigo da carga gerada;

tabela trabalha em modo compartilhado;

Os arquivos gerados so compactados para diminuir seu tamanho;

Assistente de carregamento de cargas

SIGALOJA Carga de Ambiente

Assistente de carregamento de cargas Express

SIGALOJA Carga de Ambiente

A lista dos ambientes dependentes;

O status de cada ambiente (atualizado ou desatualizado)

O progresso da baixa da carga (caso esteja acontecendo);

O estado do servidor de arquivos do LOJA;

ambientes ou selecionar manualmente quais cargas sero aplicadas);

Os eventos que ocorreram durante a carga;

O acesso ao monitor de ambientes dependentes.

Acessar a rotina de excluso de cargas.

Atualizar o arquivo de senhas (sigapss) dos ambientes dependentes.

SIGALOJA Carga de Ambiente

PROCEDIMENTOS PARA IMPLEMENTAO

Antes de aplicar o update verifique se no atalho do smartclient no h parmetros.

Antes de executar o update/compatibilizador U_UPDLO105 imprescindvel:

O compatibilizador deve ser executado com a Integridade Referencial desativada*.

SIGALOJA Carga de Ambiente

Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instrues.

Contate o Help Desk Framework EM CASO DE DVIDAS!

SIGALOJA Carga de Ambiente

GRUPOS DE TABELAS DA CARGA

REGISTROS DA CARGA DA TABELA

FILIAIS DA CARGA DA TABELA

SIGALOJA Carga de Ambiente

Controle Ordem Carga

2. Criao de Campos no arquivo SX3 Campos:

Cod. Grp Tab

Cdigo do grp de tabela

Cdigo do grupo de tabela

Cdigo do grp de tabela

Tipo do grupo: 1 - Template / 2 - Carga