Instalação - Viasoft Decisor
Descrição
Manual de instalação
Índice
- 1 Descrição
- 2 Índice
- 3 Pré-Requisitos
- 4 Passo a passo
- 4.1 Estrutura para o Banco de Dados - Oracle
- 4.2 Como utilizar
- 4.2.1 Configurações do Whatsapp
- 4.2.2 Conexões
- 4.2.3 Decisores
- 4.2.4 Criando Menu
- 4.2.5 Menus do Viasuper e Construshow
- 4.2.6 Atualizando o Viasoft Decisor
- 5 Versão
Pré-Requisitos
Primeiramente, é necessário realizar a instalação do Orion, pois o Viasoft Decisor é uma ferramenta complementar ao Orion. Para instalar o Orion siga as instruções no link Instalação do Orion.
Após instalar o Orion é necessário realizar o download e configuração do Viasoft Decisor.
Caso prefira, segue o processo de instalação em vídeo, mais abaixo.
Observação: o vídeo abaixo mostra no detalhe de configuração do banco de dados, como utilizar o Firebird, porém nas verticais Viasuper, Construshow e Petroshow, o banco de dados utilizado é o mesmo banco do ERP. Então desconsidere esta etapa da criação do banco pois será feito de forma automática.
Passo a passo
Estrutura para o Banco de Dados - Oracle
Antes da primeira utilização do Viasoft Decisor, é necessário criar a estrutura do banco de dados. Este processo é feito de forma automática para as verticais Viasuper, Construshow e Petroshow. Basta rodar o atualizador padrão destes sistemas que o mesmo se encarrega de criar todas as tabelas necessárias no banco de dados, pois o banco do Viasoft Decisor é o mesmo banco do ERP nestas verticais.
Baixar e instalar o NodeJS.
Baixar o plugin viadecisor.war neste Link.
Configurar o Viasoft Decisor incluindo o arquivo viadecisor.war no diretório de instalação do Orion, por exemplo: C:/Orion/webapps.
Aguardar a extração do plugin no diretório viadecisor.
Configurar os arquivos application.properties e index.js
application.properties está no diretório
viadecisor/WEB-INF/classes/application.properties
index.js está no diretório
viadecisor/WEB-INF/classes/static/agroia-node/index.js
5.1 Configuração do arquivo application.properties para Viasuper, Construshow e Petroshow
Nestas verticais, o banco de dados será o mesmo banco do ERP, portanto Oracle. Assim é preciso modificar o arquivo de forma diferente. Comentar as linhas de configuração do banco MySQL com um # na frente da seguinte maneira:
#spring.datasource.driver-class-name=org.firebirdsql.jdbc.FBDriver
#spring.datasource.url=jdbc:firebirdsql://localhost:3050/D:/bkp/VIADECISOR.FDB?defaultResultSetHoldable=True&encoding=UTF8
#spring.datasource.username=viasoft
#spring.datasource.password=153
Descomentar as linhas referente ao banco Oracle e configurar o IP da máquina, porta e instância da seguinte maneira:
spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
spring.datasource.url=jdbc:oracle:thin:@localhost:1521:VIASOFT1
spring.datasource.username=VIASOFTSYS
spring.datasource.password=VIASOFTSYS
Comentar a linha hibernate.dialect do MySQL e adicionar a linha referente ao Oracle. Ficando da seguinte forma:
#hibernate.dialect=org.hibernate.dialect.MySQLDialect
hibernate.dialect=org.hibernate.dialect.OracleDialect
Na linha cliente.vertical, informar o número referente à vertical. Sendo 1 - Agrotitan, 2 - ConstruShow, 3 - Forlog, 4 - PetroShow e 5 - Viasuper. Exemplo (para o Viasuper):
Após etapas de configuração dos arquivos application.properties e index.js, já é possível configurar o Orion para trabalhar com o plugin Viasoft Decisor.
Configurar o Orion para utilizar o plugin.
Como utilizar
Configurações do Whatsapp
Após configurar o plugin a primeira coisa a fazer é realizar a configuração do Whatsapp do cliente.
Número do Whatsapp: O número do celular que será o servidor;
Whatsapp Auxiliar: O número do celular de um funcionário da empresa que receberá áudios, vídeos e textos enviados ao Assistente;
Diretório Orion: O diretório onde o Orion está instalado para salvar os templates;
Enviar Boas Vindas: Ao ser marcado é necessário definir o código sql que será executado para encontrar os novos clientes cadastrados;
Enviar avaliação após compras: Ao ser marcado é necessário definir o código sql que será executado para encontrar as notas fiscais emitidas para ser enviada a avaliação NPS;
Mensagem Inicial: Mensagem personalizada que a empresa pode preencher para substituir a padrão que será enviada na primeira interação;
Nome da Empresa: Nome que aparecerá nas mensagens do Whatsapp;
Conexões
Para o funcionamento do Assistente é necessário configurar os bancos de dados dos ERP’s que serão utilizados para gerar os dados, sendo a conexão padrão é utilizada para a verificação dos dados dos clientes.
No banco padrão também é necessário definir o código sql que traz as informações necessárias para a verificação dos dados na primeira interação.
Decisores
O cadastro de decisores é necessário para dar permissões para alguns números a ter acesso a indicadores estratégicos e gerenciais.
Criando Menu
O processo de estruturação do menu é 100% personalizado de acordo com o cenário de cada cliente.
Cada vertical tem sua lista de indicadores e estrutura de menus para implantar no cliente, o processo de criação é nas etapas abaixo:
Selecionar a ação:
Submenu: Essa ação permite a criação de um subnível para organização das opções;
Envio de PDF: Essa ação permite o envio de um relatório em pdf, sendo possível converter o relatório para imagem. Obs. O Template precisa ter o parâmetro :CLIENTE para realizar a filtragem dos dados do cliente, nas opções que serão exclusivas do cliente.
Envio de Mensagem: Essa ação permite o envio de mensagens, com o desenvolvimento de um código sql que trará as informações do cliente que solicitar. Obs. O SQL precisa ter o parâmetro :CLIENTE para realizar a filtragem dos dados do cliente, nas opções que serão exclusivas do cliente;
Avaliação: Essa ação dará ao cliente uma avaliação de um aspecto escolhido;
Mensagem: O texto que será enviado para o cliente, quando a ação for Envio de Mensagem esse campo poderá ter parâmetros que serão substituídos pelas colunas do código SQL que será executado;
Código SQL: O código que será executado quando a ação for Envio de Mensagem.
Menus do Viasuper e Construshow
Estas verticais possuem um pacote padrão de indicadores que serão disponibilizados ao cliente após atualização do sistema. Na atualização serão disponibilizados alguns arquivos *.jasper e *.sql. Para o funcionamento do Viasoft Decisor, é necessário que estes arquivos sejam copiados e colados na pasta de arquivos Assistente \Orion\files\agroia. Os arquivos *.sql deverão ser colados dentro da pasta sql, e os arquivos *.jasper deverão ser colados dentro da pasta pdf.
Atualizando o Viasoft Decisor
Quando for necessário atualizar o plugin Viasoft Decisor para uma versão mais recente, o procedimento é muito simples, mas ATENÇÃO! Há um cuidado que SEMPRE deve ser tomado.
Antes de iniciar a atualização é necessário copiar os arquivos application.properties e index.js para uma pasta de backup. Porque no ato da atualização estes arquivos são sobrescrevidos.
Conforme o exemplo na imagem, foi criada uma pasta bkp na área de trabalho e copiado os arquivo para dentro dela. Podemos prosseguir com a atualização.
Parar o serviço do Orion, que é chamado Viasoft-Orion.
Baixar o arquivo viadecisor.war do seu repositório de instalação, e com ele substituir o arquivo já existente na pasta webapps.
Pegar os arquivos
application.properties e index.js da sua pasta de backup e substituir os arquivos referentes dentro do projeto, de onde você havia os copiado anteriormente.
Iniciar o serviço do Orion e aguardar alguns minutos até subir novamente. E pronto, o plugin Viasoft Decisor já estará atualizado.
Versão
Versão da Documentação | Autor/Revisor |
---|---|
1.0 | Janderson Bezerra de Sousa |