Linha Microsiga Protheus

Árvore de páginas

Carregando...

Versões comparadas

Versão antiga 50

changes.mady.by.user Marcia Junko Doi

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Giovani Leandro Zago

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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 versão mínima da LIB necessária para o funcionamento é 20250407. Recomenda-se sempre utilizar a versão mais recente disponível no portal de downloads.

  • Pacote Smartlink:

    • A versão mínima do pacote do Smartlink necessária para o funcionamento é 20240701 2.6.0. Recomenda-se sempre utilizar a versão mais recente disponível no portal de downloads.
  • Financeiro:
    • Novo Gestor Financeiro configurado conforme as orientações da documentação  (FINA710).
    • Possuir, no mínimo, 11 semanas ou 2 anos de movimentação e 11 meses de dados movimentação consecutivas nas tabelas FK1 e FK2. Além disso, as tabelas SE1 e SE2 devem conter os campos E1_FLUXO e E2_FLUXO, ambos com o valor "S".
  • Conciliador Backoffice configurado conforme as orientações da documentação CTBA940
    • Execução da opção 4 do WizardUUID para preenchimento dos campos MDUIDT

  • Estoque e Compras

    • Ter, no mínimo, 2 anos de histórico de movimentações de estoque ( SD3 ) .
    • Contabilidade
    • e notas fiscais ( SD1 e SD2 ).

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 squad.ba@totvs.com.br.

Deck of Cards
startHiddenfalse
idstep-config
Se o REST já estiver configurado em seu ambiente, acesse-o via navegador utilizando o endereço onde o REST está configurado, exemplo http://localhost:8080/rest.
http://{IP do servidor}:{port}/{path}" 
Verifique na lista de APIs disponíveis se a rota api/ba/v1/insights/Alerts está presente.

Com essa validação concluída, você pode prosseguir para a próxima etapa, caso nao tenha configurado o REST siga o passo a passo abaixo.

No appserver.ini insira as configurações abaixo:

[GENERAL] MAXSTRINGSIZE=10 [HTTPV11] Enable=1 Sockets=HTTPREST [HTTPREST] Port=8080 URIs=HTTPURI SECURITY=1 [HTTPURI] URL=/rest PrepareIn=All Instances=1,2 [ONSTART] jobs=HTTPJOB RefreshRate=30 [HTTPJOB] MAIN=HTTP_START ENVIRONMENT=environment

Iniciar o appserver
Screenshot_16.jpgImage Removed


Após acessar o navegador com o endereço http://localhost:8080/rest, será exibida uma lista de APIs disponíveis.

Definição da URL:
http://{IP do servidor}:{porta}/{caminho}

Essa página exibe as classes WSRESTFUL compiladas no RPO do ambiente configurado. Ao clicar nos detalhes de cada classe, os métodos disponíveis serão mostrados.

Para confirmar que tudo está correto, pesquise pela API :

Card
defaulttrue
effectDuration0.5
idetapa1
labelEtapa 1
effectTypeslide

Etapa 1

Informações
iconfalse

1.1 Solicitar clientId e clientSecret

1.2 Verificar regras de firewall

1.3 Aplicar pacotes

Pacote Protheus Insights

Smartlink

1.4 Executar o UPDDISTR do arquivo de dicionário contido no pacote Protheus Insights  (em modo exclusivo)1.5 Configurar o REST

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 squad.ba@totvs.com.br 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:

https://app.carol.ai
https://provisioning.totvs.app
https://link.totvs.app
https://api-smartlink
https://admin.rac.totvs.app
https://provisioning.totvs.app
https://api-maisprazo.totvs.app
https://totvstechfin.carol.ai/api

1.3 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, envie email para squad.ba@totvs.com.br


Nota

Lembre-se sempre de realizar um backup completo do ambiente antes de realizar atualizações no repositório e\ou base de dados, para garantir a segurança do ambiente e a possibilidade de restauração em caso de necessidade.

Dica
titleImportante

Para garantir o correto funcionamento, é fundamental que os pacotes de expedição contínua dos módulos que utilizam o Protheus Insights estejam atualizados. Esses módulos incluem:  Compras, Estoque e Financeiro e estão disponíveis no pacote de expedição contínua do Backoffice.

Pacote de Atualização - Backoffice - 12.1.2310

Pacote de Atualização - Backoffice - 12.1.2410

Nota
titleAmbientes com múltiplos RPOs

Caso o ambiente do cliente possua vários appservers configurados, é necessário aplicar os pacotes em todos os repositórios, incluindo o repositório do scheduler.

Avisotip
titleEvoluções do Protheus Insights

O produto Protheus Insights está em constante evolução, e  e para manter a compatibilidade entre o dicionário de dados e o repositório é imprescindível realizar a atualização do dicionário sempre que o pacote do Protheus Insights é aplicado.

Dica
titleImportante

Observação: Após aplicar o pacote da Expedição Contínua do módulo Financeiro, deverá aplicar os pacotes informados abaixo:

