Configurador

Sumrio

Pgina 1
Sumrio............................................................................................................ 1
1. INTRODUO................................................................................................ 4
1.1. Viso Geral Do Curso..............................................................................4
1.2. Objetivos do Curso.................................................................................4
2. CONFIGURAO............................................................................................ 5
2.1. Estrutura dos Diretrios..........................................................................5
3. FAMLIAS DE ARQUIVOS................................................................................ 7
4. GRUPOS DE EMPRESAS, EMPRESAS, UNIDADES DE NEGCIO E FILIAIS.......9
4.1. Criao de Empresas..............................................................................9
Exerccio 01.............................................................................................. 13
4.2. Autorizao de Empresas.....................................................................13
Exerccio 02.............................................................................................. 14
4.3. Autorizao de Emergncia..................................................................14
5. ARQUIVOS, TABELAS E CAMPOS.................................................................15
5.1. Arquivo de Perguntas (Sx1)..................................................................15
Exerccio 04................................................................................................. 15
5.2. Mapeamento de Arquivos (Sx2)............................................................16
Exerccio 05................................................................................................. 17
5.3. Criando Novos Arquivos (Sx2)..............................................................17
5.4. Incluindo ndices................................................................................... 17
Exerccio 06 Criando Novos Arquivos........................................................19
5.5. Tabelas Genricas (SX5).......................................................................20
Exerccio 07 - Criando tabelas genricas:....................................................22
5.6. Dicionrio de Dados (Sx3)....................................................................22
Exerccio 08 Criando Novos Campos:........................................................23
Exerccio 09 Criando Novos Campos, utilizando a lista de opes e uma
validao..................................................................................................... 24
Exerccio 10 Testando o campo associado a tabela genrica:...................25
Exerccio 11 Testando o campo com lista de opes:...............................25
6. CONSULTAS-PADRO (SXB).........................................................................25
Exerccio 12 Incluindo Consultas-padro:.................................................26
6.1. Consultas-padro para Arquivos de Usurios.......................................26
Exerccio 13 Criando Consultas-padro para Arquivos de Usurios:.........26
6.2. Consultas-Padro Para Grupos De Usurios..........................................26
7. MENUS E SENHAS....................................................................................... 28
7.1. Menus................................................................................................... 28

Pgina 2
 Exerccio 15 Criando Menus para os Usurios:..........................................28
7.2. Poltica, Privilgios e Usurios..............................................................29
Exerccio 16 Criando usurios:..................................................................30
7.3. Grupos de Usurios..............................................................................30
Exerccio 17 Criando Grupos de Usurios.................................................30
8. REPOSITRIO DE IMAGENS.........................................................................30
8.1. Cadastros no Repositrio de Imagens..................................................30
Exerccio 18 Utilizando Imagens do Repositrio de Imagens:...................31
9. PARMETROS E LOGS................................................................................. 31
9.1.Parmetros (Sx6)................................................................................... 31
Exerccio 19 Cadastrando Novos Parmetros............................................32
9.2. Log de Registros................................................................................... 32
Exerccio 20 Criando Campos para a Consulta de Log de Registros:..........33
9.3.Consultas aos Arquivos Log...................................................................33
9.4.Log de Campo (SXO/SXP)......................................................................34
Exerccio 21................................................................................................. 35
10. SCHEDULE................................................................................................ 35
11. GATILHOS................................................................................................. 38
Exerccio 22 Criando Campos para utilizao em Gatilhos:......................39
Exerccio 23 Criando Gatilhos...................................................................40
Exerccio 24 Testando o novo Gatilho:.....................................................40
12. ATUALIZAO PROGRAMADA DOS DICIONRIOS DE DADOS....................41
13.MASHUPS................................................................................................... 42
Exerccio 25 Testando Mashups.................................................................43
14. GRUPOS DE CAMPOS (SXG)......................................................................44
Exerccio 26 Alterando um grupo de campos............................................44

Pgina 3
1. INTRODUO
1.1. Viso Geral Do Curso
Este curso foi elaborado para capacitar os usurios do Protheus a
utilizarem os recursos do Mdulo Configurador de forma sistemtica e
prtica, abordando os conceitos por ele utilizados e orientando-os na
operao de cada uma de suas opes para que seja possvel a
aplicao s rotinas de sua empresa.

1.2. Objetivos do Curso

Ao trmino deste curso, o aluno dever estar habilitado a:

Identificar a estrutura dos diretrios e as famlias de arquivos;

Criar e solicitar autorizao de uso de empresas;
Fazer manuteno nos cadastros de:
mapeamento dos arquivos (Sx2);
criao de tabelas (Sx5);
dicionrio de dados (Sx3);
consulta padro (SxB).
Configurar e tratar:
menus;
senhas e usurios;
parmetros (Sx6);
log de registros;
gatilhos em campos (Sx7);
- scheduled Jobs;
- mashups.

Pgina 4
2. CONFIGURAO

Neste captulo, veremos os principais arquivos de configurao do

sistema, chamados de Arquivos Customizadores, alm de outros
arquivos de uso interno do Protheus.
Tambm analisaremos os diretrios especficos de cada arquivo dentro
da estrutura do sistema.
Para acessar o configurador, deve-se obrigatoriamente escolher o
programa inicial SIGACFG, somente Administradores devem utiliz-lo.

2.1. Estrutura dos Diretrios

O Diretrio Base da instalao o \TOTVS 11\Microsiga, sendo
definidos na instalao os subdiretrios, de acordo com as tabelas a
seguir:

\PROTHEUS_DATA Raiz do sistema.

\APO Repositrio de objetos (RPO).
\ Destinado aos arquivos para acesso via
BIN\SMARTCLIENTE_ACT Web.
IVEX
\BIN\SMARTCLIENT Executveis, bibliotecas e arquivos de
configurao (.INI) do sistema.
\BIN\APPSERVER Executveis, bibliotecas e arquivos de
configurao (.INI) do sistema.
\ Arquivos de configurao e bibliotecas para
BIN\APPSERVER\ACE_9. acesso aos arquivos SX's.
99
\BIN\TOOLS Onde so encontradas as ferramentas para
manuteno do sistema

Pgina 5
\CPROVA Destinado para a gravao dos
lanamentos analticos do mdulo Contbil.
\CRYSTAL Contm arquivos de bibliotecas e relatrios
modelos do Crystal Report.
\DATA Contm o Banco de dados do Protheus
(Codebase, CTREE ou ADS).
\HANDHELD Arquivos de biblioteca para integrao com
Palm-OS e Pocket PC.
\INCLUDE Contm as Bibliotecas (.CH) necessrias
execuo e compilao do AP7.
\MY Fontes para exemplos de funes ADVPL.
PROJECTS\SAMPLES\SO
URCE
\SAMPLES\DOCUMENTS Arquivos modelos para integrao com o
pacote Microsoft Office.
\SYSTEMLOAD Arquivos de carga do Dicionrio de Dados,
Helps do Protheus e Indicadores Nativos,
usados somente na instalao/migrao do
Protheus
\SPOOL Destinado para a gravao de relatrios
gerados em disco.
\SEMAFORO Arquivos de semaforizao de registros.
\SYSTEM Contm os arquivos de Customizao,
Empresa, Usurios, Fiscais, impresso e
menus do Sistema.
\SISCOMEX Contm arquivos especficos para uso dos
mdulos de importao e exportao.
\PROFILE Armazena o perfil de cada usurio.

Pgina 6
3. FAMLIAS DE ARQUIVOS

A MICROSIGA criou uma identificao para tabelas e arquivos do

sistema Protheus, que consiste em codificar seus nomes seguindo um
padro pr-estabelecido, para que os usurios e analistas possam
identific-los com mais facilidade.
Os nomes das tabelas e arquivos so formados por um conjunto de trs
dgitos que os identificam.

O quarto e quinto dgitos indicam o nmero da empresa e o sexto

dgito sempre zero, que utilizado para identificao interna do
sistema:

1 posio (S) de SIGA ou outra letra quando se tratar de um mdulo

especfico
2 posio de (A a Z) ou (0 a 9), definindo a famlia do arquivo;
3 posio de (1 a Z), definindo a sequncia dentro da famlia.

Como exemplo, vamos utilizar o Arquivo de Clientes SA1010 no

