INSTALACAO VRFICHA MOBILE IMPRESSAO

REQUISITOS

Para que o VRFicha Mobile Impressão funcione corretamente, é necessário que:

• Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.
• Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.
• A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.
• A API do VR Ficha Mobile e o serviço VRFicha Mobile Impressão estejam conectados ao mesmo RabbitMQ.

O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:

• Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS
• Processador: 2 vCPU
• Memória RAM: 4 GB
• Disco: 40 GB

TIPOS DE IMPRESSÃO

O serviço VRFicha Mobile Impressão tem suporte a 3 tipos de impressão:

• Impressão via caminho UNC Windows

 Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.

• Impressão via nome de impressora instalada Windows

 Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.

• Impressão via CUPS (Linux e MacOS)

 Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.

Lógica de Impressão

A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC (\\servidor\impressora) a aplicação fará a impressão via caminho de rede. ATENÇÃO: impressão via caminho de rede (\\servidor\impressora) só funciona com o serviço de impressão rodando em Windows.

INSTALAÇÃO

• Faça o download do arquivo JAVA 11 clicando aqui. Obs: Verifique antes se o servidor é 32 ou 64 Bits.
• Faça o download do arquivo WAR do serviço de impressão clicando aqui.
• Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: C:\vr ou /vr)

vr.properties

[FILA-IMPRESSAO-FICHA]
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]
fichaimpressao.fila.porta=5672
fichaimpressao.fila.usuario=vr
fichaimpressao.fila.senha=vr!RbtMQ
fichaimpressao.diagnostico.habilitado=false

• fichaimpressao.fila.ip: IP da máquina onde o RabbitMQ está rodando
• fichaimpressao.fila.porta: Porta do serviço RabbitMQ
• fichaimpressao.fila.usuario: Usuário do RabbitMQ
• fichaimpressao.fila.senha: Senha do RabbitMQ
• fichaimpressao.diagnostico.habilitado: Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.

INICIALIZAÇÃO

• Coloque o arquivo VRFichaMobileImpressao.war em um local apropriado no servidor (recomendado: C:\VR\EXEC ou /vr/exec)

Windows

• Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor.
• No atalho da área de trabalho, clique com o botão direito e selecione “Propriedades”.
• No campo “Destino”, informe o comando -jar apontando para o Java 11:

  "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war

• Clique em OK.
• O serviço será executado localmente utilizando o JDK Java versão 11.

Linux (VRUbuntu)

• Crie o script que será chamado pelo atalho:

 nano /vr/exec/VRFichaMobileImpressao.sh

• Conteúdo do arquivo:

#!/bin/bash
/vr/jdk-11.0.7/bin/java -jar /vr/exec/VRFichaMobileImpressao.war

• Salve o arquivo e torne-o executável:

 chmod +x /vr/exec/VRFichaMobileImpressao.sh

• Crie o atalho gráfico na área de trabalho do usuário:

 nano ~/Desktop/VRFichaMobileImpressao.desktop

• Insira o conteúdo abaixo:

[Desktop Entry]
Type=Application
Name=VRFicha Mobile Impressão
Comment=Serviço de impressão VRFicha Mobile
Exec=/vr/exec/VRFichaMobileImpressao.sh
Icon=utilities-terminal
Terminal=true
Categories=Utility;

• Torne o arquivo .desktop executável:

 chmod +x ~/Desktop/VRFichaMobileImpressao.desktop

• Permitir execução no Ubuntu: Na primeira execução, clique com o botão direito no atalho e selecione “Permitir execução” (ou “Allow Launching”)
• Dê duplo clique no atalho VRFicha Mobile Impressão
• O serviço será iniciado em um terminal, utilizando o Java 11

Observações importantes

• O caminho do Java (/vr/jdk-11.0.7/bin/java) deve existir e apontar para o Java 11
• Caso utilize o Java instalado via sistema (/usr/bin/java), o script pode ser ajustado
• O serviço será encerrado ao fechar o terminal