Image Added

Arquivo JSON

O arquivo baixado deve ser copiado para o diretório \totvseai-monitor\config no servidor Datasul, mantendo, impreterivelmente, o nome de monitor-url-list.json. 

Caso seja necessário colocar o arquivo de configuração em outra pasta, consulte a seção, Alteração do local do Arquivo ao final deste documento.

Image Removed

Sobre o arquivo de configuração (monitor-url-list.json)

O arquivo monitor-url-list.json, situado na pasta config, é fundamental para o correto funcionamento do monitor. Nele estarão contidos todos os aplicativos referenciados numa integração, sejam internos ou externos. Um aplicativo é descrito através de um JSON contendo os seguintes atributos:

Nome do Aplicativo: Este nome, no Datasul, é composto pelo nome do environment utilizado (em upper case), seguido de @ e DATASUL. Para os demais produtos, usar, depois do @ PROTHEUS, LOGIX ou RM, conforme aplicação.
O nome será um atributo do tipo Objeto JSON, que por sua vez, conterá os seguintes atributos:

1. monitorURL: Deve seguir o mesmo endereço HTTP utilizado no produto

2. isActive: Deve existir e ter valor igual a true somente para o aplicativo interno onde o monitor estiver embarcado.

3. userCode: Usuário necessário para acessar os serviços de monitoramento do aplicativo interno (deve estar em base64).

4. password: Senha necessária para acessar os serviços de monitoramento do aplicativo interno (deve estar em base64).

5. externalApps: Atributo do tipo array de caracteres, contendo o identificador do aplicativo. Por exemplo: APP_LOGIX@LOGIX.

Os demais aplicativos devem ser referenciados usando as orientações acima. Abaixo, um exemplo de configuração do arquivo, onde um DATASUL com um environment de nome APP_INTERNO, no grupo de , comunica-se com um LOGIX com environment de nome APP_EXTERNO_1:

Exemplo de configuração do arquivo monitor-url-list.json

Image Added

{
    "APP_INTERNO@DATASUL" : {

                 "monitorURL": "http://localhost:8080",
        "isActive" : "true",
        "userCode" : "j50dkke3=",
        "password" : "j068k2jo=", 
        "externalApps" : ["APP_EXTERNO_1@LOGIX"]
    },
    "APP_EXTERNO_1@LOGIX" : {
        "userCode" : "Uj3O9=",
        "password" : "THi3L3=",
        "externalApps" : ["APP_EXTERNO@DATASUL"]
    }
}

Alteração do local do arquivo

Há situações onde o local padrão do arquivo monitor-url-list.json (/totvseai-monitor/config) não é a mais conveniente. Alguns exemplos são:

• Ambientes de teste do monitor, onde a atualização do pacote é frequente.

• Necessidade de compartilhar o arquivo sem ter que expor toda a pasta de fontes do monitor.

Por conta disso, é possível alterar o local padrão realizando ajuste do arquivo totvs-app.constant.js, situado na pasta totvseai-monitor/js. Neste arquivo, deve-se ajustar o valor da propriedade (ou variável) EXTERNAL_APPS_URL para apontar para um novo local, o qual deve estar visível como um endereço WEB.

Por exemplo: supondo que o monitor esteja hospedado no servidor http://localhost:8080, e que a nova localização do arquivo seja uma pasta chamada ...\<diretório_tomcat>\config, o arquivo de configuração deve estar acessível pelo navegador de internet usando o endereço http://localhost:8080/config/monitor-url-list.json. 

Logo, a variável deve ser alterada para:

Image Removed

<?xml version="1.0" encoding="UTF-8"?>
<Server port="8005" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener"/>
  <Listener SSLEngine="on" className="org.apache.catalina.core.AprLifecycleListener"/>
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener"/>
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener"/>
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener"/>
  <GlobalNamingResources>
    <Resource auth="Container" 
              description="User database that can be updated and saved" 
              factory="org.apache.catalina.users.MemoryUserDatabaseFactory" 
              name="UserDatabase" 
              pathname="conf/tomcat-users.xml" 
              type="org.apache.catalina.UserDatabase"/>
  </GlobalNamingResources>

  <Service name="Catalina">
    <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>

    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>

    <Engine defaultHost="localhost" name="Catalina">
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
      </Realm>

      <Host appBase="webapps" autoDeploy="true" name="localhost" startStopThreads="3" unpackWARs="true">
		
		<!--  CONFIGURACAO DO EAI  -->
		<Context docBase="../config_files" path="/config" />

		<!--  CONFIGURACAO DO VALVE -->
        <Valve className="com.totvs.valve.TotvsCorsValve"
            allowHeaders="Content-Type,Accept,Accept-Language,Content-Language,Authorization,tenantId,userId,companyId,authorization,returnformatversion"
            contextsToValidate="/totvs-login,/totvs-rest,/dts,/api,/webexecbo,/totvseai-monitor"
            allowOrigin="http://localhost:8100"
            allowMethods="GET, POST, DELETE, PUT, PATCH, HEAD, OPTIONS"
            allowCredential="true" />
		
	  </Host>
    </Engine>
  </Service>
</Server>

<Valve className="com.totvs.valve.TotvsCorsValve"
allowHeaders="Content-Type,Accept,Accept-Language,Content-Language,Authorization,tenantId,userId,companyId,authorization,returnformatversion"
contextsToValidate="/totvs-login,/totvs-rest,/dts,/api,/webexecbo,/totvseai-monitor"
allowOrigin="http://localhost:8100"
allowMethods="GET, POST, DELETE, PUT, PATCH, HEAD, OPTIONS"
allowCredential="true" />