Image Added

Painel
borderStyle none
Image Removed

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. 

Image Removed

Configurando o seu ambiente

1. Configure o Rest Protheus
2. Se você é cliente solicite um alias pelo Mingle. 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.

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
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 Tabelas: Fontes envolvidos: 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 effectDuration 0.5 id Tabelas label Tabelas / Fontes title Tabelas effectType slide Tabela Descrição DHW Configuração Grupo/Empresa que integra com o Totvs Transmite DHY Grava dos 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 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 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. cardConfiguraçãoConfiguraçãoConfiguração 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 deckslide Fluxograma effectType slide effectType Painel effectDuration 0.5 id Funcionalidades title Descrição das Etapas do Processo Observação:    [Imagem para ilustrar o Fluxo integração Importador XML e TOTVS Transmite] Image Added Parâmetros utilizados na integração. Data Inicio: Data de hoje - MV_XMLDIAS (30) Data Final: Data de hoje Imagens da configuração dos parâmetros no Wizard: Image Removed   Image Removed Deve-se informar qual Grupo/Filial estara integrada com o Totvs Transmite. Para que assim somente XMLs pertencentes ao mesmo Grupo/Filial sejam importados. Obs: Ao selecionar Grupo/Filial, o mesmo devera conter o seu Codigo Filial do Totvs Transmite. Informação esta na tabela DHW (DHW_CODFIL) Imagem da configuração de Grupo/Filial no Wizard. Image Removed Empresa/Filial: Empresa que serão utilizadas para importarem os XML's Modulo: (Ex: 02 - Compras) Deixar habilitado Informar recorrência: Definir o tempo em que os XML serão importados e gravados. Obs: Sugerimos que não deixa sempre ativo, defina a execução de tempo em tempo, Ex: 30 minutos 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. Card default true effectDuration 0.5 id WizardEtapas label WizardEtapas title WizardEtapas effectType slide Pode-se utilizar o Wizard como facilitador da configuração. Link: IX09 - Wizard Configuração Card effectDuration 0.5 id Parâmetros label Parâmetros title Parâmetros effectType slide Parâmetro Tipo Conteúdo Descrição Observação MV_DOCIMP C NFE/NFS/CTE Tipo de XML a serem importados pela integração Importador XML x Totvs Transmite MV_XMLCID C Client ID do Totvs Transmite Informação virá do Totvs Transmite MV_XMLCSEC C Client Secret do Totvs Transmite Informação virá do Totvs Transmite MV_XMLDIAS N 30 Range dias para importar documentos do Totvs Transmite   MV_XMLHIST L .F. Salva historico de Ids importados e/ou com erros Card effectDuration 0.5 id Empresa label Empresa title Empresa 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.  Card default true effectDuration 0.5 id Agendamento label Agendamento title Agendamento effectType slide 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 COLAUTOREAD Para importar XML's e gravar informações na tabela CKO SCHEDCOMCOL Ler os XML's da CKO e importar para o monitor (SDS e SDT) 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. 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 Card effectDuration 0.5 id Configuração label Configuração title Configuração 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	true
effectDuration	0.5
id	padrao
label	Padrão
title	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

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. 

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.