qual:
S significa que este arquivo pertence aos Mdulos Genricos;
A letra que representa a famlia qual o Arquivo pertence;
1 sequncia do arquivo na famlia;
01 caracteres que representam a numerao do grupo da empresa;
0 dgito de uso exclusivo da MICROSIGA.

Para as customizaes dos clientes, so reservadas as famlias SZ? e

Z??, os usurios no devem utilizar as famlias reservadas para
MICROSIGA, pois estas podero ser sobrepostas em uma futura
atualizao de verso.
A Famlia SX fica armazenada no diretrio \SYSTEM\, e formada
pelos arquivos customizadores do Protheus. Referem-se a todos os
mdulos, pois so de uso Genrico:

Tabela Funo
SIX ndices dos Arquivos (SX2)
SX1 Manuteno de Perguntas de parametrizao
(movimentaes, consultas e relatrios)

Pgina 7
SX2 Manuteno dos Arquivos
SX3 Manuteno dos Campos
SX4 Configurao de Agenda de Relatrios e Processos
SX5 Manuteno de Tabelas
SX6 Manuteno de Parmetros
SX7 Manuteno de Gatilhos de Campos (SX3)
SX9 Manuteno de Relacionamento entre Arquivos (SX2)
SXA Manuteno de Pastas Cadastrais dos Arquivos (SX2)
SXB Manuteno de Consultas-padro
SXD Cadastro de Relatrios e Processos para
Agendamento (SX4)
SXE Controle de numerao (nmeros utilizados)
SXF Controle de numerao (prximos nmeros)
SXG Manuteno de Configurao padro para grupo de
campos
SXK Controle de Perguntas (SX1) por usurio
SXM Agendamento de Workflow
SXO Cadastro de Logs por Campo
SXP Histrico de Logs cadastrados no SXO
SXQ Cadastro de filtros inteligentes da mbrowse (contm
as informaes necessrias para a criao do filtro).
SXR Cadastro de relacionamento entre programa x filtro
(utilizada internamente pelo Protheus para verificar
em quais programas os filtros podero ser
utilizados).
SXS Cadastro de programas (utilizado na validao para
mostrar/inibir os filtros na execuo da mbrowse).
SXT Tabela de usurios (contm as informaes dos
usurios que podero utilizar os filtros da mbrowse).
SXV Mashups
SXOffice Cadastro de relacionamento entre as entidades
(tabelas) e as consultas TOII.

H tambm arquivos que armazenam dados especiais, como script de

planilhas, senhas, helps, menus, consultas etc. So eles:

SIGAHLP.HLP Help de Campos

Pgina 8
 SIGAMAT.EMP Empresas
SIGAPSS.SPF Senhas
SIGAMAT.IND ndice do
SIGAMAT.EMP

Temos ainda outros arquivos com extenses que tambm fazem parte
do Protheus, os quais esto relacionados a seguir:

.#DB Backup gerado pelo Configurador

.DRV Drivers de Impressoras
.REM Envio de Transmisso Bancria
.RET Recebimento de Transmisso Bancria
.LOG Arquivo TTS
.SC999999.* Arquivos temporrios
.Batch*.op Arquivos temporrios utilizados na
gerao de OPs.

As tabelas de dados do Protheus ficam armazenados no banco de

dados ou numa pasta definida no dicionrio de dados quando se tratar
de base no relacional ou quando o formato de dados utilizado no for
permitido pelo banco de dados.

4. GRUPOS DE EMPRESAS, EMPRESAS, UNIDADES DE NEGCIO

E FILIAIS
4.1. Criao de Empresas
A estrutura de Criao de Empresas foi modificada, pensando em:
Possibilitar o compartilhamento do Dicionrio de Dados de vrias
empresas pelo Microsiga Protheus.
Introduzir o conceito de Unidade de Negcios.
Permitir a configurao do tamanho do cdigo de Empresa e Filial.
Permitir a configurao do compartilhamento entre Empresas,
Unidades de Negcio e Filiais.

Para criar um novo Grupo de Empresas, deve-se cadastrar

corretamente os componentes desse grupo, sendo: Grupo de
Empresas, Empresas, Unidade de Negcios e Filiais, levando em
considerao os acessos "Exclusivos" e "Compartilhados" dos arquivos
utilizados pelo Sistema.

Pgina 9
 Grupo de Conjunto de Empresas que esto ligadas entre si por
Empresas razes diversas e que compartilham as mesmas
definies do modelo de dados.
Empresas Conjunto de Filiais ou Unidades de Negcios que esto
dentro da mesma dependncia jurdica ou fiscal.
Unidades Conjunto de filiais que esto dentro da mesma
de Negcio atividade econmica.
Filial Estabelecimento empresarial dependente de outro que
pratica atos que tm validade jurdica ou fiscal.

Estes conceitos referem-se utilizao das mesmas informaes

gravadas nos arquivos para diferentes Empresas, Unidades de
Negcios e Filiais. Ou seja, criado o Grupo de Empresas com cinco
filiais, possvel manter um nico Cadastro de Clientes (SA1) para
todas as filiais, ou manter cinco ou menos cadastros distintos, sendo
um para cada filial. Esse mesmo conceito se aplica, tambm,
utilizao de Empresas e Unidades de Negcios.
Esta distino entre Grupo de Empresas, Empresas, Unidades de
Negcios e Filiais controlada pelo Sistema atravs da criao do
Grupo de Empresas, onde definem-se quantas e quais so as
Empresas, Unidades de Negcios e Filiais.

Todos os arquivos do Microsiga Protheus, registram os dados da

seguinte forma:
XXX_FILIAL onde: XXX = sigla do arquivo
B1_FILIAL onde: B1 = Cadastro de Produtos e FILIAL = nmero da
Empresa, Unidade de Negcios e Filial onde foi gravado o dado.

Desta forma, sempre que acessar o ambiente definindo a qual Empresa

pertence a movimentao em execuo, o Sistema grava esta
informao neste campo, que compe o nmero do registro.

Exemplo:
Suponha que um Grupo de Empresas seja composto por uma Empresa
e trs Filiais. Os arquivos referentes aos cadastros devem ser nicos
para todas as Empresas e Filiais. Porm, cada uma delas deve possuir
Planos de Contas exclusivos (CT1 - Cadastro de Planos de Contas).
Neste caso, as Empresas e Filiais criadas devem seguir o seguinte
padro:

Pgina 10
Empresa Filial Grava os campos XXX_FILIAL com
EMP01 Matriz Filial 00 EMP0100

Empresa Grava os campos XXX_FILIAL com

EMP01 Filial SP Filial 01 EMP0101

Empresa Grava os campos XXX_FILIAL com

EMP01 Filial RJ Filial 02 EMP0102

Empresa Grava os campos XXX_FILIAL com

EMP01 Filial TO Filial 03 EMP0103

Os arquivos gravados no diretrio \SYSTEM e as tabelas no banco de

dados tambm seguiro a nomenclatura do Grupo de Empresas, da
seguinte forma:
SX1010 Arquivo de Perguntas gravado no \SYSTEM, referentes ao
Grupo Empresa 01
SB1020 Cadastro de Produtos gravado no BD, referentes ao Grupo
Empresa 02
SX6030 Arquivo de Parmetros gravado no \SYSTEM, referentes ao
Grupo Empresa 03

Importante:
Antes de enviar a solicitao para criao dos grupos de empresas
TOTVS, estude cuidadosamente a necessidade de
compartilhamento de arquivos e criao de Empresas, Unidade de
Negcios e Filiais.

Para utilizao do Sistema pelo usurio so obrigatrios os cadastros

de Grupo de Empresas e Filiais, assim como o preenchimento do
tamanho do campo Filial e o layout.
O contedo do campo layout define a estrutura utilizada para o Grupo
de Empresas, como por exemplo:

Exemplo: EEUUFFFF

Pgina 11
Neste exemplo, definimos que as informaes gravadas nos campos e
filiais sero identificadas da seguinte maneira:

EE - Dois Dgitos para Empresa

UU - Dois dgitos para a Unidade de Negcio
FFFF - Quatro Dgitos para a Filial

Para cada identificador ser permitido definir uma mscara de restrio

para preenchimento conforme o exemplo a seguir:

E 0-9 Somente nmeros entre 0 e 9

