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

    Ejemplo de appserver.ini con SSLConfigure
    [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=
    
    Ejemplo de appserver.ini sin SSLConfigure
    [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=
    
    Ejemplo de appserver.ini MASTER con SSLConfigure
    [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=
    
    Ejemplo de appserver.ini SLAVE con SSLConfigure
    [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=
    
    Ejemplo de smartclient.ini con SSLConfigure
    [config]
    lastmainprog=sigaadv
    envserver=P12_DB_27_EXP
    
    [drivers]
    active=tcp
    
    [tcp]
    ;ip do server:
    Server=10.111.1.11
    port=1227
    secureconnection=1
    

    Nota

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

    Importante

    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