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