Mudanças entre as edições de "INSTALACAO VRFICHA MOBILE IMPRESSAO"

De VRWiki
(→‎INSTALAÇÃO)
 
(11 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
 
==<b>REQUISITOS</b>==
 
==<b>REQUISITOS</b>==
−
Para que o VRFicha Mobile Impressão funcione corretamente, é necessário que:
+
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:
 
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.
 
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.
 
* Haja um sistema de mensageria (RabbitMQ) 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 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.
+
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.
  
 
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:
 
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:
Linha 11: Linha 11:
 
* Memória RAM: 4 GB
 
* Memória RAM: 4 GB
 
* Disco: 40 GB
 
* Disco: 40 GB
 +
 +
==<b>TIPOS DE IMPRESSÃO</b>==
 +
O serviço <b>VRFicha Mobile Impressão</b> 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.
 +
 +
<h4>Lógica de Impressão</h4>
 +
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 <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.
  
 
==<b>INSTALAÇÃO</b>==
 
==<b>INSTALAÇÃO</b>==
−
* OBS: Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].
+
* Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui]. Obs: Verifique antes se o servidor é 32 ou 64 Bits.
−
  Obs: Verifique antes se o servidor é 32 ou 64 Bits.
+
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1IveDipmX6nCQTxPtefcDwGVtdfSlr-ea/view?usp=sharing clicando aqui].
−
* Faça o download do arquivo WAR do serviço de impressão [https://storage.googleapis.com/servicecontainer/VRFichaMobileImpressao.war clicando aqui].
+
* Certifique-se de que o arquivo <b>vr.properties</b> está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>C:\vr</b> ou <b>/vr</b>)
−
* 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: <b>/vr</b>)
+
<b>vr.properties</b>
−
  <b>vr.properties</b>
 
 
<pre>
 
<pre>
 
[FILA-IMPRESSAO-FICHA]
 
[FILA-IMPRESSAO-FICHA]
Linha 24: Linha 37:
 
fichaimpressao.fila.usuario=vr
 
fichaimpressao.fila.usuario=vr
 
fichaimpressao.fila.senha=vr!RbtMQ
 
fichaimpressao.fila.senha=vr!RbtMQ
 +
fichaimpressao.diagnostico.habilitado=false
 
</pre>
 
</pre>
 +
 +
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando
 +
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ
 +
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ
 +
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ
 +
* <b>fichaimpressao.diagnostico.habilitado:</b> 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.
  
 
==<b>INICIALIZAÇÃO</b>==
 
==<b>INICIALIZAÇÃO</b>==
−
* Coloque o arquivo VRFichaMobileImpressao.war em algum local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)
+
* Coloque o arquivo VRFichaMobileImpressao.war em um local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)
−
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor
+
 
−
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".
+
<b>Windows</b>
−
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:
+
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor.
−
   Destino:  "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war
+
* No atalho da área de trabalho, clique com o botão direito e selecione “Propriedades”.
−
  Clique em OK.
+
* 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.
 +
 
 +
<b>Linux (VRUbuntu)</b>
 +
* Crie o script que será chamado pelo atalho:
 +
  nano /vr/exec/VRFichaMobileImpressao.sh
 +
* Conteúdo do arquivo:
 +
<pre>
 +
#!/bin/bash
 +
/vr/jdk-11.0.7/bin/java -jar /vr/exec/VRFichaMobileImpressao.war
 +
</pre>
 +
* 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:
 +
<pre>
 +
[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;
 +
</pre>
  
−
* O serviço é executado localmente diretamente pelo JDK do Java na versão 11
+
* 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
 +
<h4>Observações importantes</h4>
 +
* 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

Edição atual tal como às 13h38min de 15 de janeiro de 2026

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
Disponível em "http://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&oldid=49647"