Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
titleImportante

O aplicativo Protheus Event Viewer agora se chama Meu Protheus

Painel
borderStylenone
Column
width80%

Deck of Cards
effectDuration0.5
idCABECALHOcabecalho
effectTypeslide
Card
defaulttrue
effectDuration0.5
idMEU_PROTHEUSmeu-protheus
labelMEU PROTHEUSMeu Protheus
titleMEU PROTHEUSMeu Protheus
effectTypeslide
Deck of Cards
effectDuration0.5
idTUDOtudo-SOBREsobre
effectTypeslide
Card
defaulttrue
effectDuration0.5
idINTRODUCAOIntroducao
labelINTRODUÇÃOIntrodução
titleINTRODUÇÃOIntrodução
effectTypeslide
Column

Introdução

Este documento possui o intuito de conscientizar os clientes, analistas e desenvolvedores, que utilizam ou que querem aderir na sua rotina de trabalho as funcionalidades que são disponibilizadas pelo aplicativo Meu Protheus

Aqui você entenderá:

  • O que é o aplicativo Meu Protheus.
  • Entenderá o que são Eventos e Aprovações.
  • Como configurar todos os passos para utilizar o Meu Protheus. 
  • Verá o escopo e as interfaces do aplicativo em pequenas demonstrações para ter melhor visibilidade do produto. 
Column






Homem caminhandoImage Modified

Card
defaulttrue
effectDuration0.5
idSOBRE
labelSOBRE
titleSOBRE
effectTypeslide

Sobre

O Meu Protheus  é um aplicativo da companhia TOTVS que possui integração com o ambiente do ERP PROTHEUS.

O  principal objetivo do Meu Protheus é permitir com que o usuário possa ser informado sobre eventos que ocorrem no seu ambiente do ERP PROTHEUS por meio de notificações recebidas pelo aplicativo. 

O aplicativo possui um escopo gerencial focado em:

  • Validar eventos que iniciaram, terminaram ou que tiveram algum problema ao serem processados por meio de notificações.  
  • Filtrar visualização de eventos. 
  • Processamento da Folha de Pagamento.
  • Término do recálculo do custo médio.
  • Processamento de Contabilização.
  • Aprovação de orçamento. 
  • Produto atingiu ponto de pedido.
  • Lote de produto vencido.

Ou seja, se você utiliza essas funcionalidades do PROTHEUS pelo SMARTCLIENT, por meio do APP você terá condições de acessar essas funcionalidades em qualquer lugar na palma da mão.

Para conhecermos mais sobre o Meu Protheus veja o vídeo a seguir: 


Painel
borderStylenone
titleVIDEO MEU PROTHEUS
Column
width500

Conector de Widget
width500
urlhttps://www.youtube.com/watch?v=9oFUojwBpuA
height500

Column
width50



Homem e Mulher num bate papo pelo celularImage Modified

Deck of Cards
effectDuration0.5
idFUNCIONALIDADES
effectTypeslide
Card
defaulttrue
effectDuration0.5
idEVENTOS
labelEVENTOS
titleEVENTOS
effectTypeslide

Eventos

Os eventos possuem descrição e o nome da rotina acionada, ou seja, nome da ação que foi disparada ao realizar determinado evento e o que foi feito na atividade consequentemente.

Os eventos podem ser divididos em duas modalidades: 

  • Pré-definidos

São os eventos padrões que são configurados por meio da inscrição do EVENT VIEWER. O EVENT VIEWER registra os eventos que são pré-definidos ocorridos no PROTHEUS enviados por e-mail ou rss.

  • Personalizados

São os eventos que são customizados. Aderente a qualquer rotina customizada.

Card
defaulttrue
effectDuration0.5
idAPROVACOES
labelAPROVAÇÕES
titleAPROVAÇÕES
effectTypeslide

Aprovações

As Aprovações são como documentos que precisam de autorização de um órgão superior para serem continuados. Exemplo: Suponha que um produto tenha atingido o limite máximo no estoque e tenha acionado o pedido de compra. Pelo Meu Protheus poderá ser liberado a ordem de pedido de compra por meio de uma aprovação. Caso não seja uma atividade válida o usuário poderá reprovar a solicitação. 