E 5-9 Somente nmeros entre 5 e 9
U A-Z Somente caracteres entre A e Z
U X-Z Somente caracteres entre X e Z
F !-! Qualquer dgito numrico ou
alfanumrico
F A,B,5,9 Somente caracteres entre A,B,5 e 9
F 0-9 Somente nmeros entre 0 e 9
F A-Z Somente caracteres entre A e Z

Aps a incluso do grupo de empresas, o administrador dever incluir e

relacionar os cadastros de Empresas, Unidades de Negcios e Filiais de
acordo com o Layout, conforme aplicado nos exemplos:
Para o Layout EEUUFF, o administrador dever realizar o
relacionamento dos seguintes cadastros:
Empresas X Grupo de Empresas
Unidades de Negcio X Empresas
Filiais X Unidades de Negcios

Numa instalao inicial utiliza-se o layout utilizado at o Protheus 10.1,

a saber: Grupo de Empresas 99, layout FF. Ao criar o layout o
configurador pede se deseja criar o dicionrio de dados para o novo
grupo.

Pgina 12
Caso j haja algum grupo de empresa com dicionrio de dados j
criado utilizado em personalizaes possvel replic-lo para o novo
grupo. Assim o configurador pede se deseja copi-lo ou criar um novo
com registros padro a partir da pasta systemload.

Se deixar para cri-lo depois, os arquivos SXs sero criados com

registros padro no primeiro acesso qualquer filial do novo grupo.

Importante:
No crie grupos de empresas 99 e ZZ, pois so pr-definies
de empresas de Teste, tambm no se recomendam grupos de
M0 a M9, pois podem gerar erros na criao de bases de
conhecimento.

Exerccio 01
Crie uma empresa de acordo com as informaes abaixo:
Layout: EEUFF - TOTVSIP
Empresa: 01 - TOTVSIP
Un. Neg.: 1 - Cursos
Filial: 01 - CEC_Campinas
4.2. Autorizao de Empresas
Aps criar as filiais, o admistrador deve autoriz-las, para tanto acesse
www.totvs.com/suporte, no link Central de Downloads, escolha sua
linha de produtos e abra a pgina de atualizaes do Protheus. Clique
no Link Liberao de Empresas e envie o arquivo SIGAMAT.EMP que
se encontra na pasta \SYSTEM\.

Pgina 13
Baixe o servio do Protheus AppServer, renomeie o arquivo antigo para
sigamat.old, por exemplo, grave o novo arquivo autorizado e exclua o
sigamat.ind, ele ser recriado no primeiro acesso. Confirme no
configurador que a empresa agora est autorizada.

Exerccio 02
Simule o processo de Autorizao da Empresa que foi criada
anteriormente.
4.3. Autorizao de Emergncia
A senha de emergncia libera o uso de uma empresa por um dia e
pode ser solicitada TOTVS, caso a empresa ainda no possua a
liberao definitiva, danos ou perda do Hardlock ou problemas com
arquivo de licenas.
Para obter essa senha, entre em contato com o Canal CST: 55 11
20997320, das 8:00 s 18:00, de segunda a sexta-feira ou acesse
www.totvs.com/suporte.
Para aplicar a senha de emergncia acesse o menu de Autorizao de
empresas, no submenu Aoes relacionadas escolha Emergncia.

Ser exibida caixa de texto onde deve preencher a senha de

emergncia. A senha de emergncia ter validade durante 1 dia e s
tem relao com a data, ou seja, pode ser utilizada por qualquer
cliente Totvs naquela data.

Pgina 14
Exerccio 03
Simule o processo de Autorizao da Emergncia para a empresa que
foi criada anteriormente
5. ARQUIVOS, TABELAS E CAMPOS
O Protheus conta com um dicionrio de dados dinmico, este dicionrio
responsvel pela criao de todas as tabelas criadas no banco de
dados utilizadas pelo ERP. Alm disso h elementos do prprio sistema
que podem ser configurados e criados.
5.1. Arquivo de Perguntas (Sx1)
Quando da necessidade de
Customizaes prprias que
envolvam o desenvolvimento de
relatrios ou processos prprios,
estes podero ter filtros. Tais filtros,
geralmente so: por cdigo
incio/fim, por perodo inicial/final,
por filial, etc.
Em sntese, cada processo ou filtros de um relatrio, ter seu prprio
grupo de perguntas, que sero chamadas, todas as vezes em que se
processem esses relatrios ou processos.

Para incluir Novas Perguntas:

1) Selecione as seguintes opes: Base de Dados + Dicionrio +
Bases de Dados;
2) O sistema apresentar uma tela contendo todas as opes
disponveis para configurao.
3) Selecione a opo Perguntas e clique no boto " Incluir";
4) Defina o nome do grupo e seus itens;
5) Posicionado nesse grupo de perguntas, clique no boto Preview,
para checar se as configuraes esto de acordo com o desejado.

Importante:
Os grupos de perguntas originais do Protheus no devem ser
alterados seno em casos especficos como exigncia de um

Pgina 15
Boletim Tcnico. Os nomes dos grupos criados em personalizaes
devem ser iniciados com ZZ sob o risco de serem sobrescritos numa
atualizao de verso.

Exerccio 04
Inclua um novo grupo de perguntas de acordo com as informaes
abaixo:

GRUPO: ZZTST

Or Tam Format
Pergunta Tipo
d . o

Caracte
01 Cdigo de? 6 @!
r

Caracte
02 Cdigo At? 6 @!
r

5.2. Mapeamento de Arquivos (Sx2)

O objetivo do Mapeamento permitir que os arquivos do Protheus
sejam distribudos em diversos drivers/diretrios selecionados pelo
usurio e tambm definir se ele poder ou no ser acessado por outras
empresas e filiais existentes no sistema.
A localizao dos arquivos determinada no Sx2. Cada empresa possui
arquivos prprios, como: clientes, produtos, movimentaes, etc. Mas
pode haver o uso comum de qualquer um deles, via mapeamento.

Para compartilhar arquivos entre filiais:

1) Selecione Base de Dados + Dicionrio + Arquivos;
2) O sistema apresentar uma tela contendo todos os arquivos
utilizados pelos mdulos;
3) Clique no boto "Pesquisar", informe o nome do Arquivo SB1 e
confirme;

Pgina 16
4) O sistema apresentar o arquivo solicitado, posteriormente clique no
boto Editar;
5) Altere os modos de acesso por empresa, unidade ou filial;

6) Confirme e clique no boto Atualizar Base de Dados, para a

Atualizao das Modificaes, esse procedimento deve ser feito em
modo exclusivo.

Importante:
Para compartilhamento entre grupos de empresas, basta alterar
o campo Nome, informando o arquivo a ser compartilhado.
Exemplo: Compartilhar a tabela SB1010 com o grupo de empresas
02.

Exerccio 05
Altere o modo de acesso do arquivo SA1990.
5.3. Criando Novos Arquivos (Sx2)
Como criar Novos Arquivos, utilizando Ambiente Configurador:

Pgina 17
1) Selecione as seguintes opes: Base de Dados + Dicionrio +
Arquivos e clique no boto Incluir;
2) Informe Prefixo, Path, Nome, Descrio, Modo Acesso e confirme;
3) Para inserir os campos, selecione a tabela que foi inserida e clique
no boto Editar;
4) Posicione o cursor sobre a opo Campos do lado esquerdo da
tela, clique no boto Incluir;
5) Na pasta Campo, informe os dados referentes criao do campo.
6) Na pasta Informaes, preencha os dados referentes Ttulo,
Descrio e Help;
7) Na pasta Opes, informe Inicializadores , Lista de Opes,
Consulta Padro, modo de edio.
8) Na pasta Validao informe o nvel de campo e validao de
usurio;
9) Na pasta Uso, informe se Usado, Obrigatrio ou Browse;
10) Na pasta Mdulos, informe os mdulos onde o campo ser
visvel.
5.4. Incluindo ndices
Os ndices so utilizados como chaves de pesquisa nas consultas que
so efetuadas no Sistema.
Para incluir um ndice:
1) Selecione ndices e em seguida clique em Incluir;
2) possvel digitar o nome do campo que ser o novo ndice ou
selecionar a opo Campos;
3) Repita o procedimento com todos os ndices e confirme;

Importante:
A opo Mostra Pesq. deve ser marcada se deseja que o
ndice seja visvel no browse, mas o ndice dever conter o
campo Filial, caso contrrio no ser visvel.
Toda tabela do Protheus dever ter, no mnimo, um ndice.

