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
Sankhya Web Connection
Página 1 de 14 Versão: 02 Criado em: 28/03/2017
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.
Sankhya Web Connection
Página 2 de 14 Versão: 02 Criado em: 28/03/2017
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:
Sankhya Web Connection
Página 3 de 14 Versão: 02 Criado em: 28/03/2017
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.
Sankhya Web Connection
Página 4 de 14 Versão: 02 Criado em: 28/03/2017
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.
Sankhya Web Connection
Página 5 de 14 Versão: 02 Criado em: 28/03/2017
Ao clicar na lupa, será aberta a busca no cadastro de tabelas disponíveis para a criação
do parâmetro:
Sankhya Web Connection
Página 6 de 14 Versão: 02 Criado em: 28/03/2017
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:
Sankhya Web Connection
Página 7 de 14 Versão: 02 Criado em: 28/03/2017
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.
Sankhya Web Connection
Página 8 de 14 Versão: 02 Criado em: 28/03/2017
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";
Sankhya Web Connection
Página 9 de 14 Versão: 02 Criado em: 28/03/2017
Sankhya Web Connection
Página 10 de 14 Versão: 02 Criado em: 28/03/2017
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
Sankhya Web Connection
Página 11 de 14 Versão: 02 Criado em: 28/03/2017
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";
Sankhya Web Connection
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".
Sankhya Web Connection
Página
13 de 14 Versão: 02 Criado em: 28/03/2017