01. IMPLANTAÇÃO DO DASHBOARD


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


1. Em um ambiente Protheus, inserir arquivo sdfbra.txt na pasta systemload e rodar 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.


2. Aplicar o patch disponibilizado para Download.

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


3. Inserir a rotina DASH no menu desejado, via SIGACFG:


4. Configurar REST no ambiente. Exemplo de appserver.ini:

[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=

Atenção para as tags essenciais:


[GENERAL]
App_Environment=ENVIRONMENT


[DRIVERS]
MultiProtocolPort=1

MultiProtocolPortSecure=0


[HTTPURI]

CORSEnable=1

AllowOrigin=*


5. Acessar o Protheus na rotina DASH, inserida no passo 3.

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 ar
API pode estar chamando um endereço que não existe
Instabilidade do servidor
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 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

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>