Pgina 18
No coloque NickName em tabela criadas, essa opo s ser utilizada
em tabelas padro do sistema.

Pgina 19
Exerccio 06 Criando Novos Arquivos
1) Crie um novo arquivo de acordo com as dados a seguir:

Prefixo: SZ8
Path: \DATA\
Nome: SZ8990
Descrio: CADASTRO TESTE
Modo Acesso: EXCLUSIVO para Empresa,
Unidade e Filial

2) Agora crie os campos de acordo com os dados a seguir:

Campo Z8_CODIGO
Tipo: Caracter
Tamanho: 6
Formato: @!
Contexto: Real
Propriedade: Alterar
Ttulo: Cdigo Prod.
Descrio: Cdigo do Produto
Help: Informe o cdigo do produto, que deve ser de acordo com
uma sequncia lgica.
Inic. Padro: GETSXENUM("SZ8","Z8_CODIGO")
Modo edio: __cUserId==000000
Uso: Usado, Obrigatrio e Browse

Campo Z8_DESC
Tipo: Caracter
Tamanho: 30
Formato: @!
Contexto: Real
Propriedade: Alterar
Ttulo: Produto
Descrio: Especificao do Produto
Help:Criao: Especificao resumida do produto, quanto sua
cor ou espessura.
Uso: Usado e Browse

Pgina 20
 Campo: Z8_ESPESS
Tipo: Caracter
Tamanho: 1
Formato: @!
Contexto: Real
Propriedade: Alterar
Ttulo: Espessura
Descrio: Espessura do Produto
Help:Criao: Selecione, dentre a lista de opes, a espessura do
Produto.
Lista Opes 1=2pol;2=pol;3=6pol
Inic Padro: "1"
Validao de Usurio: !Vazio()
Uso: Usado e Browse

3) Crie um ndice que utilize os campos Filial e Cdigo;

4) Atualize a Base de Dados e, atravs da opo Preview, visualize o
resultado final da criao deste arquivo.

Importante:
Os novos arquivos devem ser criados dentro das Famlias SZ?-
Z??, pois assim teremos a certeza de que durante uma
atualizao de verso, no ocorrero problemas entre nossos arquivos
e os da MICROSIGA.

5.5. Tabelas Genricas (SX5)

H situaes em que a criao de uma nova tabela com ndices e
consumo de um alias no a soluo mais inteligente. Quando os
dados forem do tipo Cdigo-Descrio e as informaes forem
estticas o Protheus conta com uma tabela destinada especificamente
pra isso.

Exemplo de tabela genrica:

Pgina 21
 02 - Tipos de Produtos
MC Material de
Consumo
MO Mo-de-obra
MP Matria-prima
PA Produto Acabado
PI Produto
Intermedirio

Para incluir tabelas:

1. No menu principal, selecione as opes Ambiente + Cadastros +
Tabelas. O Sistema apresenta uma janela relacionando todos as
tabelas utilizadas pelo Sistema.

2. Clique em Incluir para cadastrar uma nova tabela. O Sistema

apresenta a tela para cadastramento da tabela e dos respectivos itens;
3. Com a pasta Nova Tabela de Consulta selecionada, preencha os
campos correspondentes ao cadastro, conforme descrio a seguir:

Tabela Este campo preenchido automaticamente pelo

Sistema com 00.
Chave Informe o nome ou valor que identificar a tabela.
Utilize 2 caracteres.
Descri Informe a descrio da tabela em cadastro,
o identificando seu contedo.

4. Clique na pasta Itens para cadastrar os itens da tabela.

5. Preencha os campos chave e descrio e confirme.
Importante:

Pgina 22
 Utilize a faixa de segurana Z*, para no correr o risco da
tabela ser sobrescrita em atualizaes. A tabela recm criada
deve ser associada a um dos campos do dicionrio de dados para
que seja utilizada. Para tanto, preciso informar a chave na
opo Consulta padro do campo associado.

Exerccio 07 - Criando tabelas genricas:

1) Crie uma Tabela Genrica de acordo com as descries a seguir:

Tabela: 00
Chave: ZC
Descrio: Cores
Desc. Colors
English:
Desc. Colores
Spanish:

2) Cadastre os itens para a tabela genrica:

Chave Descrio Desc. Desc.

Spanish English
01 Vermelho Rojo Red
02 Azul Azul Blue
03 Amarelo Amarillo Yellow

5.6. Dicionrio de Dados (Sx3)

O Protheus foi desenvolvido considerando que cada empresa trabalha
de uma maneira, o que torna suas necessidades administrativas
diferentes umas das outras.
O Dicionrio de Dados um arquivo que contm as caractersticas dos
campos dos arquivos/tabelas de uso do sistema.
O objetivo principal permitir que o usurio inclua campos, retire de
uso ou modifique certas caractersticas dos campos quanto a seu
tamanho, descrio, mscara, validao, preenchimento, propriedades,
ordem de apresentao na tela, apresentao no browser e uso, sem
ter que alterar os programas-fontes ou recompilar o sistema.
A nica restrio encontrada para os campos-chave e campos
obrigatrios do sistema que no podem ser alterados, inibidos ou
excludos.

Pgina 23
Para Criar Novos Campos:
1) Selecione Base de dados + Dicionrio + Bases de dados;
2) Posicione o cursor sobre a opo
Dicionrio de Dados do lado esquerdo
da tela;
3) Clique no boto "Pesquisar", informe
SB1 no campo Procurar por: e
confirme clicando no boto Procurar;
4) Clique no boto Editar, clique na
opo Campos do lado esquerdo da
tela;
5) Clique no boto Incluir para incluir o novo campo;
6) Defina as especificaes do novo campo e Confirme;
7) A ordem do campo pode ser alterada, dependendo da
disponibilidade da posio.

Importante:
Os campos criados em tabelas padro do Protheus devem utilizar
a nomenclatura XX_ZZ?????, onde XX o alias da tabela e ?????
as possibilidades de nome entre caracteres e nmeros, para
evitar problemas com campos que venham a ser includos pela
Microsiga em atualizaes.

Exerccio 08 Criando Novos Campos:

1) Na tabela SB1990, inclua um novo campo de acordo com as
especificaes abaixo:

Campo B1_ZZCOR
Tipo Caracter
Tamanho 2
Formato @!
Contexto Real
Proprieda Alterar
de
Ttulo Cor
Descri Cor do Produto
o
Help Digite a cor do produto

Pgina 24
 Inic. "01"
Padro
Cons. ZC - Cores
Padro
Val. EXISTCPO("SX5","ZC"+M-
Usurio >B1_ZZCOR)
Uso Usado, Obrigatrio e Browse

2) Ordene o Campo criado cinco posies acima do que ele se

encontra;
3) Adicione o campo criado na Pasta Cadastrais.
Exerccio 09 Criando Novos Campos, utilizando a lista de
opes e uma validao.
1) Na tabela SA1990, inclua um novo campo chamado A1_ZZFIDEL, de
acordo com os dados baixo:

Campo A1_ZZFIDEL
Tipo Caracter
Tamanho 1
Formato @!
Contexto Real
Propriedad Alterar
e
Ttulo Prom.Fidel.?
Descrio Promoo Fidelidade?
Help Indique se o cliente faz ou no parte da
promoo Fidelidade.
Inic. "N"
Padro
Lista N=No;S=Sim
Opes
Val. Pertence(SN)
Usurio
Uso Usado e Browse

2) Ordene o Campo criado para a posio 166;

3) Crie uma Pasta chamada Especficos e adicione o campo
A1_ZZFIDEL na mesma;

Pgina 25
4) Crie um ndice cuja chave deve ser A1_FILIAL+A1_ZZFIDEL;
5) Defina o nickname FIDELIDADE.

Importante:
Em tabelas padro do Protheus, Nicknames SEMPRE devem ser
usados ao criar ndices e NUNCA devem ser colocados em
ndices padro. Campos virtuais no podem ser utilizados e ,
devido presena de um campo Filial, as chaves devem sempre
ser no formato Caracter, assim campos DATA e NUMERO devem utilizar
as funes de converso STOD() e STRZERO() respectivamente.

Exerccio 10 Testando o campo associado a tabela genrica:

