U2U - Unilab x Unilab

Arquivos necessários APOIO:

- Download GRA

- Download Apache

- Apache

- Gerador de Modelos Unilab

- PHP Remote Folder(PHP_Teste)

Arquivos necessários APOIADO:

- Download Remote Folder

- Remote Folder

Observações:

- Download UConvertServ

- Download Unilab_a poio

- UConvertServ(Quando o Laboratório apoiado envia um lote de pedido de exames em um formato diferente de U2U)

- Unilab_apoio(Serviço para geração do arquivo de modelos de exames do laboratório de apoio)

O que é o U2U?

A interface Unilab x Unilab é a necessidade de dois clientes que utilizam o sistema Unilab serem Apoio e Apoiado um do outro.

É um interfaceamento entre dois sistemas Unilab, dinâmica entre Apoio e Apoiado, em que o Apoiado envia os pedidos de exames para o Apoio para que ele realize os exames e retorne o resultado ao Apoiado.

Instalação Unilab Apoio X Unilab Apoiado

Unilab Apoio

• Em Cadastro > Configurações > Apoio marcar "sim" em "Ativa Unilab como Apoio"
• Configurar a pasta que o Apoio recebera os arquivos de pedidos do Apoiado (Utilizar o padrão, Exemplo: "D:\Rede_Unilab\Apoio\Apoiados\PED")

     * OBS: Este caminho deve em "\"

• Ir em "Cadastros > Convênio > Apoiado", pressionar o" Inclui" para registrar o Laboratório Apoiado
• O cadastro é bem simples, sendo preciso apenas preencher uma descrição com o nome do Apoiado

• Após inclusão do Laboratório Apoiado, é necessário incluir um convênio e configura-lo para receber os pedidos do Apoiado, em "Cadastros > Convênios > Convênio"

• Após terminar o cadastro do convênio, ainda na tela de cadastro do mesmo, clicar no botão "Apoiado" e configurar a interface

**Significados:

-Laboratório Apoiado = Opção que defini este convênio como um Laboratório Apoiado.

-Apoiado utiliza Unilab = Opção marcada caso o Laboratório Apoiado também utilize o Unilab.

-Gera novo número de amostra para os exames = Se esta opção estiver marcada no ato da importação dos pedidos provenientes do laboratório apoiado, os números de amostra são gerados novamente no laboratório de Apoio e os códigos que estão vindo do Apoiado não serão usados, com essa opção marcada o laboratório de apoio terá que re-etiquetar as amostras para identificação das mesmas.

-Permite repetir amostras do apoiado = Permite re-importar arquivos já lidos anteriormente e incluindo um novo pedido para cada solicitação enviada pelo Apoiado(Esta opção só é ativa com a opção Gera novo número de amostra para os exames Ativa).

-Considera a data de entrega informado pelo apoiado = Com esta opção marcada os pedidos passam a ignorar a previsão de entrega do laboratório de Apoio e passa a utilizar a previsão do Apoiado.

-Importa exames como "Pendentes" = Ao importar o pedido, o Apoio ignora a data de coleta informada pelo Apoiado.

-Envia laudos para internet = Opção marcada caso o laboratório de Apoio deseje enviar os pedidos do Apoiado para a internet.

-Importa Pacientes = Importa os pacientes do Apoiado.

-Importa Médicos = Importa os médicos do Apoiado.

**O campo Posto de coleta do Apoiado identifica o posto de coleta que será utilizado para receber os pedidos do Apoiado, o campo Apoiado é preenchido para que quando esteja ativo as opções Importa Pacientes e Importa médicos dentro do cadastro dos pacientes\médicos importados seja preenchido e identificado de qual Apoiado é proveniente este cadastro.
**É necessário o preenchimento destes dois campos!!

• Após configurado o ícone ficará verde, como o exemplo abaixo:

Unilab_Apoio

Para iniciar a estrutura dos serviços necessários para o processo do U2U, será preciso primeiro criar a estrutura de pastas dentro da pasta Rede_Unilab, dentro da Rede_Unilab criar a pasta Apoio, dentro da pasta Apoio criar as pastas Apoiado e Servicos, com a estrutura pronta será feita a instalação do Unilab_Apoio, que será o serviço necessário para que seja gerado os arquivos de modelos de exames que o Apoio realizara para o Apoiado.

