2.

CONFIGURADOR
2.1 Famílias de arquivos;
2.2 Arquivos Customizadores;
2.4 Mapeamento de Arquivos;
2.5 Parâmetros do Sistema;
2.10 Explorando o Dicionário de Dados do Sistema;
2.11 Explorando o uso de Gatilhos no Sistema;

Flexibilizar sem despadronizar.

Esta é a palavra de ordem das Ferramentas do Protheus.
Há várias técnicas, para se customizar um sistema, no sentido de adaptá-lo às necessidades de
cada usuário.
No Protheus , utilizamos algumas Ferramentas que facilitam a Personalização do Sistema, sem que
seja necessário, como ponto de partida, alterações em fontes de programas.
Essas Ferramentas são denominadas (Arquivos Customizadores), e tem por finalidade, facilitar as
manutenções do Sistema.

Assim, podemos resumir a Hierarquia de Customizações em:

• Parâmetros (SX6);
• Dicionário de Dados (SX3);
• Tabelas Genéricas (SX5);
• Tabelas (Arquivos);
• Expressões nos Próprios Campos (Validações) (SX3);
• Fórmulas (SM4);
• Criação de Funções (Customizações) (VsCode);
• Relatórios;
• Pastas Cadastrais;
• Consultas Padrões (SXB);
• Perguntas e Respostas (SX1);
• Sequência de Documentos (SXE e SXF);
• Modelo de Entidade e Relacionamento (MER – ver figura);
• Schedule de Processos (SX4 – Via módulo Configurador);
• Pontos de Entradas (Consulta ao Portal do Cliente com SenhaP ou Suporte telefonico);
• Integrações (Excel, Word, Crystal Report, Rest. SOAPUI, Workflow, etc...).

SX1 Perguntas e Respostas

SX2 Mapeamento de Tabelas
SX3 Dicionário de Dados
SX4 Agenda do Schedule de Processos
SX5 Tabelas
SX6 Parâmetros
SX7 Gatilhos
SX9 Relacionamento entre Tabelas *
SXA Pastas Cadastrais apontadas no SX3
SXB Consulta por meio da tecla F3 (Consulta Padrão)
SXD Controle do Schedule de Processos
SXE Seqüência de Documentos (+1)
SXF Seqüência de Documentos (próximo)
SXG Tamanho padrão para campos *
SXK Respostas das Perguntas (SX1) por Usuário *
SXO Controle de LOGs por Tabela *
SIX Índices dos Arquivos
.XNU Menu de Opções dos Módulos

* Estas tabelas são de uso e controle interno do sistema, recomenda-se não alterá-las a não ser que seja
absolutamente necessário

Perguntas e Últimas Respostas (SX1)

O Arquivo de Perguntas e Últimas Respostas (SX1), armazena Parâmetros Voláteis, ou seja, que
são normalmente alterados a cada processamento.
Desta forma, são apresentados na própria execução de cada programa, para que o próprio usuário
Os ajuste.
As Respostas são gravadas em Disco, de modo que se transformam sempre no (Default) do próximo
processamento.
Normalmente são utilizados em Relatórios, para que os usuários possam parametrizar as
informações
que devem ser impressas e também em Rotinas de Processamentos, para definir o que deve ser
executado pelo sistema em relação àquela opção.

Dicas BrasilErp: Estas perguntas são criadas geralmente ao se desenvolver relatórios e são
cadastrados através do aplicativo “apsdu” que será muito utilizado na em programação ADVPL

Mapeamento de Arquivos (SX2)

Esse arquivo é o responsável por todo o Compartilhamento ou Exclusividade existente nas Tabelas
do Protheus, tais como: Cadastros, Movimentos, etc...
É ele também quem direciona o sistema, para realizar a leitura no diretório onde estão localizados
os arquivos do Banco de Dados, possibilitando assim, a criação de várias Bases de Dados, para
testes e outras finalidades.

Dicas BrasilErp: Este é um dos primeiros arquivos a serem analizados ao se efetuar a visita a um
cliente. Daqui temos as dicas de como as regras de negócio da empresa trabalham no sistema

Dicionário de Dados (SX3)

O Objetivo deste arquivo é permitir a Flexibilização da Base de Dados, através da
Inclusão de Novos Campos, sua Alteração, Inibir o seu Uso e até Criar Novas Tabelas, que passam
a ser parte integrante do sistema.
Definir em que Pasta de Cadastro, os campos deverão se posicionar e até mesmo modificar o
posicionamento de campos, que já faziam parte do sistema antes das Customizações.
Para tal, ao invés dos programas tratarem explicitamente os campos no fonte, tudo é realizado
através de leituras ao Dicionário de Dados.
Cada registro do Dicionário de Dados, corresponde a um campo de cada tabela no sistema.
Todos os Processamentos, em especial, as telas de Cadastramentos, Consultas e Relatórios
Genéricos, são baseados no seu conteúdo.
Tamanhos, Tipos, Pictures, Legendas, Validações, Níveis de Acessos, Inicializações, Contextos
Reais ou Virtuais, Usos ou Não Usos, Obrigatoriedades, Ordens de Apresentações, Help´s e
Consultas via <F3>, são Propriedades definidas no Dicionário de Dados e passíveis de alteração
pelo próprio Administrador.
Diz-se que o Dicionário de Dados é ativo, porque ao alterá-lo, não é necessário recompilar nenhum
programa, para que a modificação entre imediatamente em funcionamento.
Schedules de Processos (SXD e SX4)
Este dois arquivos são responsáveis pelo controle de rotinas previamente configuradas para serem
executadas automaticamente através do Schedule de Processos, como por exemplo: Relatórios,
Rotinas do sistema, etc...
O (Arquivo – SXD) será o responsável por controlar os agendamentos definidos e o
(Arquivo – SX4) é quem controlará a agenda de processos, ou seja, os dias e
horários programados para a execução das tarefas.