1) Acesse o Mdulo de Faturamento;
2) Selecione as seguintes opes: Atualizaes + Cadastros +
Produtos;
3) Clique no boto Incluir e verifique o campo Cor.
Exerccio 11 Testando o campo com lista de opes:
1) Selecione as seguintes opes: Atualizaes + Cadastros +
Clientes;
2) Clique no boto Incluir e verifique o campo Prom.Fidel.?

Importante:
Sempre que houver alterao de dicionrio de dados pode-se
consultar todo o processo realizado atravs da opo Visualizar Log,
localizada na barra de ferramentas.

6. CONSULTAS-PADRO (SXB)
Essa opo permite, durante a edio de um campo, consultar uma
tabela associada a este campo, pesquisar esta utilizando ndices e
visualizando apenas os campos de interesse. A opo escolhida pode
trazer um ou mais retornos.

Para Incluir Consultas-padro:

1) Selecione as seguintes opes: Base de Dados + Dicionrio +
Base de Dados+Consulta Padro;
2) Escolha a opo Consulta Padro e defina um nome para ela;
3) Pesquise pela tabela origem dos dados que pretende consultar;
4) Defina os ndices e os campos a serem exibidos para cada ndice;

Pgina 26
5) Defina Filtros e Retornos esperados para essa consulta e confirme.

Importante:
Utilize preferencialmente uma nomenclatura Z????? para
personalizaes. A utilizao da opo Permitir incluso no
consome licenas no uso da consulta padro. Para que a consulta
seja utilizada ela deve ser especificada num campo que vai utilizar
essa associao.

Exerccio 12 Incluindo Consultas-padro:

1) Crie uma consulta padro para a Tabela SA1de acordo com os dados
abaixo:
Consulta: ZZSA1
Descrio: Cliente Fidelidade
2) Habilite a opo Habilitar Incluso e clique em Avanar;
3) Adicione o ndice A1_FILIAL+A1_ZZFIDEL
4) Adicione os Campos A1_COD, A1_NOME e A1_ZZFIDEL;
5) Como Retorno selecione SA1->A1_ZZFIDELe finalize;
6) Localize consulta criada e selecione "Preview".
6.1. Consultas-padro para Arquivos de Usurios
Para Incluir Consultas-padro para Arquivos de Usurios:
1) Selecione as seguintes opes: Base de Dados + Dicionrio +
Base de Dados+Consulta padro;
2) Selecione Consulta Usurio e defina um nome;
3) Escolha os campos de retorno e confirme.
Exerccio 13 Criando Consultas-padro para Arquivos de
Usurios:
1) Crie uma Consulta-padro para Arquivos de Usurios nomeada
ZZUSU e com descrio Usurios Protheus;
2) Adicione o campo ID como retorno;
3) Utilize o Preview" para visualizar o resultado da consulta;
4) Utilizando o dicionrio de dados, adicione esta consulta criada ao
campo H6_OPERADO da Tabela SH6990.
5) Acesse o Mdulo Planejamento e Controle da Produo e selecione
as seguintes opes: Atualizaes + Movmtos. Produo +
Produo PCP Mod. 2;

Pgina 27
6) Clique na opo Incluir e verifique o campo Operador. Este
contm uma Consulta Padro. Pressione <F3> ou clique na lupa.
6.2. Consultas-Padro Para Grupos De Usurios
Para Incluir Consultas-padro para Arquivos de Usurios:
1) Selecione as seguintes opes: Base de Dados + Dicionrio +
Base de Dados;
2) Clique em Consultas Padro e em seguida, clique na opo
Incluir, no topo da tela;
3) Ser apresentado um wizard para seleo da consulta a ser includa;
4) Na tela a seguir, mantenha marcada a opo Consulta Grupos de
Usurios e do lado direito da tela preencha os campos referentes ao
nome e a descrio da consulta;
5) Clique no boto Avanar e na prxima tela, adicione ao lado direito
os campos ID e Nome, utilizando o boto Adicionar (seta para a
direita) e clique no boto Finalizar;
6) Clique no boto "Pesquisar", no campo Procurar por:, informe
GUP e confirme clicando no boto Procurar;
7) Em seguida, clique no boto Preview", localizado na barra de
ferramentas, para verificar os contedos dos campos;
8) Depois de criado a consulta, devemos relacion-la a um campo do
Dicionrio de Dados.
Exerccio 14 Criando Consultas-padro para Grupos de Usurios:
1) Crie um Consulta-padro para Arquivos de Usurios nomeada GUP e
com descrio Grupo de Usurios;
2) Adicione os campos IDe Nome;
3) Utilize o Preview" para visualizar o resultado da consulta.

Pgina 28
7. MENUS E SENHAS
Aprenderemos a configurar novos menus a partir de arquivos padres
j existentes.
Tambm iremos verificar como devem ser criados os usurios,
configurar seus acessos e restries, grupos e as relaes entre eles.

7.1. Menus
Os Menus do sistema podem ter suas opes reformuladas de maneira
que cada Usurio possa ter um menu de acesso prprio, de acordo com
o tipo de trabalho por ele desenvolvido.
Neste programa, deve ser definido um menu para cada usurio e na
configurao de senhas, associa-se o menu senha do usurio que
determinar quais mdulos, movimentaes, empresas e filiais ele
poder acessar.
Para criar Menus para os Usurios:
1) Selecione as seguintes opes: Ambiente + Cadastros +
Menus;
2) So selecionados todos os menus, desmarque a opo Todos os
Menus e selecione um menu para que seja usado como base, ou
nenhum para criar um menu limpo, confirme;
3) Clique em Adicionar para copiar todas as opes do menu padro
ao novo menu;
4) Adicione, exclua ou altere Itens e Grupos de Menu;
5) Grave as alteraes sobrescrevendo o menu original ou criando
novos.

Exerccio 15 Criando Menus para os Usurios:

1) Crie um Backup do arquivo SigaFat.XNU que se localiza no diretrio
\System\;
2) Adicione ao menu do Mdulo de Faturamento(SigaFat.XNU), um novo
grupo chamado Especficos;
3) Adicione um item chamado NovoFat e que execute a funo de
usurio TSTSZ1;
4) Desabilite os direitos de Incluso, Excluso e Alterao do item
criado;
5) Ainda em Faturamento, no Grupo Cadastro, remova Bancos,
Moedas e Naturezas;
6) Remova os seguintes grupos: Cenrio de Vendas, CRM - Adm de
Vendas, CRM - Contratos e Diversos;

Pgina 29
7) No Item Produtos, desabilite as permisses de Incluir, Alterar e
Excluir;
8) 8- Gere dois Menus, um menu com o nome original SigaFat.XNU e no
outro informe MENUFAT.XNU.
Note que na tela onde se encontram todos os Menus, o Menufat
acaba de ser criado como ltima opo, pronto para ser utilizado;
Os arquivos de menu passam a ser em formato XML, e sua extenso
XNU convertidos automaticamente, isto permite que a subdiviso dos
menus seja ampliada possibilitando diversos nveis hierrquicos.

7.2. Poltica, Privilgios e Usurios

A Poltica de Segurana define as regras de acesso do sistema.
Essas regras devem ser definidas antes da criao de usurios e
senhas.
Para definir a Poltica de segurana, escolha Poltica no menu
Senhas e altere as opes.

Privilgios, na verdade, tratam-se de definies de restries de

acesso, uma vez aplicados a um usurio ou grupo acarreta restries a
acessos que anteriormente poderiam ser permitidos.
Para definir os privilgios, escolha Privilgios no menu Senhas.

O cadastro de Usurios e Grupos no Protheus permite definir a quais

mdulos, rotinas, opes de menu e menus um usurio ou grupo de
usurios podero ter acesso.
Para criar usurios e grupos, escolha Usurios ou Grupos no menu
Senhas.

Para farta documentao sobre poltica, privilgios, usurios e grupos

consulte o Help Online do mdulo Configurador.

Para incluir um novo usurio:

1) Defina as polticas de segurana;
2) No menu Usurios, clique em Incluir e defina os dados do
usurio na guia Usurios;
3) Na guia Restries de acesso, defina na sub-guia Filiais a quais
grupos, empresas, unidades e filiais o usurio poder ter acesso;
4) Na sub-guia Ambientes, defina os mdulos permitidos, com um
mdulo selecionado edite o menu que ele utilizar e que nvel ter
nesse mdulo;

Pgina 30
5) Pelo menu Aes relacionadas, escolha a opo Restrio de
rotinas de menu para proibir a execuo de uma rotina do menu.
6) Na guia Acesso, escolha funes especficas s quais o usurios
ter direito;

