Informações

title	Importante

O aplicativo Protheus Event Viewer agora se chama Meu Protheus.

Painel

borderStyle	none

Column

width	80%

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

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 App Meu Protheus.

Aqui você entenderá:

O que é o App 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 App em pequenas demonstrações para ter melhor visibilidade do produto.

Aviso

title	CREDENCIAIS

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

Aviso

title	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 é necessário entrar em contato com o SUPORTE da TOTVS e solicitar o pacote para atualização do ambiente via UPDDISTR.

Aviso

title	CONFIGURADOR

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

Column

Card

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

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 enviadas 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

borderStyle	none
title	VIDEO MEU PROTHEUS

Column

Conector de Widget

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

00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

Deck of Cards

effectDuration	0.5
id	FUNCIONALIDADES
effectType	slide

Card

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

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

default	true
effectDuration	0.5
id	APROVACOES
label	APROVAÇÕES
title	APROVAÇÕES
effectType	slide

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

default	true
effectDuration	0.5
id	CONFIGURACAO
label	CONFIGURAÇÃO
title	CONFIGURACAO
effectType	slide

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 App e o ambiente.

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

Painel

borderStyle	none
title	VIDEO ENTENDENDO CONFIGURAÇÕES

Column

Conector de Widget

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

00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

Deck of Cards

effectDuration	0.5
id	EVENTOS
effectType	slide

-PADRAO PADRÃO PADRÃO

Card

default	true
effectDuration	0.5
id	EVENTO-CUSTOMIZADO
label	EVENTO CUSTOMIZADO
title	EVENTO CUSTOMIZADO
effectType	slide

Deck of Cards

effectDuration	0.5
id	CONFIGURACAO_MECANISMO
effectType	slide

Card

default	true
effectDuration	0.5
id	AMBIENTE_PROTHEUS
label	AMIBIENTE PROTHEUS
title	AMBIENTE PROTHEUS
effectType	slide

Configurar REST PROTHEUS
Se você é cliente crie um Alias no MINGLE. Se você é TOTVER crie um APPLINKER.
Preencher o parâmetro MV_MINGKEY (Token de acesso) com o seguinte conteúdo: NWUwNGI3ZGVkNGE3NDJkYzFlM2QyN2E3OmY0ZjljNjg5NjQ3Y2EwYTQwNGRlZTcxOTMzZmU1YWNmLTAyYWQ1Zjg1MWQxZTY1ZDA2MzEzZmE1MDBhMDA4OTQ0LWU1MzFmNTYxYmUzNmQwODJmZjgxZDY5MzBjOWUzZGVjLTlhNzc4YTdlYWYzZWI4NTVhM2IyYmIyNWEzMDdkNDU3

Card

default	true
effectDuration	0.5
id	CRIACAO-EVENTO
label	CRIAÇÃO DO EVENTO
title	CRIAÇÃO DO EVENTO
effectType	slide

1-Criar cadastro na tabela do Configurador

Card

default	true
effectDuration	0.5
id	CONFIGURACAO-USUARIO
label	CONFIGURAÇÃO DO USUÁRIO
title	CONFIGURAÇÃO DO USUÁRIO
effectType	slide

1-Definir configurações para que Usuário receba notificações

Card

default	true
effectDuration	0.5
id	INSCRICAO-USUARIO
label	INSCRIÇÃO DO USUÁRIO
title	INSCRIÇÃO DO USUÁRIO
effectType	slide

1-Associar evento com o usuário

Card

default	true
effectDuration	0.5
id	ENVIO-MENSAGEM
label	ENVIO DA MENSAGEM
title	ENIVO DE MENSAGEM
effectType	slide

1-Receber evento no celular

Card

Configuração do Event Viewer e integração com o App

Passo 1: Configurando a rotina Event Viewer no Protheus
Antes de utilizar o aplicativo Meu Protheus, recomendamos se certificar de que a rotina Event Viewer está funcional em seu ambiente. Você pode verificar o passo a passo para esta configuração através deste link (Configurar Event Viewer).
Passo 2: Solicitando o ALIAS e a chave do parâmetro MV_MINGKEY
Uma vez que a rotina esteja corretamente configurada, você deve solicitar um ALIAS do TOTVS Mingle (plataforma de mobilidade da TOTVS).
As instruções para solicitação do ALIAS estão aqui (Como obter um ALIAS no TOTVS Mingle?)
Certifique-se de colocar no campo "Observações" que você gostaria de solicitar o token do HOST para configuração com o Event Viewer. Você receberá este token por e-mail.
Passo 3: Configurando o parâmetro MV_MINGKEY e a tabela SXI
Com o token em mão, siga estes passos (Uso do Mingle para receber notificações do Event Viewer) para configurar o seu Protheus para uso com o Mingle.
Certifique-se de incluir o token no parâmetro MV_MINGKEY do Protheus, e de preencher o campo "Jason" (XI_JSON) = "Sim" na tabela SXI.
Passo 4: Verificando os eventos no aplicativo
Veja aqui como efetuar o primeiro acesso no Event Viewer: Primeiro acesso nos aplicativos Protheus
Após ter realizado as configurações, quando o evento for gerado na rotina Event Viewer, você receberá um push notification no celular com os dados do evento.
Na primeira vez que executar o aplicativo, o usuário será questionado se autoriza ou não receber eventos via notificações, caso ele negue esta permissão, não será possível utilizar o alerta em tempo real.

