New ÍNDICE - Sankhya Gestão de Negóciosdownloads.sankhya.com.br/docs/DocumentacaoWebConnection.pdf · 2019. 8. 29. · documento). Pode-se visualizar um cubo, através da tela

Sankhya Web Connection

Página 0 de 14 Versão: 02 Criado em: 28/03/2017

Em alguns navegadores de internet, vem se tornando complicado o uso de plugins (um

plugin ou módulo de extensão é um programa de computador usado para adicionar

funções a outros programas maiores, provendo alguma funcionalidade especial ou muito

específica). Plugins do tipo "jre" estão com sua utilização comprometida; o Google

Chrome, por exemplo, irá paralisar definitivamente a utilização do jre.

Com base nestas modificações, para realização de impressões no sistema (exceto

impressão de cheques), foram buscadas algumas alternativas para suprir a necessidade

da utilização de plugins, onde a mais viável foi à criação de uma aplicação Java que será

executada na máquina do usuário do sistema, e será responsável por efetuar as

impressões. Esta aplicação tem o nome de "Sankhya Web Connection".

ÍNDICE

Download do Aplicativo WebConnection página 1

Como Utilizar o WebConnection página 1

Cubo – Variáveis de Filtros e Seleção de Campos página 3

Instalação nas distribuições Linux página 9

Permissões de Pasta página 9

Instalação do WebConnection página 11

Verificando se o WebConnection está em execução página 12

Finalizando processo do WebConnection página 12



DOWNLOAD DO APLICATIVO WEBCONNECTION

Para utilização desta funcionalidade, é necessário primeiramente:

Realizar a baixa/instalação da aplicação no site Sankhya na parte de downloads;

COMO UTILIZAR O WEBCONNECTION

Realizar-se no sistema, na tela "Configurações > Avançado > Preferências" a

configuração de dois parâmetros, sendo eles:

Utilizar aplicação externa para impressão? - USAAPPIMPRESSAO: Ao ativá-lo, o sistema

entende que a aplicação externa de impressão será utilizada; caso o parâmetro esteja

desativado, o sistema irá tentar utilizar o plugin de impressão normalmente. Para que

uma modificação na configuração do parâmetro tenha efeito, a tela de impressão deve

ser fechada e aberta novamente;

Porta onde irá rodar a aplicação de impressão - PORTAPPPRINT: Este parâmetro se

refere à porta na qual o Sankhya-W tentará encontrar a aplicação externa de

impressão para se comunicar (padrão: 9096). Assim como o parâmetro anteriormente

citado, para que uma alteração neste parâmetro tenha efeito, a tela de impressão deve

ser fechada e aberta novamente.

Importante: O parâmetro "PORTAPPPRINT" e a porta onde está "rodando" a aplicação

devem possuir a mesma informação; caso a porta onde a aplicação funciona seja

alterada, deve-se informá-la corretamente na configuração do parâmetro mencionado.



Através do Sankhya Web Connection, tem-se também a possibilidade de utilizar a função

de "visualização de cubos". A configuração de uso desta funcionalidade depende da

ativação do parâmetro "Utilizar aplicação externa para visualizar cubo? - USAAPPCUBO"

(configurações advindas da ativação deste parâmetro serão relatadas mais adiante neste

documento). Pode-se visualizar um cubo, através da tela "Financeiro > Gerente > Análise Financeira", por exemplo.

Observações:

Como já informado, a porta de comunicação deve ser a mesma do parâmetro

"PORTAPPPRINT" do Sankhya-W.

A memória RAM deve ser configurada de acordo com a necessidade para o caso de

visualização de cubos.

O tipo de carregamento de cubo Banco de dados pode ser usado para possibilitar a

visualização de cubos com grande quantidade de dados e baixa disponibilidade de

memória.

Importante: Mantendo-se os dois parâmetros "USAAPPIMPRESSAO" e

"USAAPPCUBO" desligados, o comportamento do sistema se mantém inalterado.

Vejamos agora uma funcionalidade configurada no Sankhya-W, que poderá ser

visualizada através do Web Connection:



Cubo - Variáveis de Filtros e Seleção de Campos

Atenção: A partir deste trecho, teremos orientações aos usuários da ferramenta de

construção de Cubos, onde estes poderão utilizar os novos recursos de seleção

personalizada de campos e as novas variáveis para configuração de filtros.

Criação de parâmetros com as novas variáveis:

A nova interface de criação de parâmetros permite a configuração de duas novas opções,

sendo elas, "campo requerido" e uma "tabela" que pode ser utilizada para mostrar na

tela uma pesquisa de registros.

Caso o campo seja configurado como não requerido, seu preenchimento se torna

opcional na visualização do cubo. Se for escolhida uma tabela do sistema para o campo,

ele é exibido na tela como uma busca de registros, permitindo ao usuário selecionar o

valor desejado de acordo com algum dos campos da tabela, no caso de Parceiro, Nome,

Cidade, E-mail, por exemplo.

O novo filtro é criado com a seguinte sintaxe:

/*{entity=<Nome do cadastro>;req=<s ou n>}*/

Sendo que para req, s é para campo requerido e n para campo opcional. O campo abaixo

é exibido como uma pesquisa na tabela de Parceiro e é um campo obrigatório.



No exemplo passado na imagem acima, tem-se a seguinte “Expressão de filtro”:

Selecionando-se com o cursor do mouse o parâmetro "?" que se deseja editar, faz-se

com que o botão de editar filtro apareça na tela. Ao clicar no botão é aberto o pop-up

de edição de variáveis. Além disso, é possível editar o status de obrigatoriedade (todo

campo é criado por padrão como obrigatório), ou ainda selecionando outra tabela do