Importante:
A criao das definies exige muito cuidado e planejamento
pois h situaes onde uma caracterstica prevalece sobre
outra anulando-a, enquanto outras opes acumulam direitos.
A utilizao de definio de direitos por grupos visa facilitar a
organizao dos usurios bem como a possibilidade de copiar direitos
entre usurios e grupos.

Exerccio 16 Criando usurios:

Crie um usurio atribuindo o menu Menufat.xnu ao mdulo
Faturamento;

7.3. Grupos de Usurios

A criao de Grupos de Usurios tem a finalidade de facilitar a
administrao de um determinado nmero de usurios que possuam as
mesmas caractersticas dentro do Sistema, ou seja, que possuam o
mesmo perfil de acesso.
Exerccio 17 Criando Grupos de Usurios
Crie um grupo de usurios chamado Faturamento e inclua o usurio
criado anteriormente.

8. REPOSITRIO DE IMAGENS
Apesar dos bancos de dados relacionais poderem utilizar dados
binrios como imagens, sons, filmes, etc, o Protheus foi originalmente
desenvolvido em ambiente no-grfico (DOS) e utilizava base de dados
no-relacional (DBF). A necessidade de utilizao de arquivos de
imagens e a restrio de manter a compatibilidade com as bases
Codebase e CTree deu origem ao conceito de repositrio de imagens:
um arquivo onde podem ser armazenadas imagens que sero
vinculadas a registros de tabelas do Protheus.
8.1. Cadastros no Repositrio de Imagens
Para incluir imagens no repositrio de imagens:
1) No menu Ambiente, selecione Cadastros e depois Reposit.
Imagens
2) Clique em Incluir, selecione a pasta que contm as imagens;

Pgina 31
3) Escolha as imagens *.jpg e *.bmp e confirme.

Para utilizar as imagens:

1) Acesse um mdulo onde haja um campo tipo imagem;
2) Clique no boto imagem e confirme;

Pgina 32
 Importante:
O repositrio de imagens o arquivo SIGAADV.BMD que fica na
pasta \SYSTEM\, as imagens so copiadas do local de origem
para esse arquivo. Arquivos BMP no so compactados quando
includos no repositrio, d preferncia a arquivos JPG. O
repositrio tambm nico para todas os grupos de empresas
cadastrados, pode ser mais inteligente utilizar o recurso base de
conhecimento.

Exerccio 18 Utilizando Imagens do Repositrio de Imagens:

Inclua uma imagem no repositrio de imagens e vincule-a ao campo
Foto no cadastro de Produtos, guia Atendimento.

9. PARMETROS E LOGS
9.1.Parmetros (Sx6)
Um parmetro uma varivel que atua como elemento chave na
execuo de determinado processamento. De acordo com o seu
contedo possvel obter diferentes resultados.
Todas as variveis so iniciadas pelo prefixo MV_, e agem sobre
diversas informaes no sistema como por exemplo, a varivel
MV_ALIQSS que define o percentual da alquota para clculo de ISS.
Cada filial da empresa pode ter parmetros prprios para execuo dos
processamentos.
As customizaes de usurios podem tratar parmetros diferentes aos
predefinidos pela TOTVS, neste caso, estes parmetros devem ser
includos atravs desta rotina.

Para incluir parmetros:

1) No menu Ambiente, escolha Cadastros e depois Parmetros;
2) Clique em Incluir e defina o parmetro, confirme.

Importante:
Ao criar parmetros personalizados utilize a nomenclatura
ZZ_???????, pois no somente h a possibilidade de incluso
de novos parmetros nas prximas atualizaes, como tambm
h parmetros previstos e no includos num SX6 padro.
A criao de um parmetro no faz qualquer efeito se no houver uma
personalizao desenvolvida em ADVPL que trate esse recurso.

Pgina 33
Exerccio 19 Cadastrando Novos Parmetros
1) Inclua um novo parmetro de acordo os dados a seguir:
Filial: 01
Nome da Var.: MV_CFGMBRW
Tipo: Caracter
Contedo: 2
Descrio:
1 - Exibe Browse e Resp. PROFILE,
2 - No exibe o Browse e Resp. PROFILE,
3 - Exibe o Browse e no Resp. o PROFILE,
4 - No exibe o Browse e no Resp. O PROFILE.

9.2. Log de Registros

Esta opo permite a visualizao do campo de LOG e contm
informaes sobre o usurio que realizou a incluso, alterao ou
excluso de determinados registros. Ser registrada a data da
operao e o status do registro (excludo ou ativo).
Para que o arquivo passe a ter este controle, necessrio que sejam
criados no Mdulo Configurador os campos (XX_USERLGI) e
(XX_USERLGA), que indicam, respectivamente, a incluso, alterao ou
excluso de determinados campos.
As duas primeiras posies do campo XX representam as iniciais
utilizadas para todos os campos do arquivo.

Para criar Campos para a Consulta de Log de Registros:

1) Selecione as seguintes opes: Base de dados + Dicionrio +
Base de Dados;
2) Posicione na pasta (Dicionrio de Dados), clique no boto
"Pesquisar", informe no campo Procurar por Arquivo SA1 e clique no
boto Procurar;
3) Assim que o arquivo for encontrado, clique no boto Editar,
posicione na opo Campos, clique no cone Campos Reservados;
4) Na tela que se apresenta deixe o campo Log de Incluso marcado
e pressione Finalizar, o campo A1_USERLGI foi criado
automaticamente;
5) Confira os dados, confirme a tela de Manuteno da Estrutura e
assim que o processo estiver encerrando, saia do cadastro.

Pgina 34
Exerccio 20 Criando Campos para a Consulta de Log de
Registros:
Crie os campos para Log de Incluso e Alterao para o arquivo SA1,
acesse o Mdulo de Faturamento e inclua, altere e exclua clientes.
Acesse o Mdulo Configurador, selecione as seguintes opes:
Usurio + Senhas + Log de Registros, escolha SA1 e verifique o
Browse.
Quando clicamos na opo Visualizar, conseguimos obter as
informaes sobre o usurio que realizou a ltima alterao no registro
selecionado.

9.3.Consultas aos Arquivos Log

O Protheus controla o nmero de acessos, incluses, alteraes em
arquivos, pginas de relatrios impressos e transaes por usurio,
gerando um arquivo texto dirio que conter todas as informaes
quanto a essas movimentaes.
Para que o Controle de Log seja acionado, devem ser configurados os
seguintes Parmetros:
MV_DIRLOG: indica o diretrio no qual ser gerado o Arquivo de Log;
MV_LOGSIGA: indica quais operaes sero tratadas pelo Controle de
Log.
O padro do Protheus (N)O. Para ativar esta opo, deve-se colocar
a letra (S)IM, de acordo com as seguintes posies:
S 1 Acesso a funes;
S 2 Incluses;
S 3 Alteraes;
S 4 Relatrios;
S 5 Transaes (TTS);
S 6 Envio de e-mail;
S 7 Parmetros.
No tipo 6, o Sistema ir realizar o controle de e-mails enviados e no
7 o Sistema ir gravar toda alterao dos parmetros dos relatrios.
Esta consulta poder ser realizada atravs do Mdulo Configurador,
na opo Log do Usurio.

Para configurar a gerao da Consulta de Arquivo Log:

1) Edite MV_DIRLOG e no campo Contedo, informe \SPOOL\;
2) Confira os dados e confirme a Alterao;

Pgina 35
3) Altere tambm o parmetro MV_LOGSIGA e no campo Contedo,
informe SSSSSSS;
4) Confira os dados, confirme a Alterao. Saia do Mdulo
Configurador e acesse outro mdulo qualquer e execute algumas
movimentaes, incluses, alteraes ou excluses;
5) Retorne ao Mdulo Configurador;
6) Selecione as seguintes opes: Empresas + Arquivos +
Consulta Arq. LOG;
7) O Sistema apresentar uma tela para consultas ao arquivo de Log;