Pode-se ver que isso trás uma facilidade muito maior para os usuários do PROTHEUS que agora poderão utilizar o sistema sem estarem conectados via SMARTCLIENT.  

Card
defaulttrue
effectDuration0.5
idCONFIGURACAO
labelCONFIGURAÇÃO
titleCONFIGURACAO
effectTypeslide

Configuração

O Meu Protheus  é mais uma forma que os usuários têm de conseguirem utilizar o ERP PROTHEUS. Por esse motivo é necessário que se crie as configurações necessárias para que exista a integração entre aplicativo e o ambiente.

Para conhecermos mais sobre essa configuração veja o vídeo a seguir:


Painel
borderStylenone
titleVIDEO ENTENDENDO CONFIGURAÇÕES
Column
width500

Conector de Widget
width500
urlhttps://www.youtube.com/watch?v=-FABlOLej_M
height500

Column
width50




Homem com mãos para cima ao fundo gráficosImage Modified

Deck of Cards
effectDuration0.5
idEVENTOS
effectTypeslide
Card
defaulttrue
effectDuration0.5
idPADRAO
labelPADRÃO
title PADRÃO
effectTypeslide
Deck of Cards
effectDuration0.5
idEVENTO-PADRAO
effectTypeslide
Card
defaulttrue
effectDuration0.5
idAMBIENTE_PROTHEUS
labelAMBIENTE PROTHEUS
titleAMBIENTE PROTHEUS
effectTypeslide

Configurando o seu ambiente

  1. Configurar REST PROTHEUS
  2. Se você é cliente solicite um ALIAS pelo MINGLE. Se você é TOTVER crie um Alias pelo APPLINKER.
  3. Preencher o parâmetro MV_MINGKEY (Token de acesso).
    1. Acessar o módulo Configurador (SIGACFG)

    2. Acessar a rotina Base de Dados > Dicionário > Base de Dados. 
    3. Clicar sobre o ícone + para expandir as opções e clicar em Parâmetros.
    4. Clicar sobre a lupa e pesquisar por MV_MINGKEY.
    5. Preencher nos campos Cont. Por, Cont. Ing, Cont. Esp com o TOKEN.


Dica
  1. Se você solicitou o ALIAS pelo MINGLE ou pelo APPLINKER você receberá o TOKEN junto com ALIAS.
Painel
borderStylenone
titleILUSTRAÇÃO DE PREENCHIMENTO DE PARÂMETRO

Card
defaulttrue
effectDuration0.5
idCONFIGURACAO-USUARIO
labelCONFIGURAÇÃO DO USUÁRIO
titleCONFIGURAÇÃO DO USUÁRIO
effectTypeslide

Verificar permissão de usuário

  1. Acessar o módulo Configurador (SIGACFG)
  2. Acessar a rotina Usuário > Senhas > Usuários. 
  3. Pesquisar pelo usuário que será alterado.
  4. Abrir a aba Restrições de Acesso > Aba Acessos.
  5. Habilitar a permissão 174.


Painel
borderStylenone
titleILUSTRAÇÃO DE VALIDAÇÃO DE PERMISSÃO DE USUÁRIO


Card
defaulttrue
effectDuration0.5
idINSCRICAO-USUARIO
labelINSCRIÇÃO DO USUÁRIO
titleINSCRIÇÃO DO USUÁRIO
effectTypeslide

Inscrever Event Viewer

  1. Acessar em qualquer módulo, Miscelânea > Inscr. Event Viewer.
  2. Selecionar o canal “002”.
  3. Selecionar categoria “001.
  4. Selecionar o evento que o usuário.
  5. Selecionar Sim no campo Json.

Se desejar poderá olhar aqui  a documentação completa de Event V. 

Painel
borderStylenone
titleILUSTRAÇÃO DE VALIDAÇÃO DE PERMISSÃO DE USUÁRIO




