Árvore de páginas

Precisa de ajuda?













O Configurador é a principal ferramenta de apoio ao desenvolvimento e personalização dos módulos integrados do Sistema.

Este módulo permite ao usuário adaptar o sistema às necessidades de sua empresa. Dada sua flexibilidade, possibilita a manutenção do dicionário de dados, parametrizações, gatilhos, além de outras funcionalidades restritas ao Administrador do Sistema.

O ambiente do SmartERP Protheus possui o mesmo comportamento de um ambiente on-premisse. Para maiores informações sobre o ambiente de configurador, acesse: Framework - Protheus 12


Aqui, demonstramos a utilização do sistema e as particularidades do SmartERP Protheus.

Acesso ao ambiente

O acesso do ambiente é idêntico ao on-premisse, a diferença é somente o acesso via o Smartclient electron, conforme demonstrado abaixo:

É impreterível que a latência da sua rede esteja abaixo de 30ms. Caso esteja acima disto, poderá ocorrer perda de pacotes e o sintoma de lentidão ao navegar no ambiente.

Para maiores informações, acesse: 2. SmartERP Protheus - Arquitetura SmartERP

Realizando a personalização do ambiente

O configurador foi centralizado em um único endpoint, onde é possível realizar todas as operações do ambiente. 

Abaixo descrevemos as principais ações dentro do ambiente SmartERP:

Atualização do Menu

Antes de iniciar o processo de customização no dicionário, deve-se realizar o processo de atualização do menu do ambiente do SIGACFG para o ambiente de produção. Para isto, deve-se realizar o seguinte procedimento:

  • Acessar o menu ambiente/cadastro/menus
  • Clicar no botão restaurar
  • Escolher o SIGACFG e depois no botão restaurar.

Assim que concluir o processo, saia do ambiente e entre novamente.


IMPORTANTE: este processo deve ser efetuado somente no ambiente de PRODUÇÃO.

Acesse o painel TCLOUD e clique no ambiente de produção. Após isto, role a página e clique no botão de "meus ambientes", conforme imagem abaixo:


Colete os endereços disponíveis no painel TCLOUD e configure o smartclient Electron conforme a imagem abaixo:

Para que todas as ações dentro do ambiente SmartERP sejam controladas (e para que não haja duplicidade de operações), optamos em centralizar todas as ações de configurador em um único endereço, para isto, adicionamos uma trava no sistema cujo irá bloquear qualquer acesso ao configurador de fora do endereço do CFG.

Caso o usuário tente acessar o configurador de dentro do ERP, será exibido uma mensagem indicando que o configurador não está disponível neste endereço, conforme imagem abaixo:



Este mesmo conceito vale para o acesso ao ERP de dentro do endereço do configurador. Caso o usuário tende acesso ao módulos de dentro do endereço do configurador, será exibido a mensagem que não permitido, conforme a mensagem abaixo:

Dentro do configurador do SmartERP, o usuário terá ação em todas as funcionalidades do ambiente, como:

  • A manutenção dos usuários;
  • A criação de novas filiais;
  • A manutenção dos dicionários de dados;
  • A manutenção dos parâmetros do sistema (SX6 e SX5);
  • A manutenção dos menus do sistema;
  • Instalação/Remoção das procedures;
  • A manutenção dos agentes do schedule;


O Ambiente do cliente já vem com a Gestão de empresas, ligada com o seguinte layout: EEFFFF, sendo o EE referente à disponibilização de empresas (de 00 à zz) e FFFF referente à disponibilização de filiais (de 0000 à zzzz).

Este é o padrão de criação de empresas para os ambientes SmartERP Protheus, pois com isto reduzimos os custos em:

  • Implantação
    • O ambiente já vem pré configurado para o implantador, não necessitando criar as tabelas de dicionário e a instalação de procedures, apps, agendamentos automáticos e etc. 
  • Manutenção
    • A usabilidade da gestão nos proporciona uma melhor gestão dos dicionários e a manutenção com as viradas de versão e atualizações pontuais.
  • Espaço de disco
    • Clientes da modalidade Intera, são tarifados conforme o consumo da topologia. Com a criação de diversas empresas (grupos), o Protheus realiza a criação de novos dicionários no banco e estes serão contabilizados na contagem do espaço utilizado.

Com o modelo entregue, sugerimos a criação das filiais no seguinte modelo:

Grupo de Empresa: 01
Empresa: 01 
Filial: 0001
Nome: MINHA PRIMEIRA EMPRESA - FILIAL 01

Grupo de Empresa: 01
Empresa: 01 
Filial: 0002
Nome: MINHA PRIMEIRA EMPRESA - FILIAL 02

Grupo de Empresa: 01
Empresa: 02 
Filial: 0001
Nome: MINHA SEGUNDA EMPRESA  - FILIAL 01

Grupo de Empresa: 01
Empresa: 02 
Filial: 0002
Nome: MINHA SEGUNDA EMPRESA  - FILIAL 02

  • Para este exemplo, há duas empresa com duas filiais cada.


A alteração deste layout poderá acarretar diversos problemas estruturais em seu ERP, causando à indisponibilidade do ambiente para utilização.

