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.

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.

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. 

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.

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.

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.

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. 

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. 

#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

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

{

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

{

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.

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

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

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

• 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;
      • : Alerta de que a despesa teve um custo elevado baseado na região;

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

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