Tabelas (SX5)
O Arquivo de Tabelas - SX5 - são mini-arquivos armazenadores de Dados
Específicos de cada Empresa e tem como finalidade Customizar Situações, que dependam de um
conjunto de registros que dificilmente necessitarão de alterações, tais como: Tipificar os Produtos,
os Grupos, os Tipos de Notas Fiscais, os Pagamentos, Feriados, etc.
Isso facilita o preenchimento dos campos pelo usuário e ao mesmo tempo faz a respectiva validação
quanto a informação digitada no mesmo.
Dicas BrasilErp: Entenda que essas tabelas tem o objetivo de armazenar informações comuns aos
usuários que difícilmente serão alterados ao longo do tempo (Ex.: Tipos de Produtos – MP, PA, PI,
MC, etc)

Parâmetros (Sx6)
A maneira mais primitiva de se Customizar um sistema é através de Parâmetros.
A Movimentação de Cálculo de Custos On-Line, é um exemplo bem característico.
Esta Movimentação, se por um lado traz vantagens indiscutíveis do ponto de vista gerencial, do
outro tem problemas técnicos relacionados à Performance, Seqüência de Digitação e Cancelamentos
de Movimentações.
Assim, deve-se sempre dar ao usuário a decisão de adotá-la ou não.
Uma solução:
Cria-se um Parâmetro, neste caso, denominado (MV_CUSMED), e dependendo do seu Conteúdo
(M – Mensal ou O – On-Line), há nos Programas condições que validam o conteúdo destas
variáveis, ativando ou inibindo as respectivas Movimentações dentro do Sistema.
Os Parâmetros compõem o (Arquivo – SX6) e atendem aos mais variados Tipos de Customização e
podem ser analisados no Módulo Configurador.
É uma Forma Engessada de Customização, pois qualquer alteração em programa depende de
mudanças nos fontes, além de deixar confusa a Lógica dos Programas.
Mas é válida em muitas circunstâncias.
O Protheus tem uma totalidade de parâmetros que devem ser todos cuidadosamente
configurados de acordo com as Regras de Negócios de cada Empresa.

Gatilhos (SX7)
Os gatilhos são disparados quando se digita alguma informação nos Campos das Telas de Entradas
de Dados, ou seja, trata-se da atualização de campos dependentes na tela de digitação a partir do
preenchimento de um Campo Origem, obedecendo uma determinada Regra, para tal preenchimento.
Muitas vezes, para que a Regra atenda a determinadas situações pode-se desenvolver Funções em
ADVPL e chamá-las através das Regras dos gatilhos
Com ela, em todos os Campos onde se pode escrever uma Expressão, é possível
evocar-se uma Função, cujo retorno definirá o seu Conteúdo.

Dicas BrasilErp: Resumindo : <Enter> em um campo para preencher outro campo e/ou outros
campos

Pastas Cadastrais (SXA)

Trata todas as Pastas Cadastrais, utilizadas nas Telas de Cadastros e Movimentações
no Protheus , através deste arquivo é possivel configurar os campos que deverão
aparecer dentro de cada uma das Pastas, além da possibilidade da criação de outras
Pastas, além das originais, com a finalidade de distribuir de maneira prática os campos entre elas,
para melhor aproveitamento durante seus respectivos cadastros realizados pelos usuários.

Consultas Padrões (SXB)

É ele quem define o modelo do (Combo Box), que será utilizado no momento em que o Usuário
acionar a tecla <F3> ou clicar na ícone , sobre campos que possuam ligação com alguma
Tabela do Sistema.

Sequências de Documentos (SXE e SXF)

Este dois Arquivos são os responsáveis pelo armazenamento dos Seqüências de Campos
Núméricos, como por exemplo: Códigos de Cadastros, Numeração de Notas Fiscais, enfim,
qualquer Campo que deva seguir uma Numeração Seqüêncial.
O fato de existirem dois Arquivos ao invés de um, segue a seguinte Estrutura:
O (Arquivo – SXF) sempre controla o próximo (Número da Sequência) e o (Arquivo – SXE), grava
sempre mais um, isso garante mair segurança no momento da Geração destas sequências.

Dicas BrasilErp: Dê atenção ao parâmetro “EnableNumber” na sessão [License Server] do arquivo

mp8srv.ini em \bin\server\. Se ele estiver com valor 0 (zero) o controle da numeração está nos
arquivos SXE/SXF, se estiver 1 o controle será efetuado pelo HardLock do sistema

Chaves de Índices (SIX)

Este arquivo é responsável pelas Chaves Primárias e Chaves Estrangeiras dos arquivos do Sistema.
Através dele é possível configurar novas Chaves de Índices, para as Novas Tabelas que forem
criadas, além da possibilidade de criar Novos Tipos de Pesquisas, para os cadastros.

Relacionamento entre Arquivos (SX9)

É o arquivo que documenta todo o Relacionamento entre as Tabelas do Protheus , no que diz
respeito a (Arquivos de Domínio e Contra-Domínio), ou seja, o (M.E.R. – Modelo de Entidades e
Relacionamentos).

Funções
De forma análoga, e considerando que toda (Opção de Menu) do Protheus 8 é na
verdade uma Função, é possível se desenvolver: Novos Relatórios, Consultas,
Cadastros e mesmo, Sub-Módulos e acessá-los diretamente através do Menu.
Chegado a este ponto, pode-se dizer que o único recurso que ainda faltaria, para se ter uma
Flexibilização Completa, seria o Acesso aos Fontes.
Isto foi resolvido, em parte, com os (Pontos de Entradas).

Linguagem de Programação ADVPL

Até aqui, falamos em Customizações, que não envolvem Códigos de Programação.
São importantes, porém Limitadas quando se quer algo mais específico.
O AdvPl, por sua vez, é uma Linguagem Estruturada que, embora compilada, é tratada pelo Sistema
como uma Função, e armazenada em um Arquivo Binário denominado Repositório de Objetos
(RPO).
Sempre que um usuário acessa algum módulo do sistema, automaticamente é realizada
uma carga dinâmica deste RPO, desta forma todos os recursos existentes nesse arquivo serão
disponibilizados, para execução imediata.

Tabelas Especiais
Algumas Tabelas embora não façam parte das tabelas oficiais de parametrizações do sistema são
importantes neste capítulo porque permite a parametrização de algumas partes no sistema pelos
conhecimentos do próprio usuário