Em caso de problemas, consulte nossa seção de FAQ ao final do documento.

Card

default	true
effectDuration	0.5
id	CRIACAO-EVENTO


label	CRIAÇÃO DO EVENTO


title	CRIAÇÃO DO EVENTO


effectType	slide

Deck of Cards

effectDuration	0.5
id	EVENTO-PADRAO
effectType	slide

1-Criar cadastro na tabela do Configurador

Card

default	true
effectDuration	0.5
id	AMBIENTE_PROTHEUSCONFIGURACAO-USUARIO
label	AMIBIENTE PROTHEUSCONFIGURAÇÃO DO USUÁRIO
title	AMBIENTE PROTHEUSCONFIGURAÇÃO DO USUÁRIO
effectType	slide

1-Definir configurações para que Usuário receba notificações

Card

default	true
effectDuration	0.5
id	CONFIGURACAOINSCRICAO-USUARIO
label	CONFIGURAÇÃO INSCRIÇÃO DO USUÁRIO
title	CONFIGURAÇÃO INSCRIÇÃO DO USUÁRIO
effectType	slide

1-Associar evento com o usuário

Card

default	true
effectDuration	0.5
id	INSCRICAOENVIO-USUARIOMENSAGEM
label	INSCRIÇÃO DO USUÁRIOENVIO DA MENSAGEM
title	INSCRIÇÃO DO USUÁRIOENIVO DE MENSAGEM
effectType	slide

Section
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

Pré-requisitos

O Meu Protheus é um aplicativo complementar ao ERP TOTVS Protheus. Sendo assim, é preciso um usuário e senha do Protheus (a partir da versão 12.1.17) para utilizá-lo.

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

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;

Ter a rotina "Event Viewer" do módulo Configurador implantada e funcional.

Celular.

Lista de Sistema Operacionais compatíveis com o uso:

Android
IOS
Windows Phone.