Card
defaulttrue
effectDuration0.5
idCUSTOMIZADO
labelCUSTOMIZADO
titleCUSTOMIZADO
effectTypeslide
Deck of Cards
effectDuration0.5
idCONFIGURACAO_MECANISMO
effectTypeslide
Card
defaulttrue
effectDuration0.5
idAMBIENTE_PROTHEUS
labelAMIBIENTE PROTHEUS
titleAMBIENTE PROTHEUS
effectTypeslide

Configurando o seu ambiente

  1. Configurar REST PROTHEUS
  2. Se você é cliente crie um ALIAS e TOKEN no MINGLE. Se você é TOTVER crie um Alias pelo APPLINKER.
  3. Preencher o parâmetro MV_MINGKEY (Token de acesso).
    1. Acessar o módulo Configurador (SIGACFG)

    2. Acessar a rotina Base de Dados > Dicionário > Base de Dados. 
    3. Clicar sobre o ícone + para expandir as opções e clicar em Parâmetros.
    4. Clicar sobre a lupa e pesquisar por MV_MINGKEY.
    5. Preencher no Cont. Por, Cont. Ing, Cont. Esp o TOKEN.


Dica
  1. Se você solicitou o ALIAS pelo MINGLE ou pelo APPLINKER você receberá o TOKEN junto com ALIAS.
Painel
borderStylenone
titleILUSTRAÇÃO DE PREENCHIMENTO DE PARÂMETRO

Card
defaulttrue
effectDuration0.5
idCRIACAO-EVENTO
labelCRIAÇÃO DO EVENTO
titleCRIAÇÃO DO EVENTO
effectTypeslide

Criando  o evento

  1. Acessar o módulo CONFIGURADOR (SIGACFG)
  2. Acessar a rotina Ambiente > Cadastro > Tabelas.
  3. Pesquisar pela tabela (E3).
  4. Clicar no botão Editar.
  5. Incluir o novo evento.


Painel
borderStylenone
titleILUSTRAÇÃO DE INCLUSÃO DE EVENTO


Card
defaulttrue
effectDuration0.5
idCONFIGURACAO-USUARIO
labelCONFIGURAÇÃO DO USUÁRIO
titleCONFIGURAÇÃO DO USUÁRIO
effectTypeslide

Verificar permissão usuário

  1. Acessar o módulo Configurador (SIGACFG)
  2. Acessar a rotina Usuário > Senhas > Usuários. 
  3. Pesquisar pelo usuário que será alterado.
  4. Abrir a aba Restrições de Acesso > Aba Acessos.
  5. Habilitar a permissão 174.


Painel
borderStylenone
titleILUSTRAÇÃO DE VALIDAÇÃO DE PERMISSÃO DE USUÁRIO


Card
defaulttrue
effectDuration0.5
idINSCRICAO-USUARIO
labelINSCRIÇÃO DO USUÁRIO
titleINSCRIÇÃO DO USUÁRIO
effectTypeslide

Inscrever Event Viewer

  1. Acessar em qualquer módulo, Miscelânea > Inscr. Event Viewer.
  2. Selecionar o canal “002”.
  3. Selecionar categoria “001.
  4. Selecionar o evento que o usuário.
  5. Selecionar Sim no campo Json.

Se desejar poderá olhar aqui  a documentação completa de Event Viewer. 

Painel
borderStylenone
titleILUSTRAÇÃO DE VALIDAÇÃO DE PERMISSÃO DE USUÁRIO




Card
defaulttrue
effectDuration0.5
idNOTIFICACAO
labelNOTIFICAÇÃO
titleNOTIFICAÇÃO
effectTypeslide

Compilando e enviando notificação

Para que você receba uma notificação no Meu Protheus você deverá compilar a função que aciona a notificação e o acionar a notificação.


Deck of Cards
effectDuration0.5
idNOTIFICACOES
effectTypeslide
Card
defaulttrue
effectDuration0.5
idCOMPILANDO
labelCOMPILANDO
titleCOMPILANDO
effectTypeslide

Compilar fonte no RPO

Para funções customizadas você deverá compilar o fonte exemplo  no RPO com o seguinte código.


Dica

