Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 16

changes.mady.by.user Aline Martineli De Araujo Navarro

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Debora Frias Constantino

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Expandir
titleInformações Importantes 🛑
Aviso

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

Aviso

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

Aviso

O Dashboard necessita do Binário dede outubro/2021 ou superior.

Aviso

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

Informações

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


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

1. 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 A1Rserão criadas. Elas correspondem aos Cards, Charts e Visões do Dash.

2. Aplique o patch-dash.ptm disponibilizado para Download.

...

. Ajuste os arquivos appserver.ini e smartclient.ini, com a Porta Multiprotocolo e outras chaves necessárias, conforme explanado a seguir.

Deck of Cards
idambientes
Card
defaulttrue
idobrigatorias
labelChaves Obrigatórias

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

[GENERAL]
App_Environment=ENVIRONMENT

[DRIVERS]
MultiProtocolPort=1

Card
idCSSL
labelCom SSLConfigure (comunicação segura)

Efetue os passos abaixo caso deseje utilizar comunicação segura:

1.1. Instale 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. Execute 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. Copie para a pasta appserver os dois arquivos gerados no passo anterior.


1.4. Insira no appserver.ini as chaves:

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


1.5. Insira no(s) smartclient.ini a chave:

[tcp]
secureconnection=1

Card
idSSSL
labelSem SSLConfigure

Efetue os passos abaixo caso não deseje utilizar comunicação segura:

1.1. Insira no appserver.ini a chave:

[DRIVERS]
MultiProtocolPort=1 
MultiProtocolPortSecure=0

1.2. Insira no(s) smartclient.ini a chave:

[tcp]
secureconnection=0

Bloco de código
languagedelphi
firstline1
titleExemplo de appserver.ini com SSLConfigure
linenumberstrue
collapsetrue
[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 (adeque para o caminho onde foram colocados os certificados)
KeyServer=C:\Protheus12\totvs\tec\appserver\totvs_certificate_key.pem (adeque 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

[WebApp/webapp]
MPP=

...

 Bloco de código
languagedelphi
firstline1
titleExemplo de appserver.ini sem SSLConfigure
linenumberstrue
collapsetrue
[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=*
 Bloco de código
languagedelphi
firstline1
titleExemplo de appserver.ini MASTER com SSLConfigure
linenumberstrue
collapsetrue
[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=


 Informações
titleImportante!
...
 Bloco de código
languagedelphi
firstline1
titleExemplo de appserver.ini SLAVE com SSLConfigure
linenumberstrue
collapsetrue
[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=

 Bloco de código
languagedelphi
firstline1
titleExemplo de smartclient.ini com SSLConfigure
linenumberstrue
collapsetrue
[config]
lastmainprog=sigaadv
envserver=P12_DB_27_EXP

[drivers]
active=tcp

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

 Informações
titleNota
Não será necessário configurar REST, pois será utilizado o REST Server da Porta Multiprotocolo.
 Informações
titleImportante
Caso seja utilizado Load Balance, a comunicação usada no appserver.ini dos slaves deverá ser a mesma do master, conforme explicado em Porta Multiprotocolo.
02. POSSÍVEIS ERROS
 Expandir
titleErro 503
Possíveis MotivosSolução
Serviço de API fora do arVerificar Verifique se serviços do Protheus estão no ar
API pode estar chamando um endereço que não existeVerificar Verifique se tabelas A1N, A1O, A1P, A1Q e A1R estão populadas
Instabilidade do servidorVerificar Verifique se servidor está ativo
 Expandir
titleServidor não está respondendo
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 Verifique se as configurações de appserver.ini e smartclient.ini estão de acordo com o ponto 1 desta documentação
O serviço REST pode estar fora do ar ou instávelVerificar Verifique se serviços do Protheus estão no ar
O Servidor pode estar desligadoVerificar Verifique se Servidor está ativo
 Expandir
titleNOFUNCW - Opção Não Disponível no Protheus

Possíveis MotivosSolução
Funções padrões responsáveis pelo funcionamento do Dash não estão compiladasAplicar patch enviadoAplique o patch do Dashboard disponibilizado para Download
 Expandir
titleEsta pagina não está funcionando
Possíveis MotivosSolução
O serviço REST pode estar fora do arVerificar Verifique 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 Verifique se as configurações de appserver.ini e smartclient.ini estão de acordo com o ponto 1 desta documentação
03. ASSUNTOS RELACIONADOS








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