Caso isto ocorra, iremos restaurar o backup do dia anterior à alteração, sem a possibilidade de demais manutenções.

O comportamento do cadastro de usuários não mudou, ou seja, todas as ações seguem o mesmo padrão do ambiente on-premisse. Conforme imagem abaixo:

A diferença é somente no que encontra-se cadastrado no ambiente padrão. Hoje o ambiente já sai com dois usuários cadastrados, o ADMIN e o TOTVS. Ambos possuem uma senha forte para acesso dos administradores do ambiente SMART.

Importante: Pedimos que não alterem a senha do usuário TOTVS, pois é nele que realizamos as manutenções programadas em seu ambiente quando necessário.

Caso precise resetar a senha do administrador, clique abaixo:

Não foi possível renderizar {include} A página incluída não pôde ser encontrada.

O Scheduller do Protheus foi configurado para sempre executar no endereço do configurador, desta forma, todas as ações de schedule deverão ser pensadas nesta centralização. Abaixo o acesso e os agentes configurados do schedule.

Importante: Caso seja cadastrado uma nova empresa, deve-se lembrar que configurar mais agentes de schedules.


Não foi possível renderizar {include} A página incluída não pôde ser encontrada.

Os envios de informações de dentro do SmartERP utilizam o canal de e-mail configurado no ambiente. Devido a isto, o ambiente sai com uma configuração padrão de e-mail. Recomendamos que efetuem a configuração para o gerenciador de e-mail de sua empresa, desta forma, todas as ações de envio de informação ficam guardadas em seus servidores de mail.


Importante: A liberação do e-mail já encontra-se disposta para um serviço do tipo GMAIL, com o SSL2 ligado e TLS desligado. Caso o seu servidor de e-mail exija uma configuração diferente de segurança, recomendamos que entrem em contato com o suporte TOTVS e solicite a alteração.

Não foi possível renderizar {include} A página incluída não pôde ser encontrada.



O ambiente do SmartERP possui uma única diferença em comparação com ambiente on-premisse, não existe a possibilidade de parar os serviços do ambiente. Isto ocorre pois o SmartERP encontra-se em uma plataforma de auto-gerenciamento/controle de quedas. Na prática, temos um agente de monitoramento que varre o sistema todo à cada 'x' segundos e se este agente encontrar um problema e/ou a falta de conexão em um dos componentes instalados no ambiente, este irá tentar restabelecer o serviço de forma autônoma. Caso o mesmo não consiga, nos envia um alerta de queda para analise e ação manual.

Se o usuário tentar realizar a execução de uma manutenção de banco e/ou dicionário de dados, o agente entrará em ação, bloqueando a operação do usuário. Isto pois entende que há um problema de conexão entre os seus componentes.

Para liberarmos a ação de personalização dentro do dicionário de dados, criamos uma ferramenta de atualização manual do usuário, cujo tem a função de avisar o agente de monitoramento que há uma manutenção programada pelo usuário e para que não entre em ação até o término do processo solicitado pelo usuário. Alem disto, o usuário escolherá qual o ambiente irá executar a manutenção do ambiente.

Para utilizar esta funcionalidade, iremos utilizar duas ferramentas (ou etapas) para isto. A primeira é o gerenciador de ambiente Protheus (Master Metadata) e a segunda é o TCLOUD.

Gerenciador de ambiente Protheus ou Master Metadata:

O gerenciador de ambiente ou master metadata é uma ferramenta que visa controlar todas as alterações de dicionário de dados e a criação de parâmetros e menus em projetos, para assim, facilitar a replica destas alterações entre os diversos ambientes do cliente. Este processo se dá pois criamos um pacote de atualização e aplicamos no ambiente do cliente através do UPDDISTR. Este pacote é gerado somente pelo ambiente de configurador do ambiente de produção e poderá ser replicado para qualquer ambiente que o usuário escolher.

Para isto, implementamos o conceito de Stages no ambiente do SmartERP (futuramente será liberado para os clientes on-premisse). Os stages permitem controlar o ciclo de vida de uma inovação ou personalização de um metadado no SmartERP, desde sua construção até a entrega ao ambiente de produção.

Dentro do ambiente tempos os seguinte Stages: Configurador, Homologação e Produção

  • O Stage de Configuração é o único que permite ao usuário que realize edições no dicionário do ERP. Este está configurado somente no endereço do configurador de produção.
  • O Stage de Homologação é utilizado em todos os ambientes derivados do ambiente develop (ou homologação) e neste é permitido somente a alteração de conteúdos de parâmetros ou alterações que não envolvam diretamente o dicionário de dados, como usuários, schedules, sispags, cnabs e etc..
  • O Stage de Produção habilita somente a utilização dos módulos do ERP, não deixando acessar o configurador. 


Para identificar os Stages, acesse o shift+f6 de dentro do módulo e posicione na segunda aba, conforme imagem abaixo:

Importante: As informações de contidas neste quadro serve para nortear as suas alterações e também informar em qual Stage você se encontra.


Como utilizar o gerenciador de ambiente?

