Painel |
---|
|
![](/download/attachments/307838137/image2020-10-1_12-40-47.png?version=1&modificationDate=1601566854357&api=v2)
|
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údoEste 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 |
---|
Image Removed 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 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 |
---|
borderStyle | none |
---|
title | Conheça o Meu Protheus |
---|
|
Column |
---|
|
Conector de Widget |
---|
width | 500 |
---|
url | https://www.youtube.com/watch?v=9oFUojwBpuA |
---|
height | 500 |
---|
|
|
Column |
---|
|
Image Removed
A seguir você pode encontrar mais informações sobre o escopo do produto baseado nas funcionalidades.
Deck of Cards |
---|
effectDuration | 0.5 |
---|
id | Funcionalidades |
---|
effectType | slide |
---|
|
Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | Eventos |
---|
label | Eventos |
---|
title | Eventos |
---|
effectType | slide |
---|
| 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. Ele podem ser divididos em duas modalidades: 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 menviando-os por e-mail ou RSS. 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 |
---|
| O que é ?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 |
---|
|
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 |
---|
|
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 |
---|
|
Conector de Widget |
---|
width | 500 |
---|
url | https://www.youtube.com/watch?v=-FABlOLej_M |
---|
height | 500 |
---|
|
|
Column |
---|
|
Image Removed
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.
Acesse o módulo Configurador (SIGACFG)
- Acesse a rotina Base de Dados > Dicionário > Base de Dados.
- Clique sobre o ícone + para expandir as opções e clicar em Parâmetros.
- Clique sobre a lupa e pesquisar por MV_MINGKEY.
- Preencha nos campos Cont. Por, Cont. Ing, Cont. Esp com o Token.
Dica |
---|
- O Token será encaminhado ao solicitar o o alias pelo MINGLE ou pelo APPLINKER .
|
Painel |
---|
borderStyle | none |
---|
title | Preencha o parâmetro MV_MINGKEY |
---|
|
Image Removed
|
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 |
---|
|
Image Removed
|
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 |
---|
|
Image Removed 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.
- Preencher o parâmetro MV_MINGKEY (Token de acesso).
Acesse o módulo Configurador (SIGACFG)
- Acesse a rotina Base de Dados > Dicionário > Base de Dados.
- Clique sobre o ícone + para expandir as opções e clicar em Parâmetros.
- Clique sobre a lupa e pesquisar por MV_MINGKEY.
- Preencha nos campos Cont. Por, Cont. Ing, Cont. Esp com o Token.
Dica |
---|
- O Token será encaminhado ao solicitar o o alias pelo MINGLE ou pelo APPLINKER .
|
Painel |
---|
borderStyle | none |
---|
title | Preencha o parâmetro MV_MINGKEY |
---|
|
Image Removed
|
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 |
---|
|
Image Removed
|
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 |
---|
|
Image Removed
|
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 a documentação completa de Event Viewer.
Painel |
---|
borderStyle | none |
---|
title | Inscreva do Event Viewer |
---|
|
Image Removed 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 |
---|
|
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 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 |
---|
|
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 |
---|
borderStyle | none |
---|
title | ILUSTRAÇÃO DE CHAMADA DA FUNÇÃO |
---|
|
Image Removed
|
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 |
---|
|
|
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 |
---|
|
Acessando o seu ambiente
Para realizar o seu acesso utilize:
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 |
---|
|
Image Removed
Column |
---|
|
Image Removed
Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | solicite-alias |
---|
label | Solicite um Alias |
---|
title | Solicite um 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
Image Removed. 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 |
---|
|
Image Removed
Column |
---|
|
Image Removed
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
Image Removed.
Painel |
---|
borderStyle | none |
---|
title | Escolha uma Filial |
---|
|
Column |
---|
|
Image Removed{ Column |
---|
|
Image Removed
Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | Eventos |
---|
label | Eventos |
---|
title | Eventos |
---|
effectType | slide |
---|
|
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
Image Removed.
Deck of Cards |
---|
effectDuration | 0.5 |
---|
id | teste |
---|
effectType | slide |
---|
|
Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | visualize |
---|
label | Visualize |
---|
title | Visualize |
---|
effectType | slide |
---|
|
Column |
---|
|
Image Removed{ Column |
---|
|
Image Removed
Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | Filtros |
---|
label | Filtros |
---|
title | Filtros |
---|
effectType | slide |
---|
|
Para filtrar um evento clique sobre o ícone
Image Removed 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 |
---|
|
Image Removed{ Column |
---|
|
Image Removed
Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | Compartilhar |
---|
label | Compartilhar |
---|
title | Compartilhar |
---|
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 |
---|
|
Image Removed { |
Column |
---|
|
Image Removed
Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | aprovacoes |
---|
label | Aprovações |
---|
title | Aprovações |
---|
effectType | slide |
---|
|
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 | ILUSTRAÇÃO DE APROVAÇÕES |
---|
|
Column |
---|
|
Image Removed
|
Column |
---|
|
Image Removed
Card |
---|
default | true |
---|
effectDuration | 0.5 |
---|
id | usuario |
---|
label | Usuário |
---|
title | Usuário |
---|
effectType | slide |
---|
|
Apresenta dados importantes sobre a conexão do aplicativo com o ambiente Protheus.
- Usuário
- Cliente
- Empresa
- Set
- Filial
Painel |
---|
borderStyle | none |
---|
title | Acesso Perfil |
---|
|
Column |
---|
|
Image Removed
|
Column |
---|
|
Image Removed
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 |
---|
|
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 EVENT VIEWER. Os eventos são enviados para o App 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 usuario no Event Viewer
Acesso Aplicativos Móveis