01. IMPLANTACIÓN DEL DASHBOARD

Esta funcionalidad está en tiempo de piloto, es decir, aún no está disponible para todos los clientes.

 El Dashboard necesita del Microsiga Protheus® Release 12.1.33 o superior.

El Dashboard necesita del Binario de enero/2021 o superior.

El Dashboard necesita de la Lib de 06/01/2021 o superior.

El Dashboard es compatible con los módulos del Backoffice Protheus.


Siga este paso a paso para la implantación y utilización del Dashboard Backoffice.

1. Ajuste los archivos appserver.ini y smartclient.ini, con el Puerto multiprotocolo y otras claves necesarias, como se explica a continuación.

Incluya en el appserver.ini las siguientes claves, independientemente del tipo de comunicación utilizado en el entorno:

[GENERAL]
App_Environment=ENVIRONMENT

[DRIVERS]
MultiProtocolPort=1

Efectúe los siguientes pasos si desea utilizar la comunicación segura:

1.1. Instale en el servidor y en la(s) máquina(s) donde se ejecutará el Smartclient, el certificado totvs_certificate_CA.crt contenido en la carpeta appserver. Más información en Application Server - Puerto multiprotocolo.

1.2. Ejecute el totvs_certificates.exe disponible en Puerto multiprotocolo - Generación de certificado, para generar el certificado del servidor (archivos totvs_certificate.crt e totvs_certificate_key.pem).

1.3. Copie en la carpeta appserver los dos archivos generados en el paso anterior.


1.4. 
Incluya en el appserver.ini las claves:

[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 (adecúe al camino donde se colocaron los certificados)
KeyServer=C:\Protheus12\totvs\tec\appserver\totvs_certificate_key.pem (adecúe al camino donde se colocaron los certificados)


1.5. 
Incluya en el(los) smartclient.ini la clave:

[tcp]
secureconnection=1

Efectúe los siguientes pasos si no desea utilizar comunicación segura:

1.1. Insira no appserver.ini a chave:

[DRIVERS]
MultiProtocolPort=1 
MultiProtocolPortSecure=0

1.2. Incluya en el appserver.ini la clave:

[tcp]
secureconnection=0

[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 (adecúe al camino donde se colocaron los certificados)
KeyServer=C:\Protheus12\totvs\tec\appserver\totvs_certificate_key.pem (adecúe al camino donde se colocaron los 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=
[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=
[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=
[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=
[config]
lastmainprog=sigaadv
envserver=P12_DB_27_EXP

[drivers]
active=tcp

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

No es necesario configurar el REST, pues se utilizará el REST Server del Puerto multiprotocolo.

Si se utiliza Load Balance, la comunicación utilizada en el appserver.ini de los slaves debe ser la misma del máster, de acuerdo con lo explicado en Puerto multiprotocolo.


2.
En un ente Protheus, copie el archivo sdfbra.txt (puesto a disposición para Download) a la carpeta systemload y ejecute UPDDISTR.

Al ejecutar este paso, las tablas A1N, A1O, A1P, A1Q y A1R se crearán. Estas corresponden a los Cards, Gráficos y Visiones del Dashboard.

3. Aplique el patch-dash.ptm puesto a disposición para Download.

Este paquete contiene la rutina FATA900.app y los servicios Protheus necesarios para su funcionamiento.

 
4. Incluya la rutina FATA900 en el menú deseado, vía SIGACFG.


5.
Acceda al Protheus, a la rutina DASH, incluida en el paso anterior.
En la primera ejecución, las tablas creadas por UPDDISTR se completarán con los Cards, Gráficos y Visiones estándares.

02. POSIBLES ERRORES

Posibles motivos

Solución

Servicio de API fuera del aire

Verifique si los servicios del Protheus están en el aire.

La API puede estar llamando una dirección que no existe.

Verifique si las tablas A1N, A1O, A1P, A1Q y A1R están completadas.

Inestabilidad del servidor.

Verifique si el servidor está activo.

Posibles motivos

Solución

El servicio puede estar configurado de manera incorrecta.

Verifique si las configuraciones de appserver.ini y smartclient.ini están de acuerdo con el punto 1 de esta documentación.

El servicio puede estar fuera del aire o inestable.

Verifique si los servicios del Protheus están en el aire.

El servidor puede estar desconectado.

Verifique si el servidor está activo.


Posibles motivos

Solución

Funciones estándares responsables por el funcionamiento del Dash no están compiladas.

Aplique el patch del Dashboard puesto a disposición para Download.

Posibles motivos

Solución

El servicio puede estar fuera del aire.

Verifique si los servicios del Protheus están en el aire.

El servicio puede estar configurado de manera incorrecta.

Verifique si las configuraciones de appserver.ini y smartclient.ini están de acuerdo con el punto 1 de esta documentación.

03. ASUNTOS RELACIONADOS