Alias cadastrado. (O Alias é um intermediador entre o Aplicativo e o ERP PROTHEUS. Após a instalação do aplicativo no celular caso você não tenha um Alias você poderá solicitar na tela de login (tela de acesso onde é disponibilizado as credenciais). Segue abaixo um passo a passo para solicitação de Alias:

Solicitar Alias.

Clicar em Solicitar Alias.
Informar dados no formulário para solicitação de Alias e clicar em Solicitar.

Configuração do Event Viewer e integração com o App

Passo 1: Configurando a rotina Event Viewer no Protheus

Antes de utilizar o aplicativo Meu Protheus, recomendamos se certificar de que a rotina Event Viewer está funcional em seu ambiente. Você pode verificar o passo a passo para esta configuração através deste link (Configurar Event Viewer).

Passo 2: Solicitando o ALIAS e a chave do parâmetro MV_MINGKEY

Uma vez que a rotina esteja corretamente configurada, você deve solicitar um ALIAS do TOTVS Mingle (plataforma de mobilidade da TOTVS).

As instruções para solicitação do ALIAS estão aqui (Como obter um ALIAS no TOTVS Mingle?)

Certifique-se de colocar no campo "Observações" que você gostaria de solicitar o token do HOST para configuração com o Event Viewer. Você receberá este token por e-mail.

Passo 3: Configurando o parâmetro MV_MINGKEY e a tabela SXI

Com o token em mão, siga estes passos (Uso do Mingle para receber notificações do Event Viewer) para configurar o seu Protheus para uso com o Mingle.

Certifique-se de incluir o token no parâmetro MV_MINGKEY do Protheus, e de preencher o campo "Jason" (XI_JSON) = "Sim" na tabela SXI.

1-Receber evento no celular

Card

default	true
effectDuration	0.5
id	EVENTO-PADRAO
label	EVENTO PADRÃO
title	EVENTO PADRÃO
effectType	slide

Deck of Cards

effectDuration	0.5
id	EVENTO-PADRAO
effectType	slide

Card

default	true
effectDuration	0.5
id	AMBIENTE_PROTHEUS
label	AMIBIENTE PROTHEUS
title	AMBIENTE PROTHEUS
effectType	slide

Card

default	true
effectDuration	0.5
id	CONFIGURACAO-USUARIO
label	CONFIGURAÇÃO DO USUÁRIO
title	CONFIGURAÇÃO DO USUÁRIO
effectType	slide

Card

default	true
effectDuration	0.5
id	INSCRICAO-USUARIO
label	INSCRIÇÃO DO USUÁRIO
title	INSCRIÇÃO DO USUÁRIO
effectType	slide

Passo 4: Verificando os eventos no aplicativo

Veja aqui como efetuar o primeiro acesso no Event Viewer: Primeiro acesso nos aplicativos Protheus

Após ter realizado as configurações, quando o evento for gerado na rotina Event Viewer, você receberá um push notification no celular com os dados do evento.

Na primeira vez que executar o aplicativo, o usuário será questionado se autoriza ou não receber eventos via notificações, caso ele negue esta permissão, não será possível utilizar o alerta em tempo real.

Em caso de problemas, consulte nossa seção de FAQ ao final do documento.

Card

default	true
effectDuration	0.5
id	INTERFACE
label	FUNCIONALIDADES E INTERFACES
title	FUNCIONALIDADES
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

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

borderStyle	none
title	ILUSTRAÇÃO DE ACESSO

Column

000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 HOMENS CONVERSANDO

Card

default	true
effectDuration	0.5
id	SOLICITAR-ALIAS
label	SOLICITAR ALIAS
title	SOLICITAR ALIAS
effectType	slide

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

borderStyle	none
title	ILUSTRAÇÃO DE SOLICITAÇÃO DE ALIAS

Column

000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

Card

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

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

borderStyle	none
title	ILUSTRAÇÃO DE COMO ESCOLHER UMA FILIAL

Column
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000{

Card

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

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

borderStyle	none
title	ILUSTRAÇÃO DE VISUALIZAÇÃO DE EVENTOS

Deck of Cards

effectDuration	0.5
id	teste
effectType	slide

Card

default	true
effectDuration	0.5
id	VISUALIZAR-EVENTOS
label	VISUALIZAR EVENTOS
title	VISUALIZAR EVENTOS
effectType	slide

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

Column
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000{

Card

default	true
effectDuration	0.5
id	FILTRAR-EVENTOS
label	FILTRAR EVENTOS
title	FILTRAR EVENTOS
effectType	slide

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
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000{

Card

default	true
effectDuration	0.5
id	APROVACOES
label	APROVAÇÕES
title	APROVAÇÕES
effectType	slide

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 o Aprovador terá que justificar o motivo da sua escolha.

Painel

borderStyle	none
title	ILUSTRAÇÃO DE APROVAÇÕES

Column
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

Card

default	true
effectDuration	0.5
id	USUARIO
label	ÚSUARIO
title	ÚSUARIO
effectType	slide

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

borderStyle	none
title	ILUSTRAÇÃO DE ACESSO AS INFORMAÇÕES DE USUÁRIO

Column
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

Card

default	true
effectDuration	0.5
id	ALERTAS-ERROS
label	ALERTAS E ERROS
title	ALERTAS-ERROS
effectType	slide

Card

default	true
effectDuration	0.5
id	SUPORTE
label	SUPORTE
effectType	slide

Suporte

Perguntas Frequentes (FAQs)

Qual o meu Usuário e Senha?

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

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.

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

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

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

Quais os status dos eventos?

Os status dos eventos são:

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

Como compartilho um Evento?

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

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 usuario no Event Viewer

Acesso Aplicativos Móveis

Card

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

Deck of Cards

effectDuration	0.5
id	EQUIPE
effectType	slide

Painel

borderStyle	none

Painel

titleColor	laranja
borderStyle	none

Column

Column

Painel

borderStyle	none

Column

Column

Painel

borderStyle	none

Column

Column

Painel

borderStyle	none

Column

Column

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 264

Nova versão 265

Chave

Introdução

Sobre

Eventos

Aprovações

Configuração.

Configuração do Event Viewer e integração com o App

Pré-requisitos

Configuração do Event Viewer e integração com o App

Acessando o seu ambiente.

Solicitando um Alias.

Escolha uma Filial.

Aprovações.

Usuário.

Suporte

Perguntas Frequentes (FAQs)

Materiais Auxiliares

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 264

Nova versão 265

Chave

Introdução

Sobre

Eventos

Aprovações

Configuração.

Configuração do Event Viewer e integração com o App

Pré-requisitos

Configuração do Event Viewer e integração com o App

Acessando o seu ambiente.

Solicitando um Alias.

Escolha uma Filial.

Aprovações.

Usuário.

Suporte

Perguntas Frequentes (FAQs)

Materiais Auxiliares