Exibir código-fonte para Fila de atendimento

'''ATENÇÃO! ESTÁ PÁGINA FOI MIGRADA PARA A WIKI NOVA E NÃO VAI SER MAIS ATUALIZADA AQUI, PARA CONFERIR: http://wiki.uniware.net.br/pt-br/unilab/fila-de-atendimento'''

[[Categoria:Suporte]]
[[Categoria:Unilab]]
==Definição==
O que seria este recurso de "Fila de Atendimento" ?
A resposta disso é simples, o paciente irá chegar ao laboratório onde na entrada irá conter uma botoeira, onde irá conter até 4 botões, onde é possível configura-los para atender determinadas filas. Cada botão atende uma fila, usando um determinado prefixo, podendo ser de prioridade:
#Normal
#Preferencial
Após o paciente pressionar um dos botões será emitido uma senha para o paciente que é composta por:
#4 (Quatro) dígitos (Exemplo A001) sendo eles:
##Primeiro caractere é referente ao PREFIXO da fila referente ao botão (Normal ou preferencial)
##Três últimos caracteres são uma sequência de 0 até 999 manipulada pelo Unilab. Nisso temos alguns conceitos básicos:
###Após a 00:00 a próxima senha virá com a sequência zerada (000) caso esteja configurado para reiniciar a contagem ao fim do dia;
###Caso em um dia seja atendimento 999+ será zerada a sequência (000);
Após o paciente estar com a senha em mãos, irá conter um PAINEL DE SENHAS onde irá mostrar as senhas a serem atendidas, e o funcionário responsável poderá chamar a próxima senha a qualquer momento.

'''Atenção !! Não funciona a locução em windows XP!!!'''

'''A fila de senhas/atendimentos será 2 por 1. Isso significa que a cada 2 preferenciais será chamado 1 normal.'''

'''<u>OBS: A botoeira só identifica que uma senha foi atendida, se alguma ação no unilab for feita na hora que a senha foi chamada, então assim que chamar a senha deve ser feito ex: impresso laudo, etiqueta orçamento gerado pdf ou algo do tipo. Caso esse procedimento não seja feito, o sistema vai identificar que a senha foi cancelada e chamar uma outra igual, desta forma se ficar clicando em proxima senha ele vai chamar todas as Preferênciais e depois todas Normais, isso pode causar confusão na hora de configurar e testar então preste atenção.</u>'''

==Botoeira da UNIWARE==
Essa é a parte inicial e essencial para o funcionamento do recurso. Nele o cliente deverá adquirir juntamente com a <font color="#000080">'''UNI''WARE'''''</font> os seguintes itens:
#Botoeira:
##Deverá conter 2 Botões sendo: 1º: NORMAL e 2º: PREFERENCIAL
#Impressora EPSON TM-T20: Para configurar seguir a documentação proposta: http://192.168.0.21/wiki/index.php/TM-T20

'''A impressora EPSON TM-T20 abaixo com explicações:'''

[[Arquivo:t20.jpg|400px|thumb|center|EPSON TM-T20]]

#Inicialmente terá um botão Liga/Desliga
#Entrada de energia
#Conexão via Ethernet
#Para reset existe um pequeno botão na parte de trás da impressora

'''Abaixo uma imagem da BOTOEIRA da ''' <font color="#000080">'''UNI''WARE'''''</font>:

[[Arquivo:m1.jpg|400px|thumb|center|Botoeira - Modelo 1]]

[[Arquivo:m2.jpg|400px|thumb|center|Botoeira - Modelo 2]]
[[Arquivo:Botoeira.jpg|centro|miniaturadaimagem|Botoeira - Novo Modelo]]

==UniSenha==
O UniSenha é um programa responsável por monitorar a botoeira, ou seja, sempre que você apertar um botão é esse programa que fará a conexão com o sistema UNILAB.
Ele também é utilizado como Endpoint para a utilização do App UniCheckIn.

[[Arquivo:Unisenha.jpg|500px|thumb|center|Tela Inicial UniSenha]]

