Histórico da Página

...

Expandir

title	Informações Importantes 🛑

Aviso
Essa funcionalidade está em tempo de piloto, isto é, ainda não disponível para todos os clientes.
Aviso
O Dashboard necessita do Microsiga Protheus® Release 12.1.33 ou superior.

Aviso
O Dashboard necessita do Binário de janeiro outubro/2021 ou superior.

Aviso
O Dashboard necessita de Lib de 06/01/2021 ou superior.

Informações
O Dashboard é compatível com os módulos do Backoffice Protheus.

...

1. Ajuste os arquivos appserver.ini e smartclient.ini, com a Porta Multiprotocolo e outras chaves necessárias, conforme explanado a seguir.

Deck of Cards

id	ambientes

Card

default	true
id	obrigatorias
label	Chaves Obrigatórias

Inserir Insira no appserver.ini as chaves abaixo, independente do tipo de comunicação utilizado no ambiente:

[GENERAL]
App_Environment=ENVIRONMENT

[DRIVERS]
MultiProtocolPort=1

Card

id	CSSL
label	Com SSLConfigure (comunicação segura)

Efetuar Efetue os passos abaixo caso deseje utilizar comunicação segura:

1.1. Instalar Instale no servidor e na(s) máquina(s) onde será executado o Smartclient, o certificado totvs_certificate_CA.crt contido na pasta appserver. Mais informações em Application Server - Porta Multiprotocolo.

1.2. Executar Execute o totvs_certificates.exe disponível em Porta Multiprotocolo - Geração de Certificado, a fim de gerar o certificado do servidor (arquivos totvs_certificate.crt e totvs_certificate_key.pem).

1.3. Inserir na Copie para a pasta appserver os 2 dois arquivos gerados no passo anterior.

1.4. Inserir Insira no appserver.ini as chaves:

[DRIVERS]
MultiProtocolPort=1
MultiProtocolPortSecure=1

[SSLConfigure]
SSL2 = 1
SSL3 = 1
TLS1_0 = 1
TLS1_1 = 1
TLS1_2 = 1
Bugs =1
State =1
CertificateServer=C:\Protheus12\totvs\tec\appserver\totvs_certificate.crt (adequar adeque para o caminho onde foram colocados os certificados)
KeyServer=C:\Protheus12\totvs\tec\appserver\totvs_certificate_key.pem (adequar adeque para o caminho onde foram colocados os certificados)

1.5. Inserir Insira no(s) smartclient.ini a chave:

[tcp]
secureconnection=1

Card

id	SSSL
label	Sem SSLConfigure

Efetuar Efetue os passos abaixo caso não deseje utilizar comunicação segura:

1.1. Inserir Insira no appserver.ini a chave:

[DRIVERS]
MultiProtocolPort=1
MultiProtocolPortSecure=0

1.2. Inserir Insira no(s) smartclient.ini a chave:

[tcp]
secureconnection=0

Bloco de código

language	delphi
firstline	1
title	Exemplo de appserver.ini com SSLConfigure
linenumbers	true
collapse	true

[ENVIRONMENT]
SOURCEPATH=C:\Protheus12\totvs\protheus\apo
ROOTPATH=C:\Protheus12\totvs\protheus\Protheus_data
STARTPATH=/system/
RPODB=TOP
RPOLANGUAGE=PORTUGUESE
RPOVERSION=120
LOCALFILES=CTREE
LOCALDBEXTENSION=.dtc
StartSysInDB=1
TOPMEMOMEGA=1
PICTFORMAT=DEFAULT
DATEFORMAT=DEFAULT

;sql 
DBDATABASE=MSSQL
DBSERVER=LOCALHOST
DBALIAS=ENVIRONMENT
dbport=7892

[TDS]
AllowApplyPatch=*
AllowEdit=*

[DRIVERS]
ACTIVE=TCP
MultiProtocolPort=1 
MultiProtocolPortSecure=1

[SSLConfigure]
SSL2   = 1
SSL3   = 1
TLS1_0 = 1
TLS1_1 = 1
TLS1_2 = 1
Bugs    =1
State   =1
CertificateServer=C:\Protheus12\totvs\tec\appserver\totvs_certificate.crt (adequaradeque para o caminho onde foram colocados os certificados)
KeyServer=C:\Protheus12\totvs\tec\appserver\totvs_certificate_key.pem (adequaradeque para o caminho onde foram colocados os certificados)
 