Importante:
O log ser gravado num arquivo tipo texto na pasta informada
com o nome segundo a estrutura SL+<DD/MM/AA>.LOG. Esse
tipo de Log no recomendado pela Totvs por questes de
desempenho. Em vez disso utilize o aplicativo Audit Trail, que oferece
timos recursos, gratuito e tem menos impacto sobre o sistema
9.4.Log de Campo (SXO/SXP)
Para consultas mais especficas sobre alteraes de campos e que
armazenem no somente o autor e data de alterao, mas tambm
quais alteraes foram feitas, existe o Log de campo onde so
armazenados:
SXO Regras do Log: campo, opo de incluso, alterao, excluso.
SXP O prprio Log.

Para definir o Log de campo:

1) Acesse no menu Usurio a opo Auditoria
e depois Configurao de Log;
2) Escolha o Alias da tabela, e utiliza a opo
Consultar Estrutura no menu Aes
relacionadas para escolher os campos;
3) Escolha os tipos de log e confirme.

Para consultar o Log de campo:

1) Acesse no menu Usurios a opo Auditoria e depois Consulta
de Log;
2) Clique no boto Parmetros, defina os parmetros desejados e
confirme;
3) Com um duplo-clique na linha, visualize as informaes do log.

Pgina 36
 Importante:
O log ser gravado na tabela SXP do grupo de empresa, como o
log cumulativo possvel mov-lo como um backup e ele ser
recriado um novo arquivo primeira necessidade. Assim
possvel manter um arquivo relativamente pequeno de Log e fcil
manter um backup dele.

Exerccio 21
Defina o Log de incluso, alterao e excluso para os campos Calcula
ICMS e Calcula ISS da tabela SF4, edite o cadastro de TES em
qualquer mdulo e visualize o Log.
10. SCHEDULE
O mdulo Configurador dispe de um recurso de programao de
tarefas, onde possvel gerar e enviar relatrios e posies de
processos controlados pelos mdulos do Microsiga Protheus.
Todos os relatrios disponveis no Sistema so apresentados na relao
do Schedule, exceto aqueles que exijam a interveno do usurio para
informao de dados, que no sejam os parmetros de configurao
comuns, como por exemplo, os relatrios que necessitem da
informao de Textos e Observaes.

O Schedule agenda as tarefas para envio destes relatrios via e-mail,

ou por acesso Internet, onde exige uma configurao especfica na
estao de trabalho do usurio que consultar estes relatrios. O
Schedule composto por trs componentes principais:

Manag componente responsvel por fazer o gerenciamento das

er tarefas, bem como o controle de gerao das tarefas e das
filas de execues (Task e Queue).
Agent este componente gerencia as execues e distribu as
tarefas para as Executes configuradas que esto disponveis
para utilizao. Os agents podem estar localizados em
diferentes servidores, possibilitando a distribuio da carga
de execues.
Execut so os componentes responsveis por fazer a execuo das

Pgina 37
e tarefas. a nica entidade que consome licena. Esse
consumo de licena se d apenas durante a execuo de
uma tarefa.

Para iniciar a utilizao do Schedule:

1) Acesse o mdulo Configurador > Ambientes > Schedule > Schedule:
2) Na viso inicial, selecione Schedule.
3) Clique em Iniciar todos os servios.
4) O processo de monitoramento das tarefas do Schedule ser iniciado.
Automaticamente, o arquivo de configurao do Microsiga Protheus
alterado. As chaves includas no arquivo .INI so:

[ONSTART]
RefreshRate=180
jobs=_SCHDMANAG,_SCHDQUEUE

[_SCHDMANAG]
Main=_SCHDMANAG
Environment=<Ambiente Protheus>

[_SCHDQUEUE]
Main=_SCHDQUEUE
Environment=<Ambiente Protheus>

Para que as tarefas possam ser executadas, necessrio que exista

um agent cadastrado com a empresa equivalente.
Para configurar os agents:
1) Acesse Schedule > Agent > Cadastro.
O novo Schedule permite que agents sejam adicionados
automaticamente.
Na Barra Superior, em Adicionar Agent (+) adiciona um agent para
cada empresa existente no cadastro de empresas.
Cada agent cadastrado j vem configurado com duas threads.
possvel verificar os status dos agents clicando na Legenda.
possvel incluir agents manualmente. Para isso, clique no cone (+)
localizado na janela inferior. Alm disso, nesta mesma barra, tambm
possvel solicitar alterao e excluso (x) de um agent.

Pgina 38
 Importante:
recomendvel que seja utilizado sempre o endereo IP e no o
alias de rede. Ex.:
Correto: 172.16.75.160,
No recomendvel: maquina.

Cadastro de Agendamentos
1) Para cadastrar agendamentos, acesse Agendamentos, Cadastro.
2) No cadastro de agendamentos possvel importar os registros do
Schedule antigo para o novo Schedule. Clique na primeira opo da
tela "Importar agendamentos antigos" .
Importante:
A importao realizada apenas uma vez. Para isso as tabelas do
Schedule antigo, SX4 e SXM, so alteradas. includo um campo
chamado X4_IMPORT ou XM_IMPORT respectivamente, que sinaliza se o
registro foi ou no importado.
3) Na Barra Superior da pasta Detalhes possvel adicionar (+),
alterar (lpis) e excluir (x) um agendamento.
4) Para selecionar uma rotina, posicione o cursor sobre o campo
Rotina e, em seguida, clique no boto de interrogao (?).
5) Aps informar a rotina, se ela estiver dentro dos padres
determinados para agendamento, ser necessrio informar os
parmetros. Se a tela de parmetros no se abrir automaticamente
basta clicar em Parmetros.
6) Para agendar um processo especial (que no esteja dentro dos
padres de Schedule), basta informar a rotina e informar os parmetros
entre parnteses para que sejam lidos. Ex.: u_teste( par01, par02 ).
7) O novo Schedule possibilita a seleo de mais de uma empresa e
filial para a execuo de tarefas durante o cadastramento de um
agendamento.
O campo Empresa/Filial possui recurso de pesquisa de opes para
facilitar o preenchimento. Este campo permite selecionar mltiplas
Empresas/Filiais para preenchimento.8) Para agendar uma rotina,
preciso informar o mdulo que ser utilizado para a execuo. Esse
mdulo pode ser informado diretamente (se o usurio souber o cdigo
relacionado), ou pode ser feita uma pesquisa ativando-se o F3 do
campo.
9) Para informar uma recorrncia para um agendamento, clique em
Recorrncia, localizado na janela inferior dessa viso.
10) Para recorrncia existem cinco tipos:

Pgina 39
 Diria: informe o perodo de dias a ser considerado, assim como
o nmero de execues por perodo, o intervalo e a data de trmino, se
houver.
Semanal: informe os dias da semana a serem considerados,
assim como o nmero de execues por perodo, o intervalo e a data
de trmino, se houver.
Mensal: informe o ms a ser considerado, assim como o nmero
de execues por perodo, o intervalo e a data de trmino, se houver.
Anual: informe o ano a ser considerado, assim como o nmero de
execues por perodo, o intervalo e a data de trmino, se houver.
Sempre ativo: Esta opo mantm a rotina agendada em
funcionamento contnuo at a data de trmino, se houver.
11) Para informar a quantidade de execues em um mesmo dia,
existe os campos:
Nmero de Execues no mesmo dia;
Intervalo e
Execues.
Alm de informar a quantidade de execues preciso indicar o
intervalo entre elas. O mnimo permitido de 15 minutos.
12) O recurso Execues, exibe em uma lista a hora de cada execuo.
13) Para essa recorrncia pode ser informado que existe uma data de
trmino ou no.
14) Para realizar filtros no browse onde os agendamentos so exibidos,
utilize a opo de filtro, localizado na parte superior do browse.
15) possvel realizar buscas no browse a partir da opo Buscar
localizada acima do browse de agents.
16) Esse mesmo cadastro pode ser realizado por meio das prprias
rotinas. Mas, para isso o usurio deve possuir permisso de
agendamento e gerao de arquivo no servidor.
17) O cadastro segue o mesmo princpio.

11. GATILHOS
O Gatilho permite ao usurio estabelecer uma atualizao dinmica
dos dados atravs da definio de critrios, isto , a partir da digitao
de um dado possvel atualizar automaticamente outros campos.

Pgina 40
Procedimentos
Para definir um gatilho:
1) No menu principal, selecione as opes "Base de Dados" +
"Dicionrio" + "Gatilhos";
So apresentados alguns gatilhos j cadastrados utilizados pelo prprio
Sistema.
2) Clique em "Incluir" e preencha os campos conforme descrio.

Campo Nome do campo que ao ser alterado inicia o processo de