'''Nesta tela temos as seguintes opções:'''
#Opção para ligar/desligar a conexão com o Unilab e o endpoint.
#Log com erros e sucessos. Ex: "Senha N001 Emitida com sucesso" ou "ERRO - Falha ao se conectar com o DataCenter"
#Opção para imprimir ou não a hora na senha (Irá sair na Epson)
#Texto para cabeçalho da senha, é o que irá sair no inicio da senha impressa (Irá sair na Epson)
#Fechar
#Configurar


*Na ultima versão do Unisenhas, há uma opção onde você pode colocar uma logo para ser impressa junto com a senha do paciente. Por padrão é um logo da Uniware. Ao configurar a logo, o tamanho deve ser 1108 x 200.

No inicio de tudo é necessário estar configurando o acesso ao UNILAB, quando for configurar irá abrir um tela para o usuário digitar LOGIN e SENHA afinal apenas responsáveis da <font color="#000080">'''UNI''WARE'''''</font> podem mexer em determinadas configurações.


'''No caso temos dois tipos de configurações, a local:''' 

[[Arquivo:ConfigUniSenha.jpg|350px|thumb|center|Tela de configurações LOCAL]]

Que temos os seguintes campos padrões que são obrigatórios mesmo para cliente DATACENTER e LOCAL:
#Posto - Posto de coleta aonde serão gerados os atendimentos no UNILAB.
#Código da Botoeira - Botoeira com cadastros da Fila de Atendimento em que os atendimentos serão redirecionados. **Isso é cadastrado no UNILAB, mais abaixo na documentação está explicado sobre este tópico.
#Cód. Fila Checkin - Código da fila de coleta do unilab na qual serão colocados os pacientes do App UniCheckin (Não é necessário para funcionamento da botoeira).
#Comunicação - Deve ser selecionado "Serial" quando o cliente utiliza a botoeira física e "API" quando utiliza o App UniCheckin.
#Porta - Caso a comunicação seja "Serial", deverá ser informada a porta serial aonde está conectado a botoeira. Geralmente está na COM1. Para saber vá em: (Meu Computador > Propriedades > Gerenciador de Dispositivos > E localizar a porta Serial COM). Caso a comunicação seja "API", deverá ser informada a porta que será ficará a API utilizado no App UniCheckin.
#Impressora - Impressora para onde será impresso a senha do paciente.
#DataCenter - Se o cliente for datacenter, tem que marcar essa opção afinal a conexão é diferente.
#Largura - Largura da senha emitida na impressora, no caso utilize a padrão que vier configurado já por default. (Passado pelo setor de testes as medidas.)
#Logo - Carrega uma imagem para ser utilizada como logo nas senhas impressas. O tamanho é de 1108 de Largura para 200 de Altura.

'''Na configuração local(Como na imagem) temos as seguintes configurações:'''
#Host - Nome da máquina aonde está o banco de dados (Sempre é o servidor)
#Banco de Dados - É a base de dados, por padrão é "unilabw"
#Usuário - Usuário padrão [Não modificar, pois já está correto]
#Senha - Senha padrão [Não modificar, pois já está correto]
#Porta - Será 3309

'''O outro tipo de configurações que temos é o DATACENTER:'''

Pedir para o setor de datacenter configurar o server, se não ocorre o erro '''Código de ADM inválido'''.

[[Arquivo:ConfigUniSenhaDataCenter.jpg|350px|thumb|center|Tela de configurações DATACENTER]]

Explicação sobre os campos:
#Host Antigo - http://uniware-dc.no-ip.net\unilabsenha\senha.php 
#'''Host Novo - http://uniware-dc.no-ip.net/unilab-web/unisenhav2/senha.php''' 
#Chave - Você deverá ir no sistema UNILAB do cliente no menu: Outros > Chave > Chave A, assim ele irá emitir uma chave para a sua área de transferência e copiar no campo
#Os outros campos são específicos para proxy do cliente, informações que o técnico do mesmo deverão lhe fornecer.

