5. 6. 7. 8. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24.
Clique nas seguintes opção: “ Atualizações” , no botão “Novo Grupo” , digite “ Teste Menu” e confirme; Do lado esquerdo da tela, selecione as seguintes opções: “ Atualizações” e cli que no botão “ Adicionar” ; Selecione as opção “ Consultas” e clique no botão “ Adicionar” ; Posicione o cursor sobre a tela do lado direito, selecionando a opção “ Cadastros + Produtos” e cli que no botão “ Detalhes” ; No campo “ Módulos” , selecione o “ Módulo de Faturamento” ; Na tela de “ Rotinas do Browser” , desmarque com um duplo clique o “ X” das opções “ 3, 4 e 5” e confirme; Selecione a opção “ Grupo de Produtos” e clique no botão “ Detalhes” ; No campo “ Módulos” , selecione o “ Módulo de Faturamento” ; Na tela “ Status” , marque “ Desabili tado” e confirme; Selecione a opção “ Unidades de Medidas” e clique no botão “ Detalhes” ; No campo “ Módulos” , selecione o “ Módulo de Faturamento” ; Na opção “ Status” , marque “ Inibido” e confirme; Posicione o cursor sobre a opção “ Teste Menu” do lado direit o da tela, clique na opção “ Novo I tem” e configure-o da seguint e maneira: Na tela “ Descrição” , no campo “ Português” , informe “ Novo” ; No campo “ Modulos” , selecione o “ Módulo de Faturamento” ; No campo programa, preencha com “ TSTSZ1” e confirme; Para finalizar, clique no botão “ Gerar” ; Crie o “ Novo Menu”, com o nome de “ NovoFat” e confirme; Clique em “ Fechar” e novamente em “ Fechar” , e por últ imo em “Cancelar” .
Obs.:
Note que na tela onde se encontram todos os Menus, o “ Novofat” acaba de ser criado como última opção, pronto para ser utili zado. 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. Para saber sobre Criação de Menus, do Módulo Configurador, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finali dade e como executá-lo.
Anotações:
CONFIGURADOR Protheus - 31
Senhas e Usuários 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óri os 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 determi nado 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.
Exercício 18 – Como cadastrar usuários:
1.
Selecione as seguintes opções: “ Usuári o” + ” Senhas” + ” Senhas de Usuári o” ;
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 Fil iais” no rodapé da tela; 7. Na tela de “ Módulos” , dê um duplo clique na opção “ Faturamento” , configure a li nha de diretóri o como: “ Sigaadv\ Novofat.mnu” e confir me; 8. Agora, desmarque todos o módulos no rodapé da tela, dê um duplo cli que no módulo “ Faturamento” , ati ve o it em “ Acesso” e confir me; 9. Na pasta “ Impressão” , defina o tipo de impressão em disco e clique no botão “ Ok” ; 10. Encerrada a configuração do novo usuári o, confirme a sua cri ação clicando nas seguintes opções “ Ok” , botão (Salvar) e (Sair); 11. Agora faça o teste com este usuário, encerrando o sistema e acessando o “ Módulo de Faturamento” com o novo usuário.
Anotações:
32 - CONFIGURADOR Protheus
Dicas:
Podemos imprimir todos os detalhes da configuração do usuário, 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 confi gurar 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 . 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.
Exercício 19 – Como cadastrar Grupos de Usuários:
1.
Selecione as seguint es opções: “ Usuário” + “ Senhas” + “ Senhas de Usuári o” ;
2.
Posicione o cursor sobre a opção “
3.
Clique no botão “
4. 5. 6.
Clique na opção “ Detalhes” , marque “Todas as Empresas” ; Confira os dados e confirme clicando no botão “ Ok” ; Clique na opção “ (Usuários)” ;
(Grupos)”;
(Incluir)” e informe o novo grupo como “ Faturamento” ;
7.
Selecione o “Usuário” criado anteriormente, clique no botão ” (Alterar)” + “Grupos”; 8. Posicione o cursor sobre o grupo “ Faturamento” ; 9. Clique no botão “ Adicionar” ; 10. No rodapé da tela marque a opção “ Priorizar Configurações do Grupo”;
Anotações:
CONFIGURADOR Protheus - 33
11. Confira os dados e confirme o cadastro de “ Grupos de Usuári os” , clicando no botão “ Ok” e confirmando duas vezes; 12. Clique no botão “
(Salvar)”, para gravar as configurações + “
(Sair)” ;
13. 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 “ Alt erar” , localizada na barr a 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ór io de Configuração do Usuári o” . Este relatório permite que você verifique asinformações do usuário por “ Usuário” ou “ Grupo” . Lembre-se que para incl uir usuários em um determinado grupo, deve-se acessar o “ Cadastro de Usuári os” 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 . Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
O que você aprendeu neste capítulo Neste capítulo aprendemos a criar menus, senhas de acesso ao sistema e grupos de usuários. Além disso, vimos como é realizada a relação entre as senhas e menus.
Próximo Passo No próximo capítulo, iremos aprender como incluir uma nova imagem dentro do configurador com extensões (*.JPEG) e (*.BMP).
Anotações:
34 - CONFIGURADOR Protheus
REPOSITÓRIO DE I MAGENS O que você irá aprender neste capítulo Veremos como incluir uma nova imagem dentro do confi gurador com extensões (*.JPEG) e (*.BMP).
Rotinas Abordadas Módulo Configurador: • Repositóri o de Imagens.
Repositório de Imagens Esta opção tem por fi nalidade selecionar imagens existentes em diretórios específicos e associálas ao repositório de imagens do Protheus, para que futuramente seja relacionado aos produtos cadastrados e também ao cadastro de funcionário do Módulo de Gestão de Pessoal.
Exercício 20 – Como cadastrar Imagens no Repositório de Imagens:
1. Selecione as seguintes opções: “ Ambiente” + “ Cadastr os” + “ Reposit. Imagens” ; 2. Clique no botão ” (Incluir)” e localize um diretório que possua osarquivos do tipo “ .JPEG” ou “ .BMP” ; 3. Como exemplo, poderemos utili zar o diretório “ \ SIGAADV\ ” que se localiza na pasta raiz do Protheus; 4. Confira os dados e confirme clicando no botão “ Ok” . Obs.:
Note que o sistema irá trazer uma tela que possui ícones de auxílio para que se possa disponibili zar os arquivos “ .BMP” ou “ .JPEG” .
Para saber sobre Cadastros de Imagens, do Módulo Configurador, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finali dade e como executá-lo.
Anotações:
CONFIGURADOR Protheus - 35
Exercício 21 – Como associar Imagens aos Produtos:
1. 2. 3.
Acesse o “Módulo de Faturamento” ; Selecione as seguintes opções: “ Atualizações” + “ Cadastros” + “ Produtos” ; Clique no botão “ Incluir” e informe os dados a seguir: Código: Descrição: Tipo: Unidade: Armazém Pad.:
4.
10020002 Borracha PA UM 01
(F3 Disponível) (F3 Disponível)
Na pasta “ Atendimento” , clique no botão “ Imagem” , realize a associação da imagem cadastrada ao registr o corrente e confi rme;
Obs.:
A partir de agora este produto está relacionado a uma imagem e poderá ser exibido no “ Módulo de Controle de Lojas” , nas roti nas relacionadas à vendas. Dica:
Crie um diretório no qual possam ser localizadas todas as imagens disponíveis para sua configuração. Para saber sobre Repositórios de Imagens, do Módulo Configurador, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
O que você aprendeu neste capítulo Neste capítulo aprendemos como incluir novas imagens no Módulo Configurador com extensões (*.JPEG) e (*.BMP).
Próximo Passo No próximo capítulo, iremos aprender como configurar os parâmetros do sistema, Log de registros e Log de usuários.
Anotações:
36 - CONFIGURADOR Protheus
PARÂMETROS E LOG
S
O que você irá aprender neste capítulo Veremos como devem ser configurados os parâmetros do sistema e quando eles devem ser cr iados ou alterados. Conheceremos também o controle de LOGs que o Protheus possibilita, ajudando o administrador do sistema a controlar todos os acessos e movimentações realizadas pelos usuários.
Rotinas Abordadas Módulo Configurador: • Parâmetros (Sx6); • Log de Registros.
Parâmetros (Sx6) Um parâmetro é uma variável que atua como elemento-chave na execução de um determinado processamento. De acordo com o seu conteúdo, será possível obter di ferentes resultados.
Exercício 22 – Como cadastrar Novos Parâmetros:
1.
Selecione as seguintes opções: “ Ambiente” + “ Cadastros” + “ Parâmetros” ;
2.
Clique no botão “ Filial: Nome da Var.: Tipo: Conteúdo:
3.
MV_CFGMBRW Caracter 2
Na pasta “Descrição” , informe os dados a seguir: Descrição:
4.
(Incluir)” , e informe os dados a seguir:
1 - Exibe Browse e Resp. PROFILE, 2 - Não exibe o Browse e Resp. PROFILE, 3 - Exibe o Browse e não Resp. o PROFILE, 4 - Não exibe o Browse e não Resp. O PROFILE.
Confira os dados e confirme o cadastro de “ Parâmetros” .
Anotações:
CONFIGURADOR Protheus - 37
Dica:
Ao acessar novamente o Protheus, você irá notar a mudança, poi s o sistema irá trazer a opção de seleção da tela (Browser). Obs.:
Lembre-se sempre antes de alterar algum parâmetro, que tal mudança irá influenciar em toda a empresa e não apenas naquela fi lial. Para saber sobre Parâmetros (Sx6), do Módulo Configurador, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
Log de Registros Esta opção permite a visualização do campo de LOG e contém 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 arqui vo passe a ter este controle, é necessário que sejam criadosno Módulo Configurador os campos (XX_USERLGI) e (XX_USERLGA), que indicam, respectivamente, a inclusão, alteração ou exclusão de determinados campos. Obs:
As duas primeiras posições do campo “ XX” representam as iniciais utilizadas para todos os campos do arquivo.
Exercício 23 – Como criar Campos para a Consulta de Log de Registros:
1.
Selecione as seguintes opções: “ Base de dados” + “ Di cioná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 cli que no botão “ Procurar” ;
3.
Assim que o arquivo for encontrado, clique no botão “ opção “
4.
(Campos)”, clique no icone “
(Editar)” , posicione na
(Campos Reservados)”
Na tela que se apresenta deixe o campo “ Log de Inclusão” marcado e pressione “ Finalizar”
Obs: Verifique que o campo “ A1_USERLGI” foi cri ado automaticamente.
Anotações:
38 - CONFIGURADOR Protheus
5.
Clique novamente no icone “
(Campos Reservados)”
6.
Na tela que se apresenta marque o campo “Log de Alteração” e pressione “Finalizar”
Obs: Verifi que que o campo “ A1_USERLGA” foi criado automaticamente. 7. 8.
Confirme a inclusão dos novos campos e clique no botão “ (Atualizar Base de Dados)” ; 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 . Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
Exercício 24 – Como cr iar Registros para Consultas ao Log de Registros:
1. 2. 3.
Acesse o “Módulo de Faturamento” ; Selecione as seguintes opções: “ Atuali zações” + “ Cadastros” + “ Cli entes” ; Clique no botão “ Incluir” e informe os dados a seguir: Código: Loja: Nome: N. Fantasia: Tipo: Endereço: Município: Estado:
4.
(F3 Disponível)
Confira os dados, confirme o cadastro de cli entes e informe os dados a seguir: Código: Loja: Nome: N. Fantasia: Tipo: Endereço: Município: Estado:
5. 6.
000001 01 Cliente 1 Cliente 1 R = Revendedor Av. Braz Leme, 1369 São Paulo SP
000002 01 Cliente 2 Cliente 2 R = Revendedor Rua Cândido de Assis, 51 São Paulo SP (F3 Disponível)
Confir a os dados, confirme o cadastro de cli entes e cancele a próxima inclusão. Posicione o cursor sobre o cliente “ 2” e clique no botão “ Excluir” ;
Anotações:
CONFIGURADOR Protheus - 39
7. 8. 9. 10. 11.
Confira os dados e confirme a “ Exclusão” ; Acesse o “ Módulo Configurador” ; Selecione as seguintes opções: “ Usuári o” + “ Senhas” + “ Log de Registros” ; Selecione o arquivo –SA1” e confirme; Posicione o cursor sobre os registros e clique no botão “ Visuali zar” , para verificar os conteúdos dos campos.
Obs.:
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 clicamosna opção “ Visualizar” , conseguimos obter asinformações sobre o usuário que reali zou a últi ma alt eração no registro selecionado.
Para saber sobre: Clientes, do Módulo de Faturamento, posicione na opção e pressione a tecla . Será apresentado o H elp 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 . Será apresentado o H elp 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: i ndica 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óri os; “ S” 5 – Transações (TTS); “ S” 6 – Envio de e-mail; “ S” 7 – Parâmetros.
Anotações:
40 - CONFIGURADOR Protheus
Dica:
Not e que for am impl ementados dois novos contr oles o “ 6” e o “ 7” . No “ 6” o si st ema ir á real izar o cont rol e de e-mai ls envi ados e no “ 7” o si stema ir á gravar toda alteração dos parâmetros do relatório. Esta consulta poderá ser reali zada pelo “ Módul o Confi gurador” , na opção “ Log do Usuári o” . Ao alterarmos uma ou mais posições para (S)IM e saírmos do Módulo Configurador, o sistema automaticamente iniciará a gravação das informações correspondentes no Arquivo de Log Diário.
Exercício 25 – Como configurar a geração da Consulta de Arquivo Log:
1.
Selecione as seguintes opções: “ Ambiente” + “ Cadastr os” + “ Parâmetr os” ;
2.
Clique no botão " (Pesquisar)", informe no campo “ Pesquisar por:” o parâmetr o “ MV_DIRLOG” e confi rme pressionando o botão “ Procurar” ;
3.
Assim que o “Parâmetro” for encontrado, clique no botão “ e no campo “ Conteúdo” , informe “ \ SPOO L\ ” ; Confira os dados e confirme a “ Alteração” ;
4.
(Editar)”
5.
Cli que 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 “ e no campo “ Conteúdo” , informe “SSSSSSS” ;
7.
Confira os dados, confirme a “ Alteração” e clique no botão “
8. 9. 10. 11. 12. 13.
Saia do “ Módulo Configurador” e acesse outro módulo qualquer; Execute algumas movimentações, inclusões, alterações ou exclusões; Acesse o “ Módulo Configurador” ; Selecione as seguintes opções: “ Empresas” + “ Arquivos” + “ Consulta Arq. LOG” ; O sistema apresentará uma tela para consult as ao arqui vo de Log. Pode-se reali zar um filt ro 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 “ da consulta.
(Editar)”
(Sair)” ;
(Visualizar)” no lado direito da tela e analise o resultado
Anotações:
CONFIGURADOR Protheus - 41
15. Em seguida, selecione o botão “ (Imprimir)” , marque a opção em disco e confirme; 16. Anali se o relatóri o gerado com base nos dados a seguir : Número de Posições 01 O C S F B E I A R 99 01 03 15 08 06 10 03 14 08 08
Informação Tipo de Registro: Início de Operação de um Módulo Fim de Operação de um Módulo Início de Operação de uma Função Fim de Operação de uma Função Início de Transação (Begin Transaction) Fim de Transação (End Transaction) Inclusão de um Registro em Arquivo Alteração de um Registro em Arquivo Emissão de Relatório Código da Empresa Código da Filial Sigla do Módulo Identificação do Usuário Nome do Programa (Opção no Menu de Acesso) Horário Início ou Final do Processo Número de Registro utilizado ou se for relatório, informa o Número de Páginas Alias do Arquivo alterado Código de Identificação Interna do Protheus Dispositivo de Saída (LPT1, COM1, etc...) Reservado para uso futuro
Dica:
O arquivo gerado localiza-se no diretório informado no parâmetr o “ MV_DIRLOG” e apresenta a estr utura a seguir : “ SL+.LOG” . Para saber sobre Cri ação de Arquivos Log, do Módulo Configurador, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
O que você aprendeu neste capítulo Aprendemos neste capítulo a configurar os parâmetros do sistema. Verificamos também a necessidade de realizar tal manutenção e ativamos os LOGs existentes no Protheus, além disso, analisamos os resultados desta ferramenta.
Próximo Passo No próximo capítulo, i remos aprender a confi gurar os recursos para Schedule de Processos.
Anotações:
42 - CONFIGURADOR Protheus
SCHEDULE O que você irá aprender neste capítulo No próximo capítulo, iremos aprender a configurar os recursos da ferramenta Schedule.
Rotinas Abordadas Módulo Configurador: • Schedule de Processos.
Schedule de Processos Esta rotina deverá ser utilizada sempre que precisarmos utilizar recursos de disparos automáti cos de relatórios, processos em Batch e processos especiais sem a necessidade de intervenção direta do usuário. Será disponibi lizada a visualização de relatórios, através do envio de e-mails aos usuários, ou via Web através dos recursos de WebSpool.
Exercício 26 – Como confi gurar o Schedule de Processos:
1.
Selecione as seguintes opções: “ Ambiente” + “ Schedule” + “ Schedule” ;
2.
Clique na opção [+] da opção “
3.
Clique na opção [+] da opção “
4.
Clique na opção [+] da opção “
5.
Por fim, clique em [+] da opção “ item “
(Schedule)” , ao lado esquerdo da tela; (Administrador)” que será apresentada em seguida; (Fili al)” que será apresentada;
(Diário)” e clique no botão “
(Relatórios)” , posicionando o cursor sobre o (Incluir)” ;
Obs.:
Será apresentada uma tela para que possamos definir o relatór io a ser utilizado para este processo. 6. No campo “ Procurar por:” , selecione a opção “ Programa” . 7. No campo abaixo informe o “Programa – MATR010” e pressione a tecla . Anotações:
CONFIGURADOR Protheus - 43
8.
9. 10. 11. 12. 13.
Assim que o programa for localizado, clique na opção [+] de “ (Relatórios)” ao lado esquerdo da tela e posicione o cursor sobre a opção “ (Freqüência)” , para definir com que freqüência este relatório será emit ido pelo sistema. Do lado direito da tela, na opção “ Frequência” , selecione a opção “ Diária” ; Na opção “ Iniciar em” defina um horário válido, no campo “ Início” e clique no botão “ Execuções” logo abaixo, para verifi car os horários das próximas execuções; Posicione o cursor sobre a opção “ (Dispositi vo)” , do lado esquerdo da tela; Do lado direito, na opção “ Tipo de Saída” , marque a opção “ WebSpool” ; Do lado esquerdo da tela, posicione o cursor sobre a opção “ (Configurações)” ;
14. Do l ado direito, clique no botão “ Atualizar Parâmetros” e informe os dados a seguir: De: Ate:
ZZZZZZZZZZZZZZZ
15. Confira o dados, confirme e acesse a opção “ (Usuário(s)” no lado esquerdo da tela; 16. Na opção “ Grupo(s)” , posicione o cursor “ Administradores” e clique no botão “ Adicionar” logo abaixo da tela; 17. Confira os dados, confi rme o “ Schedule de Processos” e saia do cadastro. Dica:
Esta opção também poderá ser utilizada através do envio de e-mail aos usuários, bastando para isso defi nir que o tipo de saída na opção “Di spositivo” durante a confi guração da rotina. Para saber sobre Schedule de Processos, do Módulo Configurador, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
O que você aprendeu neste capítulo Neste capítulo, aprendemos a configurar os recursos para Schedule de Processos.
Próximo Passo No próximo capítulo, i remos verificar como criar e utilizar os Gatil hos (Triggers) nos cadastros e movimentações do sistema.
Anotações:
44 - CONFIGURADOR Protheus
GATILHOS O que você irá aprender neste capítulo Neste capítulo, iremos criar Gati lhos, veri fi cando quais as regras para essa criação e sua aplicação na utilização dos cadastros e movimentações do sistema.
Rotinas Abordadas Módulo Configurador: • Gatilhos em Campos (Sx7);
Gatilhos em Campos (Sx7) O Gatilho é uma atualização disparada a partir de um determinado evento previamente definido. No caso do Protheus, a definição deste evento é a digitação de determinados campos. O Gatilho permite ao usuário estabelecer uma atualização dinâmica dos dadosatravés da defini ção de critérios, isto é, a partir da digitação de um dado é possível atualizar automaticamente outros campos pertencentes ao mesmo arquivo ou não. Essa movimentação aceita Sintaxes Xbase, ou seja, Clipper ou ADVPL.
Exercício 27 – Como cri ar Campos para uti li zação em Gatilhos:
1.
Selecione as seguintes opções: “ Base de dados” + “ Dicionário” + “ Base de Dados” ;
2.
Posicione o cursor sobre a opção “
3.
Clique no botão " (Pesquisar)", informe no campo “Pesquisar por:” , o “ Arquivo – SD1” e clique no botão “ Procurar” ;
4.
Clique no botão “
5.
Posicionado o cursor sobre a opção “ e informe os dados a seguir:
(Dicionário de Dados)” ;
(Edi tar)” ; (Campos)” , clique no botão “
(Incluir)”
Anotações:
CONFIGURADOR Protheus - 45
D1_NOME Caracter 30 Virtual Visualizar
Campo: Tipo: Tamanho: Contexto: Propriedade:
6.
Na pasta “ Informações” , insira os dados a seguir: Descricao Descrição do Produto
Título: Descrição:
7.
Na pasta “ Módulos” , marque a opção “ Uti lizado por todos os Módulos” e confirme;
8.
Posicione o cursor sobre este campo e clique no botão “
9.
Na tela de “ Posicionamento dos Campos” , clique no botão “Mover Acima” até que ele fique logo abaixo do campo –D1_COD ” , ou seja, na posição –4” e confirme a gravação do campo.
(Ordenar)” ;
10. Clique no botão “ (Atualizar Base de Dados)” , para confirmar a atualização do arquivo. 11. Assim que todos os dados forem atualizados, saia do cadastro. Para saber sobre Criação de campos para utilização em Gatilhos, do Módulo Configurador, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
Exercício 28 – Como criar Gatil hos:
1.
Selecione as seguintes opções: “ Base de dados” + “ Dicionário” + “ Gatilhos” ;
2.
Clique no botão “ Campo: Sequência: Cnt. Domínio: Tipo: Regra: Posiciona: Alias: Ordem: Chave:
3.
(Incluir)” e informe os dados a seguir: D1_COD 002 D1_NOME Primário SB1->B1_DESC SIM SB1 1 XFILIAL("SB1")+M->D1_COD
Confira osdados, confirme o cadastro de “ Gatilhos” , clique no botão “ e informe os dados a seguir:
Anotações:
46 - CONFIGURADOR Protheus
(Incluir)”
Campo: Sequência: Cnt. Domínio: Tipo: Regra: Posiciona:
4.
D1_VUNIT 001 D1_TOTAL Primário ROUND(M->D1_QUANT*M->D1_VUNIT,2) NÃO
Confi ra os dados, confi rme o cadastr o de “ Gati lhos” e saia do “ Módulo Configurador” .
Para saber sobre Gatilhos, do Módulo Configurador, posicionado na opção, pressione a tecla e será apresentado o Help do Programa, esclarecendo, a sua finalidade e como executá-lo.
Exercício 29 – Como Testar o novo Gatilho:
1. 2. 3.
Acesse o “ Módulo de Compras” ; Selecione as seguintes opções “ Atuali zações” + “ Movimentos” + “ Documento Entr ada” ; Clique no botão “ Incluir” e informe os dados a seguir: Tipo: Formulário Próprio: Documento: Série: Emissão: Fornecedor/Loja: Tipo de Documento: Produto: Quantidade: Vlr. Unitário: Vlr. Total Tipo Entrada:
4. 5.
(N)ormal (N)ão 000001 UNI Data de hoje 000001/01 NF 10020001 1 150,00 150,00 001
(F3 Disponível) (F3 Disponível)
(F3 Disponível)
Confira os dados e confirme o cadastro de “ Documentos de Entradas” ; Saia do “ Cadastro” e do “ Módulo de Compras” .
Obs.:
Not e que após a digit ação do “ Código do Produto” , a “ Descri ção” foi atuali zada automaticamente e o mesmo ocorreu quando da digitação dos campos relacionados à “ Quantidade e Valor Unitário” , sendo que o campo “ Valor Total” , também foi atualizado através do “ Gatilho” configurado para esta sit uação.
Anotações:
CONFIGURADOR Protheus - 47
Para saber sobre Teste de Gatilhos, do Módulo de Compras, posicionado na opção, pressione a tecla e será apresentado o Help do Programa, esclarecendo, a sua finalidade e como executá-lo.
Exercício 30 – Como cri ar Campos, para utili zação em Novos Gatil hos:
1. 2.
Acesse o “ Módulo Configurador” ; Selecione as seguintes opções “ Base de dados” + “ Di cionário” + “ Base de Dados” ;
3.
Posicione com o cursor sobre a opção “
4.
Clique no botão " (Pesquisar)", informe no campo “Pesquisar por:” , o “ Arquivo – SC4” e cli que no botão “Procurar” ;
5.
Posicionado com o cursor sobre a opção “ (Incluir)” e informe os dados a seguir: Campo: Tipo: Tamanho: Contexto: Propriedade:
6.
Cor Cor do Produto
C4_DESCOR Caracter 15 Virtual Visualizar
Na pasta “ Informações” , insira os dados a seguir: Título: Descrição:
9.
C4_COR Caracter 2 Virtual Visualizar
Na pasta “ Módulos” , marque a opção “ Uti lizado por todos os módulos” , confirme, clique no botão “ (Incluir)” e informe os dados a seguir: Campo: Tipo: Tamanho: Contexto: Propriedade:
8.
(Campos)” , clique no botão “
Na pasta “ Informações” , informe os dados a seguir: Título: Descrição:
7.
(Dicionário de Dados)” ;
Desc. Cor Descrição da Cor
Na pasta “ Módulos” , marque a opção “ Uti lizado por todos os módulos” e confirme;
10. Clique no botão “ (Atualizar Base de Dados)” , para confirmar a atualização do arquivo; 11. Após a atuali zação dos dados, saia do cadastro. Anotações:
48 - CONFIGURADOR Protheus
Para saber sobre Criação de Campos, do Módulo Configurador, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finali dade e como executá-lo.
Exercício 31 – Como criar Novos Gatil hos:
1.
Selecione as seguintes opções: “ Base de Dados” + “ Dicionário” + “ Gatilhos” ;
2.
Clique no botão “ Campo: Sequência: Cnt. Domínio: Tipo: Regra: Posiciona: Alias: Ordem: Chave:
3.
(Incluir)”
C4_PRODUTO 002 C4_DESCOR Primário TABELA("90",M->C4_COR) NÃO
Confira osdados, confirme o cadastro de “ Gatilhos” , clique no botão “ e informe os dados a seguir: Campo: Sequência: Cnt. Domínio: Tipo: Regra: Posiciona:
5.
C4_PRODUTO 001 C4_COR Primário SB1->B1_COR SIM SB1 1 XFILIAL("SB1")+M->C4_PRODUTO
Confira osdados, confirme o cadastro de “ Gatilhos” , clique no botão “ e informe os dados a seguir: Campo: Sequência: Cnt. Domínio: Tipo: Regra: Posiciona:
4.
(Incluir)” e informe os dados a seguir:
(Incluir)”
C4_PRODUTO 003 C4_LOCAL Primário SB1->B1_LOCPAD NÃO
Confira osdados, confirme o cadastro de “ Gatilhos” , clique no botão “ e informe os dados a seguir:
(Incluir)”
Anotações:
CONFIGURADOR Protheus - 49
Campo: Sequência: Cnt. Domínio: Tipo: Regra: Posiciona:
6.
C4_QUANT 001 C4_VALOR Primário ROUND(M->C4_QUANT*SB1->B1_PRV1,2) NÃO
Confir a os dados, confi rme o cadastr o de “ Gati lhos” e saia do “ Módulo Configurador” .
Para saber sobre Criação de Gatilhos, do Módulo Configurador, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
Exercício 32 – Como Testar os Gatilhos em Cadastros:
1. 2. 3.
Acesse o “Módulo de Faturamento” ; Selecione as seguintes opções: “ Atualizações” + “ Cenári os de Vendas” + “ Previsão de Vendas” ; Clique na opção “ Incluir” e informe os dados a seguir: Produto: Armazém: Quantidade:
4.
10020001 01 1
(F3 Disponível)
Confir a os dados e confirme o cadastro de “ Previsão de Vendas” .
Obs.:
Note, que quando o campo “ Produto” foi preenchido automaticamente, o campo “ Cor” foi atualizado com referência ao cadastro de produtos, o mesmo ocorreu em relação ao campo “ Valor” , no momento em que o campo “ Quantidade” foi preenchido. Para saber sobre Previsão de Vendas, do Módulo de Faturamento, posicione na opção e pressione a tecla . Será apresentado o Help do Programa esclarecendo a sua finalidade e como executá-lo.
Anotações:
50 - CONFIGURADOR Protheus