Fórmulas (SM4)
Nos Cadastros de Fórmulas (SM4), armazena-se Expressões definidas pelo usuário, e que são
chamadas nos Pontos do sistema, onde cada usuário necessitar de uma Fórmula Proprietária.
Por exemplo:
No “Pedido de Vendas”, onde pode-se determinar a “Fórmula de Reajuste de Preços” entre a
“Emissão do Pedido de Vendas” e a “Data da Emisão da Nota Fiscal”, ou ainda na “Folha de
Pagamento”, onde cada “Verba”, tem seu próprio “Cálculo”.
As Fórmulas, têm ainda a vantagem que, em casos de muitas repetições, como as Fórmulas de
Cálculo do Prazo de Entrega e do Estoque de Segurança, cadastra-se uma Única Vez e repete-se o
Código nos Diversos Produtos.

Lançamentos Padronizados (SI5 – Contabilidade, CT5 – Contabilidade Gerencial)

De forma similar ao Arquivo de Fórmulas, mas sem ter um passo intermediário, pode-se também,
em vários pontos do sistema, escrever uma (Expressão), diretamente no Campo.
Tal ocorre no Arquivo de Lançamentos Padronizados (SI5), nos seus campos (Débito, Crédito,
Histórico e Valor).
Sua aplicação é simples, seja ela através da implementação de Macros, onde as
mesmas farão referência às Tabelas e Campos do Sistema ou através de programas com (Lógicas)
mais complexas.

Da mesma forma, nos Campos de Validação do Usuário e Inicializador Padrão do Dicionário de

Dados, na Folha de Pagamento, para criar Cálculos Específicos de Vencimentos, Descontos e
Encargos, na Planilha de Formação de Preço de Venda, nas Células da Planilha Excel, nas Regras
dos Gatilhos, etc.

Pontos de Entradas
São Chamadas colocadas em lugares estratégicos dos programas e que, originalmente, não fazem
nada.
Assim que o usuário necessitar de uma intervenção neste ponto, cria-se uma (Rotina), dá-se a ela o
nome do Ponto de Entrada, citado na documentação do Protheus e compila-se o programa.
Ao passar por ela, esta (Rotina) é executada.
Claro está que, quem escreve rotinas em Pontos de Entradas, precisa saber muito bem, sobre a
Lógica do Programa em questão e mesmo qual a Situação da Memória naquele momento.
No Portal do Cliente através do “SenhaP” os inumeros Pontos de Entradas, são detalhadamente
documentados.

Integrações
Além das ferramentas originais de customização do Protheus, podemos mencionar mais recursos
que resolvem muitos casos de forma mais rápida e prática.
São as integrações com o (Crystal Report, Excel, Word, etc).

Excel
A Integração com o Excel, nada mais é do que a possibilidade de se inserir nas Células desta
Planilha, User Functions desenvolvidas em ADVPL, à semelhança das Macros em Visual Basic.
Como as User Functions tem acesso à Base de Dados do sistema e podem fazer processamentos
ilimitados, fica fácil perceber como este recurso pode integrar as duas ferramentas.
A Ferramenta Excel, precisa ser chamada, a partir do menu de algum Módulo do Protheus.

Word
A integração com o Word é a mais simples de todas, pois utiliza apenas chamadas em variáveis do
Protheus, sem necessariamente utilizar funções da MICROSIGA.
Essa ferramenta é muito utilizada em integrações com a Folha de Pagamento, na elaboração de
Documentos dos Módulos de Qualidade, etc...

Crystal Report
A integração com a Ferramenta Crystal Report é semelhante, ou seja, pode-se chamar User
Functions desenvolvidas em (Linguagem de Programação – ADVPL), na geração dos Gráficos e
Relatórios desenvolvidos com esta ferramenta.

Project
A integração do MS-Project é realizada, através do Módulo de PCP, quando se gera a Carga de
Máquina (MRP II) ou com outros Módulos como por exemplo WMS e OMS (Logística), para a
Elaboração de Projetos.

M.E.R. Modelo de Entidades e Relacionamento

O Modelo de Entidades e Relacionamentos é um modelo abstrato cuja finalidade é descrever, de
maneira conceitual, os dados a serem utilizados em um Sistema de Informações ou que pertencem a
um domínio. Ou seja, é a regra adotada pelo Protheus para identificar suas Milhares de Tabelas e
informações.
De forma muito simples, identificamos o significado das informações apenas lendo os dois
primeiros dígitos das tabelas criadas pelo Protheus, conforme a figura abaixo:

SA - Cadastros SO - Assist. Técnica

SB - Estoques SP - Ponto Eletrônico
SC - Previsões de E/S SQ - Recr. e Seleção
SD - Mov. De Estoque SR - Folha de Pagto
SE - Financeiro ST - Manut. Industrial
SF - Fiscal SU - Telemarketing
SG - Estruturas SV - Concessionárias
SH - Carga de Máquina SW e SY - Export./Import.
SI - Contábil Q? - Qualidade (Celerina)
SJ - Estatísticas R? - Recursos Humanos
SM - Miscelâneas SZ,QZ,RZ - Livres
SN - Ativo Fixo P? - Projetos Especiais
CT - Contábil Gerencial