Caso o cliente tenha o seu próprio TS deverá fazer os seguintes passos:
*Ter o apache instalado em sua máquina (mesma do Banco de Dados)
*Na pasta [Onde está o apache]/conf/uniware.conf abrir o arquivo e fazer os seguintes passos:
*Nele escrever o seguinte trecho:
 Alias /unisenha "D:\CVS_UNILABWEB\trunk\unisenha"
 
 <Directory "D:\CVS_UNILABWEB\trunk\unisenha">
    Options FollowSymLinks
    AllowOverride All
    Require all granted
 </Directory>

*'''OBS''':(os caminhos D:\CVS_UNILABWEB\trunk\unisenha é onde a pasta da unisenha esta, que por padrão é a pasta '''D:\internet\www\unisenha''' )
*No nosso servidor na pasta \\uniware-files1\suporte\Botoeira-TS tem um arquivo unisenha.7z copia-lo
*Colocar o arquivo dentro da pasta D:\internet\www\unisenha [Se não tiver crie!]
*Extrair o arquivo dentro dessa pasta.
*Na pasta D:\internet\www\unisenha\app\config\conexao.php abri-lo
*E ajusta-lo de acordo com a base do mesmo:
 <?php
    unset($dsn);
    switch ($CodAdm) {		
        case "<font color="red">CODIGO ADM</font>":
                $dsn = "mysql:host=<font color="red">HOST:3309</font>;dbname=<font color="red">BASE</font>";
                break;  
    }
 ?>

*Realizar os mesmos ajustes no arquivo D:\Internet\www\app\config\db.php

==Fila de atendimento==
Inicialmente no sistema UNILAB será necessário cadastrar uma FILA DE ATENDIMENTO, pois cada botoeira irá emitir as senhas para uma determinada FILA.

'''No sistema iremos ter o menu:''' 
#Fila de Atendimento - Terá esse nome quando o usuário logado não estiver atendendo.
#Atendendo Guichê XX - Terá esse nome quando o usuário logado estiver atendendo no guichê XX (Pode ser qualquer digito, tendo 2 caracteres obrigatóriamente);
#Na documentação para facilitar iremos chamar o menu de "Fila de Atendimento".

'''O cadastro da Fila será realizado no menu:'''
:Fila de Atendimento > Fila de Atendimento;

'''E abrirá a seguinte tela:'''

[[Arquivo:FiladeAtendimentoSel.jpg|500px|thumb|center|Tela de cadastro de Fila]]

[[Arquivo:FiladeAtendimentoCad.jpg|500px|thumb|center|Tela de cadastro de Fila]]

'''Onde teremos o campo:'''
#Descrição - É a descrição da Fila para melhor compreensão Ex: "Fila da Recepção Central" e seu preenchimento é obrigatório

==Botoeira==

Cadastro de Botoeira, encontra-se no menu: Fila de Atendimento > Botoeira

[[Arquivo:BotoeiraSel.jpg|500px|thumb|center|Tela de cadastro de Fila]]

[[Arquivo:BotoeiraCad.jpg|500px|thumb|center|Tela de cadastro de Fila]]

Seu cadastro deve conter as configurações da botoeira e seus botoes, sendo eles, a fila que ele representa, seu prefixo que sera único em cada posto e sua prioridade.

==Configurações==
Então, para funcionar o painel de senha devemos configurar alguns detalhes.

'''Para isso teremos o menu:'''
#Fila de Atendimento > Configurar Atendimento

[[Arquivo:ConfiguracaodeAtendimento.jpg|350px|thumb|center|Tela de configuração de atendimento]]

'''Nessa tela teremos os seguintes campos:'''
#Fila de atendimento - Nesse campo será escolhida a fila de atendimento em que aquela máquina irá trabalhar. Nas opções será mostrado uma listagem com todas cadastradas.
#Sequencia de atendimento de filas -  Nesses campos serão escolhidas as filas de atendimentos que serão chamadas quando a fila de atendimento principal não tiver mais atendimentos.
#Estou atendendo no guichê - O usuário irá preencher com 2 a 4 caracteres não especiais, qual é o guichê que ele irá atender com aquela máquina. Ex: "01", "A1", "N001"
#Recolocar na Fila a Senha - Não é obrigatório, ele simplesmente recoloca na fila uma senha que já foi finalizada no mesmo dia.
#Cancela senhas não atendidas da fila: Cancela o atendimento anteriores ao dia de hoje da fila selecionada

