Edição atual tal como às 09h08min de 27 de julho de 2022

TSPrint.exe Cliente de impressão TS da Uniware

TSPrint é uma ferramenta para impressão em ambiente TS, pensado para substituir o antigo UXTsPrint. O TSPrint utiliza o protocolo HTTP para acesso a um servidor REST-PHP que pode ser configurado para uso exclusivo (privado) ou compartilhado (publico) entre vários clientes em um ambiente como o Datacenter ou Amazon.

Pré-requisitos

• Sempre utilizar o notepad++ para editar os arquivos do apache da parte do servidor. Utilizar o bloco de notas pode converter o arquivo de texto para um formato não aceito pelo apache e gerar problemas.
• Na parte do servidor (onde vai ficar o apache) deve existir uma porta liberada, esta que vai ser configurada posteriormente na aplicação (semelhante ao REDIR atual)

TSPrint

A nova aplicação TSPrint foi desenvolvida para substituir o antigo Redir. Teoricamente esta nova versão deve ser mais rápida em todas as situações, além de ter a capacidade para realizar processos simultâneos (imprimir em múltiplas impressoras ao mesmo tempo, ou enviar múltiplos arquivos para as impressoras de uma vez só ).

O TSprint esta disponível na FTP, no caminho http://uniware-lda.no-ip.net:3080/uniftp/ws-ftp-suporte/Versao_Atual/Apache o nome do arquivo normalmente é TSPrint_v(Versão atual).

Parâmetros de Linha de Comando

Aba configuração

Na imagem acima, o TSprint esta aberto em sua aba de configurações, estas que funcionam da seguinte maneira:

• Servidor: Existem as opções "Compartilhado", onde indica que o servidor do TSPrint é compartilhado por vários clientes com códigos ADM diferentes, como o DataCenter ou Amazon, e a opção "Privado", que indica que o servidor do TSPrint atende um único cliente ( TS Próprio ), não sendo então necessário preencher nenhum código ADM.
• Número máximo de processos: Indica quantos processos simultâneos o TSPrint pode realizar, recomendamos deixar no mínimo 20 ( pode enviar 10 arquivos para 10 impressoras diferentes ao mesmo tempo por exemplo )
• Intervalo: Intervalo em segundos que indica de quanto em quanto tempo o TSPrint vai realizar uma nova operação.
• URL do serviço: Campo onde se configura a URL ou IP do servidor onde o apache esta instalado, necessário sempre começar com http://
• Código ADM: Código ADM do cliente nos casos de Servidor Compartilhado. Caso o Servidor seja Privado, o código ADM fica "default" por padrão
• Usuário RDP: Nome do usuário utilizado para acessar o servidor TS. Basicamente vai ser o nome da pasta na qual o TSPrint vai buscar as impressões (mesmo funcionamento do Redir)
• Porta: Porta utilizada pelo servidor apache na qual o TSPrint vai se conectar.
• Senha: Senha configurada no configapp.ini no servidor apache (vai ser visto mais a frente)
• Restaurar: Restaura as ultimas configurações aplicadas
• Aplicar: Aplica as configurações
• Testar Conexão: Testa a conexão da maquina na qual o TSprint esta aberto com o servidor do apache
• Testar Internet: Testa a conexão de internet da maquina no qual o TSPrint esta aberto
• Testar Servidor: Faz um teste geral, retornando se o TSPrint vai ou não funcionar da forma que esta configurado.

Aba impressoras - comuns

Na imagem acima, são exibidas as impressoras e uma tela de exemplo de configuração de impressora, esta tela tem um funcionamento da seguinte maneira:

• Os 3 botões no canto superior direito indicam, respectivamente, Adicionar, editar e excluir uma impressora
• Pasta: Possui por padrão a opção "root" que indica a pasta raiz das impressões configuradas no apache (a pasta imp dentro da pasta com o nome do usuário que acessa remotamente). Caso existam pastas diferentes criadas dentro da pasta raiz, esta pastas também vão aparecer ali para serem selecionadas. Lembrando que este último só é possível caso o botão "Testar Servidor" da tela anterior tenha sido acionado e passado no teste corretamente.
• Impressora: Exibe as impressoras da maquina para serem selecionadas.
• Baixar: Indica se o TSPrint vai baixar os arquivos quando os mesmos estiverem disponíveis na pasta selecionada.
• Imprimir: Indica se o arquivo baixado vai ser impresso na impressora selecionada.

