Á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

Deck of Cards
effectDuration0.5
idcabecalho
effectTypeslide
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
idmeu-protheus
labelMeu Protheus
titleMeu Protheus
effectTypeslide

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

Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
Card
defaulttrue
effectDuration0.5
idIntroducao
labelIntrodução
titleIntrodução
effectTypeslide
Column

Conteúdo

Este documento possui o intuito de ser um guia para 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ê verá:

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






Homem caminhando

Card
defaulttrue
effectDuration0.5
idSobre
labelSobre
titleSobre
effectTypeslide

Escopo

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 que o usuário possa ser informado sobre eventos e interagir com aprovações 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.

Entre muitos outros eventos que estão cadastrados na tabela de eventos (E3).

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 conhecer mais sobre o MEU PROTHEUS assista ao vídeo: 


Painel
borderStylenone
titleConheça o 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 celular


A seguir você pode encontrar mais informações sobre o escopo do produto baseado nas funcionalidades.

Deck of Cards
effectDuration0.5
idFuncionalidades
effectTypeslide
Card
defaulttrue
effectDuration0.5
idEventos
labelEventos
titleEventos
effectTypeslide

O que são ?

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

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 eventos que podem ser criados especificamente para uso em rotinas customizadas, criadas pelo cliente.. Aderente a qualquer rotina customizada.

Card
defaulttrue
effectDuration0.5
idAprovacoes
labelAprovações
titleAprovações
effectTypeslide

O que é ?

Suponha que um produto tenha atingido o limite mínimo 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. 

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

Card
defaulttrue
effectDuration0.5
idConfiguracao
labelConfiguração
titleConfiguração
effectTypeslide

Passo a Passo

O MEU PROTHEUS é mais uma forma que os usuários têm de conseguirem utilizar o ERP PROTHEUSSendo assim, são necessárias algumas configurações específicas para  integrar o aplicativo com o ambiente.

Para conhecer mais sobre a configuração necessária, assista ao vídeo.


Painelwarning
borderStyletitlenone
titleEntenda as configurações
Column
width500

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

Column
width50
CREDENCIAIS

É 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;


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.

Painel
borderStylenone
titleEntenda as 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 Added

Deck of Cards
effectDuration0.5
idContainer
effectTypeslide
Deck of Cards
effectDuration0.5
idContainer
effectTypeslide
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
Aviso
titleLIB

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

Dica
titleSUPORTE
Card
defaulttrue
effectDuration0.5
idcustomizado
labelCustomizado
titleCustomizado
effectTypeslide



Deck of Cards
effectDuration0.5
idconfiguracao
effectTypeslide
Card
defaulttrue
effectDuration0.5
idambiente-protheus
labelAmbiente Protheus
titleAmbiente Protheus
effectTypeslide

Configurando o seu ambiente

  1. Configure o 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. Acesse o módulo Configurador (SIGACFG)

    2. Acesse a rotina Base de Dados > Dicionário > Base de Dados. 
    3. Clique sobre o ícone + para expandir as opções e clicar em Parâmetros.
    4. Clique sobre a lupa e pesquisar por MV_MINGKEY.
    5. Preencha 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
titlePreencha o parâmetro MV_MINGKEY

Card
defaulttrue
effectDuration0.5
idcriacao-evento
labelCriação do evento
titleCriação do evento
effectTypeslide

Criando o evento

  1. Acesse o módulo CONFIGURADOR (SIGACFG)
  2. Acesse a rotina Ambiente > Cadastro > Tabelas.
  3. Pesquise pela tabela (E3).
  4. Clique no botão Editar.
  5. Inclua o novo evento.


Painel
borderStylenone
titleCrie o Evento

Card
defaulttrue
effectDuration0.5
idconfiguracao-usuario
labelConfiguração do Usuário
titleConfiguração do Usuário
effectTypeslide

Verificar a permissão de usuário

  1. Acesse o módulo Configurador (SIGACFG)
  2. Acesse a rotina Usuário > Senhas > Usuários. 
  3. Pesquise pelo usuário que será alterado.
  4. Selecione o Usuário e clique em alterar.
  5. Selecione a aba Restrições de Acesso > Aba Acessos.
  6. Habilite a permissão 174 - Acesso a inscrição nos eventos do EventViewer.


Painel
borderStylenone
titleValide permissão 174 do usuário

Card
defaulttrue
effectDuration0.5
idevent-viewer
labelEvent Viewer
titleEvent Viewer
effectTypeslide