O código a seguir é apenas um exemplo. Você poderá customizar ele da melhor forma para que atenda as suas necessidades. Segue a documentação do fonte.  

Bloco de código
languagejs
themeRDark
firstline0
titleExemplo para envio de notificação.
linenumberstrue
#include 'PROTHEUS.CH'

#include 'FWEVENTVIEWCONSTS.CH'

/**
* AUTOR: GABRIEL GAMELEIRA DOS SANTOS
* DATA: 29/09/2020
* HORA: 12:19
* FINALIDADE DO PROGRAMA: CRIAR EVENTO CUSTOMIZADO. LEMBRANDO QUE ESTE FONTE PRECISA SER ADD NA SUA FUNCAO CUSTOMIZADA PARA QUE NO MOMENTO QUE FUNCAO SER CHAMADA EXECUTE O EVENTO  
*/

User Function MOBILE0000()

    Local cEventId := "062"

    Local cMensagem := "Evento enviado!"

    Local cTitulo := "Teste do Evento" + Time() //FUNCAO TIME PEGA O HORARIO ATUAL BASEADO NO S.O

    RPCSETTYPE(3) //NAO CONSOME LICENSAS

    RPCSETENV("99", "01") //ABERTURA DO AMBIENTE PASSANDO OS ARGUMENTOS EMPRESA E FILIAL RESPECTIVAMENTE
    
    EventInsert(FW_EV_CHANEL_ENVIRONMENT, FW_EV_CATEGORY_MODULES, cEventId, FW_EV_LEVEL_INFO, "", cTitulo, cMensagem, .T.) //CHAMADA DO EVENTO

Return Nil

Dica

Você poderá alterar o quarto argumento passado na função EventInsert por qualquer um dos valores listados abaixo. As outras constantes mantenha pois é padrão.  

PALAVRA CHAVESIGNIFICADOCOR
FW_EV_LEVEL_INFOMENSAGEM DE INFORMACÃOCINZA
FW_EV_LEVEL_ERRORMENSAGEM DE ERROVERMELHO
FW_EV_LEVEL_WARNINGMENSAGEM DE ATENÇÃOAMARELO
Card
defaulttrue
effectDuration0.5
idCHAMANDO-EVENTO
labelCHAMANDO EVENTO
titleCHAMANDO EVENTO
effectTypeslide

Executando o evento

Para que você receba os eventos execute a função customizada que você adicionou no RPO. Caso você simplesmente tenha compilado o fonte no RPO você chamar a função na chamada do SMART CLIENT, chamar ele em um menu que você associou a função ou qualquer outra solução encontrada por você. A seguir um exemplo de execução da função sendo feita nos Parâmetros Iniciais ao clicar sobre o SMART CLIENT:


Painel
borderStylenone
titleILUSTRAÇÃO DE CHAMADA DA FUNÇÃO

SmartClient chamando a funçãoImage Modified



Aviso
titleCREDENCIAIS

É preciso um usuário e senha do Protheus (a partir da versão 12.1.17) para utilizá-lo.

Aviso
titleCONFIGURADOR

Ter a rotina EVENT VIEWER do módulo Configurador implantada e funcional.

Aviso
titleLIB

A lib com a funcionalidade precisa ser igual ou superior a 20180216;

Dica
titleSUPORTE

Para uso antes da liberação de janeiro/2018 do Protheus é necessário entrar em contato com o SUPORTE da TOTVS e solicitar o pacote para atualização do ambiente via UPDDISTR.






Card
defaulttrue
effectDuration0.5
idINSTALACAO
labelINSTALAÇÃO
titleINSTALAÇÃO
effectTypeslide

Instalando no seu celular

O Meu Protheus  está disponível nas duas principais lojas de distribuição de aplicativos.

Você poderá ir na loja pesquisar por Meu Protheus, clicar sobre o mesmo e instalar.

Clique sobre o ícone do seu sistema operacional para ser encaminhado para a loja. 


Painel
borderStylenone
titleAPLICATIVO DISPONIVEL EM ANDROID E IOS



Column
width250

AndroidImage Modified

Column
width250

