Configurador do Protheus (SIGACFG): o que é e o que se faz nele

O Configurador é o módulo do Protheus onde se decide como o sistema se comporta, e não onde se lança movimento. É nele que se cadastra usuário, se monta menu, se cria tabela e campo, se ajusta parâmetro e se desliga um ponto de entrada. A documentação da TOTVS o descreve como a principal ferramenta de apoio ao desenvolvimento e personalização dos módulos integrados do sistema.

Para entrar, abra o SmartClient, informe SIGACFG no campo Programa inicial e confirme. Depois vem o login normal, com usuário e senha.

O menu do Configurador é organizado por assunto: Usuário, Ambiente e Base de Dados concentram o dia a dia. Comece pela linha do que você veio fazer:

A TOTVS escreve a entrada do dicionário de duas formas: as páginas de tabela e de edição de arquivo usam Base de Dados > Dicionário > Arquivos; as de campo, índice e consulta padrão usam Base de Dados > Dicionário > Base de Dados (algumas, Bases de Dados). Os tutoriais de campo da série seguem o roteiro da página de edição de arquivo: Arquivos, Editar na tabela e a pasta Campos. Os demais repetem o caminho da página que citam.

Cada caminho e cada código de rotina é o que a página da TOTVS sobre aquela tarefa indica; onde a coluna Rotina está vazia, a página mostra só o caminho. As páginas estão nas referências, no fim do artigo.

Quem opera tende a ficar nas linhas de Usuário e Ambiente: liberar acesso, trocar o menu de alguém, limpar o profile de uma tela que quebrou. Quem desenvolve passa mais tempo no dicionário, onde a tela do Configurador permite criar e ajustar tabelas, campos, índices e consultas.

Criar ou alterar campo, tabela ou índice no Configurador não muda o banco na hora. A alteração fica no dicionário e só segue para o banco quando alguém roda Atualizar Base de Dados, em Base de Dados > Dicionário > Base de Dados, dentro do Dicionário de Dados da empresa. O índice tem um passo a mais: segundo a TOTVS, ele só passa a constar na estrutura da tabela no banco depois que algum processo ou rotina abre essa tabela (detalhes no artigo de índices). A TOTVS documenta três regras da atualização:

• Alteração de estrutura exige modo exclusivo. Incluir campo, alterar título, excluir campo: essas mudanças só são gravadas se nenhum usuário estiver usando o sistema. Com gente conectada, a rotina avisa e deixa avançar sem gravar.
• O que não foi gravado fica pendente. O Protheus guarda as alterações não gravadas num arquivo temporário. Na próxima entrada em Base de Dados, ele avisa e oferece restaurá-las. Se a resposta for Não, elas são descartadas e não voltam mais.
• Antes de gravar, ele faz backup. Em modo exclusivo, a rotina faz um backup de segurança, grava e mostra ao final o que foi alterado.

Na prática: mudança de dicionário se planeja para uma janela sem usuários, e não no meio do expediente.

A série segue a ordem em que o assunto se aprende: primeiro o ambiente, depois quem entra nele, depois o dicionário de dados, campo por campo.

Ambiente

Para quem precisa levar uma foto para o cadastro, pôr uma rotina no menu, corrigir a tela de um usuário, entender um número que pulou ou desligar uma customização.

2. Repositório de imagens: como levar fotos para dentro do Protheus
3. Menus do Protheus: como incluir uma rotina customizada no módulo
4. Manutenção de profile: quando a tela quebra só para um usuário
5. Controle de numeração: quando o próximo número sai da sequência
6. Catálogo de personalizações: desligar um ponto de entrada sem recompilar

Usuários e segurança

Para quem libera acesso: senha, abas do cadastro de usuário, privilégios e o rastro de quem mexeu em cada registro.

7. Política de senhas no Protheus: as regras que valem para todo usuário
8. Cadastro de usuários no Protheus: o que cada aba decide
9. Privilégios no Protheus: a diferença entre não permitido e negado
10. Log de registros: quem incluiu e quem alterou um cadastro

Dicionário de dados: tabelas

Para quem vai criar uma tabela customizada e precisa saber onde o dicionário guarda cada coisa.

11. Dicionário de dados do Protheus: o mapa das tabelas SX
12. Grupo de campos: aumentar um campo em todas as tabelas de uma vez
13. Tabela customizada no Protheus: as faixas SZ e Z e o modo de acesso
14. Campos reservados: log de inclusão e alteração, bloqueio e imagem

Dicionário de dados: campos

Para quem vai criar um campo e precisa escolher o tipo certo e saber o que ele grava no banco.

15. Os cinco tipos de campo do Protheus e o que cada um grava no banco
16. Campo caractere: código sequencial, máscara e validação
17. Campo data: o que a tela mostra e o que o banco grava
18. Campo numérico: tamanho, decimais e a máscara
19. Campo lógico: o checkbox do dicionário
20. Campo memo: texto longo que o SQL não lê direto
21. Campo combo: a lista de opções em valor=descrição
22. Campo real ou virtual: o contexto decide se ele existe no banco

Dicionário de dados: o comportamento do campo e da tela

Para quem quer que o campo nasça preenchido, valide, trave, preencha outro campo ou apareça na pasta certa.

23. Inicializador padrão e de browse: quando cada um roda
24. Validação de campo: ExistCpo, NaoVazio, Positivo e a função própria
25. Modo de edição (X3_WHEN): quando o campo pode ser editado
26. Pastas e agrupamentos: organizando a tela do cadastro
27. Índices no Protheus: filial primeiro e nickname em tabela padrão
28. Gatilhos no Protheus: como um campo preenche outro
29. Testando a tabela criada: a primeira tela de cadastro

Listas, parâmetros, perguntas e consultas

Para quem precisa de uma lista fixa, de um parâmetro, da tela de perguntas de um relatório ou da lupa de um campo.

30. Tabelas genéricas (SX5): listas fixas sem criar tabela nova
31. Parâmetros (SX6): como criar e ler um MV_ customizado
32. Perguntas (SX1): o grupo de perguntas de relatórios e rotinas
33. Consulta padrão (F3): como criar a lupa de um campo

Fechamento

Para conferir procedures instaladas e resolver cinco situações do Configurador, cada uma com uma consulta.

34. Stored procedures no Protheus: instalar, conferir e quando usar
35. Cinco situações do Configurador, com a consulta que resolve cada uma

Para não trocar de assunto a cada artigo, a série usa um cenário só: uma transportadora que precisa de um cadastro de motoristas. Ele vira a tabela customizada ZA1, com código sequencial, nome, data de nascimento, idade calculada por gatilho, tipo de vínculo, curso MOPP e observação, além dos campos reservados de bloqueio, foto e log. A rotina que abre esse cadastro, U_ZA1CAD, entra no menu do Faturamento, e o pedido de venda ganha um campo para informar o motorista.

Quando um artigo precisa de tabela, campo, gatilho, consulta ou parâmetro customizado de exemplo, ele sai desse cenário. Os nomes são fictícios e não existem no dicionário padrão.

Se o termo “dicionário”, “alias” ou “filial” ainda não é familiar, o glossário do Protheus resolve antes de seguir.