'''Validações nesta tela:'''
#Campos de Fila e Guichê são obrigatórios.
#Para recolocar na fila, preciso ter um guichê e fila.
#Para recolocar na fila, precisa ser uma senha existente e que já tenha sido atendida/finalizada naquele mesmo dia.

'''Detalhes extras:'''
#Sempre na confirmação desta tela, é verificado se existem atendimentos não finalizados a mais de 1 hora. Caso exista serão encerrados.

==Conector botoeira==
Abaixo o esquema de conexão de pinagem do cabo serial da botoeira.

'''Botoeira Antiga:'''
[[Arquivo:CONECTORANTIGO.jpg|400px|thumb|center]]



'''Botoeira Nova:'''
[[Arquivo:novo1.jpg|400px|thumb|center]]

[[Arquivo:novo22.jpg|400px|thumb|center]]

[[Arquivo:novo33.jpg|400px|thumb|center]]

Arquivo em PDF da pinagem do cabo serial das botoeiras: \\uniware-files1\suporte\ConectorBotoeira

==Tela de Pedidos==
Na tela de pedidos como muitos devem ter visto, foram adicionados três novos botões ao centro da tela:


'''Vamos para as explicações de cada botões e como funcionam:'''
#Próxima Senha: É o primeiro botão, onde o atendente chama a próxima senha disponível seguindo a '''ordenação'''(Tópico explicativo mais abaixo) definida que irá emitir a senha aos Paineis conectados naquela unidade, vamos para algumas validações:
##Para chamar a próxima senha, precisa ao menos ter um painel conectado na unidade.
##Para chamar a próxima senha, precisa ter a configuração de guichê e fila já definidas.
##Deve possuir senhas na fila aguardando atendimento.
##Ao chamar próxima senha, será finalizado o atendimento que estava sendo realizado. Seguindo a regra já descrito na documentação (Caso tenha histórico será finalizado com sucesso, caso não Atendimento Cancelado).
#Rechamar XXXX: É o botão do meio, onde será feito a re-chamada para o Painel da senha. O XXXX é a senha que está em atendimento.
#Parar de Atender: Finaliza o atendimento em andamento seguindo as regras definidas, e libera o guichê e a fila de atendimento.

'''Outras especificações da tela:'''
#Caso você esteja com um atendimento ou com um guichê configurado, ao fechar a tela de pedidos será avisado que se o mesmo fechar será tudo finalizado. Caso o usuário clique para continuar, será finalizado o atendimento e guichê liberado.
#Quando o usuário estiver com o atendimento os três botões irão ficar com a '''<font color="green">coloração verde</font>''' em volta como na imagem abaixo:

[[Arquivo:PEDICAD.jpg|800px|thumb|center|Tela de Pedidos]]

==Histórico de Atendimento==
Teremos um histórico de atendimento, mais o que afinal é isso?

Histórico de atendimento é quando o usuário logado no sistema estiver atendendo será gravado quais ações referentes a pedido ele clicará para realizar.

'''Como assim clicará?''' Clicou em um botão, registra que clicou lá.

Essa opção gravará todos os botões da tela de seleção de pedidos, além da abertura da tela de impressão de resultado (Menu e Atalhos), abaixo segue a listagem completa:
*Incluir Pedido
*Incluir Cópia Pedido 
*Alterar Pedido 
*Excluir Pedido 
*Consultar Pedido
*Filtra Pedido 
*Legenda Pedido 
*Envia SMS 
*Relatório Pedidos  
*Liberar Guias
*Preenche Guia
*Guia TISS 
*Entrega/Caixa 
*Consulta Resultado 
*Cancela Resultado
*Resultados do Paciente 
*Rastreabilidade
*Reenviar Internet
*Fatura Pedido
*Recoleta
*Libera Resultado
*Info. Adicionais
*Contatos
*Imprime
*Histórico Intervenções
*Retransmitir Pedido
*Refaz Status Resultado
*Refaz Status Caixa 
*Perguntas do Pedido
*Excluir Laudo da Internet
*Adicionar na Fila de Coleta
*Impressão de Resultados