PACOTE PONTUAL FINANCEIRO:2210: https://suporte.totvs.com/portal/p/10098/download?e=1175997
2310: https://suporte.totvs.com/portal/p/10098/download?e=1175994
2410: https://suporte.totvs.com/portal/p/10098/download?e=1175995PACOTE PONTUAL PROTHEUS INSIGHTS:
12.


1

.2210:https://r.totvs

.

io/p/1177543
12.1.2310:https://r.totvs.io/p/1177544 
12.1.2410:https://r.totvs.io/p/1177545

Esses pacotes se fazem necessarios pois a expedição continua do financeiro esta com fontes desatualizados.

1.4 Executar o UPDDISTR ou UPDBATCH


  • Dicionário do pacote Protheus Insights.

    • 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.
      • O recomendável é aplicar a atualização do dicionário em todas as empresas cadastradas.
    • Caso tenha dúvidas de como executar a atualização, verifique a documentação:  Atualizador de dicionário e base de dados - UPDDISTR e UPDBATCH - Atualização de pacotes.
    • Após o término da atualização, verifique cuidadosamente se todas as tabelas necessárias foram criadas.

      Exemplo: 

Bloco de código
languagesql
SELECT * FROM SX2010 WHERE X2_CHAVE = 'I19'

SELECT * FROM SX3010 WHERE X3_ARQUIVO = 'I19'


1.5 Configurar REST

Para configurar o serviço REST, precisamos das seguintes chaves(ini):
Dica
Bloco de código
languagejs
themeRDark
linenumberstrue
Bloco de código
languagejs
themeMidnight
api/ba/v1/insights/Alerts

Em caso de dúvidas sobre configuração do REST consulte: Documento de referência sobre RESTApós garantir que os itens da Etapa 1 foram concluídos com sucesso, prossiga para a Etapa 2.

Card
effectDuration0.5
idetapa2
labelEtapa 2
effectTypeslide

Etapa 2

Informações
iconfalse

2.1 Confirmar ativação do PO-UI para uso da nova interface

2.2 Executar o WIZSMARTBA

Verificar o schedule FWTECHFINJOB

Incluir o schedule manualmente FWTOTVSLINKJOB


Nota

A partir da lib de Janeiro/2025 os jobs FWTECHFINJOB e FWTOTVSLINKJOB não são/devem ser criados no Schedule.
Assim que as credenciais forem cadastradas no Protheus via Wizard, os jobs serão iniciados nativamente. Com isso, não haverá o cadastro destes jobs na tabela XX1 - Agendamentos do Schedule.

A documentação deste item está disponível em https://tdn.totvs.com/pages/releaseview.action?pageId=905609875

Nota
titleClientes com ambiente no Cloud da TOTVS

Quando o cliente possui o ambiente no Cloud da TOTVS, é obrigatório rodar a rotina WIZSMARTBA configurada deve ser executada no Tipo de Comunicação WF.


2.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.

  1. 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:

      [Drivers]
      MultiProtocolPort=1
      MultiProtocolPortSecure=0

    • Na seção "[General]", assegure-se de que o "App_Environment" esteja direcionado para o ambiente principal, por exemplo:

      [General]
      App_Environment= insira_o_nome_do_seu_ambiente

2.2 Executar o WIZSMARTBA



Verificar o schedule FWTECHFINJOB

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.

 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.

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.

Selecione a(s) empresa(s) e filiais de acordo com sua preferência e preencha os demais campos conforme o exemplo da imagem.

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.

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 squad.ba@totvs.com.br 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
languagesql
titleExemplo
SELECT * FROM I14010 WHERE I14_MODULO= 'ALL'





Após garantir que os itens da Etapas 1 e 2 foram concluídos com sucesso, prossiga para a Etapa 3.

Card
effectDuration0.5
idetapa3
labelEtapa 3
effectTypeslide

Etapa 3

Informações
iconfalse

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

3.2 Adicionar no menu do Estoque e custos o Armazém IA (ARMZIA) 

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.

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 filtrar quais insights serão gerados. Observa-se que por padrão, os armazéns 01 e 03 já estão cadastrados, podendo ser alterados ou excluídos se não forem utilizados. É necessário cadastrar os armazéns de demanda e produção.

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
effectDuration0.5
idetapa4
labelEtapa 4
effectTypeslide

Etapa 4

Informações
iconfalse

4.1 Entendendo a execução do modelo de IA

4.2  Como testar a comunicação Smartlink

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, que ocorre semanalmente aos domingos. Durante essa execução, os dados coletados diariamente através do job schedule FWTECHFINJOB são processados e analisados para gerar insights.

Recebendo os Insights

Os insights gerados são disponibilizados na segunda-feira de manhã, após a primeira execução do modelo de IA no domingo. 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.

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.



Atenção, estas informações são sensíveis e caso voce delete e clique em confirmar será necessário executar o wizard novamente.

Dica
iconfalse

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 está utilizando as chaves (clientId e clientSecret) corretas para o Protheus Insights ao executar o WIZSMARBA.

...