Histórico da Página

CONTEÚDO

Índice

01. VISÃO GERAL

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

O escopo do aplicativo pode ser dividido entre duas funcionalidades principais: Aprovações e eventos.

Deck of Cards

id	deck-sobre

Card

id	sobre-aprovacao
label	Aprovações

Aprovações

O aplicativo Meu Protheus possibilita ao usuário realizar aprovações de processos ocorridos no ERP através do smartphone e abaixo estão listados os processos aderentes a este mecanismo de aprovações.

Deck of Cards

id	deck-aprovacoes

Card

id	aprovacoes-pedido-de-compras
label	Pedido de Compras

Pedido de Compras

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de pedidos de compras de forma aderente ao processo padrão de liberação de documentos (MATA094).

Card

id	aprovacoes-solicitacao-de-compras
label	Solicitação de Compras

Solicitação de Compras

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de solicitação de compras.

Card

id	aprovacoes-prestacao-de-contas
label	Prestação de Contas

Prestação de Contas

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de prestação de contas (Controle de Viagens).

Aviso

title	Importante

Caso o participante informado na inclusão da prestação de contas, contenha em seu cadastro o tipo "Externo", a aprovação deverá ser realizada exclusivamente pelo ERP.

Card

id	aprovacoes-medicao-de-contratos
label	Medição de Contratos

Medição de Contratos

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de medições de contratos (SIGAGCT).

Card

id	sobre-eventos
label	Eventos

Eventos

O objetivo dos eventos é 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 eventos pré-definidos na sua integração com o ERP, conforme alguns exemplos abaixo:

Visualizar 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 (SX5).

Aviso

title	Nota

Caso o usuário logado esteja integrado ao Active Directory (usuário de rede), as notificações não estarão disponíveis. Atualmente esse recurso não é suportado pelo serviço responsável por gerenciar as notificações (Push Notification).

Dica

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 na rotina do Event Viewer.

Utilizando o aplicativo Meu Protheus os eventos registrados são recebidos por meio de notificações para celular (Push notifications).

Personalizados

São eventos que podem ser criados especificamente para uso em rotinas customizadas.

Card

id	acm
label	ACM
title	ACM
class	Principal
effectType	slide

Configurando pela Web

Com o Assistente de Configuração Mobile é possivel configurar todos os passos até a utilização do app.

O Assistente de Configuração Mobile está disponivel na web. Clique aqui para acessar.

Painel

borderStyle	none
title	Tela inicial

Na tela inicial você terá acesso aos insights (novidades / notícias) que ficarão disponíveis com conteúdo informativo sobre nossas soluções. Também é possível visualizar as aplicações que estão disponiveis para configuração no seu ambiente.
Explore a aba de navegação "Funcionalidades" na página do Assistente de Configuração Mobile no TDN, para saber mais sobre o ACM (Assistente de Configuração Mobile).

Image Added

Se você utiliza essas funcionalidades do Protheus pelo SmartClient, por meio do Aplicativo você poderá 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=lQwh3MVBrbs
height	500

02. PRÉ-REQUISITOS MÍNIMOS

Aviso

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.

Para o correto funcionamento do App Meu Protheus na Jornada de Compras, deve ser aplicado o pacote de Expedição Contínua do Mobile, por conter os fontes responsáveis pelo funcionamento do App Meu Protheus. Baixe o pacote de expedição contínua no link: Pacotes de Atualização - Mobile

Informações

title	Observação

Licenças: Em relação ao Meu Protheus, as requisições recebidas via Mingle seguem um tratamento diferente, onde não se utilizam de licenças TOTVS I e sim as licenças de Apps, desta forma, a lista de APIs não serão exibidas ao abrir a URL do Rest, porém pode seguir em frente com a configuração e as requisições do App serão atendidas sem problemas.

03. CONFIGURAÇÕES

Deck of Cards

id	deck-aprovacoes

Card

id	configuracao-aprovacao
label	Aprovações

Aprovações

Para o escopo de aprovações:

Configure o Rest Protheus
Se você é cliente solicite um alias pelo Mingle ou crie pelo Assistente de Configuração Mobile.
Processo de alçadas de Compras ou Viagens

Card

id	configuracao-eventos
label	Eventos

Eventos
O Meu Protheus pode ser utilizado tambem como um recurso para visualizar eventos do ERP , onde podemos utilizar eventos pré-definidos(padrão) ou customizados

Deck of Cards

id	detalhes-configuracao-eventos

Card

id	detalhes-configuracao-eventos-ambiente
label	Ambiente

Ambiente

Para o escopo de eventos:

Configure o Rest Protheus
Se você é cliente solicite um alias pelo Mingle ou crie pelo Assistente de Configuração Mobile.
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

title	Dica

O Token será encaminhado ao solicitar o alias pelo Mingle ou pelo AppLinker .

Aviso

title	Nota

Caso o usuário logado esteja integrado ao Active Directory (usuário de rede), as notificações não estarão disponíveis. Atualmente esse recurso não é suportado pelo serviço responsável por gerenciar as notificações (Push Notification).

Card

default	true
effectDuration	0.5
id	detalhes-configuracao-eventos-permissao
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 a permissão 174 do usuário

Card

default	true
effectDuration	0.5
id	detalhes-configuracao-eventos-padrao
label	Event Viewer - Padrão
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

id	detalhes-configuracao-eventos-custom
label	Event Viewer - Personalizado

Deck of Cards

id	events-custom

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

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: USER
* DATA: 00/00/0000
* 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

04. TELA XXXXX

Principais Campos e Parâmetros

Campo	Descrição

Card documentos

Informacao	Use esse box para destacar informações relevantes e/ou de destaque.
Titulo	IMPORTANTE!

Árvore de páginas

Versões comparadas

Versão antiga 9

Nova versão 10

Chave

01. VISÃO GERAL

Configurando pela Web

02. PRÉ-REQUISITOS MÍNIMOS

03. CONFIGURAÇÕES

04. TELA XXXXX

05. TABELAS UTILIZADAS