Akitasoft REST API - Orientações de implantação

gustavo_siqueira

Requisitos

Tomcat 7.0.62 e Java 7+ para a API
Versão do Akitasoft 6.2.8.5+
Tomcat 8 para o insoft-auth

Deploy

Obter deploy da aplicação na pasta "O:\Sistemas_Java\AkitasoftRestApi".
Certificar-se de que existe um deploy em funcionamento do INSOFT-AUTH configurado para o AKITASOFT rodando no cliente.
- O INSOFT-AUTH é necessário pois é o artefato responsável pela autenticação (recebendo usuário e senha e retornando token válido) do akitasoft-rest-api.
Utilizar arquivo externalizado com as mesmas configurações já definidas no Akitasoft do cliente (conexão com banco de dados). Adicionar no config.groovy o endereço do insoft-auth:

environments.production.api.authenticator.url = "http://192.168.0.81:8081" // Endereço de deploy do INSOFT-AUTH

Ainda no config.groovy é possível configurar os logs a serem realizados durante o funcionamento da API:

Para mudar as configurações de log só é necessário atualizar o Config.groovy externalizado e reiniciar a aplicação (Não precisa gerar novo deploy). O arquivo externalizado deve conter a estrutura a seguir:

log4j = {

    appenders {
        String diretorio = grails.util.Environment.warDeployed ? System.getProperty("catalina.base") + "/logs" : "target"

        rollingFile name: "arquivoLog",
                maximumFileSize: 30 * 1024 * 1024,
                file: "${diretorio}/akitasoft-rest-api-config-externa.log",//Aqui você pode definir o nome de arquivo de log.
                layout: pattern(conversionPattern: "%d %-5p %c{2} %x - %m%n"),//Este é o padrão de como cada linha é iniciada. "2021-07-09 11:45:52,842 INFO  akitasoft.NomeClasse  - "
                maxBackupIndex: 9
    }

    info arquivoLog: [
            "grails.app.controllers",//grails/controllers
            "grails.app.services",//grails/services
            "br.com.insoft4",//grails/src
    ]
    /*
    O array contem os tipos de objetos que terão os logs inputados no arquivo.
      - arquivoLog é o valor definido anteriormente na propriedade "name".
      - "info" é o tipo de log. 
          Recomenda-se utilizar "info" para exibir o fluxo normal de execução. 
          Caso desejar apenas exibir os erros deve-se utilizar o "error"
          
    */
 }

Parametrização no Akitasoft/Pontosoft

Cadastro do usuário que representa o owner da conexão precisa ter um site de acesso vinculado.