[TCP]
TYPE=TCPIP
PORT=1232

[GENERAL]
App_Environment=ENVIRONMENT 
BUILDKILLUSERS=1
MAXSTRINGSIZE=10

[LICENSECLIENT]
server=LOCALHOST
port=8009

[HTTP]
ENABLE=1
PORT=88
ENVIRONMENT=ENVIRONMENT

[WEBAPP]
PORT=1255
WebSocket=0
LastMainProg=SIGAADV

[WebApp/webapp]
MPP=

Bloco de código

language	delphi
firstline	1
title	Exemplo de appserver.ini sem SSLConfigure
linenumbers	true
collapse	true

[ENVIRONMENT]
SOURCEPATH=C:\Protheus12\ENVIRONMENT\totvs\protheus\apo
ROOTPATH=C:\Protheus12\ENVIRONMENT\totvs\protheus\Protheus_data
STARTPATH=/system/
RPODB=TOP
RPOLANGUAGE=PORTUGUESE
RPOVERSION=120
LOCALFILES=CTREE
LOCALDBEXTENSION=.dtc
StartSysInDB=1
TOPMEMOMEGA=1
PICTFORMAT=DEFAULT
DATEFORMAT=DEFAULT

;sql 
DBDATABASE=MSSQL
DBSERVER=LOCALHOST
DBALIAS=ENVIRONMENT
dbport=7892

[TDS]
AllowApplyPatch=*
AllowEdit=*

[DRIVERS]
ACTIVE=TCP
MultiProtocolPort=1 
MultiProtocolPortSecure=0
 
[TCP]
TYPE=TCPIP
PORT=1232

[GENERAL]
App_Environment=ENVIRONMENT 
BUILDKILLUSERS=1
MAXSTRINGSIZE=10

[LICENSECLIENT]
server=LOCALHOST
port=8009

[HTTP]
ENABLE=1
PORT=88
ENVIRONMENT=ENVIRONMENT

[WEBAPP]
PORT=1255
WebSocket=0
LastMainProg=SIGAADV

[WebApp/webapp]
MPP=

Bloco de código

language	delphi
firstline	1
title	Exemplo de appserver.ini MASTER com SSLConfigure
linenumbers	true
collapse	true

[P12_DB_27_EXP]
SourcePath=C:\Protheus\Apo64
RootPath=C:\Protheus\Protheus_Data
STARTPATH=\system\
RPODB=Top
RPOLANGUAGE=portuguese
RPOVERSION=120
LOCALFILES=CTREE
TRACE=0
LOCALDBEXTENSION=.dtc
SpecialKey=FCO_P12
TopMemoMega=1
DBDATABASE=MSSQL
DBSERVER=LOCALHOST
DBALIAS=P12_DB_27_EXP
StartSysInDB=1

[LICENSECLIENT]
server=localhost
port=8009

[Drivers]
Active=TCP
MultiProtocolPort=1
MultiProtocolPortSecure=1

[SSLConfigure]
SSL2   = 1
SSL3   = 1
TLS1_0 = 1
TLS1_1 = 1
TLS1_2 = 1
Bugs    =1
State   =1
CertificateServer=C:\Protheus\Bin\64\appserver\totvs_certificate.crt
KeyServer=C:\Protheus\Bin\64\appserver\totvs_certificate_key.pem

[TCP]
TYPE=TCPIP
Port=1227

[General]
consolemaxsize=15728640 
MAXSTRINGSIZE=10
MaxQuerySize=65536
App_Environment=P12_DB_27_EXP

[ServerNetwork]
MasterConnection=1
Servers=SLAVE

[SLAVE]
Type=TCPIP
;ip do server:
Server=10.111.1.11 
Port=1228
Connections=1

[HTTP]
enable=1
port=8282

[WEBAPP]
Port=1210

[WebApp/webapp]
MPP=

Bloco de código

language	delphi
firstline	1
title	Exemplo de appserver.ini SLAVE com SSLConfigure
linenumbers	true
collapse	true