IOSImage Modified

Card
defaulttrue
effectDuration0.5
idINTERFACE
labelFUNCIONALIDADES E INTERFACES
titleFUNCIONALIDADES
effectTypeslide
Deck of Cards
effectDuration0.5
idTODAS_FUNCIONALIDADES
effectTypeslide
Card
defaulttrue
effectDuration0.5
idACESSO
labelACESSO
titleACESSO
effectTypeslide

Acessando o seu ambiente

Para realizar o seu acesso utilize: 

  • Usuário 
  • Senha
  • Alias

Nos campos Usuário e Senha deverá ser informado os mesmos dados que você utiliza quando acessa o seu ambiente no ERP PROTHEUS via SMARTCLIENT.

No campo Alias informe o seu identificador no MINGLE ou APPLINKER. 


Painel
borderStylenone
titleILUSTRAÇÃO DE ACESSO
Column
width500


Tela de acesso Image Modified



Column
width50



Mulher negra mexendo no computadorImage Modified



Card
defaulttrue
effectDuration0.5
idSOLICITAR-ALIAS
labelSOLICITAR ALIAS
titleSOLICITAR ALIAS
effectTypeslide

Solicitando um Alias

Por meio do aplicativo, na tela de acesso é possível solicitar um Alias. Para solicitar um Alias clique sobre . Será exibido uma tela solicitando: 

  • Nome
  • Nome da empresa
  • E-mail
  • Telefone

Todos os campos solicitados serão utilizados para entrarmos em contato com os clientes que precisam de um Alias e que não fizeram seu cadastro por meio do MINGLE


Painel
borderStylenone
titleILUSTRAÇÃO DE SOLICITAÇÃO DE ALIAS
Column
width500


Tela de solicitação de AliasImage Modified

Column
width50



Homem mexendo no celular. Gráficos ao fundoImage Modified

Card
defaulttrue
effectDuration0.5
idFILIAL
labelFILIAL
titleFILIAL
effectTypeslide

Escolha uma Filial

Após o acesso, escolha uma Filial.

Caso deseje filtrar uma Filial da lista de filiais, você poderá encontrar uma Filial pesquisando pelo código ou pelo nome no campo de busca .


Painel
borderStylenone
titleILUSTRAÇÃO DE COMO ESCOLHER UMA FILIAL
Column
width500


