ADDON GESTÃO DE CEREAIS

BOLETIM TÉCNICO

05/10/2020
 Boletim Técnico – Addon Gestão de Cereais

Sumário
Addon Gestão de Cereais ........................................................................................................................................................................ 3
1.1. Pré-Requisitos ................................................................................................................................................................................ 3
1.2. Procedimentos de Atualização - Aplicação .............................................................................................................................. 4
1.3. Procedimentos de Atualização - Dicionário de Dados ........................................................................................................... 5
1.4. Utilizando o Addon Gestão de Cereais ..................................................................................................................................... 9

Fábrica de Software – Totvs Cascavel – PR

2
 Boletim Técnico – Addon Gestão de Cereais

Este documento contempla informações à respeito dos procedimentos técnicos apliváveis à realização de instalação e
atualização do Addon Gestão de Cereais junto ao ERP Protheus.

Addon Gestão de Cereais

O Addon Gestão de Cereais possibilita à realização de todas as regras e processos vinculados à comercialização de cereais junto
ao ERP Protheus. A integração entre as rotinas e processos disponíveis neste addon com o ERP Protheus ocorre através através da
integração com os módulos padrões do ERP abaixo elencados:
 Compras
 Estoque
 Financeiro
 Faturamento
 Gestão de Distribuíção

Junto à este boletim técnico, serão disponibilizadas as informações pertinentes à realização das atividades necessárias para à
disponibilização do Addon Gestão de Cereais junto ao ERP Protheus.

1.1. Pré-Requisitos

Realizar o procedimento em base de testes, efetuando à validação antes de aplicar em ambiente de produção.

Antes de executar o as atividades vinculadas ao processo, é imprescindível:

a) Realizar backup do repositório de objetos (rpo) do ambiente;

b) Realiza backup do dicionário de dados (pasta protheus_data/system)* do ambiente;

* Os diretórios acima mencionados correspondem à instalação padrão do ERP Protheus, portanto, devem ser
alterados conforme encontra-se configurado o ambiente.

c) Realizar backup da base de dados (banco de dados) vinculado à utilização do ERP Protheus;

d) Caso existam índices personalizados (criados pela empresa) junto as tabelas do Addon Gestão de Cereais, antes de
executar o compatibilizador, certifique-se que os mesmos estejam identificados pelo nickname. Caso o
compatibilizador necessite criar novos índices, irá adicioná-los a partir da ordem padrão do addon, o que poderá
ocasionar a sobregravação de índices personalizados;

e) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema;

f) O compatibilizador deve ser executado com a Integridade Referencial desativada;

Fábrica de Software – Totvs Cascavel – PR

3
 Boletim Técnico – Addon Gestão de Cereais

1.2. Procedimentos de Atualização - Aplicação

1. Descompactar o pacote disponibilizado referente ao Addon Gestão de Cereais;

2. Copiar a pasta UPDGC para o rootpath do ambiente (Exemplo: \protheus_data\);

3. Copiar os arquivos HTML presentes disponibilizados na pasta \workflow\gestao_cereais para à pasta de workflow do
ambiente (Exemplo: \protheus_data\workflow\gestao_cereais\);

4. Copiar para o starpath (Exemplo: protheus_data\system\) do ambiente o arquivo de MENU (sigaesp.xnu) conforme
disponibilizado no pacote do Addon Gestão de Cereais;
a. Utilize o arquivo de menu correspondente ao país de utilização do ERP Protheus;

b. Caso existam definições de menu personalizadas no ambiente, sugere-se que seja realizado à
compatibilização dos mesmos em relação ao arquivo de menu atualizado o qual foi disponibilizado;

c. Ou seja, verificar junto ao novo arquivo de menu novas rotinas disponibilizadas no Addon Gestão de
Cereais e disponibilizar as mesmas nos arquivos de menu personalizados conforme à politica de acessos
definida pela empresa em relação aos colaboradores que utilizam o addon;

5. Realizar à compatibilização dos rdmakes referentes à pontos de entrada (caso presente no pacote do disponibilizado)
utilizados pelo Addon Gestão de Cereias disponíveis no pacote de atualização junto à pasta RDMAKES para o projeto
de personalizações da empresa;
a. Utilize como referência, os rdmakes de pontos de entrada disponibilizados, correspondentes ao país de
utilização do ERP Protheus;

b. Ao realizar este processo, caso a empresa já utilize algum dos pontos de entrada disponibilizados, o
mesmo deverá ser compatibilizado, ou seja, adicionar à chamada do Addon Gestão de Cereais conforme
modelo disponibilizado, porém, junto ao final das regras presentes no ponto de entrada vinculado ao
ambiente da empresa;

c. Caso um ou mais pontos de entrada disponibilizados com o pacote de atualização do Addon Gestão de
Cereais não sejam atualmente utilizados no ambiente, estes deverão ser vinculados ao projeto de
personalizações da empresa para que sejam compilados no ambiente;