Há também arquivos que armazenam dados especiais, como script de planilhas, senhas, helps,
menus, consultas etc., normalmente em formato texto.
São eles:
SIGAMAT.CFG Número de Estações
SIGAADV.HLP Help de Campos
SIGAADV.HPR Help de Programas
SIGAMAT.EMP Empresas
SIGAMAT.ALC Alçadas e Solicitações de Compras
SIGAFIS.MAG Livros Fiscais Magnéticos
SIGAADV.PSS Senhas
SIGAMAT.DEP Depuração
SIGAMAT.ACS Acessos
SIGAMAT.IND Índice do SIGAMAT.EMP
Temos ainda outros arquivos com extensões que também fazem parte do Protheus, os quais
estão relacionados a seguir:
.#DB Backup
.REL Relatórios
.DUP Script de Duplicata
.PDV Planilha de Custos
.NF2 Script da Nota Fiscal
.PLN Planilhas
.RPG Script do RPG
.DRV Drivers de Impressoras
.REM Envio de Transmissão Bancária
.RET Recebimento de Transmissão Bancária
.FAT Script de Fatura
.IMP Configurações de Importação de Dados
.LOG Arquivo TTS
.PRW e .PRX Programas em ADVPL e RDMAKE
Os demais arquivos contendo os dados dos usuários propriamente ditos ficam armazenados no
diretório padrão “\DATA\” e podem ser analisados no arquivo “Sx2 – Drivers e Diretórios de
Arquivos. O conteúdo de cada arquivo pode ser analisado no arquivo “Sx3 – Dicionário de Dados.
Caso os arquivos não existam no diretório que foram indicados, serão criados na abertura do
sistema.

2.3 Criação de Empresas (Inicialização da empresa oficial);

O usuário pode criar novas empresas/filiais numericamente até o limite de (99). Cada nova empresa
equivale a um jogo de arquivos próprios.
As empresas também podem ser criadas com códigos alfa-numéricos, extendendo o gerenciamento
para até (1.296 empresas) e com até (1.296 filiais).
O Protheus possibilita a sua utilização em empresas de todos os portes com a garantia da
integridade de seus dados.
Em casos de grupos de empresas, os arquivos do sistema podem ser utilizados por uma ou mais
empresas, conforme a definição disponível em sua tela. Dessa forma, será possível acessar os
menus mais rapidamente.

Autorização de Emergência
Caso a liberação para o uso da empresa não possa ser efetuada imediatamente, pode-se recorrer à
senha de emergência. Esta senha é apenas temporária e terá validade apenas durante o dia em que
foi digitada, ou seja, 24 horas.

Como utilizar a Autorização de Emergência :

1. Selecione as seguintes opções: “Senhas” + “Autoriz. Emergência”;
2. Clique na opção [+] da opção “Empresas”;
3. Posicione o cursor sobre a opção “Inf. Corporativas” e clique no botão “ (Lâmpada
Vermelha)” que será habilitado na barra de ferramentas.

2.6 Configuração de Menus;

2.8 Configuração de Acessos e Restrições;

Os Menus do sistema podem ter suas opções reformuladas de maneira que cada Usuário possa
ter um menu de acesso próprio, de acordo com o tipo de trabalho por ele desenvolvido.
Neste programa, deve ser definido um menu para cada usuário e na configuração de senhas,
associase o menu à senha do usuário que determinará quais módulos, movimentações, empresas
e filiais ele poderá acessar.
Como criar Menus para os Usuários:
1. Selecione as seguintes opções: “Ambiente” + “Cadastros” + “Menus”;

Como default são selecionados todos os menus, pois o objetivo é demonstrar que podemos
utilizar opções de outros menus e gerarmos um menu totalmente modificado.

2. Desmarque a opção “Todos os Menus”;

3. Marque apenas a opção “Faturamento” com um duplo clique e confirme;

A opção “Configurar” permite a criação de menus de usuários em diretórios específicos,

para facilitar a manutenção dos mesmos e preservar os menus padrões do Protheus.
Os diretórios devem ser previamente criados abaixo da raiz do Protheus, para que possam
ser “visualizados” pelo Sistema.

4. Confirme, clicando em “Ok”;

Teremos dois lados de menus: à esquerda, teremos o “menu origem” e, da direita, teremos
o menu “destino”, isto é, com as modificações já efetuadas;
Quando criamos opções específicas, recomenda-se criar um grupo intitulado
“Específicos” previamente, pois isto garantirá que as adequações sejam inseridas aí.
5. No lado esquerdo, posicione sobre a opção “ Faturamento” e, no lado direito,
posicione em “ Atualizações”;
6. Clique em “Adicionar” e aguarde;
7. No lado direito, selecione “ Atualizações” e em seguida, clique em “Novo Grupo”;
8. Digite “Específicos”, para Inglês, Português e Espanhol e confirme;
9. Clique em “Atualizações” + “Cadastros” + “Bancos”;
10. Clique em “Remover”;
11. Repita os procedimentos de 09 a 10 para a opção “Naturezas” e “Moedas”;
12. Remova os seguintes grupos: “Cenário de Vendas”, “CRM - Adm de Vendas”, “CRM
- Contratos” e “Diversos”;
Suponhamos que na sua Empresa, o Depto. de Faturamento tenham duas pessoas com
funções distintas. Então, removemos opções de uma e mantemos habilitados da outra, para
que cada uma tenha um menu de acordo com suas funções.
13. Selecione “Cadastros” + “Produtos” e em seguida, clique em “Detalhes”;
14. Desmarque as seguintes opções: “3, 4 e 5”, que se referem a “Incluir”, “Alterar” e
“Excluir”, respectivamente. Confirme;
15. Clique em “Gerar” e informe “MENUFAT” e confirme;
16. Retornando à tela de seleção de menus, clique em “Cancelar”.

Como criar Menus para os Usuários, acrescentando novos itens:

1. Selecione as seguintes opções: “Ambiente” + “Cadastros” + “Menus”;
Como default são selecionados todos os menus, pois o objetivo é demonstrar que podemos
utilizar opções de outros menus e gerarmos um menu totalmente modificado.
2. Desmarque a opção “Todos os Menus”;
3. Marque apenas o menu criado anteriormente, “Menufat.xnu” e confirme;
4. Posicionado ao lado esquerdo da tela, em Menufat, clique em “Adicionar” e
aguarde;
5. Selecione “Atualizações” + “Específicos” e em seguida, clique em “Novo Item”;
6. Na tela “Descrição”, no campo “Português”, informe “NovoFat”;
7. No campo “Modulos”, selecione o “Módulo de Faturamento”;
8. No campo “Tipo”, selecione “Função de Usuário”;
9. No campo “Programa”, preencha com “TSTSZ1” e confirme;
10. Na área de Tabelas, selecione “SZ1” e confirme;
11. Para finalizar, clique no botão “Gerar” e informe “MENUFAT”;
Será apresentado mensagem para regravação do menu.
12. Clique em “Fechar” e novamente em “Fechar”, e por último em “Cancelar”.
Dicas:
• Note que na tela onde se encontram todos os Menus, o “Menufat” acaba de ser criado
como última opção, pronto para ser utilizado;
• Os arquivos de menu passam a ser em formato XML, e sua extensão é XNU convertidos
automaticamentes, isto permite que a subdivisão dos menus seja ampliada possibilitando
diversos níveis hierárquicos.

