Histórico da Página

...

Âncora

	CONFIG_PILOTO
	CONFIG_PILOTO

04. CONFIGURAÇÕES

Painel

Totvs custom tabs box

tabs	01 - DBAccess, 02 - Configuração Inicial, 03 - Appserver, 04 - TOTVS Mingle
ids	passo1,passo2,passo3,passo4

O Portal Gestão de Vendas é uma plataforma de web integrada com o modulo Faturamento (SIGAFAT) do Microsiga Protheus®, para efetuar esta integração é necessário que o seu ambiente esteja configurado corretamente com o pré-requisitos listados abaixo:

Totvs custom tabs box

tabs	01 - DBAccess, 02 - Configuração Inicial, 03 - Appserver, 04 - TOTVS Mingle
ids	passo1,passo2,passo3,passo4

Totvs custom tabs box items

default	yes
referencia	passo1

Para sincronizar os dados as APIs do Portal Gestão de Vendas utilizam o campo S_T_A_M_P_ como parâmetro de busca, sendo necessária a inclusão da chave UseRowStamp no TOTVS DBAccess.

Aviso

title	S_T_A_M_P_

O campo S_T_A_M_P_ será criado somente nas tabelas utilizadas pelo Portal Gestão de Vendas após a execução do programa inicial SETUPTGV (Verificar Passo 02)

Bloco de código

firstline	1
title	Exemplo dbaccess.ini
linenumbers	true

[General]
Port=7890

[MSSQL]
environments=environment

[MSSQL/environment]
UseRowStamp=1

Totvs custom tabs box items

default	no
referencia	passo2

Após executar a configuração do TOTVS DBAccess, conforme informado no Passo 01, será necessário efetuar a carga inicial das tabelas de Schemas (A1V) e campos dos schemas (A1W), também será necessário efetuar a inclusão do campo S_T_A_M_P_ nas tabelas utilizadas no portal Gestão de Vendas, para pode efetuar este procedimento foi criado um facilitador (SETUPTGV) que deve ser executado por um Administrador do sistema em modo exclusivo.

É possível efetuar estas configurações de duas formas, onde o usuário pode executar diretamente no SmartClient o programa inicial SETUPTGV ou através de uma função de usuário (user function), conforme exemplos abaixo:

Expandir

title	Expandir origem para visualizar exemplo de execução através do Smartclient

Totvs custom tabs box

tabs	Passo 01, Passo 02, Passo 03, Passo 04
ids	p1,p2,p3,p4

Aviso

title	Acesso exclusivo ao sistema

Antes de executar o passo a passo abaixo, certifique-se que não exista usuários ou job conectados ao sistema, caso contrario pode ocorrer falhas nos procedimentos.

Totvs custom tabs box items

default	yes
referencia	p1

Abrir o smartclient
Preencha o campo Programa inicial com o valor SETUPTGV
Clique em Ok para confirmar ação.

Image Modified

Totvs custom tabs box items

default	no
referencia	p2

Selecione as Empresa(s) e Filial(is) que serão utilizadas no Portal Gestão de Vendas.
Clique em confirmar

Image Modified

Totvs custom tabs box items

default	no
referencia	p3

Acesse a Parâmetros (botão Param.) e selecione as opções Atualizar tabelas com campo S_T_A_M_P_ e Carga Inicial de Schemas e clique em confirmar.
Novamente na tela inicial, clique em Ok para iniciar processamento.
Será apresentado uma tela onde deve ser informando os dados de um usuário com privilégios de Administrador.
Após validação do acesso do usuário será iniciado o processamento.

Informações
Este procedimento pode levar alguns minutos para ser concluído.

Informações
Caso as tabelas de Schemas do Gestão de Vendas (A1V) e Campos do Schema (A1W) contenham registros, será apresentada uma pergunta para o usuário selecionar se deseja atualizar os registros ou não.

Image Modified

Totvs custom tabs box items

default	no
referencia	p4

Ao finalizar o processamento, deve ser apresentado uma mensagem de Log conforme exemplo abaixo.
As tabelas utilizadas no Portal Gestão de Vendas devem apresentar o campo S_T_A_M_P_ ao concluir este procedimento (Para as Tabelas Genéricas (SX5) não será criado o campo).
As tabelas de Schemas do Gestão de Vendas (A1V) e Campos do Schema (A1W), devem conter registros.