Aba impressoras - texto

Na imagem acima, basicamente temos a mesma tela que a anterior, porém na parte com a configuração das impressoras de modo texto ( etiquetadoras, impressoras de cupom e etc...)

• Tipo: Possui varias opções, entre TXT, PR1...PR5. Indica qual a extensão do arquivo de texto que vai ser impresso nesta impressora
• Porta: Pode-se selecionar uma impressora conectada em alguma porta da máquina ou digitar manualmente o caminho, exemplo: \\PC\Zebra
• Baixar: Mesmo funcionamento da anterior
• Imprimir: Mesmo funcionamento da anterior
• DW+: Indica se o TSPrint vai utiliza o recurso DW+. O DW+ basicamente serve para agrupar vários arquivos em uma única impressão, exemplo: Cliente solicitou a impressão de 15 etiquetas de exames diferentes, gerando 15 arquivos que o TSPrint vai baixar para imprimir. Ao enviar esta impressão para a impressora, ao invés de mandar uma fila de 15 arquivos, o mesmo agrupo tudo em um único arquivo. Teoricamente isso deixa a impressão de etiquetas mais rápida.

Informações importantes:

• A impressão de etiquetas olha principalmente para a pasta root de impressos (imp). Porém caso alguma impressora esteja configurada para outra pasta, as etiquetas desta pasta também vão ser baixadas pelo TSPrint
• Foras estas opções e telas ainda existem as telas de processos, que demonstra quantos processos foram realizados desde que o TSPrint foi iniciado ( quantidade de downloads, impressões PDF e etc...), além da tela LOG, que exibe o log de tudo que esta acontecendo.
• Para colocar o TSPrint para rodar basta clicar no botão com simbolo de "Play", e para parar no botão quadrado.
• Se apenas minimizar a tela do TSPrint, o mesmo continua rodando ao lado do relógio do windows.
• Se clicar com o botão direito no ícone do TSPrint ao lado do relógio, existe uma opção "Ferramentas" com as opções para limpar Servidor ou Local. Limpar Servidor exclui todos os arquivos disponíveis no servidor e limpar Local faz a mesma coisa para os arquivos que já foram baixados localmente.
• A opção "Baixar" na configuração das etiquetas existe com o proposito de "desativar" as impressoras sem ter que deletar suas configurações, bastando marcar este campo como não, logo a config. da impressora vai ficar inutilizada.
• Nas configurações de impressora modelo texto é possível selecionar as extensões TXT e de PR1 até PR5. Porém caso sejam necessários mais extensões, é possível digitar entre PR6 e PR9 também para utilizar.
• Os arquivos de modelo texto (etiquetas, mapas e protocolos de modelo texto) devem ser todos colocados na pasta root de impressões.
• É possível colocar o parâmetro -a no atalho do TSPrint para que o mesmo já seja executado em funcionamento, sem ter que apertar play.

Biometria NITGEN TS

Para utilizar a Biometria via TS, basta configurar o servidor normalmente assim como está descrito na wiki da Biometria Nitgen.

No terminal do cliente (onde de fato o leitor biométrico vai ficar) é necessário é claro, além do leitor biométrico, instalar o Driver do leitor biométrico (vide wiki da Biometria também), o TSPrint rodando e junto do caminho do TSPrint é necessário estar com o TSFingerCapNit.exe (Normalmente o mesmo fica distribuído junto do TSPrint.exe).

No TSPrint, basta selecionar o dispositivo de captura para impressão digital (Na tela de Configurações do TSPrint) e salvar.