Tela de escolha da filialImage Modified{
Column
width50



Homem negro mexendo no celularImage Modified

Card
defaulttrue
effectDuration0.5
idEVENTOS
labelEVENTOS
titleEVENTOS
effectTypeslide

Eventos


Com a Filial escolhida, você terá acesso aos Eventos que ocorrem no seu ambiente do ERP PROTHEUS. 

Os eventos são exibidos logo após a escolha da Filial. Caso você mude para Aprovações e deseje voltar para a lista de eventos clique no ícone .


Painel
borderStylenone
titleILUSTRAÇÃO DE VISUALIZAÇÃO DE EVENTOS
Deck of Cards
effectDuration0.5
idteste
effectTypeslide
Card
defaulttrue
effectDuration0.5
idVISUALIZAR-EVENTOS
labelVISUALIZAR EVENTOS
titleVISUALIZAR EVENTOS
effectTypeslide

Visualizar

Para obter mais detalhes sobre um evento clique sobre o ícone  para expandir mais informações sobre o evento. 


Column
width500


Tela de visualização de eventosImage Modified{
Column
width50



Homem mexendo no celularImage Modified

Card
defaulttrue
effectDuration0.5
idFILTRAR-EVENTOS
labelFILTRAR EVENTOS
titleFILTRAR EVENTOS
effectTypeslide

Filtrar

Para filtrar um evento clique sobre o ícone  e escolha a sua condição para filtrar os eventos. É possível realizar o filtro de eventos pelas seguintes condições:

  • Nome da rotina
  • Mensagem
  • Titulo
  • Período
  • Criticidade
  • Tipo do evento


Column
width500


Tela de filtro de eventosImage Modified{
Column
width50


Homem mexendo no celularImage Modified

Card
defaulttrue
effectDuration0.5
idCOMPARTILHAR
labelCOMPARTILHAR
titleCOMPARTILHAR
effectTypeslide

Compartilhar

Para compartilhar um evento clique e segure sobre o evento. Espere a tela de aplicativos que são possíveis serem utilizados para compartilhar o evento. 


Column
width500

Tela de compartilhamento de eventosImage Modified

{
Column
width50


Pessoas conversandoImage Modified

Card
defaulttrue
effectDuration0.5
idAPROVACOES
labelAPROVAÇÕES
titleAPROVAÇÕES
effectTypeslide

Aprovações

Com a Filial escolhida, você terá acesso as Aprovações que ocorrem no seu ambiente do ERP PROTHEUS. Para ter acesso a lista de aprovações clique no ícone .

Ao clicar sobre um item na lista de Aprovações você terá duas opções:

  • Aprovar 
  • Reprovar

Para qualquer uma das situações será apresentado uma tela para que o Aprovador justifique sua decisão. Se clicar em reprovar terá que justificar o motivo da sua escolha. A justificação não é obrigatória em caso  de aprovação.  


Painel
borderStylenone
titleILUSTRAÇÃO DE APROVAÇÕES
Column
width500

Tela de aprovaçõesImage Modified

Column
width50



Homem mexendo no celularImage Modified

Card
defaulttrue
effectDuration0.5
idUSUARIO
labelUSUÁRIO
titleUSUÁRIO
effectTypeslide

Usuário

Você poderá ver algumas informações importantes do seu usuário enquanto estiver acessando seu ambiente.

  • Usuário
  • Cliente
  • Empresa
  • Set
  • Filial


Painel
borderStylenone
titleILUSTRAÇÃO DE ACESSO AS INFORMAÇÕES DE USUÁRIO
Column
width500

Tela de perfilImage Modified

Column
width50



Homem mexendo no celularImage Modified

Suporte
Card
defaulttrue
effectDuration0.5
idSUPORTE
labelSUPORTE
effectTypeslide
Perguntas Frequentes (FAQs)


Expandir
titleQual o meu Usuário e Senha?

Correspondem ao mesmo usuário e senha que você utiliza para fazer acesso no PROTHEUS via SMARTCLIENT.

Expandir
titleO que é o Alias?

Um ALIAS é um identificador único do cliente na TOTVS. Cada cliente pode ter mais de um ALIAS e cada ALIAS corresponde a um PROTHEUS instalado.

O ALIAS é a chave para que o aplicativo consiga encontrar o PROTHEUS e assim realizar a comunicação.

Se você ainda não possui um ALIAS, solicite o seu através da abertura de um chamado no Portal do Cliente ou acesse AQUI.

Expandir
titleEsqueci o meu Usuário e/ou Senha. O que faço?

Sua senha pode ser redefinida somente através do PROTHEUS.

Expandir
titleQuais eventos eu visualizo?

No aplicativo são visualizados somente os eventos a que o usuário do PROTHEUS está cadastrado na inscrição EVENT VIEWER.

Os eventos são enviados para o App através da notificação e também na home do aplicativo.

Expandir
titleQuais os status dos eventos?

Os status dos eventos são:

  • Cinza: Informação
  • Amarelo: Alerta
  • Vermelho: Erro
Expandir
titleComo compartilho um Evento?

Na tela do MEU PROTHEUS, selecione o evento e clique no botão compartilhar.

Expandir
titleComo sair do Aplicativo?

Na tela de Configurações, clicar no botão Sair.

Materiais Auxiliares

Os materiais abaixo dizem respeito ao EVENT VIEWER do PROTHEUS e ao TOTVS MINGLE:

Configurar Event Viewer

Como adicionar uma rotina de usuario no Event Viewer

Acesso Aplicativos Móveis


HTML
<!-- esconder o menu --> <style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } </style>



HTML
<style>

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:link, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:visited, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:focus, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:hover, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:active {
color: white;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after {
background: white; !important}
Composition Setup
deck.tab.inactive.background = #e7e7e7
deck.tab.active.background = #252626