Image Added

Painel
borderStyle none
Image Removed

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.

Deck of Cards
effectDuration 0.5 id cabecalho effectType slide
Card default true effectDuration 0.
Deck of Cards
effectDuration 0.5 id cabecalho effectType slide
true Card default true effectDuration 0.5 id transmite label Importador XML x Totvs TOTVS Transmite title Transmite effectType slide Deck of Cards effectDuration 0.5 id tudo-sobre effectType slide slide Card default true effectDuration 0.5 id Introducao label Introdução title Introdução effectType slide Column 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 integração do Importador XML x Totvs TOTVS Transmite.    Aqui você verá: Configuração. Funcionalidades e Interfaces. Card Painel title Processo de Check-list Para que a integração entre o Importador XML e TOTVS Transmitefuncione corretamente, preparamos um Checklist dos requisitos mínimos que devem ser validados para o correto funcionamento da integração.  [Imagem para ilustrar as etapas do Checklist] Image Added *Clique na imagem para ampliar. Painel title Integração (Processo macro): Abaixo uma imagem ilustrativa do processo de integração entre o Importador XML e TOTVS Transmite. [Imagem para ilustrar a integração Importador XML e TOTVS Transmite] Image Added *Clique na imagem para ampliar. effectDuration 0.5 id Sobre label Sobre title Sobre effectType EventosEventosEventos 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. 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. 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). Prestação de Contas O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de prestação de contas (Controle de Viagens). 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). 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). 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:  Card default true effectDuration 0.5 id Fluxograma label Fluxograma / Etapas do Processo title Fluxograma effectType slide Deck of Cards effectDuration 0.5 id Fluxo effectType slide Card default true effectDuration 0.5 id Fluxograma label Fluxograma title Fluxograma effectType slide Painel title Descrição das Etapas do Processo Observação:    [Imagem para ilustrar o Fluxo integração Importador XML e TOTVS Transmite] Image Added Card default true effectDuration 0.5 id Etapas label Etapas title Etapas effectType slide Painel title Descrição das Etapas do Processo  Observação: Para um melhor aproveitamento e entendimento da integração entre o Importador XML e TOTVS Transmite é importante que o usuário tenha o conhecimento prévio   Etapas Importador XML x TOTVS Transmite Descrição do Processo TOTVS Transmite Descrição do Processo  Importador XML Descrição do Processo TEC PASSO 1 Configuração da integração Importador XML x Totvs Transmite Parâmetros: MV_IMPXML (Habilitado Importador XML) MV_XMLCID (Client Id Transmite) MV_XMLCSEC (Client Secret Transmite) MV_APITRAN (Ambiente Transmite) MV_NGINN (Pasta IN) MV_NGLIDOS (Pasta Lidos) MV_DOCIMP (Tipo documentos a serem importados) Wizard: Através do Wizard é possível configurar todos os parâmetros descritos acima e informar as filiais do Importador XML que serão integradas junto ao Totvs Transmite (Gravando na DHW) PASSO 2 Agendamento COLAUTOREAD Inicia verificando se possui XMLs na pasta IN (MV_NGINN) PASSO 3 Agendamento SCHEDIMPTRA Feita a chamado do EndPoint no Totvs Transmite para requisitar os XMLs "pendentes" para integração com Importador XML Importante: Para correto funcionamento do EndPoint, é preciso ter: Tabela DHW com o vinculo entre as filiais do Protheus e Totvs Transmite Parâmetro: MV_DOCIMP e MV_DTINITR PASSO 4 Agendamento SCHEDIMPTRA Totvs Transmite recebe requisição solicitada pelo Importador XML e retorna ao Protheus os "Recibos" Importante: Totvs Transmite retorno um recibo por tipo de documento (MV_DOCIMP) PASSO 5 Agendamento SCHEDIMPTRA Protheus (Importador XML) recebe os "Recibos" do Totvs Transmite e os grava na tabela DHY PASSO 6 Agendamento SCHEDIMPTRA Com os "Recibos" na tabela DHY é feito a chamada de outro EndPoint no Totvs Transmite para gravar o XMLs no Importador XML (Tabela CKO)  PASSO 7 Agendamento SCHEDIMPTRA Totvs Transmite recebe requisição solicitada pelo Importador XML e retorna ao Protheus um arquivo em Encode64 com todos os XMLs daquele "Recibo" PASSO 8 Agendamento SCHEDIMPTRA Protheus (Importador XML) recebe o Encode64 com os XMLs e vai fazer o Decode64 (TEC) O Decode64 é feito e seu retorno gera um arquivo .ZIP PASSO 9 Agendamento SCHEDIMPTRA Com o arquivo .ZIP gerado através do Decode64, é necessário fazer a descompactação desse arquivo. A descompactação do arquivo .ZIP é feito pela função FUnZip PASSO 10 Agendamento SCHEDIMPTRA Os arquivos descompactados serão salvos dentro da pasta (\transmite\) e feita a leitura dos XMLs gravando na tabela CKO PASSO 11 Agendamento SCHEDUPDTRA Após a gravação na tabela CKO, o Importador XML chama o EndPoint do Totvs Transmite para fazer as atualizações de status do documento no Totvs Transmite PASSO 12 Agendamento SCHEDUPDTRA Totvs Transmite recebe requisição solicitada pelo Importador XML com a chave do documento e faz a atualização dos status no Totvs Transmite. PASSO 12 Agendamento SCHEDCOMCOL Protheus (Importador XML) lê os XMLs da tabela CKO e os envia para o Monitor, caso não encontre nenhuma inconsistência 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.   Painel borderStyle none title Conheça o Meu Protheus Column width 500 Conector de Widget width 500 url https://www.youtube.com/watch?v=JBf1ObCPLYE&t=7s height 500 A seguir você pode encontrar mais informações sobre o as funcionalidades do aplicativo. Deck of Cards effectDuration 0.5 id Funcionalidades effectType slide Card default true effectDuration 0.5 id Eventos label Eventos title Eventos effectType slide 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 effectDuration 0.5 id Aprovacoes label Aprovações title Aprovações effectType slide 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 .  Passo a passo de configuração 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. Card effectDuration 0.5 id ConfiguracaoTabelas label ConfiguraçãoTabelas / Fontes title ConfiguraçãoTabelas effectType slide Aviso title Pré-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 title Suporte 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. Deck of Cards effectDuration 0.5 id Container effectType slide Card default Tabelas: Tabela Descrição DHW Configuração Grupo/Empresa que integra com o Totvs Transmite DHY Grava os Ids para consulta dos XML importados do Totvs Transmite DHZ Histórico de Ids com erros e já importados no Importador XML CKOCOL Registros do XMLs importados SDS Cabeçalho do documento no monitor SDT Itens do documento no monitor Fontes envolvidos: Fontes Descrição COLXCFG Wizard de configuração TOTVS Colaboração / Importador XML COLAUTOREAD Rotina para importar XMLs na CKOCOL COMTRANSMITE Classe/Objeto para importação dos XML originados via TOTVS Transmite COMXCOL Monitor MATA140I Importa NFE/NFS do TOTVS Colaboração / Importador XML MATA116I Importa CTE/CTEOS do TOTVS Colaboração / Importador XML WIZIMP Wizard Integração Importador XML x TOTVS Transmite IMPTRATOOL Ferramenta de Analise Integração Importador XML x TOTVS Transmite SCHEDIMPTRA Agendamento requisição e leitura dos recibos SCHEDUPDTRA Agendamento atualização status no TOTVS Transmite padraoPadrãoPadrão 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.  Image Removed 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 clique em Parâmetros. Clique sobre a lupa e pesquisar por MV_MINGKEY. Preencha nos campos Cont. Por, Cont. Ing, Cont. Esp com o Token. Card effectDuration 0.5 id Configuração label Configuração title Configuração effectType slide configuracao-2 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. Deck of Cards effectDuration 0.5 id Funcionalidades effectType slide ambiente-protheusAmbiente ProtheusAmbiente Protheus 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 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 clique em Parâmetros. Clique sobre a lupa e pesquisar por MV_MINGKEY. Preencha nos campos Cont. Por, Cont. Ing, Cont. Esp com o Token. Card default true effectDuration 0.5 id Wizard label Wizard title Wizard effectType slide Dica O Token será encaminhado ao solicitar 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 Painel borderStyle none title Valide a 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 Painel borderStyle none title Inscrição do Event Viewer 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 Dica O Token será encaminhado ao solicitar 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

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. 

