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
...
ATUALIZADA:
A data mínima para a LIB é 08/04/2024.
Financeiro:
Novo Gestor Financeiro configurado conforme as orientações da documentação (FINA710).
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
Informações
icon
false
1.1 Solicitar clientId e clientSecret
1.2 Verificar regras de firewall
1.3 Aplicar pacotes
Protheus Insights
Smartlink
1.
3
4 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 Verificar as Regras de Firewall:
Verifique e ajuste suas configurações de firewall conforme necessário para garantir a conectividade adequada com os serviços mencionados abaixo, caso haja alguma regra de bloqueio de firewall, por favor, liberar os seguintes endereços:
É 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]
Aplique os pacotes relacionados no ambiente de modo exclusivo:
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.
Por favor, verifique e ajuste suas configurações de firewall conforme necessário para garantir a conectividade adequada com os serviços mencionados acima.
Image Added
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
Informações
icon
false
ETAPA 2
2.1 Confirmar ativação do PO-UI para uso da nova interface
2.2 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 Removed
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 Removed
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 Removed
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 Removed
3.Aceitar Contrato
Leia atentamente o contrato apresentado. Caso concorde com os termos, clique em "Eu Concordo" para avançar.
Image Removed
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 Removed
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.
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 Removed
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 Removed
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 Removed
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 Removed
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 Removed
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 Removed
3.Aceitar Contrato
Leia atentamente o contrato apresentado. Caso concorde com os termos, clique em "Eu Concordo" para avançar.
Image Removed
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 Removed
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.
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 Removed
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 Removed
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 Removed Image Removed
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 Removed Image Removed Importante:
3 Verificar registro de permissão na tabela I14
2.1 Confirmar ativação do PO-UI para uso da nova interface
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:
Após a execução do wizard, ao acessar o schedule no configurador em agendamentos, o job FWTECHFINJOB estará criado automaticamente e habilitado, com a recorrência sempre ativa.
Image Added
Incluir o schedule manualmente FWTOTVSLINKJOB
Após confirmar que o FWTECHFINJOB foi criado automaticamente após a execução do wizard WIZSMARTBA, configure o FWTOTVSLINKJOB clicando no botão "Novo" e inserindo manualmente as configurações necessárias. Image Added
O campo "Dia e hora da primeira execução" será por padrão o horário atual, mas é possível definir um dia e horário específico para a primeira execução.
Image Added
Selecione a(s) empresa(s) e filiais de acordo com sua preferência e preencha os demais campos conforme o exemplo da imagem.
Image Added
O horário da primeira execução será conforme o que foi definido no agendamento. Após isso, ele permanecerá como sempre ativo, conforme selecionado no agendamento.
Image Added
2.4 Verificar registro de permissão na tabela I14
Ao realizar a consulta na tabela I14, ela deve apresentar um registro de permissão. Para identificar o campo I14_MODULO igual a 'ALL', o registro deve conter a data atual. Esta permissão é renovada semanalmente de forma automática, atualizando o campo I14_DTRESP.
Caso ocorra a indicação de que a tabela não existe, possivelmente devido à permissão não ter sido recebida e com isso a tabela ainda não foi criada, verifique se a tabela I14 está presente nas tabelas SX2 e SX3, conforme orientado na etapa 1.4. Se estiver presente, envie um e-mail para [email protected] informando a empresa e o código Totvs que fez a configuração, mas ainda não recebeu a permissão.
Bloco de código
language
sql
title
Exemplo
SELECT * FROM I14010 WHERE I14_MODULO= 'ALL'
Image Added
Após garantir que os itens da Etapas 1 e 2 foram concluídos com sucesso, prossiga para a Etapa 3.
Card
effectDuration
0.5
id
etapa3
label
Etapa 3
effectType
slide
Etapa 3
Informações
icon
false
3.1 Habilitar Parametro MV_INSIGHT
3.2 Adicionar no menu do Estoque e custos o Armazém IA (ARMZIA)
3.3 Cadastrar Armazéns no Armazém IA
3.1 Habilitar Parametro MV_INSIGHT
Image Added
3.2 Adicionar no menu do Estoque e custos o Armazém IA (ARMZIA)
Image Added
3.3 Cadastrar Armazéns no Armazém IA
Acesse pelo módulo de Estoque e Custos o novo item cadastrado em Produtos > Produto > Armazém IA.
Esta nova opção no menu
Este cadastro é de
extrema 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
filtrar quais insights serão gerados. Observa-se que por padrão
já estão cadastrados
, os armazéns 01 e 03
, os quais podem
já estão cadastrados, podendo ser alterados ou excluídos
caso
se não
sejam utilizados, e é
forem utilizados. É necessário cadastrar os armazéns de demanda e produção.
Image Removed
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.
Image Added
Atualização: Os registros incluídos pela rotina serão gravados na tabela 4B. Os dados já incluídos na antiga tabela 2B serão migrados automaticamente para a nova tabela.
Após garantir que os itens da Etapas 1, 2 e 3 foram concluídos com sucesso, prossiga para a Etapa 4.
Card
effectDuration
0.5
id
etapa4
label
Etapa 4
effectType
slide
Etapa 4
Informações
icon
false
4.1 Entendendo a execução do modelo de IA
4.2 Como verificar se a comunicação esta ocorrendo
4.3 Como realizar opt-out
4.1 Entendendo a Execução do modelo de IA
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
semanalmente aos domingos. Durante essa execução, os dados coletados 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
são processados e analisados para gerar insights.
Recebendo os Insights
:Após a
Os insights gerados são disponibilizados na segunda-feira de manhã, após a primeira execução do modelo de IA no domingo
, na segunda-feira de manhã, os insights gerados são recebidos. Isso é feito
. Esse processo é realizado através do job schedule FWTOTVSLINKJOB, que habilita outros jobs responsáveis por enviar os insights para o Protheus.
Importante:
Os insights podem ser recebidos diariamente, sendo gerados conforme regras específicas para cada tipo. É crucial manter os jobs ativos para continuar recebendo atualizações de insights. A geração de insights ocorre diariamente, seguindo regras específicas para cada tipo de insight. A execução semanal do modelo de IA incorpora aprendizados contínuos, melhorando sua precisão ao longo do tempo.
4.2 Como verificar se a comunicação esta ocorrendo
Acesse o configurador dentro da pasta Smartlink e clique na opção Parametros de Conexão, caso nao esteja disponível consulte a documentação Comunicação SmartLink para configurar o FwSgdpParm.
Clique no botão Testar conexão para verificar se esta funcionado a comunicação.
Image Added
Atenção, estas informacoes são sensíveis e caso voce delete e clique em confirmar será necessário executar o wizard novamente, pois quando os campos clientID e clientSecret são deletados após confirmar o sistema entende como um opt-out,
4.3 Como realizar opt-out e excluir as credenciais
Caso após a configuração quiser parar a utilização dos insights siga os passos abaixo para realizar o opt-out e excluir as credenciais:
Importante: Esse procedimento para toda a comunicação do smartlink e isso pode impactar alem do Protheus Insights, também produtos como Gesplan e Techfin que utilizam o smartlink.
Passo1: Acesse o schedule no configurador para remover as rotinas FWTOTVSLINKJOB e FWTECHFINJOB de agendamentos (schedule) para garantir que não haja envio de dados.
Passo 2: Acesse o configurador dentro da pasta Smartlink e clique na opção Parametros de Conexão, caso nao esteja disponível consulte a documentação Comunicação SmartLink para configurar o FwSgdpParm.
Delete as credenciais presentes nos campos. com os dois campos em "branco" e clique em "Confirmar" para salvar as alterações.
Image Added
Passo 3: Remover os dados e insights da plataforma Carol: Envie um e-mail para [email protected] solicitando a exclusão dos insights, informando Razão Social, CNPJ, Código TOTVS, clientId e clientSecret.
Dica
icon
false
Importante:
As chaves clientId e clientSecret são exclusivas e não devem ser compartilhadas entre ambientes.
Outros produtos como "techfin", "gesplan", podem usar esses campos credenciais parecidas, então garanta que esta utilizando as chaves (clientId e clientSecret) corretas para o Protheus Insights ao executar o WIZSMARBA ou ao fazer o opt-out.
Se precisar utilizar em outro ambiente o clientId e clientSecret, realize o procedimento de opt-out acima e desative as configurações dos jobs e execute novamente o WIZSMARTBA
. 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