Informações

title	Importante

O aplicativo Protheus Event Viewer agora se chama Meu Protheus.

Painel

borderStyle	none

Deck of Cards

effectDuration	0.5
id	cabecalho
effectType	slide

Card

default	true
effectDuration	0.5
id	meu-protheus
label	Meu Protheus
title	Meu Protheus
effectType	slide

Deck of Cards

effectDuration	0.5
id	tudo-sobre
effectType	slide

Card

default	true
effectDuration	0.5
id	Introducao
label	Introdução
title	Introdução
effectType	slide

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

Card

default	true
effectDuration	0.5
id	Sobre
label	Sobre
title	Sobre
effectType	slide

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 genérica E3 - Eventos.

Se você utiliza essas funcionalidades do Protheus pelo SmartClient, por meio do Aplicativo 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

borderStyle	none
title	Conheça o Meu Protheus

Column

width	500

Conector de Widget

width	500
url	https://www.youtube.com/watch?v=9oFUojwBpuA
height	500

Column

width	50

Homem e Mulher num bate papo pelo celular

A seguir você pode encontrar mais informações sobre o as funcionalidades do aplicativo.

Deck of Cards

effectDuration	0.5
id	Funcionalidades
effectType	slide

Card

default	true
effectDuration	0.5
id	Eventos
label	Eventos
title	Eventos
effectType	slide

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.

Eles podem ser divididos em duas modalidades:

Pré-definidos

São os eventos padrões configurados por meio da inscrição no Event Viewer. O Event Viewer registra os eventos ocorridos no Protheus e enviando-os por e-mail ou RSS.

Personalizados

São eventos que podem ser criados especificamente para uso em rotinas customizadas, criadas pelo cliente.

Card

default	true
effectDuration	0.5
id	Aprovacoes
label	Aprovações
title	Aprovações
effectType	slide

Suponha que um produto tenha atingido o limite mínimo no estoque e tenha acionado o fluxo de pedido de compra.

Pelo Meu Protheus, a ordem de pedido de compra pode ser liberada por meio da aprovação.

Card

default	true
effectDuration	0.5
id	Configuracao
label	Configuração
title	Configuração
effectType	slide

Passo a passo

O Meu Protheus é mais uma forma que os usuários têm de conseguirem utilizar o ERP Protheus. Sendo 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.

Aviso

title	Pré-Requisitos

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

Configurador: Ter a rotina Event Viewer no módulo implantada e funcional.

Lib: A lib com a funcionalidade precisa ser igual ou superior a 20180216.

Dica

title	Suporte

Para uso antes da liberação de janeiro/2018 do Protheus entre em contato com o suporte da TOTVS e solicite o pacote para atualização do ambiente via UPDDISTR.

Painel

borderStyle	none
title	Entenda as configurações

Column

width	500

Conector de Widget

width	500
url	https://www.youtube.com/watch?v=-FABlOLej_M
height	500

Column

width	50

Homem com mãos para cima ao fundo gráficos

Deck of Cards

effectDuration	0.5
id	Container
effectType	slide

Card

default	true
effectDuration	0.5
id	padrao
label	Padrão
title	Padrão
effectType	slide

Deck of Cards

effectDuration	0.5
id	configuracao-2
effectType	slide

Card

default	true
effectDuration	0.5
id	ambiente-protheus
label	Ambiente Protheus
title	Ambiente Protheus
effectType	slide

Configurando o seu ambiente

Configure o Rest Protheus
Se você é cliente solicite um alias pelo Mingle. Se você é Totver crie um alias pelo AppLinker.
Preencha com o Token de acesso o parâmetro MV_MINGKEY.
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 clique 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
O Token será encaminhado ao solicitar o alias pelo Mingle ou pelo AppLinker .

Painel

borderStyle	none
title	Preencha o parâmetro MV_MINGKEY

Card

default	true
effectDuration	0.5
id	configuracao-usuario
label	Configuração do usuário
title	Configuração do usuário
effectType	slide

Verificar a permissão de usuário

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

Painel

borderStyle	none
title	Valide permissão 174 do usuário

Card

default	true
effectDuration	0.5
id	event-viewer
label	Event Viewer
title	Event Viewer
effectType	slide

Inscrever no Event Viewer

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

Para informações sobre o Event Viewer, clique aqui.

Painel

borderStyle	none
title	Inscrição do Event Viewer

Card

default	true
effectDuration	0.5
id	customizado
label	Customizado
title	Customizado
effectType	slide

Deck of Cards