O gestor de ambiente utiliza o conceito de projetos para empacotamento das alterações do usuário. Sendo assim, podemos ter vários projetos para um mesmo ambiente trabalhando de forma independente.

As alterações de dicionários são vinculadas ao Projeto e essas alterações são geradas posteriormente. Qualquer projeto pode gerar os pacotes de atualização. Ele gera apenas as alterações vinculadas à ele.

Abaixo demonstramos como ficará os projetos dentro do ambiente:

Importante: Todos os projetos seguem uma linha base para realização das alterações, para isto, configuramos o dicionário de produção para este papel. Com isto, garantimos sempre que as alterações realizadas nos ambiente de homologação sejam um espelho de produção, evitando assim incompatibilidade entre os ambientes.


Acessando o gestor de ambiente

Para acessar o gerenciador de ambiente, acesso o configurador (pelo endpoint cfg de produção) e após logar navegue entre os menus: Base de Dados \ Gestão de Ambientes \ Gestão de Projetos

Ao abrir a tela, verás que é um cadastro simples contendo os dados do projeto. Proceda com a criação de um novo projeto conforme imagem abaixo:


Inciando ambiente de projeto:

Para que todas as ações realizadas no configurador sejam vinculadas à este projeto, deve-se informar ao ambiente que há um projeto ativo, para isto acesse: Base de Dados \ Gestão de Ambientes \ Inicializa Ambiente

Ao concluir esta ação, todas as operações dentro do configurador serão vinculadas à este projeto.


Realizando alteração no dicionário de dados:

As alterações no dicionário de dados seguem o mesmo conceito do configurador padrão, porém notem que não há o botão de salvar as alterações, pois estes entram automaticamente dentro do projeto iniciado. Abaixo um exemplo de uma edição de uma tabela padrão:

Importante: Todas as inclusões de tabelas e/ou alterações em campos serão automaticamente vinculadas aos projetos. Também serão vinculados os novos parâmetros, novos helps e menus. Para estes, as alterações são aplicadas automaticamente no ambiente, pois pela regra do UPDDISTR, não realizamos alterações de conteúdos neste componentes. 


Fechando pacote de atualização:

Após todas as alterações realizadas pelo usuário, devemos informar ao sistema que o projeto foi finalizado. Para isto, devemos voltar à rotina de gestão de projetos e realizar a geração do pacote conforme demonstrado abaixo:

Após a conclusão do projeto, será demonstrado a seguinte mensagem:


O pacote gerado conterá 3 arquivos: O prjpack.mzp contendo as alterações do dicionário, o manifest_update.txt contendo um log de todas as alterações e o arquivo dictionary.json que trata do mapeamento entre o projeto e as empresas.


Aplicando personalização no ambiente:

Conforme informamos acima, após finalizarmos as alterações do dicionário, precisamos informar ao agente de monitoramento do ambiente que há uma atualização à ser efetuada e para isto, utilizaremos o painel TCLOUD para realizar a atualização dos ambientes.

Dentro do ambiente TCLOUD, selecione o ambiente que deseja atualizar e em seguida qual o pacote a ser aplicado. Após isto clique no botão aplicar, conforme imagem abaixo:

Com o clique do botão, será enviado um comando para o agente para:

→ Copiar o pacote/projeto para o ambiente escolhido na atualização

→ Parar todos os serviços vinculados àquele ambiente

→ Iniciar o processo de backup do ambiente (banco e volume)

→ Iniciar o processo de UPDDISTR no ambiente

Importante: Ao realizar este procedimento, o ambiente estará indisponível ou seja, se aplicado dentro da janela produtiva do cliente, o mesmo ficará inoperante. Pedimos que agende entre as áreas operacionais do cliente, o melhor horário para aplicação deste procedimento. 


Centralizando projetos:

Como mencionamos acima, podemos ter vários projetos simultâneos no ambiente e isto poderá gerar um CDM grande no momento da aplicação destes pacotes, para isto, existe a possibilidade de aglutinarmos todos os projetos em um único.

A vantagem deste processo é que diminuímos a quantidade de vezes de execução do UPDDISTR no ambiente do cliente e também o tempo de down-time no mesmo.

Para demonstrar este processo, iremos criar 3 projetos, sendo duas features e develop. Após as alterações e finalizações das duas features, iremos dentro do menu de gestão de projetos e incorporaremos todas no projeto develop, conforme descritivo abaixo:

 

Após a conclusão, os dois projetos de features ficarão com o status de incorporados e somente o projeto develop estará ativo. Neste, iremos proceder com a geração dos artefatos conforme descrito anteriormente.

Importante: Um cuidado que se deve ter com relação à ordem de incorporação. Quando houver alterações do mesmo dado em projetos diferentes, prevalecerá a alteração do último projeto incorporado.


Dentro do ambiente, basta acessar o menu: Base de Dados \ Gestão de Ambientes \ Cadastro de Projetos \ Outras Ações \ Incorporar

Para maiores informações, acesse: Gestão de Ambientes


Após as alterações efetuadas dentro do gestor de ambientes, deve-se entrar no painel TCLOUD (4. SmartERP Protheus - Painel Gestão do Ambiente) e realize a atualização do ambiente.








  • Sem rótulos