A configuração da Biometria utiliza apenas o usuário RDP configurado no TSPrint para validar, ou seja, se o mesmo usuário (windows) que está acessando o Unilab remotamente estiver configurado no campo "Usuário RDP", quando o terminal deste usuário requerer o leitor biométrico automaticamente o TSPrint executará o acionamento do leitor, não sendo necessário mais nenhuma configuração (caminhos de arquivos e etc...)

Fora isso tudo, pode ser necessário configurar um caminho específico no servidor do TSPrint. No caminho do Server do TSPrint/scr/config, editar o arquivo config.php e localizar a linha referente ao MODULO_REMOTE_CMD, logo abaixo onde se encontram os ADMs dos clientes, configurar o caminho. O caminho que deve ser configurado aqui é a raiz do unilab, normalmente a uniwarew.

Server TSPrint (APACHE)

Logo abaixo, existe um manual de como realizar a instalação do apache em um servidor para utilização da impressão remota com TSPrint. Será utilizado o instalador do Apache disponível na FTP, porém é possível utilizar tambpem o XAMPP com seus devidos ajustes.

INSTALAÇÃO APACHE (Impressão remota com TSPrint)

1 - Primeiramente, deve ser instalado o apache no servidor. Inicialmente a instalação deve ser feita de forma idêntica a que é feita para o antigo servidor do Redir, bastando baixar o instalador x-webserver.exe disponível em http://uniware-lda.no-ip.net:3080/uniftp/ws-ftp-suporte/Versao_Atual/Apache e executa-lo (Lembrando que é preciso existir uma partição D:\ no disco para a instalação ocorrer corretamente).

Lembrar de, após a instalação, abrir o caminho D:\Arquivos de Programas\x-webserver\apache\conf e abrir o arquivo httpd.conf para colocar qual porta vai ser utilizada pelo redir (linha Listen, deixar descomentada somente uma linha com a porta correta, lembrando que esta porta deve ser liberada também no firewall, modem e roteador do cliente).

2 - Após a instalação do Apache, é preciso acessar a FTP, no caminho http://uniware-lda.no-ip.net:3080/uniftp/ws-ftp-suporte/Versao_Atual/Apache baixar e baixar o arquivo tsprint_server.rar

3 - Criar uma pasta, de preferencia na raiz do disco D:\ (uma pasta com um nome simples, por exemplo tsprint) e extrair o conteúdo deste arquivo nesta pasta. No resto deste tutorial vamos considerar que o caminho desta pasta seja D:\tsprint. Se houver um .zip chamado vendor.7z (na pasta do tsprint que acabou de extrair do tsprint_Server), extrair no local.

4 - Agora, acessar o caminho D:\Arquivos de Programas\x-webserver\apache\conf\extra e abrir o arquivo httpd-vhosts.conf

Neste caminho, é necessário criar uma nova estrutura de VirtualHost, segue um exemplo abaixo de como criar um vhost, com as respectivas explicações de cada ponto (Pode copiar e colar o trecho abaixo, apenas removendo os comentários e realizando as alterações necessárias):

 <VirtualHost *:5180> - Aqui, basta trocar 5180 pela porta que será utilizada no TSprint (A mesma que foi configurada no http.conf anteriormente)
   ServerName tsprint.net -
   ServerAdmin webmaster@localhost
   DocumentRoot "D:\tsprint\site" - Alterar o caminho para a pasta site onde os arquivos do tsprint_server.rar foram extraídos.
    <Directory "D:\tsprint"> - Mesma coisa de cima, porém agora da raiz dos arquivos (não apenas da pasta site)	    		    	  
    Options Indexes FollowSymLinks
    AllowOverride All
    Allow from All
    Require all granted
    </Directory> 
   ErrorLog "logs/dummy-host.tsprint.com-error.log"
   CustomLog "logs/dummy-host.tsprint.com-access.log" common
 </VirtualHost>

6 - Voltar agora para o caminho D:\Arquivos de Programas\x-webserver\apache\conf abrir o arquivo httpd.conf e realizar as seguintes alterações:

 Descomentar a linha #LoadModule vhost_alias_module modules/mod_vhost_alias.so  (Basta retirar o # do começo da linha)
 Mover as linhas abaixo para o final do arquivo (ultimas linhas deste arquivo):
 Include conf/uniware.conf 
 Include conf/uniware-dir.conf

