Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Capa com o logo do aplicativo meu protheusImage Removed

Image Removed

Paineltip
borderStylenone
Column
width500
Column
width80
titleAssistente de Configuração Mobile

Conheça o Assistente de Configuração Mobile.

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

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

Aviso
titleFuncionalidade "Validar Fontes"

A funcionalidade de "Validar Fontes" não está disponível no ambiente web, apenas no Protheus.

Dica
titleCentral Colaborativa

Deseja sugerir alguma melhoria para soluções mobile do Backoffice Protheus? Acesse a Central Colaborativa da TOTVS

Vá em Totvs Backoffice > Linha Protheus > Aplicativos Móveis > [ Escolha o app ]

Quer dar alguma sugestão para o Meu ProtheusAcesse aqui para publicar sua ideia. 


Aviso
titleNotificações

As notificações destinadas a um único usuário serão recebidas apenas durante o último acesso. Em outras palavras, se o mesmo usuário estiver conectado em dois dispositivos simultaneamente, ele só receberá a notificação no dispositivo que foi acessado por último.

Painel
borderColororange
titleColororange
borderWidth2
titleBGColorwhite
borderStylesolid
titleNovas funcionalidades

A partir da versão 3.6.4, O Meu Protheus terá:

  • Aprovação múltipla de Solicitação de Compras e Pedido de Compra
  • Aprovação múltipla de Medição de Contratos
  • Seleção de múltiplas filiais para visualização e aprovação das pendências

Atualize o Protheus com a expedição contínua do app para usufruir das novas funcionalidades.

Painel
borderStylenone
Image Added
Deck of Cards
Deck of Cards
effectDuration0.5
idcabecalho
effectTypeslide
Card
defaulttrue
effectDuration0.5
idMEU_PROTHEUS
labelMEU PROTHEUS
titleMEU PROTHEUS
effectTypeslide
Deck of Cards
idSOBRE
effectTypeslide
Card
defaulttrue
effectDuration0.5
idINTRODUCAO
labelINTRODUÇÃO
titleINTRODUCAO
effectTypeslide
Card
defaulttrue
effectDuration0.5
idOBJETIVO
labelOBJETIVO
titleOBJETIVO
effectTypeslide
Card
defaulttrue
labelFUNCIONALIDADES E INTERFACES
titleFUNCIONALIDADES
effectDuration0.5
id
INTERFACE
cabecalho
effectTypeslide
BENEFICIOSBENEFICIOSMEU PROTHEUSINSTALACAOINSTALAÇÃOINSTALACAOcardCONFIGURACAOCONFIGURAÇÃOCONFIGURACAO
Card
defaulttrue
effectDuration0.5
id
meu-protheus
label
Meu Protheus
title
Meu Protheus
effectTypeslide
card
Deck of Cards
defaulttrue
labelMETRICAS
titleMEU PROTHEUS
effectDuration0.5
id
METRICAS
tudo-sobre
effectTypeslide
Card
defaulttrue
effectDuration0.5
id
Introducao
label
Introdução
title
Introdução
effectTypeslide
Card
defaulttrue
Column
defaulttrue
effectDuration0.5
idARQUITETURA
labelARQUITETURA DO APP
titleARQUITETURA
effectTypeslide

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.
  • 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. 
Card
effectDuration0.5
id
Sobre
label
Sobre
title
Sobre
effectTypeslide
Card
defaulttrue
effectDuration0.5
idCONTATOS
labelCONTATOS
titleCONTATOS
effectTypeslide
Informações
titleImportante

O aplicativo Protheus Event Viewer agora se chama Meu Protheus

Aplicativo Meu Protheus

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

O App Meu Protheus  é um aplicativo TOTVS que possui integração com o ambiente do ERP PROTHEUS. Ou seja, se você utiliza as 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.  Porém, 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 outras funcionalidades que são adicionadas com o feedback dos nossos clientes e com a maturação do produto. Atualmente são lançadas a cada mês um novo release. 