2.7 Configuração de Usuários e Grupos;

O Protheus trabalha com o conceito de senhas de usuário, ou seja, a senha será validada pelo
(Nome + Senha do Usuário), e não apenas pela sua senha.
A opção Senhas de Usuário deve ser utilizada para restringir o acesso às movimentações do
sistema, direcionar a gravação dos relatórios em disco e configurar drivers de impressão
específico para um usuário/grupo.
O Protheus permite reunir usuários em grupos, para facilitar a atribuição de direitos e restrições.
Neste caso, o acesso será sempre verificado de acordo com o maior nível de direito, ou seja, se
um grupo não tiver acesso a um determinado módulo, mas o usuário sim, irá prevalecer o acesso
do usuário.
Caso o usuário não tenha acesso a um módulo, mas seu grupo possua, prevalecerá o direito de
acesso do grupo e o mesmo terá o acesso permitido.

Como cadastrar usuários:

1. Selecione as seguintes opções: “Usuário” + ”Senhas” + ”Senhas de Usuário”;
2. Posicione o cursor sobre a opção “ (Usuários)” e clique no botão “ (Incluir)”;
3. Preencha os dados da pasta “Identificação” com as informações relacionadas ao
“Usuário”;
4. Na pasta “Restrições”, marque a opção “Autorizado a Alterar Senha”;
5. Na pasta “Outras informações”, informe os dados solicitados;
6. Clique sobre o botão “Detalhes” e marque “Todas as Empresas e Filiais” no rodapé
da tela;
7. Agora, desmarque todos o módulos no rodapé da tela, dê um duplo clique no módulo
“Faturamento”, ative o item “Acesso” e confirme;
8. Na tela de “Módulos”, dê um duplo clique na opção “Faturamento”;
Obs.:
Será apresentado uma tela de configuração de menus e nível de usuário.
9. Habilite a opção “Acesso”, pressione a tecla <Tab> e, em seguida, configure a linha
de diretório como: “System\menufat.xnu” e confirme;
10. Na pasta “Impressão”, defina o tipo de impressão em disco e clique no botão “Ok”;
11. Encerrada a configuração do novo usuário, confirme a sua criação clicando nas
seguintes opções “Ok”, botão (Salvar) e (Sair);
12. Agora faça o teste com este usuário, acessando o “Módulo de Faturamento” com o
novo usuário.
Dicas:
• Podemos imprimir todos os detalhes da configuração dos Usuários, clicando no botão
(Relatório de Configurações dos Usuários), existente na barra de ferramentas do
cadastro;
• Na pasta “Segurança”, tem-se a opção de configurar o Log de operações no sistema,
mas lembre-se de que se trabalhará em conjunto com o parâmetro MV_LOGSIGA, no qual
o padrão de aplicação é determinado;
• A utilização de qualquer um destes LOGs pode acarretar a perda de performace,
especialmente nos LOGs de INCLUSÃO. Utilize-o apenas em análise específica.
Para saber sobre Criação de Usuários, do Módulo Configurador, posicione na opção e pressione a
tecla <F1>. Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-
lo.

Grupos de Usuários
A criação de Grupos de Usuários tem a finalidade de facilitar a administração de um determinado
número de usuários que possuam as mesmas características dentro do Sistema, ou seja, que
possuam o mesmo perfil de acesso.
Como cadastrar Grupos de Usuários:
1. Selecione as seguintes opções: “Usuário” + “Senhas” + “Senhas de Usuário”;
2. Posicione o cursor sobre a opção “ (Grupos)”;
3. Clique no botão “ (Incluir)” e informe o novo grupo como “Faturamento”;
4. Clique na opção “Detalhes”, marque “Todas as Empresas”;
5. Confira os dados e confirme clicando no botão “Ok”;
6. Clique na opção “ (Usuários)”;
7. Selecione o “Usuário” criado anteriormente, clique no botão ” (Alterar)” + CONFIGURADOR
“Grupos”;
8. Posicione o cursor sobre o grupo “Faturamento”;
9. Clique no botão “Adicionar”;
10. Confira os dados e confirme o cadastro de “Grupos de Usuários”, clicando no botão
“Ok” e confirmando duas vezes;
11. Clique no botão “ (Salvar)”, para gravar as configurações + “ (Sair)”;
12. Realize o teste no “Módulo de Faturamento”.
Dicas:
• Para saber quantos usuários cada grupo possui, basta selecionar o grupo desejado e
clicar na opção “Alterar”, localizada na barra de ferramentas. Note que existe um espaço
reservado para os nomes de cada usuário adicionado dentro dos grupos;
• Está disponível nesta versão a opção de “Relatório de Configuração do Usuário”. Este
relatório permite que você verifique as informações do usuário por “Usuário” ou “Grupo”;
• Lembre-se que para incluir usuários em um determinado grupo, deve-se acessar o
“Cadastro de Usuários” e informar o grupo ao qual ele irá pertencer.
Para saber sobre Grupos de Usuários, do Módulo Configurador, posicione na opção e
pressione a tecla <F1>. Será apresentado o Help do Programa esclarecendo a sua finalidade
e como executá-lo.

2.9 Criação e Manutenção de Tabelas;

Criando Novos Campos:

