Instalação e configuração do Alcis Printer

Antes de realizar a instalação do Printer WMS Alcis os seguintes procedimentos precisam ser realizados e seguidos à risca.

• O serviço deve ser instalado em um servidor com Windows Server 2016 ou superior. Também é possível instalar em um computador com Windows 10 ou superior.
• Instalação pacote .NET 5 na máquina onde será instalado o software.
  • https://dotnet.microsoft.com/en-us/download/dotnet/5.0
• Para impressoras em rede:
  • Todas as impressoras devem estar com IP fixo e compartilhado;
  • A máquina ou servidor onde está instalado o printer WMS Alcis deve ter acesso às impressoras compartilhadas (mesma rede).
• A impressora deve estar instalada diretamente no computador onde está o serviço do Printer WMS Alcis.
• Liberação para acesso aos serviços do printer para os links abaixo:
  • label.alcis.com.br, porta 5671
  • ociapi.alcis.com.br, porta 4440

Para que o serviço do Printer funcione de forma adequada e plena, recomendamos atenção para os itens abaixo:

1. Quando instalado em um servidor, tenha certeza de que o usuário de início do serviço (aba logon) não seja do usuário que rodou o script de criação do serviço (ver item 4 na área de configuração neste manual). Se isso ocorrer, quando a sessão do usuário no servidor for encerrada, o serviço ficará inativo.
2. Quando instalado em um computador da operação, garanta que a máquina não vá entrar em hibernação ou ser desligada ao final do turno. Caso isso ocorra, o serviço ficará inativo.
3. Quando as impressoras estiverem em rede, é aconselhável instalar mais de um serviço para o mesmo site em servidores ou computadores diferentes. Sempre haverá apenas um serviço recebendo as impressões, porém se o serviço ativo ficar fora do ar, o outro serviço assumirá e as impressões continuarão a ocorrer sem parada.

   Importante

   Não é possível executar simultaneamente dois serviços para o mesmo site. Se for necessário utilizar dois serviços de impressão na mesma máquina, é crucial que os nomes desses serviços sejam distintos. Caso contrário, ocorrerá um conflito entre os serviços, resultando na impossibilidade de enviar qualquer informação para a nossa fila de impressão.

4. Certifique-se de que todas as URLs citadas nos Requisitos para o funcionamento estejam devidamente liberadas na rede do computador/servidor onde o serviço de impressão será instalado.

Após todos os pré-requisitos serem atendidos pode ser dado início a instalação.

1. Realizar o download do pacote direto do link enviado pela Senior Alcis.

2. Copiar o arquivo zipado para o C:\Alcis da máquina

3. Extrair o arquivo zipado e após executar como Administrador o instalador Install_Instalação_PrinterService.

1. Após finalizar a instalação, vá até o diretório extraído PrinterService, abra o arquivo AppSettings e altere as seguintes linhas:

• Alias: Código do cliente fornecido pela ALCIS.
• Site: Código do site do WMS.
• PrinterToken: Senha de acesso do Printer.

  

2. Após alteração do arquivo AppSettings.json, será necessário configurar o serviço e iniciá-lo.

3. No serviço AlcisPrintService, clique com botão direito no serviço e vá até Propriedades, onde abrirá a tela a seguir.

4. Quando o serviço for instalado em um servidor, devemos alterar o usuário na aba Logon para o Administrador da máquina. Para redes com AD (Active Directory), pode ocorrer de a comunicação com a impressora e/ou Internet ser bloqueada por alguma política de rede. Neste caso, deve-se informar um usuário administrador de rede para que o serviço funcione adequadamente.

5. Na aba Recuperação, colocar a opção de Reiniciar o serviço para as 3 falhas, conforme a imagem abaixo, preservando o tempo de 1 minuto.

6. Neste passo vamos na aba Geral e vamos colocar o status do serviço como Automático, iniciar clicando em Iniciar e depois em Ok ou Aplicar.

Executar o WMS e acessar a tela Configuração de URL de Notificação (SD314) para atualizar o ALIAS de acordo com o enviado na documentação do ambiente.

Ao acessar a tela Configuração de URL de Notificação (SD314), procurar pelo código de integração PRINTTAG e atualizar o campo do ALIAS conforme imagem abaixo. Após feita a atualização, salvar as alterações realizadas.

Ainda na tela Configuração de URL de Notificação (SD314), verificar qual o Módulo de Sistema, se AG ou WMS, e preencher a coluna de acordo com o módulo do cenário.

Em seguida, navegar até a tela Configuração de Processos (SY102) e verificar no campo Processo se o SQLDYN está com o campo Status selecionado com a opção Iniciado. Caso não esteja, inicie-o.

Na tela Configuração do Sistema (SD900), verificar se a URL no campo Valor (campo inacessível) e na linha Valor é a mesma, seja de Homologação (HML) ou Produção (PRD).

• URL de Homologação: http://ociapi.alcis.com.br:3341/api/v2/
• URL de Produção: http://ociapi.alcis.com.br:4435/api/v2/

Ainda na tabela, na coluna Token, verificar se a inscrição single-active-consumer, está presente, pois é uma inscrição obrigatória e padrão da fila do Printer. E na coluna Alias, verificar se a informação corresponde ao enviado no documento do Printer.