7 - Criar a estrutura de pastas na qual o Unilab vai gerar os arquivos de impressões, lembrando que o padrão é Disco:\Pasta\Nome do usuário de acesso remoto (TS)\imp além de ser possível criar pastas dentro deste caminho para separar as impressões, como uma pasta só para protocolos, uma só para mapas e etc (isso ajuda a configurar as impressoras, para que cada uma puxe apenas os arquivos específicos a ela). NOTA: O padrão de pastas em casos de múltiplos clientes é Disco:\Pasta\Código ADM\Nome do usuário de acesso remoto (TS)\imp

8 - ***OLHAR NOTA ABAIXO DO BLOCO!!: Agora, abrir o caminho D:\tsprint\scr\config, e abrir o arquivo ConfigApp.php onde vamos realizar as configurações referentes a própria utilização do TSPrint, aqui, segue um exemplo de configuração e a explicação do funcionamento do mesmo:

 Primeiramente o bloco $TOKEN. O mesmo pode ser configurado desta forma (exemplo): 
 $TOKEN = array(
   "default" => "aaa",
   "00006" => "bbb",
   "09999" => "ccc"
 );
 Desta forma, basicamente estamos indicando que a configuração default (para clientes que possuem servidor de TS próprio), possui a senha aaa (esta que é configurada no redir, no campo Senha). Caso seja um servidor de múltiplos bancos (DC ou Amazon), é possível adicionar vários clientes, com seus códigos ADMs, separados por virgula, conforme o exemplo acima, que possui a senha bbb para o cliente 00006 e ccc para o cliente 09999.
 Neste ponto, caso seja TS Próprio, configurar a senha desejada ali no lugar de aaa.
 Ainda no mesmo arquivo, existe a configuração do diretório onde o unilab vai gerar os arquivos de impressões (No qual o TSPrint vai puxar)
 Esta configuração é feita no bloco $PATH_CLI. O mesmo pode ser configurado desta forma (exemplo):
 $PATH_CLI = array(
  "default" => "D:/tsprintdownloads",
  "00006" => "D:/tsprintdownloads2" 
 );
 Desta forma, o cliente default (TS próprio) possui a estrutura de pasta em D:/tsprintdownloads (dentro desta pasta, cada usuário TS vai ter uma pasta com seu nome/imp). Para servidor de múltiplos clientes, o funcionamento é igual ao do blodo de TOKEN, bastando configurar os diferentes caminhos separando por virgula, no formato acima.
 Lembrando que tanto no bloco $TOKEN quanto no $PATCH_CLI, para clientes com servidor TS próprio, pode-se configurar apenas uma linha, a default.

Nas versões mais novas do TSPrint server a configuração não é mais feita toda no ConfigApp.php. Agora a parte da configuração de Token e caminho das impressões por exemplo possui um arquivo .php próprio. O funcionamento é basicamente o mesmo, porém agora estas configurações ficam no arquivo config.php.

9 - Finalmente, reiniciar o apache para aplicar todas as configurações e o servidor já vai estar funcionando, sendo necessário agora configurar o próprio TSPrint em si cada maquina que irá utiliza-lo.

• NOTA SOBRE POSSÍVEL PROBLEMA NAS VERSÕES MAIS RECENTES DO TSPrint SERVER:

Foi observado que em alguns casos após a instalação do TSPrint Server novo e configuração dos TSPrints, os arquivos de impressão estavam tendo seus nomes alterados remotamente porém os mesmos não eram puxados pelo TSPrint e nem impressos. Para resolver este problema (no Windows), abrir Disco\Caminho do TSPrint server\scr\config e editar o arquivo config.php. Neste arquivo, localizar a linha que possui a variável $WIN_SAFETY e alterar o valor da mesma de false para true; Lembrando que isso deve ser feito apenas quando o problema acontecer no windows.