1. Selecione as seguintes opções: “Base de dados” + “Dicionário” + “Base de dados”;
2. Posicione o cursor sobre a opção “ (Dicionário de Dados)” do lado esquerdo da tela;
3. Clique no botão " (Pesquisar)", informe “SB1” no campo “Procurar por:” e confirme clicando no
botão “Procurar”;
4. Agora, clique no botão “ (Editar)”, clique na opção “ (Campos)” do lado esquerdo da tela;
5. Clique no botão “ (Incluir)” e informe os dados a seguir:
Campo: B1_COR
Tipo: Caracter
Tamanho: 2
Formato: @!
Contexto: Real
Propriedade: Alterar
6. Na pasta “Informações”, informe os dados a seguir:
Título: Cor
Descrição: Cor do Produto
Help: Digite a cor do produto

7. Na pasta “Opções”, informe os dados a seguir:

Inic. Padrão: "01"
Cons. Padrão: 90 - Cores

8. Na pasta “Validações”, informe os dados a seguir:

Val. Usuário: EXISTCPO("SX5","90"+M->B1_COR)
9. Na pasta “Uso”, marque as seguintes opções “Obrigatório”, ”Usado” e “Browser”.
10 Na pasta “Módulos”, deixe a opção “Utilizado por todos os Módulos” marcada e confirme;
11. Agora, encontre o campo criado no browser do lado direito, posicione o cursor sobre
ele e clique no botão “ (Ordenar)”;
12. Encontre-o novamente na tela de ordenação, clique utilizando o botão “Mover Acima”,
para posicioná-lo no local desejado dentro do cadastro e confirme;
13. Clique na opção “ (Pastas)”, localizada no lado esquerdo da tela, clique na linha
“Cadastrais” e em seguida no botão “ (Editar)”;
14. Posicione o cursor sobre a opção “ (Campos)” e clique no botão “ (Adicionar)”;
15. Marque com um “X” o campo –B1_COR”, através de um duplo clique e confirme até voltar à
tela que contenha a opção de “Pastas Cadastrais”;
16. Confirme a tela de “Edição Tabela de Dados - SB1”.
17. Clique no botão “ (Atualizar Base de Dados)” e confirme;
18. Assim que o sistema encerrar a atualização, clique no botão “ (Sair)” para encerrar
a criação do campo.

Como criar Novos Campos, utilizando a lista de opções e uma validação:

1. Selecione as seguintes opções: “Base de Dados” + “Base de Dados”;
2. Posicione o cursor sobre a opção “ (Dicionário de Dados)” ao lado esquerdo da tela;
3. Clique no botão “ (Pesquisar)”, informe “SA1“, no campo “Procurar por:” e confirme clicando no
botão “Procurar”;
4. Agora, clique no botão “ (Editar)”, clique em (+) e em seguida clique na opção “ (Campos)”,
ambos ao lado esquerdo da tela;
5. Clique no botão “ (Incluir)” e informe os dados a seguir:
Campo: A1_FIDELI
Tipo: Caracter
Tamanho: 1
Formato: @!
Contexto: Real
Propriedade: Alterar

6. Na pasta “Informações”, informe os dados a seguir:

Título: Prom.Fidel.?
Descrição: Promoção Fidelidade?
Criado em: XX/XX/XX Projeto: Faturamento
Indique se o cliente faz ou não parte da
Help: promoção Fidelidade.

7. Na pasta “Opções”, informe os dados a seguir:

Lista Opções: S=Sim;N=Não
Inic. Padrão: "N"

8. Na pasta “Validações”, informe os dados a seguir:

Val. Usuário: PERTENCE("SN")
9. Na pasta “Módulos”, deixe a opção “Utilizado por todos os módulos” marcada e
confirme;
10. Localizado na última linha (último registro), estará o campo recentemente criado,
posicione o cursor sobre ele e clique no botão “ (Mover para cima)”, até que o
mesmo fique na ordem “166”;
11. Clique na opção “ (Pastas)”, localizada ao lado esquerdo da tela e em seguida no
botão “ (Incluir)”;
12. Preencha os campos “Descrição” (Português, Inglês e Espanhol) com “Específicos”;
13. Posicione o cursor sobre a opção “ (Campos)” e clique no botão “ (Adicionar)”;
14. Marque com um “X” o campo “A1_FIDELI” através de um duplo clique e confirme
até voltar a tela que contenha a lista das pastas cadastrais;
15. Confirme a tela de “Edição Tabela de Dados - SA1”.
16. Clique no botão “ (Atualizar)” e confirme;
Obs.:
• Será apresentado o wizard com o resumo da atualização efetuada nos dicionários.
Clique em “Avançar” para prosseguir as alterações;
• Para visualizar os detalhes das modificações que fizemos, basta clicar em (+).

17. Assim que o Sistema finalizar as atualizações, clique no botão “Sair” para encerrar a
criação do campo.

Como criar chaves de pesquisa para novos campos:

1. Selecione as seguintes opções: “Base de dados” + “Dicionário” + “Base de Dados”;
2. Posicione o cursor sobre a opção “ (Dicionário de Dados)” do lado esquerdo da
tela;
3. Clique no botão “ (Pesquisar)”, informe “SA1” no campo “Procurar por:” e confirme
clicando no botão “Procurar”;
4. Clique no botão “ (Editar)” e na opção “ (Incluir)” do lado esquerdo da tela;
5. Selecione a opção “ (Índices)”, localizada a esquerda da tela, clique no botão
“ (Incluir)” e informe os dados a seguir:
Chave: A1_FILIAL+A1_FIDELI
Descrição: Prom. Fidel.?
6. Confira os dados e confirme o cadastro do “Novo Índice”;
7. Clique no botão “ (Atualizar Base de Dados)” e confirme;
8. Assim que o sistema encerrar a atualização, clique no botão “ (Sair)” para encerrar.

Dicas:
• Sempre que efetuamos uma “Alteração no Dicionário de Dados”, o sistema gera, por
motivos de segurança, uma cópia automática dos dados. Essa cópia recebe a extensão
“#DB” para bases DBF e “BKP” para banco de dados, como por exemplo o “SQL”;
• Sempre que a cópia é finalizada, pode-se consultar todo o processo realizado pela
atualização da base através da opção “Log”, localizada na barra de ferramentas, durante
a movimentação de “Atualização dos Dados”;
• O campo “Modo de edição”, na pasta “Campos”, tem por finalidade definir quando um
determinado campo estará ou não dispónivel para preenchimento, de acordo com uma
regra (função) informada no mesmo;
• O campo “Inic. Browser” define se o conteúdo do campo estará ou não disponível para
visualização no browser do cadastro quando ele possuir o contexto “Visual”, de acordo
com a regra (função) informada neste campo.
Para saber sobre Dicionários de Dados (Sx3), do Módulo Configurador, posicione na opção
e pressione a tecla <F1>. Será apresentado o Help do Programa esclarecendo a sua
finalidade e como executá-lo.