d. Após realizar as atividades de compatibilização dos pontos de entrada, estes devem ser compilados junto
ao ambiente através da utilização do Ide ou Tds;

6. Através da utilização das ferramentas Totvs Developer Studio (TDS) \ Visual Studio Code (VSC), deve-se efetuar os
procedimentos de aplicação no ambiente do patch de atualização do Addon Gestão de Cereais o qual esta presente
na pasta UPDGC\PATCH vinculada ao rootpath do ambiente conforme descrito no item 2;
a. Ao realizar à aplicação do patch de atualização, selecione o pacote referente à versão do ERP Protheus
utilizada;

7. Executar o compatibilizador de atualização do dicionário de dados;

Fábrica de Software – Totvs Cascavel – PR

4
 Boletim Técnico – Addon Gestão de Cereais

1.3. Procedimentos de Atualização - Dicionário de Dados

1. Na sequência, serão apresentados os procedimentos referentes à execução do compatibilizador do Addon Gestão de

Cereais responsável pela atualização do dicionário de dados do ERP Protheus conforme à versão do addon que foi
disponibilizada.

2. Através do Totvs SmartClient, executar o compatibilizador U_UPDCEREAIS conforme exemplo;

OBSERVAÇÃO: ao executar o compatibilizador, certifique-se que o ambiente definido seja o mesmo no qual foram
realizados os procedimentos descritos na página 3.

3. Ao confirmar os parâmetros iniciais do Totvs SmartClient, será verificado acesso exclusivo ao ambiente, e caso seja
obtido, será apresentado à interface inicial do compatibilizador de atualização do dicionário de dados;

OBSERVAÇÃO: não havendo acesso exclusivo ao ambiente, será apresentado mensagem ao usuário e abortado o
processo.

Fábrica de Software – Totvs Cascavel – PR

5
 Boletim Técnico – Addon Gestão de Cereais

4. Ao avançar à interface inicial do compatibilizador, deverá ser selecionado um ou mais grupos de empresas nos quais
ocorrerá a execução do compatibilizador;

OBSERVAÇÃO: para realizar sequência ao processo, deve-se selecionar ao menos um grupo de empresas para
atualização.

5. Em seguida, é necessário confirmar de que não existam customizações especificas da empresa, utilizam-se de tabelas
vinculadas as faixas de tabelas do Addon Gestão de Cereais.

Fábrica de Software – Totvs Cascavel – PR

6
 Boletim Técnico – Addon Gestão de Cereais

6. Antes de iniciar à execução do compatibilizador, será disponibilizado um resumo em torno dos procedimentos de
backup à serem realizados antes do inicio do processamento da atualização do dicionário de dados e banco de dados;

7. Ao avançar à sessão de informações de backup, será iniciado à execução do compatibilizador de atualização do

dicionário de dados, onde é possível acompanhar à sequência de execução dos procedimentos de atualização;

Fábrica de Software – Totvs Cascavel – PR

7
 Boletim Técnico – Addon Gestão de Cereais

8. Ao finalizar à atualização de todos os grupos de empresa selecionados anteriormente, será disponibilizado o log
referente as alterações realizadas no dicionário de dados e também no banco de dados.

OBSERVAÇÃO: através do botão “salvar”, é possível salvar o log gerado pela execução do compatibilizador de
atualização do dicionário de dados para o Addon Gestão de Cereais;

9. Após confirmar à interface de log do compatibilizador, basta acionar à opção “finalizar” para encerrar à execução do
compatibilizador;

Fábrica de Software – Totvs Cascavel – PR

8
 Boletim Técnico – Addon Gestão de Cereais

1.4. Utilizando o Addon Gestão de Cereais

Após a realização de todas as etapas descritas anteriormente, o Addon Gestão de Cereais esta disponível para
utilização. Para isto, pode-se executar os procedimentos conforme abaixo.

1. Através do Totvs SmartClient, realize acesso normal ao ERP Protheu;

2. Realize os procedimentos de login com o usuário\senha utilizados;

Fábrica de Software – Totvs Cascavel – PR

9
 Boletim Técnico – Addon Gestão de Cereais

3. Após o login, selecione o grupo de empresas, empresa e filial desejada. Além disto, selecione o módulo 97 – Gestão
de Cereais;

OBSERVAÇÃO: caso o módulo 97 – Gestão de Cereais não seja disponibilizado, sugere-se que sejam revisados os
procedimentos descritos na página 4 deste boletim técnico.

4. Ao confirmar os parâmetros anteriores, será disponibilizado à interface padrão do ERP Protheus juntamente com o
menu pertinente às rotinas disponibilizadas para utilização do Addon Gestão de Cereais;

Fábrica de Software – Totvs Cascavel – PR

10