01. IMPLANTAÇÃO DO DASHBOARD

Essa funcionalidade está em tempo de piloto, isto é, ainda não disponível para todos os clientes.

 O Dashboard necessita do Microsiga Protheus® Release 12.1.33 ou superior.

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

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

O Dashboard é compatível com os módulos do Backoffice Protheus.


Siga o passo a passo abaixo para implantação e utilização do Dashboard Backoffice.

1. Habilite a Porta Multiprotocolo conforme configurações a seguir.


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


[GENERAL]
App_Environment=ENVIRONMENT


[DRIVERS]
MultiProtocolPort=1


[HTTPURI]

CORSEnable=1

AllowOrigin=*

Efetuar os passos abaixo caso for utilizada comunicação segura:


1.1. Instalar 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 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 pasta appserver os 2 arquivos gerados no passo anterior.


1.4. Inserir no appserver.ini as chaves abaixo:

[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 para o caminho onde foram colocados os certificados)
KeyServer=C:\Protheus12\totvs\tec\appserver\totvs_certificate_key.pem (adequar para o caminho onde foram colocados os certificados)


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

[tcp]
secureconnection=1


[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 (adequar para o caminho onde foram colocados os certificados)
KeyServer=C:\Protheus12\totvs\tec\appserver\totvs_certificate_key.pem (adequar 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

;config REST

[ONSTART]
jobs=HTTPJOB
RefreshRate=30
ENVIRONMENT=ENVIRONMENT

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=ENVIRONMENT

[HTTPV11]
ADVPL=1
Enable=1
Sockets=HTTPREST
TimeOut=120

[HTTPREST]
Port=8282
URIs=HTTPURI
SECURITY=0
IPSBIND=LOCALHOST

[HTTPURI]
URL=/rest
PrepareIn=All
Instances=5,5
CORSEnable=1
AllowOrigin=*

[WebApp/webapp]
MPP=

Efetuar os passos abaixo caso não for utilizada comunicação segura:


1.1. Inserir no appserver.ini:

[DRIVERS]

MultiProtocolPortSecure=0


1.2. Inserir no smartclient.ini:

[tcp]

secureconnection=0


[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

;config REST

[ONSTART]
jobs=HTTPJOB
RefreshRate=30
ENVIRONMENT=ENVIRONMENT

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=ENVIRONMENT

[HTTPV11]
ADVPL=1
Enable=1
Sockets=HTTPREST
TimeOut=120

[HTTPREST]
Port=8282
URIs=HTTPURI
SECURITY=0
IPSBIND=LOCALHOST

[HTTPURI]
URL=/rest
PrepareIn=All
Instances=5,5
CORSEnable=1
AllowOrigin=*

[WebApp/webapp]
MPP=

Caso o REST não seja configurado no ambiente, será usado o REST da Porta Multiprotocolo 


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

Nesse passo, as tabelas A1N, A1O, A1P, A1Q e A1R serão criadas. Elas correspondem aos Cards, Charts e Visões do Dash.

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.


4. Insira a rotina DASH no menu desejado, via SIGACFG.


5. Acesse o Protheus na rotina DASH, inserida no passo anterior.
Na primeira execução, as tabelas criadas pelo UPDDISTR serão populadas com os Cards, Charts e Visões padrões.

02. POSSÍVEIS ERROS

Possíveis MotivosSolução
Serviço de API fora do arVerificar se serviços do Protheus estão no ar
API pode estar chamando um endereço que não existeVerificar se tabelas A1N, A1O, A1P, A1Q e A1R estão populadas
Instabilidade do servidorVerificar se servidor está ativo
Possíveis MotivosSoluçã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 desta documentação
O serviço REST pode estar fora do ar ou instávelVerificar se serviços do Protheus estão no ar
O Servidor pode estar desligadoVerificar se Servidor está ativo

Possíveis MotivosSolução
Funções padrões responsáveis pelo funcionamento do Dash não estão compiladasAplicar patch enviado

Possíveis MotivosSolução
O serviço REST pode estar fora do arVerificar 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 desta documentação

03. ASSUNTOS RELACIONADOS









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