Como efetuar testes relativos aos campos criados, utilizando a Tabela:

1. Acesse o “Módulo de Faturamento”;
2. Selecione as seguintes opções: “Atualizações” + “Cadastros” + “Produtos”;
3. Clique no botão “Incluir” e informe os dados a seguir:
Código: 10020001
Descrição: Caixa de Madeira
Tipo: PA (F3 Disponível)
Cor: 02 (F3 Disponível)
Unidade: UM (F3 Disponível)
Armazém Pad.: 01
Preço Venda: 25,00
4. Confira os dados e confirme o cadastro de “Produtos”.
Exercício 13 - Como verificar campos criados, utilizando a lista de opções:
1. Selecione as seguintes opções: “Atualizações” + “Cadastros” + “Clientes”;
2. Clique no botão “Incluir” e informe os dados a seguir:
Código: 000001
Loja: 01
Nome: Cliente Padrão 01
N. Fantasia: Padrão 01
Tipo: R = Revendedor
Endereço: R. Catracas, 241
Município: São Paulo
Estado: SP (F3 Disponível)
Prom.Fidel.? S=Sim

3 Confira os dados e confirme o cadastro de “Clientes”.

Dica:
Sempre que o exercício possuir a opção <F3> nos campos, significa que poderemos realizar
uma consulta ao arquivo ou tabela relacionado. Através da tecla <F3> ou por meio do
ícone “lupa”, localizado ao lado direito do campo.
Para saber sobre o Dicionário de Dados e Manutenção dos Arquivos do Sistema, do Módulo
de Configurador, posicionado na rotina, pressione a tecla <F1>. Será apresentado o Help
do Programa, esclarecendo a sua finalidade e como executá-lo.
Consultas-padrão (SxB)
Por meio desta opção pode-se criar as consultas-padrão utilizadas nas telas de cadastros de
movimentações, para que seja possível a consulta e inclusão de registros em campos através da
tecla <F3> ou do botão em que o campo estiver relacionado.

Como Incluir Consultas-padrão:

1. Selecione as seguintes opções: “Base de Dados” + “Dicionário” + “Base de Dados”;
2. Clique em “ ” (Consultas Padrão) e em seguida, clique na opção “ (Incluir)”,
no topo da tela;
Obs.:
Será apresentado um wizard para seleção da consulta a ser incluída.
3. Na tela a seguir, mantenha marcada a opção “Consulta Padrão” e do lado direito da
CONFIGURADOR Protheus - 29
Anotações:
tela prencha os campos conforme os dados a seguir:
Cosulta ESPSA1
Descrição Português/Inglês/Espanhol Cliente Fidelidade
4. Clique no botão ”(Avançar)” e no campo procurar, informe: “SA1”;
5. Marque a opção “Habilitar Inclusão” e clique em “Avançar”;
6. Na tela de índices, clique no “botão (Adicionar Índice)”;
7. Escolha a opção “A1_FILIAL+A1_FIDELI” e confirme;
8. Posicione sobre a linha do índice e, do lado direito da tela, clique no botão “
(Adicionar Coluna)”;
9. Clique no ícone “ Consultar Campos” e em seguida, selecione “A1_COD”,
confirmando a operação;
10. Repita os passos 8 a 9 para os campos A1_NOME e A1_FIDELI;
11. Clique em “Avançar”;
12. Na área de seleção do “Retorno” clique no icone “ (Adicionar Retorno)” para
preenchimento do campo “expressão”;
13. Clique no ícone “ Consultar Campos” e posicione sobre o item “SA1->A1_FIDELI”,
confirme e em seguida em “Finalizar”;
14. Posicionado na última consulta (será a que criamos recentemente) e em seguinda
clique em "Preview", localizado na barra de ferramentas.

2.12 Segurança de dados do sistema através de LOGs;

Nas tabelas existe uma opção que permite a visualização do campo de LOG e as informações
sobre o usuário que realizou a inclusão, alteração ou exclusão de determinados registros.
Será registrada a data da operação e o status do registro (excluído ou ativo).
Para que o arquivo passe a ter este controle, é necessário que sejam criados no Módulo
Configurador os campos (XX_USERLGI) e (XX_USERLGA), que indicam, respectivamente, a
inclusão, alteração ou exclusão de determinados campos.
As duas primeiras posições do campo “XX” representam as iniciais utilizadas para todos os
campos do arquivo.

Como criar Campos para a Consulta de Log de Registros:

1. Selecione as seguintes opções: “Base de dados” + “Dicionário” + “Base de Dados”;
2. Posicione na pasta “ (Dicionário de Dados)”, clique no botão " (Pesquisar)",
informe no campo Procurar por:”, o “Arquivo – SA1” e clique no botão “Procurar”;
3. Assim que o arquivo for encontrado, clique no botão “ (Editar)”, posicione na opção “ (Campos)”,
clique no icone “ (Campos Reservados)”;
4. Na tela que se apresenta deixe o campo “Log de Inclusão” marcado e pressione “Finalizar”;
Obs: Verifique que o campo “A1_USERLGI” foi criado automaticamente.
5. Clique novamente no icone “ (Campos Reservados)”;
6. Na tela que se apresenta marque o campo “Log de Alteração” e pressione “Finalizar”;
Obs: Verifique que o campo “A1_USERLGA” foi criado automaticamente.
7. Confirme a inclusão dos novos campos e clique no botão “ (Atualizar Base de
Dados)”;
8. Confira os dados, confirme a tela de “Manutenção da Estrutura” e assim que o
processo estiver encerrrado, saia do cadastro.
Para saber sobre Log de Registros, do Módulo Configurador, posicione na opção e pressione
a tecla <F1>. Será apresentado o Help do Programa esclarecendo a sua finalidade e como
executá-lo.