Image Modified

Expandir

title	Expandir origem para visualizar exemplo de execução através de um função de usuário

Esta opção permite que o usuário execute o SETUPTGV, em segundo plano.

Informações
Caso já existam registros nas tabelas Schemas do Gestão de Vendas (A1V) e Campos do Schema (A1W), os dados serão atualizados.

Bloco de código

language	c#
theme	Eclipse
title	MySetupTGV
linenumbers	true

#include "totvs.ch"

user function MyStpTGV()
	local aCompanies := {}
	// aAdd( aCompanies, { "CODIGO DA EMPRESA - T1", "NOME EMPRESA" , "codigo da filial", "descrição da filial" } )
	aAdd( aCompanies, { "T1", "NOME EMPRESA" , "D MG 01 ", "descrição da filial" } )
	ProcSetupTGV(.f., aCompanies, .t., .t.)
    aSize(aCompanies, 0)
return nil

Totvs custom tabs box items

default	no
referencia	passo3

Comunicação REST

O Portal Gestão de Vendas efetua comunicação com o servidor Protheus através de requisições HTTP. Para que essa comunicação ocorra será necessário efetuar algumas configurações no servidor APPServer.
Para maiores informações sobre REST consulte o documento de referenciada da rotina.

Aviso

title	Chave de Segurança

Caso a Chave Security não seja informado no "appserver.ini" ou seja informado com o valor 0, não serão validados as permissões de acesso do usuário.

Para maiores informações consulte o documento de referenciada da rotina clicando aqui.

Aviso

title	Chave PrepareIn

Caso a chave PrepareIn esteja apontando para empresas específicas, na funcionalidade de Troca de Filial, os usuários terão acesso apenas às empresas informadas nesta chave. Caso não seja necessário este tipo de restrição, mantê-la como "All".

Para maiores informações, consulte a documentação clicando aqui.

Bloco de código

title	exemplo appserver.ini

[ENVIRONMENT]
	SourcePath=\TOTVS\apo\
	RootPath=\TOTVS\Protheus_data\
	StartPath=\system\
	RpoDb=Top
	RpoLanguage=Portuguese
	RegionalLanguage=BRA
	RpoVersion=120
	dbserver=localhost
	dbdatabase=MSSQL
	dbalias=ENVIRONMENT
	dbport=7890
	TOPMemoMega=30

[Drivers]
	Active=TCP
	MultiProtocolPort=1	
	multiprotocolportsecure=0
	Secure=SSL

[HTTPJOB]
	ENVIRONMENT=ENVIRONMENT
	MAIN=HTTP_START

[HTTPREST]
	BUGS=0
	HSM=0	
	MaxQueue=10	
	Port=8282
	SECURITY=1
	SSL2=0
	SSL3=0
	State=0
	TLS1=0
	URIs=HTTPURI
	Verbose=0

[HTTPURI]
	AllowOrigin=*
	CORSEnable=0
	Instances=1,2
	OnConnect=REST_CONNECT
	OnExit=REST_EXIT
	OnStart=REST_START
	PrepareIn=All
	URL=/rest/

[HTTPV11]
	ADVPL=0
	Enable=1
	Sockets=HTTPREST
	TimeOut=120
			
[HTTPSERVER]
	Enable=0
	Servers=HTTP_REST

[HTTP_REST]
	hostname=localhost
	port=9995
	locations=HTTP_ROOT

[HTTP_ROOT]
	Path=/rest/
	RootPath=root/web
	ThreadPool=THREAD_POOL
	
[THREAD_POOL]
	Environment=ENVIRONMENT
	MinFreeThreads=1
	MinThreads=1
	MaxThreads=10

[OnStart]
	JOBS=HTTPJOB
	REFRESHRATE=120

Âncora
MINGLE
MINGLE

Totvs custom tabs box items

default	no
referencia	passo4

Informações

title	Alias TOTVS Mingle

Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP publico.