• Fazer o download do instalador do Unilab_Apoio dentro do FTP.
• Extrair o conteúdo do arquivo baixado dentro da pasta D:Rede_Unilab\Apoio\Servicos\Unilab_Apoio
• Criar um atalho do executável Unilab_Apoio dentro da pasta, adicionar o parâmetro "-install" ao caminho do atalho e executa-lo como administrador
• Copiar o arquivo "libmysql41" localizado dentro da "Uniwarew" para dentro da pasta do "Unilab_Apoio"

Dentro da pasta juntamente ao executável, há o arquivo Unilab_Apoio.stt que precisa ser configurado, criptografando o nome do banco e o Hostname\Ip da maquina onde ele se encontra, para isto será necessário o arquivo "PHP_Teste" localizado dentro do FTP.

• Baixar o arquivo "PHP_Teste" do FTP, criar uma pasta para ele dentro da estrutura (Exemplo: D:Rede_Unilab\Apoio\Servicos\PHP)
• Executar o arquivo, dentro do PHP, ir na aba Cripto e selecionar a opção Codificar
• No primeiro campo digitar o Hostname\Ip da maquina e clicar em Executar, no segundo campo irá aparecer o Hostname digitado criptografado

• Abrir o arquivo Unilab_Apoio.stt e colocar o Codigo Criptografado dentro do campo dbhost, executar o mesmo processo com o Nome do banco e colocar o codigo criptografado em dbname
• Criar a pasta Modelos dentro de Servicos e dentro da pasta Modelos, a pasta Bkp. Após isto, dentro do arquivo Unilab_Apoio.stt, colocar o caminho da pasta Modelos dentro do campo folderModelos e o caminho da pasta Bkp dentro do campo folderBackup

GRA

Nesta parte será necessário configurar o GRA (Gerador de Resultados Automaticos), responsável por monitorar os pedidos que forem sendo liberados e gerar os arquivos de resultados para serem enviados ao Apoiado.

• Fazer o download do instalador do GRAService dentro do FTP.
• Extrair o conteúdo do arquivo baixado dentro da pasta D:Rede_Unilab\Apoio\Servicos\GRA
• Criar um atalho do executável GRAService dentro da pasta, adicionar o parâmetro "-install" ao caminho do atalho e executa-lo como administrador
• Dentro da pasta Uniwarew copiar os arquivos libmysql41 e unilabw.ini para a pasta do GRA
• Renomear o .Ini copiado de unilabw.ini para GRAService.ini. Alterar o arquivo GRAService.ini e adicionar o trecho abaixo:

        	[APOIADOS]

PathArquivosDeRetorno=D:\rede_unilab\Uniwarew\Apoio\APOIADOS\RES Intervalo=01

count=1 codigo1=0004 ModoPedido=1

• Ainda dentro do .Ini deve ser configurado o campo PathArquivosDeRetorno com o caminho que será gerado os arquivos de resultado (Como padrão é configurado o caminho: D:\Rede_Unilab\Apoio\Apoiados\RES, caso o caminho não exista, será necessário criar as pastas)
• No campo codigo1 será configurado o codigo do convênio criado para importar os pedidos do Apoiado(Caso o cliente tenha mais de um apoiado é criado a linha codigo2, codigo3, etc. e alterado o campo count para o número de Apoiados deste Apoio)
• No campo ModoPedido deve ser definido o valor 0 ou 1, onde 0 ativa o modo "Parcial" de resultados, gerando arquivo de resultados para os exames assim que estiverem liberados e 1 ativa o modo "Completo" gerando arquivos de resultado somente quando todos os exames do pedido estiverem liberados.
• Acessar a pagina de serviços do windows (services.msc) e configurar o Tipo de Inicialização do serviço do GRA para Automatico com atraso na inicialização

Configuração de exames no Apoio

Agora com os serviços instalados é necessário que o cliente faça a configuração dos exames que serão realizados para o Apoiado, para isto é necessário marcar o campo Realizado p/ apoiado dentro da configuração de exame (Cadastros > Exames > Exame).

Dentro da aba Configuração no campo de resultado, na opção Variável p/ Laudo é definido o nome da variável que será enviado para o Apoiado e que o mesmo deverá configurar em seus laudos para que seja importado o resultado, normalmente é indicado colocar um nome de variável condizente com o exame para que o Apoiado tenha mais facilidade na hora de configurar seus exames. Ainda nesta tela é possível configurar também para que seja enviado ao Apoiado outras informações, tais como Valor de Referência, Descrição e Unidade, para isto é necessário alterar o campo que deseja enviar e na opção Referente à Variável adicionar o nome da Variável de Resultado definido anteriormente.

