Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
titleImportante

Informações sobre configuração e usabilidade da ferramenta.

Obs: A partir da 12.1.27 (data XX/XX/2022)

Painel
borderStylenone
Deck of Cards
effectDuration0.5
idcabecalho
effectTypeslide
Card
defaulttrue
effectDuration0.5
idtransmite
labelImportador XML x Totvs Transmite
titleTransmite
effectTypeslide

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

Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
Card
defaulttrue
effectDuration0.5
idIntroducao
labelIntrodução
titleIntrodução
effectTypeslide
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 Transmite

Aqui você verá:

  • Configuração.
  • Funcionalidades e Interfaces.
Card
effectDuration0.5
idTabelas
labelTabelas / Fontes
titleTabelas
effectTypeslide
deck
  • Tabelas:
effectDuration
Tabela
0.5
Descrição
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
DHWConfiguração Grupo/Empresa que integra com o Totvs Transmite
DHYGrava dos Ids para consulta dos XML importados do Totvs Transmite
DHZHistórico de Ids com erros e já importados no Importador XML


  • Fontes envolvidos:
FontesDescrição
COLXCFGWizard de configuração Totvs Colaboração / Importador XML
COLAUTOREADRotina para importar XMLs na CKOCOL
COMTRANSMITEClasse/Objeto para importação dos XML originados via Totvs Transmite
COMXCOLMonitor
MATA140IImporta NFE/NFS do Totvs Colaboração / Importador XML
Pelo Meu Protheus, poderá ser analisado e escolher entre aprovar ou reprovar esse registro. 
Card
effectDuration0.5
idSobre
labelSobre
titleSobre
effectTypeslide
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. 

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.



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

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

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


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

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

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

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

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

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

Column
width250

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




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


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


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



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


{
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


{
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

{
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

{
Card
defaulttrue
effectDuration0.5
idaprovacoes
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

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.

É possível também visualizar os pedidos de compras que foram aprovados ou reprovados nas respectivas guias Aprovados e Reprovados.

Painel
borderStylenone
titleAprovações
Column
width500

Card
defaulttrue
effectDuration0.5
idAnexos
labelAnexos
titleAnexos
effectTypeslide

Anexos

Nas aprovaçōes de pedido de compra é 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. 

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

{
Column
width500

{
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

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


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