Checklist de Pré-requisitos para Utilizar o Protheus Insights
Para garantir uma experiência ótima e obter previsões precisas, verifique se você atende aos seguintes pré-requisitos:
LIB Data Mínima:
A data mínima para a LIB é 08/04/2024.
Financeiro:
Possuir, no mínimo, 11 semanas ou 11 meses de transações na tabela FK5, categorizadas por tipo de movimentação (FK5_RECPAG).
Estoque e Compras
Ter, no mínimo, 2 anos de histórico de movimentações de estoque (SD3).
Contabilidade
Conciliador Backoffice configurado conforme as orientações da documentação CTBA940
Execução da opção 4 do WizardUUID para preenchimento dos campos MDUIDT
Certifique-se de que todos os itens acima estão atendidos para utilizar o Protheus Insights de maneira eficiente. Para qualquer dúvida ou assistência, entre em contato conosco em [email protected].
Deck of Cards
startHidden
false
id
step-config
Card
default
true
effectDuration
0.5
id
step1
label
Etapa 1
effectType
slide
Etapa 1
1.1 Solicitar clientId e clientSecret
1.2 Aplicar pacotes
Protheus Insights
Smartlink
1.3 Executar o "UPDDISTR" ou "UPDBATCH" do pacoteDiferencial BA acumulado (em modo exclusivo)
1.4 Verificar regras de firewall
1.1 Solicitar clientID e clientSecret
Para garantir o acesso e a integração com a plataforma Carol, é necessário solicitar as credenciais de clientID e clientSecret.Para isso, envie um e-mail para[email protected]com essas informações da empresa na qual deseja implantar o Protheus Insights:
Razão Social: [Inserir a razão social da sua empresa aqui]
CNPJ: [Inserir o número do CNPJ da sua empresa aqui]
Código TOTVS: [Inserir o Código TOTVS da sua empresa aqui]
LIB: [Inserir a versão da LIB que esta utilizando]
Em até 24 horas úteis, você receberá as credenciais por email.
1.2 Aplicar Pacotes
É necessário atualizar o ERP Protheus com os pacotes abaixo de acordo com a release correspondente ao seu sistema e, em caso de dúvidas técnicas, enviar email para[email protected]
Abra o SmartClient e insira "UPDDISTR" ou "UPDBATCH" no campo "Programa Inicial" e, nos demais campos, insira as informações do seu ambiente.
Selecione as empresas para as quais deseja aplicar a nova funcionalidade.
Lembre-se sempre de realizar um backup completo do ambiente antes de aplicar pacotes, para garantir a segurança dos dados e a possibilidade de restauração em caso de necessidade.
Image Modified
Verifique cuidadosamente se todas as tabelas necessárias foram criadas corretamente. Exemplo: SELECT * FROM SX3010 WHERE X3_ARQUIVO = 'I14'
Image Modified
Aplique os pacotes relacionados no ambiente de modo exclusivo.
1.4 Verificar as Regras de Firewall:
Caso haja alguma regra de bloqueio de firewall, por favor, liberar os seguintes endereços:
Por favor, verifique e ajuste suas configurações de firewall conforme necessário para garantir a conectividade adequada com os serviços mencionados acima.
Após garantir que os itens da Etapa 1 foram concluídos com sucesso, prossiga para a Etapa 2.
Card
effectDuration
0.5
id
etapa2
label
Etapa 2
effectType
slide
Etapa 2
ETAPA 2
2.1 Executar o WIZSMARTBA
2.2 Verificar o schedule FWTECHFINJOB
2.3 Incluir o schedule manualmente FWTOTVSLINKJOB
2.1 Executar o Wizard WIZSMARTBA
Execute o wizardWIZSMARTBA, selecione servidor (server environment) e a conexão (connection) onde serão criado os os jobs.
Image Added
Nos "parâmetros iniciais" do SmartClient, os campos "Comunicação no cliente" e "Ambiente no servidor" devem ser preenchidos com informações do seu ambiente.
Como demonstrado no gif, aqui estão os passos do wizard:
Image Added
Como demonstrado no gif, aqui estão os passos do wizard:
2.1.1 Verifique os Dados e Selecione as Empresas:
Na primeira tela do wizard, verifique se todos os itens necessários estão marcados. Se não estiverem todos os itens checados, o wizard não avançará.
Image Added
2. Selecione as Empresas :
Selecione as empresas que serão incluídas na configuração e insira o usuário e senha do administrador.
Image Added
3.Aceitar Contrato
Leia atentamente o contrato apresentado. Caso concorde com os termos, clique em "Eu Concordo" para avançar.
Image Added
Certifique-se de que este passo seja realizado em um ambiente de produção, pois a geração dos insights é feita a partir de dados históricos.
Image Added
4. Informar Credenciais:
Forneça o "Client Id" e "Client Secret". Para receber seu "Client Id" e "Client Secret", envie um e-mail solicitando para[email protected], seguindo as instruções da etapa 1 desta documentação.
IMPORTANTE
Atenção: Uso exclusivo das chaves clientId e clientSecret.
Por favor, note que as chaves clientId e clientSecret são exclusivas e não devem ser compartilhadas. Não as utilize em mais de um ambiente ao mesmo tempo. Se necessário utilizar em um outro ambiente, desative as configurações dos jobs e execute novamente o WIZSMARTBA para uso em outro ambiente.
Outros produtos “techfin” também utilizam esses campos e pode ser que os campos clientId e clientSecret já estejam preenchidos. No entanto, deve-se sempre inserir os novos para que a configuração seja realizada corretamente. Certifique-se de inserir os clientId e clientSecret corretos para a configuração do Protheus Insights.
Image Added
5. Ativando aintegração:
Image Added
Conclusão Image Added
Após a conclusão do wizard, clique em "Concluir" e acesse o SIGACFG para conferir se os schedules FWTECHFINJOB foram incluídos automaticamente e cadastre o FWTOTVSLINKJOB. É importante acessar o configurador no mesmo ambiente onde o wizard foi executado.
Acessar o configurador (SIGACFG)
Para acessar o Configurador do sistema e navegar até a opção Schedule, siga os passos abaixo:
Configurador> Schedule>Schedule
Image Added
Configurar o schedule FWTOTVSLINKJOB
Acesse o Schedule, selecione "Agendamentos", clique no ícone de incluir e adicione o jobFWTOTVSLINKJOBno cadastro de agendamentos. Siga as instruções abaixo:
Acesso ao Schedule:
Após acessar o Configurador, navegue até a opção "Schedule" conforme instruído anteriormente.
Seleção de Agendamentos:
Dentro do Schedule, localize e selecione a opção de "Agendamentos".
Inclusão de Novo Agendamento:
Procure pelo ícone de "Incluir" para criar um novo agendamento. Clique neste ícone para iniciar o processo de inclusão.
Configuração do Novo Agendamento FWTOTVSLINKJOB:
Na tela de inclusão de novo agendamento, preencha os campos necessários conforme demonstrado no exemplo. Em seguida, clique no ícone de recorrência e siga as instruções conforme demonstrado. IMPORTANTE:Não se esqueça de clicar no ícone verde para salvar.
Adicione o agente relacionado na guia Agent >Cadastro
Inicie os agentes também no monitor correspondente.
Após concluída a inicialização dos schedules Pasta Schedule (Task Manager e Queue Manager e iniciado o agente, clique em "Sair" e continue no configurador para incluir um menu no estoque e custos.
Inicie os agentes também no monitor correspondente.
Image Added
Após concluída a inicialização dos schedules Task Manager e Queue Manager e iniciado o agente, clique em "Sair" e continue no configurador.
Card
effectDuration
0.5
id
etapa3
label
Etapa 3
effectType
slide
Etapa 3
3.4 Habilitar Parametro MV_INSIGHT
2.5 Adicionar no menu do Estoque e custos o Armazém IA(ARMZIA)
2.6 Cadastrar Armazéns no Armazém IA
2.7 Verificar tabela I14 se tem o registro de permissão
2.1 Executar o Wizard WIZSMARTBA
Execute o wizardWIZSMARTBA, selecione servidor (server environment) e a conexão (connection) onde serão criado os os jobs.
Image Added
Nos "parâmetros iniciais" do SmartClient, os campos "Comunicação no cliente" e "Ambiente no servidor" devem ser preenchidos com informações do seu ambiente.
Como demonstrado no gif, aqui estão os passos do wizard:
Image Added
Como demonstrado no gif, aqui estão os passos do wizard:
2.1.1 Verifique os Dados e Selecione as Empresas:
Na primeira tela do wizard, verifique se todos os itens necessários estão marcados. Se não estiverem todos os itens checados, o wizard não avançará.
Image Added
2. Selecione as Empresas :
Selecione as empresas que serão incluídas na configuração e insira o usuário e senha do administrador.
Image Added
3.Aceitar Contrato
Leia atentamente o contrato apresentado. Caso concorde com os termos, clique em "Eu Concordo" para avançar.
Image Added
Certifique-se de que este passo seja realizado em um ambiente de produção, pois a geração dos insights é feita a partir de dados históricos.
Image Added
4. Informar Credenciais:
Forneça o "Client Id" e "Client Secret". Para receber seu "Client Id" e "Client Secret", envie um e-mail solicitando para[email protected], seguindo as instruções da etapa 1 desta documentação.
IMPORTANTE
Atenção: Uso exclusivo das chaves clientId e clientSecret.
Por favor, note que as chaves clientId e clientSecret são exclusivas e não devem ser compartilhadas. Não as utilize em mais de um ambiente ao mesmo tempo. Se necessário utilizar em um outro ambiente, desative as configurações dos jobs e execute novamente o WIZSMARTBA para uso em outro ambiente.
Outros produtos “techfin” também utilizam esses campos e pode ser que os campos clientId e clientSecret já estejam preenchidos. No entanto, deve-se sempre inserir os novos para que a configuração seja realizada corretamente. Certifique-se de inserir os clientId e clientSecret corretos para a configuração do Protheus Insights.
Image Added
5. Ativando aintegração:
Image Added
Conclusão Image Added
Após a conclusão do wizard, clique em "Concluir" e acesse o SIGACFG para conferir se os schedules FWTECHFINJOB foram incluídos automaticamente e cadastre o FWTOTVSLINKJOB. É importante acessar o configurador no mesmo ambiente onde o wizard foi executado.
Acessar o configurador (SIGACFG)
Para acessar o Configurador do sistema e navegar até a opção Schedule, siga os passos abaixo:
Configurador> Schedule>Schedule
Image Added
Configurar o schedule FWTOTVSLINKJOB
Acesse o Schedule, selecione "Agendamentos", clique no ícone de incluir e adicione o jobFWTOTVSLINKJOBno cadastro de agendamentos. Siga as instruções abaixo:
Acesso ao Schedule:
Após acessar o Configurador, navegue até a opção "Schedule" conforme instruído anteriormente.
Seleção de Agendamentos:
Dentro do Schedule, localize e selecione a opção de "Agendamentos".
Inclusão de Novo Agendamento:
Procure pelo ícone de "Incluir" para criar um novo agendamento. Clique neste ícone para iniciar o processo de inclusão.
Configuração do Novo Agendamento FWTOTVSLINKJOB:
Na tela de inclusão de novo agendamento, preencha os campos necessários conforme demonstrado no exemplo. Em seguida, clique no ícone de recorrência e siga as instruções conforme demonstrado. IMPORTANTE:Não se esqueça de clicar no ícone verde para salvar.
Adicione o agente relacionado na guia Agent >Cadastro
Inicie os agentes também no monitor correspondente.
Após concluída a inicialização dos schedules Pasta Schedule (Task Manager e Queue Manager e iniciado o agente, clique em "Sair" e continue no configurador para incluir um menu no estoque e custos.
Inicie os agentes também no monitor correspondente.
Image Added
Após concluída a inicialização dos schedules Task Manager e Queue Manager e iniciado o agente, clique em "Sair" e continue no configurador. O próximo passo será:
Habilitar o parâmetro MV_INSIGHT
Pesquise pelo parâmetro MV_INSIGHT e altere seuconteúdopara verdadeiro (.T.) :
Image Added
Image Added
Com o parâmetro alterado, clique em “salvar” para avançar para a próxima etapa, que consiste em:
Incluir um novo item no menu de estoque e custos:
Retorne ao ambiente de configurações no SIGACFG e siga os seguintes passos:
Inclua no menu do módulo deEstoque e Custosa seguinte descrição: "Armazém IA" e o programa correspondente: "ArmzIA", conforme mostrado abaixo:
Image Added
Image Added
Importante:Acesse pelo módulo de Estoque e Custos o novo item cadastrado em Produtos > Produto > Armazém IA.
Esta nova opção no menu é deextrema importância, pois você deverácadastrar os armazéns que têm demanda. Com base nesse cadastro, a inteligência artificial irá considerar os campos-chave (código do armazém) para fazer o filtro de quais insights serão gerados. Observa-se que por padrão já estão cadastrados os armazéns 01 e 03, os quais podem ser alterados ou excluídos caso não sejam utilizados, e é necessário cadastrar os armazéns de demanda e produção.
Image Added
Para garantir que toda a configuração foi feita corretamente, você receberá uma autorização que será gravada na tabela I14.
Faça uma consulta pelo banco de dados ou pela APSDU na tabela I14 e verifique se ela possui um registro onde o campo I14_MODULO está preenchido com o conteúdo 'ALL'.
Verificar as configurações do appserver.ini para o uso do PO-UI no ambiente de produção:
Essas configurações alteram a interface do Protheus, ativando o PO-UI, e devem ser realizadas no ambiente de produção para que todos os usuários tenham acesso.
Acesse o arquivo "appserver.ini" e verifique as seguintes configurações:
Na seção "[Drivers]", confirme se as linhas "MultiProtocolPort" e "MultiProtocolPortSecure" estão configuradas como: appserver.ini
Seguindo essas etapas detalhadas, você poderá configurar o Protheus Insights em seu ERP Protheus de maneira precisa e eficaz. Certifique-se de acompanhar cada passo com atenção e estar ciente das observações importantes para garantir o sucesso da configuração.
Aguardando a Execução do Modelo de IA:
Após a conclusão das etapas anteriores, o usuário deve aguardar a próxima execução do modelo de IA para geração de insights, que ocorre a cada domingo.
Este modelo recebe os dados diariamente através do job schedule FWTECHFINJOB porém o modelo é executado aos Domingos e no próximo dia útil, os usuários já poderão visualizar os insights que forem gerados.
Recebendo os Insights:
Após a execução do modelo de IA no domingo, na segunda-feira de manhã, os insights gerados são recebidos. Isso é feito através do job schedule FWTOTVSLINKJOB. Este job é responsável por disponibilizar os insights gerados.
Enquanto os insights são aguardados, os usuários podem explorar as opções disponíveis no modo de demonstração para estoque e compras.
