Funcionamento

Esse é um guia aprofundado e técnico sobre o funcionamento do PrintRouter destinado principalmente para o time interno de suporte do PrintRouter.

Fluxo de Login

Ao executar o aplicativo pela primeira vez é aberto uma tela para informar o usuário e senha.

Caso as credenciais informadas estiverem incorretas, é renderizado uma mensagem de erro ao usuário para que ele insira suas credenciais novamente.

Caso as credenciais estejam corretas, o login será bem-sucedido e um popup será mostrado ao usuário informando que o aplicativo está aguardando documentos para impressão.

Além disso, se o login for bem-sucedido, as credenciais serão armazenadas no sistema operacional para que o usuário não precise informá-las novamente. Desta forma, no próximo login, o aplicativo irá realizar o login automaticamente.

Recuperação de senha

Caso ocorra perda das credenciais por algum motivo, o time interno da Magazord poderá gerá-las novamente. Em máquinas em que as credenciais já estão salvas, no momento de inicialização do aplicativo, elas serão deletadas e então as credenciais serão solicitadas novamente.

Impressão de documentos

Para o recebimento dos documentos de impressão assim como a impressora destino, o aplicativo se conecta a API por via de um protocolo interno após um login bem-sucedido. Desta forma, todo o documento enviado para a API PrintRouter é automaticamente enviado para o aplicativo, que desta forma, consegue criar o job de impressão para o documento.

Devido o protocolo utilizado, o PrintRouter possuí algumas limitações que são:

• O aplicativo deve estar em execução somente em 1 única máquina;

• A máquina em que o aplicativo está em execução deve ter acesso a todas as impressoras.

Para que a máquina tenha acesso a todas as impressoras, elas devem estar conectadas fisicamente nessa máquina. No caso em que as impressoras estão distribuídas em vários computadores, é necessário que o computador principal, que possuí o PrintRouter em execução, consiga acessar as impressoras por uma rede interna.

O PrintRouter não terá funcionamento efetivo caso tenha vários aplicativos em execução em diferentes máquinas. No entanto, estamos trabalhando em melhorias para utilizar outros protocolos para o envio de documentos para o aplicativo e resolver o impasse descrito acima.

Formatos suportados

O PrintRouter consegue realizar a impressão de vários tipos de documentos, como PDF, PPLA, PPLB, ZPL e ESC/P. No entanto, é necessário realizar o envio do documento corretamente para a API PrintRouter, informando o formato correspondente e o tamanho do documento.

Tamanhos suportados

O PrintRouter suporta alguns tamanhos de papel pré-definidos e que fazem sentido para os clientes que a utilizam, que são

• A4 - (210 x 297) mm
• ARGOX_GRANDE - (100 x 150) mm
• ARGOX_PEQUENA - (60 x 30) mm

Local de instalação

O aplicativo é instalado na pasta do usuário, logo, se a máquina contém mais de 1 usuário e esses também precisem utilizar o PrintRouter, cada um deles deverá instalar o aplicativo. O caminho completo para o local de instalação é C:\User\{usuario}\AppData\Local\Programs\PrintRouter.

Essa pasta contém o desinstalador do aplicativo uninstall.exe e também uma pasta chamada application.

Na pasta application é armazenado todos os arquivos para o devido funcionamento da aplicação. Nenhum desses arquivos devem ser deletados ou alterados para que a aplicação funcione corretamente.

Logs

Durante sua execução, o aplicativo gera logs de todo o processo executado com o intuito de facilitar a rastreabilidade de problemas. Os logs podem ser encontrados na pasta logs onde o aplicativo está instalado.

Nessa pasta haverá um arquivo de texto com formato .log contendo os logs da aplicação e também pode conter arquivos comprimidos no formato .log.tar.gz para os logs mais antigos que 7 dias.

O launcher da aplicação também gera logs que podem ser encontrados na raiz do projeto conforme abaixo