Premissas para uso

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

    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  podem ser dividas em duas modalidades: 

    • Pré-definidos

    São os eventos padrões que são configurados por meio do Event Viewer. O Event Viewer registra os eventos que são pré-definidos ocorridos no PROTHEUS enviados por EMAIL ou RSS.

    • Personalizados

    São os eventos que são customizados.

    • Exemplos:
      • Rotinas de Job.
      • Integrações.
      • Alterações cadastrais. 

    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.

    Informações
    titleImportante

    Após cadastrar a chave de autenticação ( MV_MINGKEY ) reiniciar os Appserver´s do ambiente.

    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.

    Escopo

    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
    iddeck-sobre
    effectTypeslide
    Card
    idsobre-aprovacao
    labelAprovaçõ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.

    Card
    idsobre-pedido-de-compra
    labelPedido 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
    idsobre-solicitacao-de-compra
    labelSolicitaçã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
    idsobre-prestacao-de-contas
    labelPrestaçã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).

    Card
    idsobre-medicao-de-contratos
    labelMediçã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
    idsobre-eventos
    labelEventos

    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
    titleNota

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

       

    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
    borderStylenone
    titleConheça o Meu Protheus
    Column
    width500

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


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


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

    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
    effectDuration0.5
    idAprovacoes
    labelAprovações
    titleAprovações
    effectTypeslide

    Suponha que um colaborador tenha realizado o fluxo de prestação de contas e essa prestação está pendente para analise.

    Pelo Meu Protheus, poderá ser analisado e escolher entre aprovar ou reprovar esse registro. 

    Aviso
    titleImportante

    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
    effectDuration0.5
    idConfiguracao
    labelConfiguração
    titleConfiguração
    effectTypeslide

    Passo a passo de configuração

    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.


    Aviso
    titlePré-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
    titleSuporte

    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.

    Observação:       

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

    Interface

    Abaixo seguirá um guia para as telas e botões do aplicativo para melhor entendimento.

    Tela do Meu Protheus

    Essa é a tela inicial do aplicativo. Através dessa tela o usuário poderá selecionar os eventos que deseja visualizar e compartilhar.

    Image Removed

    Imagem 1 – Tela Event Viewer

    CampoDescriçãoConfiguraçõesPermite ao usuário sair do aplicativo.CompartilharPermite ao usuário compartilhar o evento

    Imagem 2 – Push notification

    Image Removed

    Imagem 3 – Tela Compartilhamento Event Viewer

    Image Removed

    Eventos:

    O Evento vem com a descrição  e o nome da rotina, o ícone no canto direito superior se refere ao tipo de evento.

    Image Removed

    Todos os eventos aparecerão com o ícone: Image Removed

    Configurações

    Nessa tela o usuário poderá visualizar as configurações, dados de login e sair do aplicativo. 

    Image Removed

    Imagem 4 – Configurações

    Filtro

    Nessa tela o usuário poderá filtrar por período( até três meses da data atual ), rotina, mensagem, título, criticidade e tipo de eventos. 

    Image Removed

                                                                                                                                       
     Imagem 5 – Filtros
                                                                                                                     

    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.                                                                                                                                                                                                                                                           

    Deck of Cards
    effectDuration0.5
    idContainer
    effectTypeslide
    Card
    defaulttrue
    effectDuration0.5
    idpadrao
    labelPadrão
    titlePadrão
    effectTypeslide
    Deck of Cards
    effectDuration0.5
    idconfiguracao-2
    effectTypeslide
    Card
    defaulttrue
    effectDuration0.5
    idambiente-protheus
    labelAmbiente Protheus
    titleAmbiente Protheus
    effectTypeslide

    Aprovações

    Para o escopo de aprovações (Pedido de Compras e Prestação de Contas) não existe nenhuma configuração adicional, bastando apenas que o ambiente esteja provisionado (REST configurado e ALIAS do Mingle gerado). 

    Após o ambiente configurado, basta que o usuário que é um Aprovador acesse o aplicativo e o mesmo irá visualizar os itens que estão pendentes de sua análise, podendo ser Pedido de Compras ou Prestação de Contas.

    Para configurar o envio de notificações do ERP para o aplicativo, siga as instruções abaixo. Observando que os passo abaixo NÃO SÃO obrigatórios para o funcionamento do escopo de aprovações.

    Configurando o seu ambiente

    1. Configure o Rest Protheus
    2. Se você é cliente solicite um alias pelo Mingle ou crie pelo Assistente de Configuração Mobile.
    3. 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
    borderStylenone
    titlePreencha o parâmetro MV_MINGKEY

    Image Added

    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 Event Viewer.


    Painel
    borderStylenone
    titleValide a permissão 174 do usuário

    Image Added

    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. 


    Painel
    borderStylenone
    titleInscrição do Event Viewer


    Image Added
    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 ou crie pelo Assistente de Configuração Mobile. Se você é Totver crie um alias pelo AppLinker.
    3. 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
    borderStylenone
    titlePreencha o parâmetro MV_MINGKEY

    Image Added

    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.


    Card documentos
    InformacaoPara eventos customizados, recomenda-se utilizar o padrão de nomear o código do evento iniciando com a letra <b>Z</b>
    TituloImportante

    Painel
    borderStylenone
    titleCrie o evento

    Image Added

    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 Event Viewer.


    Painel
    borderStylenone
    titleValide permissão 174 do usuário

    Image Added

    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. 


    Painel
    borderStylenone
    titleInscrição do Event Viewer

    Image Added

    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 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
    effectDuration0.5
    idnotificacoes
    effectTypeslide
    Card
    defaulttrue
    effectDuration0.5
    idCompilando
    labelCompilando
    titleCompilando
    effectTypeslide

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

    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
    titleDISPARE A FUNÇÃO

    SmartClient chamando a funçãoImage Added

    Card
    idacm
    labelACM
    titleACM
    classPrincipal
    effectTypeslide

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


    Card
    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

    AndroidImage Added

    Column
    width250

    IOSImage Added

    Painel
    borderStylenone
    titleQR Code Android e IOS
    Column
    width250

    Image Added

    Column
    width250

    Image Added

    Card
    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

    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 Aliasinforme o seu identificador no Mingle ou AppLinker. 


    Painel
    borderStylenone
    titleAcesso
    Column
    width500


    Tela de acesso Image Added



    Card
    defaulttrue
    effectDuration0.5
    idsolicite-alias
    labelSolicite um alias
    titleSolicite um Alias
    effectTypeslide

    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
    borderStylenone
    titleSolicite um alias
    Column
    width500


    Tela de solicitação de AliasImage Added

    Card
    defaulttrue
    effectDuration0.5
    idfilial
    labelFilial
    titleFilial
    effectTypeslide

    Escolha a 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 filialImage Added{
    Card
    defaulttrue
    effectDuration0.5
    idEventos
    labelEventos
    titleEventos
    effectTypeslide

    Visualize e interaja com eventos

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


    Aviso
    titleImportante

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

    Informações
    titleDuração das notificações no app

    Atualmente o aplicativo Meu Protheus armazena as notificações por tempo limitado. Ao completar um mês em que uma notificação chegou no app e foi armazenada na aba "Eventos", ela é desprezada/deletada. Esse comportamento preza por manter a área de notificações (Eventos) mais limpa e organizada, sem necessitar que essa limpeza seja feita pelo usuário frequentemente.



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

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


    Column
    width500


    Tela de visualização de eventosImage Added{
    Card
    defaulttrue
    effectDuration0.5
    idFiltros
    labelFiltros
    titleFiltros
    effectTypeslide

    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
    width500


    Tela de filtro de eventosImage Added{
    Card
    defaulttrue
    effectDuration0.5
    idCompartilhe
    labelCompartilhe
    titleCompartilhe
    effectTypeslide

    Para compartilhar um Evento, clique sobre o ícone de compartilhar. Assim que realizar o clique  será apresentada a tela de aplicativos que podem ser utilizados para compartilhá-lo.


    Column
    width500

    Image Added

    {
    Card
    defaulttrue
    effectDuration0.5
    idLinks
    labelLinks
    titleLinks
    effectTypeslide

    Caso existam links envolvidos no corpo do evento, você poderá clicar sobre o link desejado e ser redirecionado para a página. 


    Column
    width500

    Image Added

    {
    Card
    defaulttrue
    effectDuration0.5
    idcard-aprovacoes
    labelAprovações
    titleAprovações
    effectTypeslide

    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.

    Nas abas 'Pendentes', 'Aprovados ' e 'Reprovados' é possível visualizar: 

    Deck of Cards
    idtypes
    effectTypeslide
    Card
    idpedido-de-compra
    labelPedido de Compra
    • Pedidos de Compra
      • Informações do card
        • Filial, núm. do pedido, fornecedor, condição de pagamento, data de emissão, comprador e valor total (soma do valor de cada item - SC7);
      • Informações da página de Detalhes
        • Núm. do pedido, comprador, valor total
        • Itens do pedido: Descrição do produto (B1_DESC), c. de custo, quantidade, un. de medida, valor unit. e valor total;
          • Ver mais: Data de entrega, quantidade entregue e campos adicionais via ponto de entrada MT094CPC;
          • Anexos: Imagens e / ou PDFs anexados via Banco de Conhecimento. Recomendável que o tamanho do arquivo não exceda 5mb;
          • Histórico: Histórico de compras do produto, mostrando a data em que foi comprado, com qual fornecedor, quantidade e preço por unidade;
    Card
    idsolicitacao-de-compra
    labelSolicitação de Compra
    • Solicitações de Compras
      • Informações do card
        • Filial, núm. da solicitação, data da solicitação, c. de custo, solicitante e valor total (soma do valor de cada item pela SCR);
      • Informações da página de Detalhes
        • Núm. da solicitação, data da solicitação, grupo de aprovação e valor total;
        • Itens da solicitação: Descrição do produto (B1_DESC), c. de custo, quantidade, unidade de medida e valor;
          • Histórico: Histórico de compras do produto, mostrando a data em que foi comprado, com qual fornecedor, quantidade e preço por unidade;
    Card
    idprestacao-de-conta
    labelPrestação de Contas
    • Prestações de Contas do tipo Viagem e Avulsa
      • Informações do card
        • Núm. da prestação de contas, participante, c. de custo, data de início, data final, motivo e valor total (soma de cada despesa pela FLE);
      • Informações da página de Detalhes
        • Núm. da prestação de contas, participante, data de início, data final, valor reembolsável e valor não reembolsável;
        • Itens de despesa: Data da despesa, descrição da despesa, local, quantidade e valor total;
          • Anexo: Imagem do comprovante de despesa;
          • Alert, danger, error, exclamation mark, mark, problem, warning icon -  Download on IconfinderImage Added: Alerta de que a despesa teve um custo elevado baseado na região;
    Card
    idmedicao-de-contratos
    labelMedição de Contratos
    • Medições de contratos
      • Informações do card
        • Núm. da medicão, filial, núm. do contrato, data da competencia, núm. da planilha, valor;
      • Informações da página de Detalhes
        • Núm. da medicão, filial, núm. da planilha, data da jurisdição, valor e descrição;
        • Itens da solicitação: Descrição do produto (B1_DESC), c. de custo, quantidade, unidade de medida e valor;
          • Histórico: Histórico do produto, mostrando a data de entrega, quantidade e preço por unidade;
    Aviso
    titleSobre Aprovados e Reprovados

    Hoje somente não é possível visualizar na aba de "Aprovados" e "Reprovados", as Medições de Contrato. Estamos trabalhando para que tenhamos esta funcionalidade disponível em breve. 



    Deck of Cards
    idaprovacao-simples
    effectTypeslide
    Card
    labelAprovação Por Filial
    Painel
    borderStylenone
    titleAprovação Por Filial

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

    Independente da ação selecionada, uma tela solicitando uma justifica será apresentada.


    Column
    width500

    Image Added

    Card
    labelAprovação Multifilial
    Dica
    titleAprovação Multifilial

       Na aprovação Multifilial o usuário pode fazer a aprovação de multiplos documentos de um mesmo TIPO.
    Exemplo: Ao fazer o filtro de multiplas filiais e o usário selecionar o documento do tipo Pedidos de Compra, todas as Solicitações de Compra e Medições de Contratos serão desabilitados para seleção, seguindo essa mesma regra para os demais tipos.

    Aviso
    titleAviso

    Observação importante: Essa nova funcionalidade não inclui filtro de multifiliais e nem  a provação de multiplos documentos do tipo Prestações de Contas

    Painel
    titleAprovação Multifilial

       Ao clicar no Icone no canto superior direito de multifilial e selecionar as filiais desejadas, serão listados todos os documentos (Pedidos de Compras, Solicitações de Compras e Medições de Contratos) pendentes de aprovações, com exceção de prestações de contas, que não é contemplada com essa nova funcionalidade.


    Image Added


    Painel
    titleAprovação de Multiplus Documentos

       Ao selecionar as filiais desejada, será listado todos os documentos pendentes de aprovação (Pedidos de Compras, Solicitações de Compras e Medições de Contratos), podendo ser selecionado vários documentos de um mesmo tipo.

    Exemplo: Ao selecionar PEDIDO DE COMPRA, as opções de SOLICITAÇÃO DE COMPRA E MEDIÇÃO DE CONTRATOS serão desabilitados.


    Column
    width500

    Image Added









    Card
    defaulttrue
    effectDuration0.5
    idAnexos
    labelAnexos
    titleAnexos
    effectTypeslide

    Anexos

    Nas aprovaçōes de pedido de compra e solicitação de compras, é possível ter acesso aos documentos e imagens anexos ao item. 

    Aviso
    titleExpedição continua

    Esteja atualizado com a versão mais recente da expedição continua do mobile. 

    Informações

    No app Meu Protheus é possível visualizar nativamente imagens anexadas via Banco de Conhecimento.
    Para os demais tipos de arquivos, como .pdf, .txt, .xlsx, dependera de recursos disponíveis no celular que entenda o respectivo arquivo.

    Deck of Cards
    effectDuration0.5
    idteste
    effectTypeslide
    Card
    defaulttrue
    effectDuration0.5
    idvisualize
    labelVisualizando os anexos
    titleVisualize os anexos
    effectTypeslide

    Para apresentar os anexos clique sobre "Anexos" para visualizar a lista de documentos do item. 


    Column
    width500

    Image Added

    {
    Column
    width500

    Image Added

    {
    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 perfilImage Added

    Card
    labelNova Home Page

    Nova Home Page

    A nova pagina é responsavel por mostrar uma lista de cards com os principais documentos de alçadas (PC, IP, SC, MD e IM), mostrando a quantidade total de documentos pendentes de aprovação para o usuário logado, facilitando a gestão de aprovação.

    • Pedido de Compra
    • Pedido de Compra por Item
    • Solicitação de Compras
    • Medição de Contratos
    • Medição de Contratos por Item

    Image Added






    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
    titleExiste limite de tamanho para PDF nos anexos do pedido de compra?

    Existe! Porém, a limitação é para arquivos com mais de 5MB.

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

    Os eventos são enviados para o aplicativo 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
    titleQual configuração é necessária para aprovar pedidos de compras no aplicativo?

    Não existe nenhuma configuração específica para que os pedidos de compra possam ser analisados pelo aplicativo. Com o provisionamento do ambiente (REST e Mingle), basta que o usuário com perfil de Aprovador acesso o aplicativo. 

    Observando que a aprovação de pedido de compras é aderente ao processo padrão de liberação de documentos (MATA094).

    Expandir
    titleÉ possível customizar a aprovação de pedido de compras?

    No aplicativo existe uma área chama "Ver mais" onde é possível inserir informações customizadas que sejam relevantes para a tomada de decisão do aprovador. É possível inserir novas informações nesta área através do Ponto de Entrada MT094CPC (https://tdn.totvs.com/x/gXAPEQ), onde os campos informados no Ponto de Entrada serão exibidos no aplicativo.

    Expandir
    titleHá limite no tamanho de arquivo na visualização de anexo de pedido de compra?

    Não necessariamente um limite, mas arquivos com tamanho maior de 5MB podem não ser visualizados dependendo da infraestrutura em que o ambiente Protheus se encontra.

    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 usuário no Event Viewer

    Acesso Aplicativos Móveis

    Funcionalidades

    Visualização dos Eventos

    1. Navegue pela tela de Eventos (Imagem 1)
    2. Os eventos são demonstrados em ordem decrescente de data

    Compartilhando um Evento

    1. Navegue pela tela de Eventos (Imagem 1)
    2. No evento selecionado, clique em "Compartilhar"
    3. Selecione o modo de compartilhamento (Imagem 3)

    Filtro de Eventos

    1. Navegue pela tela de filtros (Imagem 5)
    2. Selecione os campos que deseja filtrar
    3. Clique em aplicar filtros

    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

    Índice
    outlinetrue
    indent30px

    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