Inscrever no Event Viewer

  1. Acesse  Miscelânea > Inscr. Event Viewer em qualquer módulo.
  2. Clique em Incluir.
  3. Selecione o canal 002.
  4. Selecione categoria 001.
  5. Selecione o evento desejado.
  6. Selecione Sim no campo Json.

Para informações sobre o Event Viewer, clique aqui  a documentação completa de Event Viewer. 


Painel
borderStylenone
titleInscreva do Event Viewer


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 EventInsert que aciona a notificação no momento que for disparada.

Para receber as notificações no APP acione a rotina. 

A seguir você verá um exemplo de como realizar esses passos. 


Aviso

Os exemplos a seguir são apenas modelos para fins de estudo e visualização rápida das notificações. Procure implantar os passos se adequando ao seu negócio e necessidade. 

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á adicionar algumas linhas de código. 


Dica

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

Aviso

Compilar a função a seguir apenas para testes. Adapte o código na função que deseja acionar e receber a notificação. 

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

    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 o Evento
titleChamando o Evento
effectTypeslide

Execute a função

Após o código fonte compilado acione a rotina. A seguir segue um exemplo para acionar a função compilada no RPO.


Dica

Existem inúmeras formas de executar uma função. Execute ela do jeito que achar melhor. 

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

SmartClient chamando a função






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
titleDisponível em Android e IOS
Column
width250

Android

Column
width250

IOS

Card
defaulttrue
effectDuration0.5
idfuncionalidades-interfaces
labelFuncionalidades e Interfaces
titleFuncionalidades e Interfaces
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 senhainforme os mesmos dados que você utiliza quando acessa o seu ambiente no ERP PROTHEUS via SMARTCLIENT.

No campo Aliasinforme o seu identificador no MINGLE ou APPLINKER. 


Painel
borderStylenone
titleAcesso
Column
width500


Tela de acesso



Column
width50



Mulher negra mexendo no computador



Card
defaulttrue
effectDuration0.5
idsolicite-alias
labelSolicite um Alias
titleSolicite um 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
titleSolicite um Alias
Column
width500


Tela de solicitação de Alias

Column
width50



Homem mexendo no celular. Gráficos ao fundo

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
titleEscolha uma Filial
Column
width500


Tela de escolha da filial{
Column
width50



Homem negro mexendo no celular

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. Para acessar os eventos clique no ícone .


Painel
borderStylenone
titleVisualize Eventos
Deck of Cards
effectDuration0.5
idteste
effectTypeslide
Card
defaulttrue
effectDuration0.5
idvisualize
labelVisualize
titleVisualize
effectTypeslide

Veja

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


Column
width500


Tela de visualização de eventos{
Column
width50



Homem mexendo no celular

Card
defaulttrue
effectDuration0.5
idFiltros
labelFiltros
titleFiltros
effectTypeslide

Filtre

Para filtrar um evento clique sobre o ícone  e escolha a sua condição. É 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 eventos{
Column
width50


Homem mexendo no celular

Card
defaulttrue
effectDuration0.5
idCompartilhar
labelCompartilhar
titleCompartilhar
effectTypeslide

Compartilhe

Para compartilhar um evento, clique e segure o evento até que seja apresentada a tela de aplicativos que podem ser utilizados para compartilhá-lo.


Column
width500

Tela de compartilhamento de eventos

{
Column
width50


Pessoas conversando

Card
defaulttrue
effectDuration0.5
idaprovacoes
labelAprovações
titleAprovações
effectTypeslide

Aprovações

Com a filial escolhida, você terá acesso aos registros de aprovações  que aguardam por sua ação no ambiente do ERP PROTHEUS. Para ter acesso a lista de aprovações clique no ícone .

Ao clicar sobre um item na lista, você pode aprovar ou reprovar a operação.

Independente da ação selecionada, uma tela solicitando uma justifica será apresentada, porém, a justificativa é obrigatória somente ao reprovar o registro.

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

Tela de aprovações

Column
width50



Homem mexendo no celular

Card
defaulttrue
effectDuration0.5
idusuario
labelUsuário
titleUsuário
effectTypeslide

Perfil

Apresenta dados importantes sobre a conexão do aplicativo com o ambiente Protheus.

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


Painel
borderStylenone
titleAcesso Perfil
Column
width500

Tela de perfil

Column
width50



Homem mexendo no celular

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