Você está na página 1de 44

Configurador

Pgina 1

Sumrio
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
Pgina 2

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
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).

\BIN\SMARTCLIENTE_ACTIVEX

Destinado aos arquivos para acesso via Web.

\BIN\SMARTCLIENT

Executveis, bibliotecas e arquivos de configurao


(.INI) do sistema.

\BIN\APPSERVER

Executveis, bibliotecas e arquivos de configurao


(.INI) do sistema.

\BIN\APPSERVER\ACE_9.99

Arquivos de configurao e bibliotecas para acesso aos


arquivos SX's.

\BIN\TOOLS

Onde so encontradas as ferramentas para


manuteno do sistema

\CPROVA

Destinado para a gravao dos lanamentos analticos

Pgina 5

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
PROJECTS\SAMPLES\SOURCE

Fontes para exemplos de funes ADVPL.

\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)

SX2

Manuteno dos Arquivos

SX3

Manuteno dos Campos

Pgina 7

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.

Pgina 8

H tambm arquivos que armazenam dados especiais, como script de planilhas, senhas,
helps, menus, consultas etc. So eles:
SIGAHLP.HLP

Help de Campos

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.

Pgina 9

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.

Grupo de
Empresas

Conjunto de Empresas que esto ligadas entre si por 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 de
Negcio

Conjunto de filiais que esto dentro da mesma 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.
Pgina 10

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:

Empresa
EMP01

Filial Matriz Filial 00

Grava os campos XXX_FILIAL com


EMP0100

Empresa
EMP01

Filial SP

Filial 01

Grava os campos XXX_FILIAL com


EMP0101

Filial 02

Grava os campos XXX_FILIAL com


EMP0102

Filial 03

Grava os campos XXX_FILIAL com


EMP0103

Empresa
EMP01
Empresa
EMP01

Filial RJ
Filial TO

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:

0-9

Somente nmeros entre 0 e 9

5-9

Somente nmeros entre 5 e 9

A-Z

Somente caracteres entre A e Z

X-Z

Somente caracteres entre X e Z

!-!

Qualquer dgito numrico ou alfanumrico

A,B,5,9

0-9

Somente nmeros entre 0 e 9

A-Z

Somente caracteres entre A e Z

Somente caracteres entre A,B,5 e 9

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 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:

Pgina 15

GRUPO: ZZTST
Ord Pergunta

Tipo

Tam. Formato

01

Cdigo de?

Caracter

6 @!

02

Cdigo At?

Caracter

6 @!

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;

4) O sistema apresentar o arquivo solicitado, posteriormente clique no boto Editar;


5) Altere os modos de acesso por empresa, unidade ou filial;

Pgina 16

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:
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;
Pgina 17

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.
No coloque NickName em tabela criadas, essa opo s ser utilizada em tabelas
padro do sistema.

Pgina 18

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
Pgina 19

Help:Criao: Especificao resumida do produto, quanto sua cor ou espessura.


Uso: Usado e Browse
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.

Pgina 20

Exemplo de tabela genrica:

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.

Descrio

Informe a descrio da tabela em cadastro, identificando seu


contedo.

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


5. Preencha os campos chave e descrio e confirme.
Pgina 21

Importante:
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. English:

Colors

Desc. Spanish:

Colores

2) Cadastre os itens para a tabela genrica:


Chave

Descrio

Desc. Spanish Desc. 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 22

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:

Pgina 23

Campo

B1_ZZCOR

Tipo

Caracter

Tamanho

Formato

@!

Contexto

Real

Propriedade

Alterar

Ttulo

Cor

Descrio

Cor do Produto

Help

Digite a cor do produto

Inic. Padro

"01"

Cons.
Padro

ZC - Cores

Val. Usurio

EXISTCPO("SX5","ZC"+M->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

Formato

@!

Contexto

Real

Propriedade

Alterar

Ttulo

Prom.Fidel.?

Descrio

Promoo Fidelidade?

Help

Indique se o cliente faz ou no parte da promoo


Fidelidade.

Inic. Padro

"N"

Lista Opes

N=No;S=Sim

Val. Usurio

Pertence(SN)

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;
4) Crie um ndice cuja chave deve ser A1_FILIAL+A1_ZZFIDEL;
Pgina 24

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;
5) Defina Filtros e Retornos esperados para essa consulta e confirme.

Pgina 25

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;
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;

Pgina 26

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 27

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;
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;

Pgina 28

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;
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
Pgina 29

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;
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 30

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 31

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 32

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;
3) Altere tambm o parmetro MV_LOGSIGA e no campo Contedo, informe
SSSSSSS;

Pgina 33

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.
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.
Pgina 34

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:
Manager

componente responsvel por fazer o gerenciamento das 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.

Execute

so os componentes responsveis por fazer a execuo das 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.
Pgina 35

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.
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
Pgina 36

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:

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:
Pgina 37

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.

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.


Pgina 38

Cnt. Domnio

Nome contra-domnio, ou seja, campo que dever ser 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 contradomnio.

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.

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
Pgina 39

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
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.
Pgina 40

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.

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.

Pgina 41

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.
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:

Pgina 42

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;
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.

Pgina 43

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;

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 44