A plataforma Portal Gestão de Venda é armazenada em uma nuvem TOTVS. Para que a aplicação possa se comunicar com o servidor Protheus é necessário efetuar a configuração do TOTVS Mingle, que executa o papel de um gateway entre a aplicação é o servidor Protheus. Além disso, ao configurar o TOTVS Mingle, a aplicação passa a utilizar os dados de Autenticação padrão do Protheus.
Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP publico.
O Administrador do sistema deve solicitar um Alias, através da pagina TOTVS MINGLE e informar o app Portal Gestão de Vendas.
O Usuário deve receber a chave de acesso por e-mail.

Informações

title	Empresa/Filial

Deve ser informado ao menos uma empresa e filial no cadastro do Mingle

Image Modified

O Alias recebido deve ser o mesmo utilizado para acessar a plataforma e deve ser inserido junto com os dados do Login do usuário.

Image Modified

Âncora

	TECNICAS
	TECNICAS

04. INFORMAÇÕES TÉCNICAS

Painel

Âncora

	ENTRAR
	ENTRAR

Para entrar na plataforma, o Vendedor deve informar o mesmo Usuário e Senha utilizados no Protheus e informar o Alias, mencionado na sessão requisitos mínimos.
Ao entrar no Portal Gestão de Vendas pela primeira vez, a aplicação deverá efetuar a carga inicial. Esta carga é efetuada apenas no primeiro acesso ou caso o usuário seja alterado.

Image Modified

Ao efetuar o Login e iniciar a carga inicial, o usuário é redirecionado para os Indicadores de Venda (Home).
Na barra superior é possível visualizar os dados do Vendedor, consultar as Notificações e Sair da aplicação.

Image Modified

Âncora

	VERSAO
	VERSAO

Ao realizar o login no Portal de Gestão de Vendas, é executada uma verificação para avaliar se a versão do servidor Protheus é a mesma que consta no Portal do Usuário. Caso o Vendedor ( usuário ) receba a mensagem abaixo, significa que o deve ser atualizado o Repositório ( RPO ) aplicando o último pacote da expedição continua que consta AQUI. O usuário ficará impossibilitado de realizar o login até que o repositório seja atualizado com sua versão mais recente.

Image Modified

Âncora

	TABELAS_UTILIZADAS
	TABELAS_UTILIZADAS

05. TABELAS UTILIZADAS

Painel

A1S - Notificações do Vendedor
A1T - Controle de Integração de Pedidos
A1V - Schemas do Gestão de vendas
A1W - Campos do Schema
AC8 - Relação de Contatos X Entidade
AGB - Telefones X Entidades
DA0 - Tabela de Preços
DA1 - Itens da Tabela de Preços
SA1 - Clientes
SA3 - Vendedores
SA4 - Transportadoras
SB1 - Descrição Genérica do Produto
SB2 - Saldos Físico e Financeiro
SC5 - Pedidos de Venda
SC6 - Itens dos Pedidos de Venda
SC9 - Pedidos Liberados
SD2 - Itens de Venda da NF
SE1 - Contas a Receber
SE4 - Condições de Pagamento
SF2 - Cabeçalho das NF de Saída
SU5 - Contatos
SX5 - Tabelas Genéricas
SYA - Países

Âncora

	RELACIONADOS
	RELACIONADOS

06. ASSUNTOS RELACIONADOS

Painel
Perguntas mais frequentes do Portal Gestão de Vendas Indicadores de Venda Minhas Notificações Meus Clientes Meus Pedidos TOTVS Mingle Schedule - Como agendar a execução de rotinas REST ADVPL Entendendo as novidades do REST (2.0) REST com ERP Microsiga Protheus DBAccess - Seção [Environment], chave UseRowStamp Controle de dados protegidos - Protheus 12

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>

...

Árvore de páginas

Versões comparadas

Versão antiga 142

Nova versão 143

Chave

04. CONFIGURAÇÕES

Âncora
MINGLE
MINGLE

04. INFORMAÇÕES TÉCNICAS

06. ASSUNTOS RELACIONADOS

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 142

Nova versão 143

Chave

04. CONFIGURAÇÕES

ÂncoraMINGLEMINGLE

04. INFORMAÇÕES TÉCNICAS

a. ENTRAR (LOGIN)

b. VALIDAÇÃO DE VERSÃO (LOGIN)

06. ASSUNTOS RELACIONADOS

Âncora
MINGLE
MINGLE

a. **ENTRAR (LOGIN)**

b. **VALIDAÇÃO DE VERSÃO (LOGIN)**