Após estas configurações o Serviço do Unilab_Apoio irá gerar os arquivos de modelo sempre que houver uma alteração de laudo dentro da pasta unilab localizado no caminho definido dentro do .ini do mesmo (Como padrão o caminho é: D:\Rede_Unilab\Apoio\Servicos\Modelos\unilab).

Unilab Apoiado

Dentro do sistema Unilab do Apoiado, será preciso adicionar o Laboratório Apoiado em Cadastros > Laboratórios clicando em Inclui. Dentro destas confgiurações é necessáriod definir o Nome para este laboratório de Apoio, marcar a opção Interfaceado como Sim e o Padrão de Interface como Sistema Unilab. Na opção Código no Lab. Apoio é inserido o código do convênio criado dentro do sistema do Apoio para importar os arquivos do Apoiado.

Após Confirmar está configuração será solicitado a chave de ativação da interface U2U que deve ser verificada com o setor Comércial.

• Alterar o cadastro do "Laboratório de Apoio" criada, ir na aba Arquivos, clicar na opção Importar arquivo de exames e selecionar o arquivo de modelos gerado dentro do sistema do Apoio

Configuração de exames no Apoiado

Após criar o Laboratório de Apoio e importar os arquivos de modelo, é necessário configurar os exames para serem enviados ao Apoio e configurar as variáveis para que seja importado o Resultado retornado do mesmo. Dentro da configuração de exame (Cadastros > Exames > Exame) selecionar o exame e clicar em Alterar.

• Selecionar o Laboratório de Apoio cadastrado.
• Na opção Cod. Exame é selecinado o código do exame cadastrado no Apoio.

         Nesta opção ao selecionar o código do exame com o comando F2 é selecionar somente o código do exame

Ao selecionar utilizando o comando CTRL + F2 é selecionado o código do exame e substituido os dados da aba geral do exame (Nome do exame, Método do exame, Prazo de entrega do exame, Agrupamento de amostra, Volume Recomendável, Conservação, Tempo de Jejum, Instruções para o paciente) Ao selecionar utilizando o comando SHIFT + CTRL + F2 é selecionado o código do exame e Substituido os dados da aba geral e da aba configuração do exame deixando a configuração do laudo idêntico ao laudo do Apoio

• Alterar a opção Int. Ativo para Sim.

• Dentro da aba Configuração é necessário configurar as variáveis dentro do laudo, alterando o campo de resultado e no campo Variável p/ Interfaceamento adicionar a variável do Apoio que pode ser encontrada na opção Lista de Variáveis.

Gerar Lotes de pedidos para o Apoio

• Observação: para ser possível gerar o arquivo de lote, é necessário que os exames estejam triados

• Para ser possível gerar lote é preciso ir em: "Movimentação > Interfaceamento > Laboratório de Apoio".
• Escolher o Laboratório de Apoio, depois clicar em "Inclui", e selecionar os pedidos que deseja gerar nesse lote.
• Por fim clicar em "Gerar Arq.", e então sera gerado, para ir até o arquivo é só clicar com o botão direito e então "abrir em pasta"
  

• Agora sabendo aonde o arquivo está, falta encaminhar para o Apoio, é nessa parte que o RemoteFolder entra

Remote Folder

Apoio

• Será necessário o Apache, o link está no começo da pagina, após baixa-lo e coloca-lo no "Disco D:" e então extrai-lo após isso verificar se o serviço está inicializado em "Serviços".
• Observação: caso não esteja, vá na pasta do apache em Arquivos de Programa > x-webservice > apache > bin > e execute como ADM o "instalar", novamente verifique se foi inicializado
• Logo em seguida ir em:  Arquivos e Programas > x-webserver > apache > conf e abrir httpd.conf com notepad++, comentar o Listen que estará no meio, ou seja, colocar a '#' antes dele, e verificar se a porta 5180 se encontra presente.
• Exemplo:
  
• Verificar no navegador usando (ip da maquina + ":" + porta nesse caso 5180) ex:10.1.0.152:5180
• Se tudo deu certo até aqui irá aparecer algo como na imagem abaixo:
• 