Para funções customizadas você deverá adicionar algumas linhas de código. 

#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

Após o código fonte compilado acione a rotina. A seguir segue um exemplo para acionar a função compilada no RPO.

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. 

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

Image Removed

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. 

Image Removed

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.

Image Removed

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.

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

Image Removed

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

Image Removed{

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. 

Anexos

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

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

Perfil

Apresenta dados importantes sobre a conexão do aplicativo com o ambiente Protheus.

• Usuário
• Cliente
• Empresa
• Set
• filial

No Importador XML é necessário criar agendamentos das rotinas responsáveis pela importação e gravação do XML no Monitor (Protheus).

Para realizar o cadastro dos agendamentos é necessário o seguinte:

• SIGACFG -> AMBIENTE -> SCHEDULE -> SCHEDULE (Agendamento -> Cadastro): 
  • Informar usuário (Ex: 000000 - Administrador)

  • Rotina (tabela abaixo)

    Agendamento	Descrição	Recorrência	Configuração	Consumo Licença
    COLAUTOREAD	Para importar XML's através da pasta IN (MV_NGINN) e gravar informações na tabela CKO	48 (00:30 min)	Configurar apenas uma filial por grupo de empresa que ocorrera a importação Ex: T1 / D MG 01       T2 / D SP 01 Obs: Dessa forma ao importar XML será analisado se documento pertence a qualquer filial de cada grupo de empresa.	Por Empresa
    SCHEDIMPTRA	Para requisitar e ler recibos retornados do TOTVS Transmite	144 (00:10 min)	Configurar apenas uma filial por grupo de empresa que ocorrera a importação Ex: T1 / D MG 01       T2 / D SP 01 Obs: Dessa forma ao importar XML será analisado se documento pertence a qualquer filial de cada grupo de empresa.	Por Empresa
    SCHEDUPDTRA	Para atualizar status de documentos no TOTVS Transmite	72 (00:20 min)	Configurar apenas uma filial por grupo de empresa que ocorrera a importação Ex: T1 / D MG 01       T2 / D SP 01 Obs: Dessa forma ao atualiza status será analisado toda a CKO, com documentos de todos grupos e filiais importados.	Por Empresa
    SCHEDCOMCOL	Ler os XML's da CKO e importar para o monitor (SDS e SDT)	288 (00:05 min)	Configurar TODOS os grupos e filiais que documentos possam pertencer para que sera importado para o monitor no grupo e filial correto Ex: T1 / D MG 01       T1 / D MG 02       T2 / D SP 01       T2 / D SP 02	Por Filial

  • Modulo: (Ex: 02 - Compras)
  • Deixar habilitado

• SIGACFG -> AMBIENTE -> SCHEDULE -> SCHEDULE (Agent -> Cadastro): 
  • Incluir o Grupo de empresa/Empresa que contem configurado os agendamentos.

Para que funcione corretamente os agendamentos é necessário que após toda configuração, o Agent e o Schedule sejam ativados.