'''Essa opção é usada para determinar o tipo de encerramento que será lhe concedido.'''
*Caso aquele atendimento tenha histórico ele será finalizado com SUCESSO.
*Caso não tenha histórico o atendimento será CANCELADO.

Além do mais isso vai fornecer dados estatísticos das funcionalidades, além de servir como futuros relatórios.

==Painel de Senha==
O painel de senha é responsável por exibir a senha de atendimento em determinado guichê, além de exibir os últimos atendimentos.

Inicialmente será pelo menu: Fila de Atendimento > Painel onde irá abrir o lançador do painel.

O painel só ira mostrar as senhas das filas selecionadas.

[[Arquivo:AtendimentodeSenha.jpg|500px|thumb|center|Lançador do Painel de Senhas]]

'''Configurações:'''
#Fila de Atendimento - Mostra quais de quais filas o painel de senha vai exibir as senhas chamadas
#Som para chamada - Essa é uma opção para quando receber uma nova chamada exibir um som. Esses sons estão na pasta '''Uniwarew/Sons''' e devem ter o formato '''.wav'''. Se o cliente quiser pode adicionar mais sons que irão aparecer na opção do UNILAB.
#Locução - É o recurso de Locução do WINDOWS 7 ou superior. Onde irá carregar todas as vozes disponíveis no WINDOWS. Caso o sistema operacional do cliente for maior que o 8 terá a voz em português da MARIA. Caso seja 7 poderá estar instalando a voz da RAQUEL que estará no seguinte link: \\svw-uniware2\programas_inst\Instalador_Realspeak_Raquel_SaPi5.exe
#Exibe hora do atendimento - Caso habilitado irá exibir hora. Ex: 18/05/2015 17:51 caso não: 18/05/2015

Após a confirmação do lançador como mostrado na imagem acima irá abrir um painel como o da imagem abaixo:
[[Arquivo:Painel.jpg|700px|thumb|center|Painel de senhas para atendimento]]

'''Legendas e especificações:'''
#Sempre que alguem na tela de pedidos chamar a opção "Próxima Senha" será exibido aqui, além de conter o Alerta selecionado no lançador juntamente com o recurso de locução (Senha XXXX, Guichê XX será narrado).
#A tela tem auto-ajuste quando redimensionado horizontalmente (largura).
#No canto direito será exibido as últimas cinco chamadas. (Re-chamada só entra uma vez na listagem). Recolocados na fila, irá entrar sempre.

==Ordenação da Fila==
A fila de senhas/atendimentos será 2 por 1. Isso significa que a cada 2 preferenciais será chamado 1 normal.

Se tiver 10 preferenciais e chegou 1 normal, ele vai ser atendido antes dos outros preferenciais? Não. Primeiro os preferenciais que tiverem chego antes e depois será feito a ordenação 2 por 1.

Aos recolocados na fila, serão atendidos na sequência em que foram recolocados, independente do seu tipo (preferencial ou normal).

==Configurações no modem==

* '''Acessar o modem '''. 
  Usuário padrão 'admin' senha 'admin' ou o fornecido pelo cliente

* Verificar as configurações do proxy e desativar se estiver ativo.

* Verificar as configurações de Firewall e desativar todos.

==Novo Painel de Senha (WEB)==
[[Arquivo:Novo-painel-senha-configurações.jpg|500px|thumb|right|Tela de configurações do novo Painel de Senhas Web]]
[[Arquivo:Novo-painel-senha.jpg|500px|thumb|center|Novo Painel de Senhas Web]]

'''Instalação'''

Um executável deve ser configurado para inicialização automática no servidor do cliente, este executável irá sempre procurar a versão mais recente do (Painel de Senhas) whale e iniciar o serviço.
O executável deve ser instalado em apenas um computador, os computadores que forem rodar o painel apenas precisam abrir o navegador no endereço configurado.