sistema para o filtro.



Ao clicar na lupa, será aberta a busca no cadastro de tabelas disponíveis para a criação

do parâmetro:



O filtro abaixo foi criado a partir da sintaxe citada anteriormente. Este filtro permite a

digitação direta do código desejado no campo de texto, além da busca dos registros da

tabela salvos no sistema.

Após a configuração do novo parâmetro para o cubo, clicando-se na lupa, o filtro criado

permite a busca no cadastro para o preenchimento do filtro; neste exemplo, uma

pesquisa de parceiro pelo Nome do Parceiro:



A imagem seguinte exibe o filtro de parceiro com um registro selecionado para filtrar;

caso o usuário queira, é possível clicar em "Executar" para visualizar o cubo com todos

os campos selecionados, com os registros filtrados por este parceiro.

Para visualizar o cubo, todos os campos obrigatórios de filtros devem ser preenchidos,

tais campos serão destacados com um "*" (asterisco) na cor vermelha, tal como o

campo "Data Baixa", em destaque na imagem.

A funcionalidade de seleção de campos, em destaque na imagem, permite a seleção de

apenas alguns campos para visualização; esta função será detalhada mais adiante neste

documento.

Aba de seleção de campos:

Nesta aba, pode-se selecionar, dentre os campos disponíveis para este cubo, os campos

que se deseja visualizar. Além disso, é possível agrupar os campos de data por dia,

semana, mês, trimestre e ano. Tanto a seleção de campos para visualização, quanto o

agrupamento por data, são estratégias para melhorar o desempenho do cubo,

diminuindo o tráfego de dados com o servidor e permitindo uma melhor navegação nos

dados.



Pode-se salvar a seleção para visualizar posteriormente. A opção fica disponível, quando

o usuário está com a opção "[Padrão]" selecionada para criar uma nova seleção, ou

quando posicionado em uma seleção criada anteriormente para salvar possíveis

alterações feitas. Deve-se fornecer um nome para identificar a seleção criada.

A opção de excluir torna-se disponível sempre que estiver escolhida uma seleção criada

pelo usuário, ou seja, não é possível excluir a seleção padrão.

As opções de agrupamento de data se tornam visíveis, quando é selecionado um campo

de data na lista de campos de dimensão.

Para selecionar um campo como campo de valor, este deve ser do tipo numérico, tal

como Valor do desdobramento de um financeiro, por exemplo.

INSTALAÇÃO NAS DISTRIBUIÇÕES LINUX

O Web Connection foi homologado com as seguintes versões:

Mint Mate x64 Mint Mate x86 Mint Cinnamon x64 CentOS 7 x64 Ubuntu x64

Após baixar o Sankhya Web Connection, será gerado um arquivo, tendo como exemplo: Caso seja 64-bits: SankhyaWebConnection_linuxx64_2_0.run Caso seja 32-bits: SankhyaWebConnection_linux_2_0b13.run

PERMISSÕES DE PASTA

É necessário habilitar as permissões do executável para o instalador do Web

Connection, essa modificação pode ser feita de duas formas:

Pela própria interface gráfica, pressione com o botão direito do mouse e selecione

a opção "Propriedades". Na aba "Permissões" no campo Executar, ative a opção "Permitir

execução do arquivo como um programa";





Na pasta onde foi baixado o WebConnection, abra o terminal (Console texto) e digite o

seguinte comando chmod +x nome_do_arquivo.

Por exemplo, chmod +x SankhyaWebConnection_linuxx64_2_0.run



Observação: Excepcionalmente na versão do Linux Mint Mate 32-Bits deve-se realizar a

instalação em modo Terminal (console texto).

INSTALAÇÃO DO WEBCONNECTION

Ao realizar o comando ./SankhyaWebConnection_linuxx64_2_0b13.run

após ser exibida a mensagem “web connection instalado com sucesso” no terminal, serão

gerados os arquivos que estarão disponíveis na pasta

/nome_do_usuario/webconnection/contents.

Nota: "nome_do_usuario" pode diferenciar de acordo com cada distribuição do Linux.

É necessário copiar o arquivo "Configurar WebConnection" para a Área de

Trabalho para que seja possível abrir o WebConnection.

Se o arquivo executável estiver com o nome de webconnection.desktop,

selecione o arquivo, pressione com o botão direito do mouse e clique na aba

"Permissões". No campo Executar, ative a opção "Permitir execução do arquivo como

um programa";


Página 12 de 14 Versão: 02

2

Criado em: 28/03/2017

VERIFICANDO SE O WEBCONNECTION ESTÁ EM EXECUÇÃO

Caso queira verificar se o WebConnection está em execução, abra o Terminal, digite o

comando

"ps ax | grep java", cuja função é listar os processos que estão em execução, somente

serão filtrados apenas os processos java.

FINALIZAR O PROCESSO DO WEBCONNECTION

Para finalizar o processo que utiliza o WebConnection, pode ser usado o terminal que já

está aberto, digite o comando kill -9 numero_do_processo.

Por exemplo kill –9 4545 e utilize o comando acima novamente para verificar se o

processo "jre/bin/java -Xms256m –Xmx256m –jar snklocalapp.jar" se está em

execução ou não.

Ao reiniciar a máquina, automaticamente o WebConnection já estará em execução,

somente será aberta a tela de configurações conforme a imagem abaixo ao abrir o

arquivo "Configurar web connection".


Página

13 de 14 Versão: 02 Criado em: 28/03/2017

Documents

New ÍNDICE - Sankhya Gestão de Negóciosdownloads.sankhya.com.br/docs/DocumentacaoWebConnection.pdf · 2019. 8. 29. · documento). Pode-se visualizar um cubo, através da tela