[P12_DB_27_EXP]
SourcePath=C:\Protheus\Apo64
RootPath=C:\Protheus\Protheus_Data
STARTPATH=\system\
RPODB=Top
RPOLANGUAGE=portuguese
RPOVERSION=120
LOCALFILES=CTREE
TRACE=0
LOCALDBEXTENSION=.dtc
SpecialKey=FCO_P12
TopMemoMega=1
DBDATABASE=MSSQL
DBSERVER=LOCALHOST
DBALIAS=P12_DB_27_EXP
StartSysInDB=1

[LICENSECLIENT]
server=localhost
port=8009

[Drivers]
Active=TCP
MultiProtocolPort=1
MultiProtocolPortSecure=1

[SSLConfigure]
SSL2   = 1
SSL3   = 1
TLS1_0 = 1
TLS1_1 = 1
TLS1_2 = 1
Bugs    =1
State   =1
CertificateServer=C:\Protheus\Bin\64\appserver\totvs_certificate.crt
KeyServer=C:\Protheus\Bin\64\appserver\totvs_certificate_key.pem

[TCP]
TYPE=TCPIP
Port=1228

[General]
consolemaxsize=15728640 
MAXSTRINGSIZE=10
MaxQuerySize=65536
App_Environment=P12_DB_27_EXP

[HTTP]
enable=1
port=8283

[WEBAPP]
Port=1210

[WebApp/webapp]
MPP=

Bloco de código

language	delphi
firstline	1
title	Exemplo de smartclient.ini com SSLConfigure
linenumbers	true
collapse	true

[config]
lastmainprog=sigaadv
envserver=P12_DB_27_EXP

[drivers]
active=tcp

[tcp]
;ip do server:
Server=10.111.1.11
port=1227
secureconnection=1

Informações

title	Nota

Não será necessário configurar REST, pois será utilizado o REST Server da Porta Multiprotocolo.

2. Em um ambiente Protheus, insira o arquivo sdfbra.txt (disponibilizado para Download) na pasta systemload e rode o UPDDISTR.

...

3. Aplique o patch-dash.ptm disponibilizado para Download.

Esse pacote contém a rotina DASH.app e os serviços Protheus necessários para seu funcionamento.

...

Image Removed

...

Informações

title	Importante

Caso seja utilizado Load Balance, a comunicação usada no appserver.ini dos slaves deverá ser a mesma do master, conforme explicado em Porta Multiprotocolo

...

.

02. POSSÍVEIS ERROS

Expandir

title	Erro 503

Possíveis Motivos	Solução
Serviço de API fora do ar	Verificar Verifique se serviços do Protheus estão no ar
API pode estar chamando um endereço que não existe	Verificar Verifique se tabelas A1N, A1O, A1P, A1Q e A1R estão populadas
Instabilidade do servidor	Verificar Verifique se servidor está ativo

Expandir

title	Servidor não está respondendo

Possíveis Motivos	Solução
O serviço REST pode não estar configurado de maneira correta	Verificar configuração do REST conforme explanado no ponto 14 do passo a passo Verifique se as configurações de appserver.ini e smartclient.ini estão de acordo com o ponto 1 desta documentação
O serviço REST pode estar fora do ar ou instável	Verificar Verifique se serviços do Protheus estão no ar
O Servidor pode estar desligado	Verificar Verifique se Servidor está ativo

Expandir

title	NOFUNCW - Opção Não Disponível no Protheus

Possíveis Motivos	Solução
Funções padrões responsáveis pelo funcionamento do Dash não estão compiladas	Aplicar patch enviadoAplique o patch do Dashboard disponibilizado para Download

Expandir

title	Esta pagina não está funcionando

Possíveis Motivos	Solução
O serviço REST pode estar fora do ar	Verificar Verifique se serviços do Protheus estão no ar
O serviço REST pode não estar configurado de maneira correta	Verificar configuração do REST conforme explanado no ponto 14 Verifique se as configurações de appserver.ini e smartclient.ini estão de acordo com o ponto 1 desta documentação

03. ASSUNTOS RELACIONADOS

...

Árvore de páginas

Versões comparadas

Versão antiga 30

Nova versão Atual

Chave

02. POSSÍVEIS ERROS

03. ASSUNTOS RELACIONADOS