'''Windows'''

#Realizar o download do lançador em http://uniware.com.br/updates/painel/painel-lancador.exe
#Mover o instalador para uma pasta de instalação, exemplo D:\uniware\painel-de-senhas
#Criar um atalho do painel-lancador.exe
#Mover o atalho para pasta de inicialização do Windows (Win+R e digitar "shell:startup" sem aspas) ou no Windows 10 "C:\Users\Username\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"
#Executar o atalho ou o painel-lancador.exe e aguardar o download da última versão.
#Após o download o painel estará executando e apresentará no terminal o endereço da página do painel para acessar no navegador. (geralmente IP local da máquina na porta 3001)
#Uma mensagem assim será apresentada no terminal: '''Executando Painel de Senha em: http://10.1.0.141:3001''' basta usar o endereço que aparecer no terminal para acessar o painel em outros computadores.
#O TERMINAL NÃO DEVE SER FECHADO, SE O TERMINAL FOR FECHADO O SERVIÇO PARA, ORIENTAR OS CLIENTES PARA MINIMIZAR O TERMINAL CASO SEJA EM UMA MAQUINA DE USUÁRIO A INSTALAÇÃO E NÃO EM UM SERVIDOR.
#Testar acessar o endereço fornecido no terminal em um navegador, preferencialmente o Chrome.
#Se o endereço IP estiver errado ou for necessário alterar a porta basta abrir o arquivo conf.json na pasta de instalação e reiniciar o painel. O endereço deve ser o IP da maquina ou qualquer nome DNS que consiga resolver até a máquina.
#O '''código de acesso''' para entrar no painel é o código ADM do cliente, se o código estiver incorreto o painel até abre, mas não funciona.


'''Linux'''

* Realizar o download do lançador em http://uniware.com.br/updates/painel/painel-lancador
* Mover o instalador para uma pasta de instalação, exemplo /home/gustavo/painel
* Deixar o arquivo executável `sudo chmod +x painel-lancador`
* Criar o arquivo /etc/systemd/system/painel.service com o conteúdo abaixo:
  [Unit]
  Description = Painel de Senha Uniware
  After=network.target
  
  [Service]
  Type=simple
  User=root
  ExecStart=/home/gustavo/painel/painel-lancador
  WorkingDirectory=/home/gustavo/painel
  User=gustavo
  
  [Install]
  WantedBy = multi-user.target
* Lembrar de conferir os diretórios acima, e o usuário do sistema.
* Habilitar o serviço `sudo systemctl enable painel.service`
* Iniciar o serviço `sudo systemctl start painel.service`
* Verificar o status do serviço `sudo systemctl status painel.service`
* Se precisar conferir o log rodar `journalctl -u painel.service`
* Existe outro log (log do servidor express) também na pasta da instalação, exemplo: /home/gustavo/painel/versoes/1.0.0/server.log
* Após o donwload o painel estará executando e apresentará no terminal (log do serviço) o endereço da página do painel para acessar no navegador. (geralmente IP local da máquina na porta 3001)
* Se o endereço IP estiver errado ou for necessário alterar a porta basta abrir o arquivo conf.json na pasta de instalação e reiniciar o serviço. O endereço deve ser o IP da maquina ou qualquer nome DNS que consiga resolver até a máquina.

'''No Unilab'''
* É necessário apenas abrir o caminho Cadastros > Configurações > Internet > Internet ADM e preencher o campo "Painel de senha online" com o caminho do painel ( ip:porta por exemplo ). Depois disso o painel pode ser aberto normalmente pelo menu Fila de Atendimento > Painel, que o mesmo já irá abrir o painel no navegador painel

'''Documentação técnica'''

[http://10.1.1.13/uniware/whale Ver o README do projeto aqui]

== Erros ==
'''LB_ATEND''': erro muito comum onde a _ullib_ esta desatualizada ou no caso os arquivos da pasta do unisenha que são senha.php e teste.php, também pode ser o certificado desatualizado.