atualizao.
Seqncia Nmero seqencial gerado pelo sistema para cada
gatilho.
Cnt. Nome contra-domnio, ou seja, campo que dever ser
Domnio atualizado automaticamente.
Tipo Selecione o tipo do gatilho, sendo:
P - Primrio para atualizaes visuais e externas do
mesmo arquivo.
E - Estrangeiro para atualizaes de dados em outros
arquivos.
X - Posicionamento para posicionar o arquivo mencionado
no Alias sem efetuar nenhuma atualizao. Utilizado para
casos em que o usurio deseja estabelecer um
relacionamento entre os arquivos.
Regra Expresso em linguagem AdvPL a ser transportada para o
contra-domnio.
Posiciona Selecione a opo "Sim" para movimenta o ponteiro em
outro arquivo com base na expresso definida em
PROCURA. (SEEK), ou "No", caso contrrio.
Alias Alis do arquivo. As 3 letras iniciais do arquivo cujo
ponteiro deve ser movimentado.
Ordem Nmero da chave de ndice a ser utilizada para
movimentao do ponteiro.

Pgina 41
Procura Expresso em linguagem que determina o
posicionamento do ponteiro (SEEK).
Condio Informe a condio, Execblocks, etc, que iro determinar
quando o gatilho deve ser executado.

Importante:
Os gatilhos trabalham com valores que foram carregados na
memria, a linguagem ADVPL diferencia os valores em
memria com M->. Assim o campo C6_QTDVEN ser
referenciado no gatilho como M->C6_QTDVEN.
Mas ao acessar dados j gravados de outras tabelas,
utilizamos o alias da tabela e o nome do campo. Assim,
B1_PRV1 ser referenciado como SB1->B1_PRV1.

Exerccio 22 Criando Campos para utilizao em Gatilhos:

1) Crie um campo virtual no SD1, para utiliz-lo no gatilho;
Campo: D1_NOME
Tipo: Caracter
Tamanho: 30
Contexto: Virtual
Propriedade: Visualizar
Ttulo: Descrio
Descrio: Descrio do Produto
2) O Campo deve ser utilizado em todos os mdulos;
3) Ordene o campo para a posio 4;
4) Finalize a criao do Campo.

Exerccio 23 Criando Gatilhos

1) Crie dois gatilhos de acordo com os dados abaixo:
Campo: D1_COD
Sequncia: 002
Cnt. Domnio: D1_NOME
Tipo: Primrio
Regra: SB1->B1_DESC
Posiciona: SIM
Alias: SB1

Pgina 42
 Ordem: 1
Chave: XFILIAL("SB1")+M->D1_COD

Campo: D1_VUNIT
Sequncia: 001
Cnt. Domnio: D1_TOTAL
Tipo: Primrio
Regra: ROUND(M->D1_QUANT*M->D1_VUNIT,2)
Posiciona: NO

Exerccio 24 Testando o novo Gatilho:

1) Acesse o Mdulo de Compras;
2) Selecione as seguintes opes Atualizaes + Movimentos +
Documento Entrada;
3) Clique no boto Incluir e informe os dados observando os campos
disparador e alvo do gatilho.

12. ATUALIZAO PROGRAMADA DOS DICIONRIOS DE DADOS

Com o objetivo de facilitar o processo de atualizao dos dicionrios de

dados, o administrador poder programar o horrio da atualizao
automtica, utilizando o recurso Agendar Atualizao.
Ressalta-se que o processo de atualizao deve ser utilizado em modo
exclusivo; ou seja, nenhum usurio poder utilizar o Sistema durante a
realizao do processo. Se no momento agendado, o sistema estiver
sendo utilizado, a atualizao automtica no ser efetuada e outra
data dever ser agendada. Quando o usurio estiver com o sistema
aberto, porm sem processos em uso por inatividade time out, o
Sistema realizar o processo normalmente.

Pgina 43
Procedimentos
Para agendar uma atualizao:
1) No menu principal, selecione as opes "Base de Dados" +
"Dicionrio" + "Base de Dados". O Sistema apresenta a janela browse
relacionando o dicionrio de dados do Sistema, ou seja, todas as
tabelas utilizadas.
2) Clique em "Agendar Atualizao". O Sistema apresenta a janela
Gerenciador de Base de Dados - Agendar Atualizao.
3)Pre encha os seguintes campos e confirme;
Data de incio - Informe ou selecione a data que a atualizao
da base de dados deve ser realizada.
Horrio de incio - Informe o horrio que a atualizao da base
de dados deve ser realizada.

Ser apresentada a janela Atualizao programada do dicionrio de

dados com a definio da data e hora para o inicio da atualizao, o
assistente ficar aberto aguardando o horrio programado da
atualizao.

Importante:
A janela de assistente dever ficar aberta para a atualizao.
Nesta janela a hora atual e a programada podem ser
visualizadas. Se desejar cancelar a atualizao, clique em
"Cancelar".

13.MASHUPS
No ambiente web, so divulgadas diversas informaes com acesso
irrestrito, que possibilitam consultas informaes de interesse
pblico. Pensando em permitir o aproveitamento dessa disponibilidade,
a TOTVS desenvolveu o recurso de Mashup.
A estrutura da soluo de Mashup proposta, permite acessar o
contedo desejado e inserir automaticamente no cadastro do Microsiga
Protheus que acionar o recurso.

Pgina 44
Para efetuar a pesquisa e a atualizao, basta fornecer as informaes
solicitadas e que foram pr-configuradas pelo Administrador no
ambiente "Configurador". Desta forma, os demais dados sero
inseridos automaticamente, formulando um registro completo e
atualizado de acordo com o contedo online.

Para ativar o recurso.

1) No menu Ambiente, escolha a opo Cadastros e depois
Mashups;
2) Clique no boto Incluir, ser exibida a tela abaixo:

3) No menu Aes relacionadas, escolha a opo Mashups, o

Configurador ir pesquisar no Site da Totvs pelos Mashups disponveis:

4) A seguir sero exibidos os Mashups disponveis:

5) Escolha um Mashup e confirme;

6) Na tela inicial, com o mashup j escolhido, informe um alias do
Protheus;
7) No menu Aes relacionadas, escolha Parmetros;

Pgina 45
8) Na tela abaixo informe os campos que sero enviados ao Mashups e
quais campos recebero os retornos:

Importante:
Os Mashups so servios providos por sites de terceiros. A
responsabilidade sobre as informaes prestadas pertence aos
mesmos.

Exerccio 25 Testando Mashups

Defina a consulta de CEP pelo Google e CPF pela Receita Federal nos
Mashups
Inclua um cliente pessoa fsica no cadastro de clientes do mdulo
Faturamento e clique no boto Mashups para preencher
automaticamente os campos Bairro, Nome, Cidade e estado, preencha
o campo Nome fantasia com a situao do CPF.

14. GRUPOS DE CAMPOS (SXG)

O Protheus contm em seu dicionrio vrias tabelas que so
compartilhadas entre diversos mdulos, tais tabelas contm campos
cujos tipos e tamanhos devem ser coerentes entre mdulos e rotinas.
Quando houver a necessidade de alterar o tamanho de um desses
campos, o procedimento comum seria bastante trabalhoso e
demandaria um tempo invivel dependendo do tamanho da base.
Para simplificar esse processo, o Protheus tem o conceito de grupos de
campos, onde possvel alterar os campos de diversas tabelas
relacionadas de uma nica vez.

Para alterar o grupo de campos:

1) No menu Base de dados, selecione Dicionrio e Base de
dados;
2) Na opo Dicionrio esquerda, clique em (+) para expandir a
opo Grupo de campos;

Pgina 46
3) Escolha o grupo que deseja alterar, altere o tamanho e confirme;
4) Clique no boto Atualizar para que o configurador atualize todo o
dicionrio e tambm as tabelas do banco de dados.

Importante:
As opes de grupos de campos envolvem apenas campos
caracteres. A alterao de campos numricos podem envolver
rotinas de clculos que exigem que campos relacionados
tenham o mesmo tamanho. Caso tenha necessidade de alterar casas
decimais, por exemplo, abra um chamado na Totvs para verificar essa
possibilidade e quais as tabelas envolvidas.

Exerccio 26 Alterando um grupo de campos

Altere o grupo Parcela, aumentando para 2 o tamanho do campo.

Pgina 47