Como criar Registros para Consultas ao Log de Registros:

1. Acesse o “Módulo de Faturamento”;
2. Selecione as seguintes opções: “Atualizações” + “Cadastros” + “Clientes”;
3. Clique no botão “Incluir” e informe os dados a seguir:
Código: 100000
Loja: 01
Nome: Cliente 10000
N. Fantasia: Cliente 10000
Tipo: R = Revendedor
Endereço: Av. Braz Leme, 1369
Município: São Paulo
Estado: SP (F3 Disponível)

4. Confira os dados, confirme o cadastro de clientes e informe os dados a seguir:

Código: 20000
Loja: 01
Nome: Cliente 20000
N. Fantasia: Cliente 20000
Tipo: R = Revendedor
Endereço: Rua Cândido de Assis, 51
Município: São Paulo
Estado: SP (F3 Disponível)

5. Confira os dados, confirme o cadastro de clientes e cancele a próxima inclusão.

6. Posicione o cursor sobre o cliente “2” e clique no botão “Excluir”;
7. Confira os dados e confirme a “Exclusão”;
8. Acesse o “Módulo Configurador”;
9. Selecione as seguintes opções: “Usuário” + “Senhas” + “Log de Registros”;
10. Selecione o arquivo –SA1” e confirme;
11. Posicione o cursor sobre os registros e clique no botão “Visualizar”, para verificar os
conteúdos dos campos.

• Note que o registro cadastrado está com o seu status na cor verde e o que foi excluído,
está com o status na cor vermelha;
• Quando clicamos na opção “Visualizar”, conseguimos obter as informações sobre o
usuário que realizou a última alteração no registro selecionado.
Para saber sobre:
• Clientes, do Módulo de Faturamento, posicione na opção e pressione a tecla <F1>. Será
apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
• LOG de Registros, do Módulo Configurador, posicione na opção e pressione a tecla
<F1>. Será apresentado o Help do Programa esclarecendo a sua finalidade e como executálo.

Consultas aos Arquivos Log

O Protheus controla o número de acessos, inclusões, alterações em arquivos, páginas de
relatórios
impressos e transações por usuário, gerando um arquivo-texto diário que irá conter todas as
informações quanto a essas movimentações.
Para que o Controle de Log seja acionado, devem ser configurados os seguintes Parâmetros:
MV_DIRLOG: indica o diretório no qual será gerado o Arquivo de Log;
MV_LOGSIGA: indica quais operações serão tratadas pelo Controle de Log.

O padrão do Protheus é (N)ÃO. Para ativar essa opção, deve-se colocar a letra
(S)IM, de acordo com as seguintes posições:
“S” 1 – Acesso a funções;
“S” 2 – Inclusões;
“S” 3 – Alterações;
“S” 4 – Relatórios;
“S” 5 – Transações (TTS);
“S” 6 – Envio de e-mail;
“S” 7 – Parâmetros.
Dicas: No tipo “6”, o Sistema irá realizar o controle de e-mails enviados e no “7” o Sistema
irá ::gravar toda alteração dos parâmetros dos relatórios. Esta consulta poderá ser realizada
através do “Módulo Configurador”, na opção “Log do Usuário”.

Como configurar a geração da Consulta de Arquivo Log:

1. Selecione as seguintes opções: “Ambiente” + “Cadastros” + “Parâmetros”;
2. Clique no botão " (Pesquisar)", informe no campo “Pesquisar por:” o parâmetro
“MV_DIRLOG” e confirme pressionando o botão “Procurar”;
3. Assim que o “Parâmetro” for encontrado, clique no botão “ (Editar)” e no campo
“Conteúdo”, informe “\SPOOL\”;
4. Confira os dados e confirme a “Alteração”;
5. Clique novamente no botão " (Pesquisar)", informe no campo “Pesquisar por:”, o
parâmetro “MV_LOGSIGA” e confirme clicando no botão “Procurar”;
6. Assim que o “Parâmetro” for encontrado, clique no botão “ (Editar)” e no campo
“Conteúdo”, informe “SSSSSSS”;
7. Confira os dados, confirme a “Alteração” e clique no botão “ (Sair)”;
8. Saia do “Módulo Configurador” e acesse outro módulo qualquer;
9. Execute algumas movimentações, inclusões, alterações ou exclusões;
10. Retorne ao “Módulo Configurador”;
11. Selecione as seguintes opções: “Empresas” + “Arquivos” + “Consulta Arq. LOG”;
12. O sistema apresentará uma tela para consultas ao arquivo de Log.
13. Pode-se realizar um filtro da consulta, selecionando a data, o usuário, a empresa/
filial, o módulo, o tipo de transação e o arquivo.
14. Clique no botão “Visualizar” no lado direito da tela e analise o resultado da consulta.
15. Em seguida, selecione o botão “ (Imprimir)”, marque a opção em disco e
confirme;
16. Analise o relatório gerado com base nos dados a seguir:
Número de Posições Informação
01 Tipo de Registro:
O Início de Operação de um Módulo
C Fim de Operação de um Módulo
S Início de Operação de uma Função
F Fim de Operação de uma Função
B Início de Transação (Begin Transaction)
E Fim de Transação (End Transaction)
I Inclusão de um Registro em Arquivo
A Alteração de um Registro em Arquivo
R Emissão de Relatório
99 Código da Empresa
01 Código da Filial
03 Sigla do Módulo
15 Identificação do Usuário
08 Nome do Programa (Opção no Menu de Acesso)
06 Horário Início ou Final do Processo
10 Número de Registro utilizado ou se for relatório, informa o Número de Páginas
03 Alias do Arquivo alterado
14 Código de Identificação Interna do Protheus
08 Dispositivo de Saída (LPT1, COM1, etc...)
08 Reservado para uso futuro

O arquivo gerado localiza-se no diretório informado no parâmetro “MV_DIRLOG” e

apresenta a estrutura a seguir: “SL+<DD/MM/AA>.LOG”.