Com a configuração do serviço feita, na pasta onde foram extraídos os arquivos do serviço, entrar na pasta PrinterLogs e verificar as informações de checagem no arquivo de logs.

Para ativar a geração de logs, é necessário abrir o arquivo AppSettings.json e, antes de iniciar o serviço de impressão, na opção Debug mudar de "false" para "true", salvar e fechar o arquivo.

Após essa configuração, para iniciar o serviço de impressão na sessão de Serviços do Sistema Operacional, clicar com o botão direito e selecionar a opção Iniciar. Assim, será gerado um arquivo de debug da execução do serviço na pasta PrinterLogs, com as seguintes informações: 

A mensagem Serviço configurado corretamente. Aguardando etiquetas . . . será exibida indicando que o serviço foi configurado e iniciado corretamente, e está pronto para realizar os procedimentos de impressão das etiquetas. Caso ocorra algum erro de configuração, o mesmo estará descrito neste mesmo arquivo de log.

Feita a validação de configurações, voltar a opção de Debug do AppSettings.json para “false” e salvar o arquivo. Caso contrário, será gerado um log toda vez que o serviço realizar alguma tarefa. Portanto essa opção do Debug deve ser usada apenas para validar o pleno funcionamento do serviço de impressão e verificar a existência de possíveis problemas.

Para verificar se o Printer foi instalado corretamente podemos fazer um teste com uma impressora genérica.

1. Na barra de pesquisa do Windows procurar por Impressoras e scanners.

2. Após abrir a tela das impressoras, clicar em Adicionar uma impressora ou scanner.

3. Quando a lista de impressoras for atualizada, clicar em A impressora que eu quero não está na lista.

4. Para adicionar a impressora, selecionar a última opção Adicionar uma impressora local ou impressora de rede com definições manuais, e depois clicar no botão Avançar.

5. Em seguida, selecionar uma porta existente, por exemplo a porta LPT1.

6. Selecionar o driver Generic / Text Only e clicar em Avançar.

7. Selecionar a versão do driver Usar o driver já instalado (recomendável).

8. Colocar o nome da impressora.

9. Selecionar a opção de não compartilhar esta impressora.

10. Após seguir todos os passos, a impressora já foi instalada. Para verificar se está funcionando, basta imprimir uma página de teste.

11. Para verificar a impressão no WMS basta configurar o caminho da impressora na tela de Pontos de Impressão (SD171).

12. Na tela Emissão de Etiqueas (SD181) pode-se efetuar uma impressão diretamente da aplicação, para isso basta selecionar uma das etiquetas ativas para o usuário, inserir os parâmetros e realizar um teste de impressão.

13. Após realizar o teste de impressão, na tela Fila de Impressão (SD191) é possível consultar a fila de impressão e verificar que as colunas Impresso e Enviado estão indicando se o processo de impressão foi realizado com sucesso.

Caso as colunas estejam marcadas com a opção Não, ocorreu algum problema no envio da impressão, por isso é necessário verificar os seguintes pontos:

• Na tela Configuração do Sistema (SD900), verificar se a URL da Variável URL_NOTIFICATION está correta (se está apontando para o ambiente certo (Homologação ou Produção), se não falta alguma pontuação, alguma letra etc.);
• Na tela Configuração de URL de Notificação (SD314), verificar se a URL do Código de Integração PRINTTAG está correta (se está apontando para o ambiente certo (Homologação ou Produção), se não falta alguma pontuação, alguma letra etc.);
• Na tela Configuração de Processos (SY102), verifique se o Status do Processo SQLDYN está como Iniciado.

O processo de atualização do serviço só será efetuado caso seja enviado pela Senior Alcis uma nova versão do Serviço de Impressão. Caso isso ocorra, seguir os seguintes passos: 

1. Fazer backup da pasta atual do Printer;

2. Validar se o .NET 5 está instalado no mesmo servidor que o Printer. Caso o pacote não estiver presente, será necessário realizar a instalação (pode ser necessário reiniciar o servidor);

3. Copiar os arquivos do novo pacote no diretório do PrinterService, substituindo os atuais;

4. Executar o instalador como Administrador para remover o serviço antigo Install_Remover_PrinterService;

5. Executar o passo de instalação novamente;

6. Para acompanhar o status do serviço, pode-se acessar o log da aplicação na pasta PrintersLogs;

7. Caso ocorra algum erro na atualização, recomendamos que volte o backup da pasta do Printer e que entre em contato com o suporte técnico da Alcis.

Vamos explorar métodos para analisar eventuais falhas no desempenho do Alcis Printer. Essas falhas podem ocorrer em cenários específicos, tais como:

• Configuração errada do printer Alcis;
• Bloqueio de acesso a api de printer;
• Bloqueio de acesso à rede;
• Falta de acesso da máquina onde está instalado o printer com as impressoras;
• Falta de instalação das impressoras na máquina onde está instalado o printer;
• Impressora não configurada como leitura de código ZPL.

Os registros de erros serão examinados no arquivo de logs, localizado diretamente na pasta do serviço..