effectDuration	0.5
id	configuracao
effectType	slide

Card

default	true
effectDuration	0.5
id	ambiente-protheus
label	Ambiente Protheus
title	Ambiente Protheus
effectType	slide

Configurando o seu ambiente

Configure o Rest Protheus
Se você é cliente solicite um alias pelo Mingle. Se você é Totver crie um alias pelo AppLinker.
Preencha com o Token de acesso o parâmetro MV_MINGKEY.
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 clique 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
O Token será encaminhado ao solicitar o alias pelo Mingle ou pelo AppLinker .

Painel

borderStyle	none
title	Preencha o parâmetro MV_MINGKEY

Card

default	true
effectDuration	0.5
id	criacao-evento
label	Criação do evento
title	Criação do evento
effectType	slide

Criando o evento

Acesse o módulo Configurador (SIGACFG)
Acesse a rotina Ambiente > Cadastro > Tabelas.
Pesquise pela tabela (E3).
Clique no botão Editar.
Inclua o novo Evento.

Card documentos

Informacao	Para eventos customizados, recomenda-se utilizar o padrão de nomear o código do evento iniciando com a letra <b>Z</b>
Titulo	Importante

Painel

borderStyle	none
title	Crie o evento

Card

default	true
effectDuration	0.5
id	configuracao-usuario
label	Configuração do usuário
title	Configuração do usuário
effectType	slide

Verificar a permissão de usuário

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

Painel

borderStyle	none
title	Valide permissão 174 do usuário

Card

default	true
effectDuration	0.5
id	event-viewer
label	Event Viewer
title	Event Viewer
effectType	slide

Inscrever no Event Viewer

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

Para informações sobre o Event Viewer, clique aqui.

Painel

borderStyle	none
title	Inscrição do Event Viewer

Card

default	true
effectDuration	0.5
id	notificacao
label	Notificação
title	Notificação
effectType	slide

Compilando e enviando notificação

Para que você receba uma notificação no Meu Protheus inserir a função EventInsert na rotina que realize o disparo da notificação.

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

effectDuration	0.5
id	notificacoes
effectType	slide

Card

default	true
effectDuration	0.5
id	Compilando
label	Compilando
title	Compilando
effectType	slide

Para funções customizadas você deverá adicionar algumas linhas de código.

Dica
O código a seguir é apenas um exemplo e você poderá customizar ele da melhor forma. Segue a um exemplo do Event Insert.

Bloco de código

language	js
theme	RDark
firstline	0
title	Exemplo para envio de notificação.
linenumbers	true

#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 ADIONADO NA SUA FUNCAO CUSTOMIZADA PARA QUE NO MOMENTO QUE FUNCAO SER CHAMADA EXECUTE O EVENTO  
*/

User Function MOBILE0000()

    Local cEventId := "Z00"

    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 CHAVE	SIGNIFICADO	COR
FW_EV_LEVEL_INFO	MENSAGEM DE INFORMACÃO	CINZA
FW_EV_LEVEL_ERROR	MENSAGEM DE ERRO	VERMELHO
FW_EV_LEVEL_WARNING	MENSAGEM DE ATENÇÃO	AMARELO

Card

default	true
effectDuration	0.5
id	chamando-evento
label	Chamando o evento
title	Chamando o Evento
effectType	slide

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

borderStyle	none
title	DISPARE A FUNÇÃO

SmartClient chamando a função

Card

default	true
effectDuration	0.5
id	instalacao
label	Instalação
title	Instalação
effectType	slide

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

borderStyle	none
title	Disponível em Android e IOS

Column

width	250

Column

width	250

Card

default	true
effectDuration	0.5
id	funcionalidades-interfaces
label	Funcionalidades e Interfaces
title	Funcionalidades e Interfaces
effectType	slide

Deck of Cards

effectDuration	0.5
id	todas-funcionalidades
effectType	slide

Card

default	true
effectDuration	0.5
id	acesso
label	Acesso
title	Acesso
effectType	slide

Acesse o seu ambiente

Para realizar o seu acesso utilize:

Usuário
Senha
Alias

Nos campos Usuário e Senha, informe 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

borderStyle	none
title	Acesso

Column

width	500

Tela de acesso

Column

width	50

Mulher negra mexendo no computador

Card

default	true
effectDuration	0.5
id	solicite-alias
label	Solicite um alias
title	Solicite um Alias
effectType	slide

Peça um alias

Por meio do aplicativo, na tela de acesso é possível solicitar um alias. Para solicitar um alias clique sobre Solicitar Alias. 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

