Sankhya Web Connection. Versão: 02 Criado em: 28/03/2017

Transcrição

1 0 de 14 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

2 1 de 14 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.

3 2 de 14 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:

4 3 de 14 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, , 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.

5 4 de 14 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.

6 5 de 14 Ao clicar na lupa, será aberta a busca no cadastro de tabelas disponíveis para a criação do parâmetro:

7 6 de 14 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:

8 7 de 14 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.

9 8 de 14 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.

10 9 de 14 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";

11 10 de 14 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

12 11 de 14 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";

13 12 de 14 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 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.

14 13 de 14 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".

15