Após verificar que o apache está funcionando, vá em Arquivos e Programas > x-webserver > apache > conf > uniware.conf e abrir com notepad++

• Então dentro de "uniware.conf" copiar a parte selecionada na imagem a abaixo:
  
• Colar está parte em baixo e alterar os lugares marcados como representado:
  
• Alterar para o caminho da pasta aonde ficaram a "PED" e o "RES", no caso seria o caminho para "APOIADOS"
• Observação: A parte marcada em azul, é o nome que irá ser usado para acessar o caminho, logo mais abaixo será melhor esclarecido
• Ir em \\svw-uniware2\SUPORTE\install\PHP_Remote_Folder_Servidor, copiar todos os arquivos e então colar na pasta "APOIADOS"
• Dessa forma tornando possível de ser visto o caminho

Apoiado

• Criar uma pasta chamada "RemoteFolder" em "Rede_Unilab"
• Então jogar o arquivo "RemoteFolder.rar" dentro da basta "RemoteFolder", e extrai-lo e executa-lo como ADM
• No canto perto do relogio irá aparecer, basta clicar duas vezes para abri-lo
• Exemplo:

• Observação: como visto na imagem, está com uma marcação vermelha, ou seja, isso significa que algo está configurado errado.
• Após abri-lo, deverá incluir aonde serão enviados os pedidos para o APOIO, como no exemplo abaixo:

• Na imagem que segue a tela com os campos:

• 1)É o ("IP" + ":" + "Porta(ex:5180)" + "/" + "nome que foi definido em[uniware.conf] (ex:apoio)")
• 2)A pasta aonde vão ser enviados os pedidos do APOIADO(PED)/ A pasta aonde os resultado serão enviados para o APOIADO(RES)
• 3)Pasta Local = No caso de ser a situação de envio seria colocado na pasta aonde os Lot são gerados, pois ela ficará verificando esse local, e assim que fosse verificado que há algum Lot ia ser enviado para "PED" por exemplo, mas quando se trata do retorno do Resultado para o APOIADO, pode se configurar em qualquer pasta, porém como padrão cria-se uma pasta "RES" ou "RETORNO" dentro de "Uniwarew" ou então em "Rede_Unilab"
• Exemplo para PEDIDO:
  

• Observação: o que está marcado é o caminho para os Lot's gerados
• Exemplo para RESULTADO:
  

• 4)TX = pega na pasta do APOIADO e envia para o APOIO / RX= pega na pasta do APOIO e envia para o APOIADO
• Após configurado a pasta será verificado em 180 seg, pois é o Ping padrão, porém tem como altera-lo para teste, em:

• D:\Rede_Unilab\RemoteFolder (No seu ".ini")

• Em Azul é onde se configura o intervalo de verificações

• Em vermelho tem que ser o mesmo "user" e "senha" que se configura no php("uploadsingle.php"), como na imagem abaixo:

• Observação:Caso estivessem diferentes em "uploadsingle.php" ou "RemoteFolder.ini" iria dar esse problema:
  

Apoio

• Quando o Lot é enviado pelo RemoteFolder, deverá chegar na pasta PED, assim como a imagem abaixo:

• Após isso, precisamos pegar esse Lot e colocar dentro do Unilab, para isso deve-se ir em "Movimentação > Interfaceamento > Laboratórios Apoiados
• Temos a opção Manual e a Automática
• Manual:

-Clicar em "Do Arquivo" e procurar a pasta aonde está o Lot desejado(neste caso é a pasta PED)

-Após isso, para verificar se o pedido está no Unilab, basta ir em "Pedidos" e então selecionar o Posto que foi configurado para receber os pedidos

-E então fazer todos os procedimentos normais.

• Auto:

-Mesmo procedimento do Manual, o que difere os dois é o inicio, pois no Automático deve-se clicar em "Auto" e configurar o tempo que deseja que ele verifique

Retorno do Arquivo

• Após pedido estar concluído para ser retornado ao APOIADO
• Observação: Lembrando que ModoPedido estar em 0(so libera cquando todo estao liberados..) ou em 1(libera parcialmente, mesmo que não estejam todos liberados) interfere diretamente na geração de resultado.
• Se o resultado já foi
• Já com o arquivo de retorno, deve-se ir em Movimentação > Interfaceamento > Laboratório de Apoio.
• Escolher o laboratório de Apoio, então basta clicar em "Resultado" e escolher o arquivo de retorno.