borderStyle	none
title	Solicite um alias

Column

width	500

Tela de solicitação de Alias

Column

width	50

Homem mexendo no celular. Gráficos ao fundo

Card

default	true
effectDuration	0.5
id	filial
label	Filial
title	Filial
effectType	slide

Escolha a filial

Após o acesso, escolha uma

Filial

filial.

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

Painel

borderStyle	none
title	Escolha uma filial

Column

width	500

{

Column

width	50

Homem negro mexendo no celular

Card

default	true
effectDuration	0.5
id	Eventos
label	Eventos
title	Eventos
effectType	slide

Visualize e interaja com eventos

Com a Filial filial escolhida, você terá acesso aos eventos que ocorrem no seu ambiente do ERP Protheus. Para acessar os Eventos clique na guia de Eventos.

Deck of Cards

effectDuration	0.5
id	teste
effectType	slide

Card

default	true
effectDuration	0.5
id	visualize
label	Visualize
title	Visualize
effectType	slide

Para apresentar mais informações sobre um evento clique sobre a seta para expandir mais informações sobre o evento.

Column

width	500

{

Column

width	50

Homem mexendo no celular

Card

default	true
effectDuration	0.5
id	Filtros
label	Filtros
title	Filtros
effectType	slide

Para filtrar um evento clique sobre o funil 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

width	500

{

Column

width	50

Homem mexendo no celular

Card

default	true
effectDuration	0.5
id	Compartilhe
label	Compartilhe
title	Compartilhe
effectType	slide

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

width	500

Tela de compartilhamento de eventos

{

Column

width	50

Pessoas conversando

Card

default	true
effectDuration	0.5
id	aprovacoes
label	Aprovações
title	Aprovações
effectType	slide

Aprove ou reprove

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 na guia Aprovações.

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

borderStyle	none
title	Aprovações

Column

width	500

Tela de aprovações

Column

width	50

Homem mexendo no celular

Card

default	true
effectDuration	0.5
id	usuario
label	Usuário
title	Usuário
effectType	slide

Perfil

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

Usuário
Cliente
Empresa
Set
Filialfilial

Painel

borderStyle	none
title	Acesso Perfil

Column

width	500

Tela de perfil

Column

width	50

Homem mexendo no celular

Card

default	true
effectDuration	0.5
id	Suporte
label	Suporte
effectType	slide

Perguntas Frequentes (FAQs)

Expandir

title	Qual o meu Usuário e Senha?

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

Expandir

title	O 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

title	Esqueci o meu Usuário e/ou Senha. O que faço?

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

Expandir

title	Quais eventos eu visualizo?

No aplicativo são visualizados somente os eventos a que o usuário do Protheus está cadastrado na inscrição do Event Viewer.

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

Expandir

title	Quais os status dos eventos?

Os status dos Eventos são:

Cinza: Informação
Amarelo: Alerta
Vermelho: Erro

Expandir

title	Como compartilho um Evento?

Na tela do Meu Protheus, selecione o evento e clique no botão compartilhar.

Expandir

title	Como 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 usuário 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

Árvore de páginas

Versões comparadas

Versão antiga 459

Nova versão 460

Chave

Conteúdo

Escopo

Passo a passo

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

Configurando o seu ambiente

Verificar a permissão de usuário

Inscrever no Event Viewer

Configurando o seu ambiente

Criando o evento

Verificar a permissão de usuário

Inscrever no Event Viewer

Compilando e enviando notificação

Para funções customizadas você deverá adicionar algumas linhas de código.

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

Instalando no seu celular

Acesse o seu ambiente

Para realizar o seu acesso utilize:

Peça um alias

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

Escolha a filial

Após o acesso, escolha uma

filial.

Visualize e interaja com eventos

Aprove ou reprove

Perfil

Materiais Auxiliares

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 459

Nova versão 460

Chave

Conteúdo

Escopo

Passo a passo

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

Configurando o seu ambiente

Verificar a permissão de usuário

Inscrever no Event Viewer

Configurando o seu ambiente

Criando o evento

Verificar a permissão de usuário

Inscrever no Event Viewer

Compilando e enviando notificação

Para funções customizadas você deverá adicionar algumas linhas de código.

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

Instalando no seu celular

Acesse o seu ambiente

Para realizar o seu acesso utilize:

Peça um alias

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

Escolha a filial

Após o acesso, escolha uma

filial.

Visualize e interaja com eventos

Aprove ou reprove

Perfil

Materiais Auxiliares