Você está na página 1de 13

MANUAL DE CONFIGURAO DO WEBSERVICE

Data alterao: 16 / 04 / 2012

1 de 13

1. Objetivo A soluo oferecida pelo servio de WebService da Wheb Sistemas a melhor opo para o envio e retorno de informaes de Ordens de Servio. Atravs do WebService, possvel receber todos os seus histricos e anexos em sua OS, sendo gravados para eventuais consultas posteriores. 2. Vantagens As vantagens da funcionalidade em relao ao e-mail, que destacam o servio, so: - Maior velocidade no envio de OS's: as OS's so abertas diretamente na Wheb; - Maior confiabilidade: no depende de um servio instvel como o e-mail; - Maior agilidade no atendimento: a OS aberta diretamente para o grupo de suporte responsvel pela funo definida; - Maior segurana no retorno das informaes: voc recebe as atualizaes de histricos e anexos diretamente na OS. a) Da abertura, ao encerramento da OS, todo o processo pode ser realizado atravs do WebService, garantindo todas as vantagens apresentadas acima. b) Sua maior vantagem o fato de no utilizar o e-mail, devido a instabilidade do servio, no qual podemos no receber suas OS's por alguma falha no servidor de e-mail. c) Atravs do WebService, no momento da abertura da OS, voc ir automaticamente receber o nmero da OS que foi aberta na Wheb Sistemas, este nmero ficar gravado em sua OS, oferecendo maior facilidade no momento de realizar contato com a Wheb. 3. Processo de Implantao de Envio e Retorno via WebService a) As informaes detalhadas neste documento devem ser seguidas exatamente como descritas, pois a parametrizao incorreta levar ao no funcionamento, ou funcionamento incorreto do WebService. b) Os parmetros informados como Opcional no so obrigatrios para o funcionamento do WebService, sendo dispensveis suas configuraes. Porm, os parmetros obrigatrios devem estar corretamente configurados. c) Para iniciar a implantao, necessrio que sejam salvos as DLL's DelZIP179.dll e WhebZIP.dll no diretrio onde se encontra o executvel do Tasy. Caso no tenha certeza do diretrio, verifique no arquivo bat onde est definido para ser salvo o executvel. Estas DLL's devem estar salvas em todas as mquinas que forem enviar/receber informaes via WebService. d) Tambm devem ser liberadas as portas 20 e 21 no Firewall, para os IP's da Wheb (ws1.wheb.com.br e ws2.wheb.com.br). e) Aps salvar as DLL's e liberar as portas, os seguintes os parmetros abaixo devem ser configurados. Os parmetros obrigatrios so os [69], [80], [81] e [82] do Menu do Sistema, e os [08], [12] e [91] da Ordem de Servio.

Data alterao: 16 / 04 / 2012

2 de 13

4. Parmetros do Menu do Sistema - Parmetro [62] Mostrar mscara ***** nos valores dos parmetros de senha (Opcional): Caso este parmetro esteja definido com o valor SIM, ser apresentado mscara em todas as senhas registradas nos parmetros, como o [82] do Menu do Sistema.

http://ws1.wheb.com.br;
Wheb).

Parmetro

[69]

Definir

Java: Informar o valor http://ws2.wheb.com.br (IP do Servios da

URL

para

WebServer

Desta forma o sistema tentar comunicar pelo primeiro endereo e caso esteja indisponvel ir se comunicar pelo segundo, minimizando a possibilidade de indisponibilidade do servio. - Parmetro [80] Endereo do Servidor de Proxy: Dever ser definido o endereo do proxy do hospital (IP:Porta). Ex.: 172.0.0.1:3128. Referente ao parmetro [80], ideal verificar diretamente o endereo informado nas Opes da Internet (Painel de Controle > Opes da Internet > Aba Conexes > Configuraes da Lan > Servidor Proxy). O endereo informado na configurao o do Proxy utilizado. - Parmetro [81] Usurio de acesso ao Proxy: Informar o nome de usurio do Proxy, caso haja. - Parmetro [82] Senha do usurio de Proxy: Informar senha do Proxy, caso haja. Referente aos parmetros [81] e [82], possvel descobrir se h necessidade ou no de usurio/senha, acessando algum site, como o Google. Caso seja solicitado a digitao de usurio/senha, ser necessrio informar no Tasy tambm. 5. Parmetros da Ordem de Servio - Parmetro [08] Local onde ser salvo o anexo: Dever ser informado o caminho para o diretrio onde sero salvos os anexos das OS's, recebidos da Wheb. O endereo dever conter no final uma barra invertida ( \ ). Ex: F:\Anexos\ Neste parmetro correto definir uma pasta na rede, na qual todos os usurios tenham acesso total (Leitura/Escrita). Isso necessrio, pois caso haja mais de um usurio recebendo os anexos, os mesmos sero salvos em um caminho onde qualquer usurio, de qualquer mquina, consiga acessar, desde que tenha permisso para isso. - Parmetro [12] Permitir informar campos especficos da informtica: necessrio definir o valor SIM para este parmetro. Este parmetro habilita os campos Funo e Classificao da Ordem de Servio, necessrios para o envio via WebService, por agilizar na definio do grupo responsvel pela funo. - Parmetro [90] Informar a sequncia do estgio aps envio da OS (Opcional): Informar o estgio que a OS ir assumir aps ser enviado para a Wheb, atravs da opo Enviar OS via WebService. - Parmetro [91] Informar a sequncia do estgio no retorno da OS: Informar o estgio que OS ir assumir ao receber alguma atualizao da Wheb, ao utilizar a opo Obter Anexo(s)/Histrico(s) OS via WS. - Parmetro [92] Informar a sequncia do estgio ao solicitar encerramento da OS (Opcional): Informar estgio que OS ir assumir ao solicitar o encerramento, atravs da opo Encerrar OS via WebService.

Data alterao: 16 / 04 / 2012

3 de 13

- Parmetro [93] Informar a sequncia do estgio aps encerrar a OS (Opcional): Informar o estgio que a OS ir assumir aps ser encerrada. Os estgios podem ser cadastrados em Cadastros > Manuteno Hospitalar > Cadastros > Estgio do Processo. Para o parmetro [91], sugerimos a criao do estgio Retorno Wheb, para uma maior facilidade na identificao de OS's com novos histricos / anexos, porm, poder ser utilizado qualquer outro estgio. - Parmetro [122] Forma de agrupamento das Ordens de Servio (Opcional): Se o parmetro for definido com o valor SIM, ser criada uma pasta no diretrio definido no parmetro [08] com o nome como o nmero da OS e dentro desta pasta sero salvos os anexos da OS. O objetivo do parmetro uma maior organizao dos anexos. 6. Liberao do Uso do WebService Ao realizar as parametrizaes necessrias e salvar as DLL's no diretrio do executvel, necessrio solicitar a liberao para utilizar o Envio e Retorno via WebService. Esta solicitao pode ser feita atravs de e-mail (suporte@wheb.com.br), sendo necessrios os seguintes dados: Nome Completo; E-mail; Data de Nascimento; Hospital; Cdigo do Cadastro de Pessoa Fsica do Tasy.

Aps solicitar a liberao para o envio e retorno, ser necessrio realizar um teste, enviando uma OS via WebService, para que seja verificado se a funcionalidade foi configurada corretamente e se est sendo possvel receber as atualizaes corretamente. 7. Opes do WebService Ao concluir o processo de implantao, estaro disponveis trs novas opes referentes ao WebService, no menu Pop-Up do boto direito do mouse, na funo Ordem de Servio: - Enviar OS via WebService: Esta opo dever ser utilizada ao abrir uma nova OS com a Wheb, ou ao inserir novo histrico/anexo para enviar Wheb. Esta opo deve ser utilizada em cada OS que for atualizada, pois s envia as informaes da OS em questo. - Obter Anexo(s)/Histrico(s) OS via WS: Esta opo dever ser utilizada para verificar se h novos histricos/anexos de alguma OS pendente com a Wheb. Esta opo pode ser utilizada uma nica vez, pois busca as atualizaes de todas as OS's que estiverem pendentes com a Wheb. - Encerrar OS via WebService: Esta opo dever ser utilizada ao concluir a OS. Desta forma, o WebService substitui totalmente a utilizao de e-mails para o processo de abertura, atualizao e encerramento das OS's com a Wheb. 8. Situaes ao Enviar OS via WebService Ao efetuar os testes de envio/retorno de OS's via WebService, podem ocorrer as seguintes situaes, devido a parametrizao incorreta:

Mensagem: General SQL Error. Ora-01722: Nmero Invlido.


4 de 13

Data alterao: 16 / 04 / 2012

Causa: Parmetro que define o estgio da OS foi informado incorretamente. Soluo: Verificar os parmetros [90], [91], [92] e [93] da Ordem de Servio, a fim de identificar qual teve o valor definido incorretamente. Mensagem: [IP] no respondeu solicitao!!!.

Data alterao: 16 / 04 / 2012

5 de 13

Causa: Endereo do Proxy definido incorretamente no parmetro [80] do Menu do Sistema. Soluo: Identificar Proxy correto (atravs das Opes da Internet, conforme descrito acima) e definir o valor no parmetro.

Mensagem: Invalid WSDL Document XML Document Must Have a Top Level Element.

Data alterao: 16 / 04 / 2012

6 de 13

Causa: Frequentemente relacionado ao valor do parmetro [69] do Menu do Sistema, definido incorretamente, tambm pode estar ligado a falta de liberao das portas 20 e 21, descritas no incio do documento, ou algum outro bloqueio, impedindo o Tasy de acessar o endereo especificado. Soluo: Verificar parmetro [69], definindo o IP da Wheb (http://200.215.15.66), e solicitar a verificao das portas 20 e 21 do Firewall, a fim de identificar se esto corretamente liberadas.

Mensagem: Violao de Acesso.

Data alterao: 16 / 04 / 2012

7 de 13

Causa: Esta mensagem pode estar relacionada a: 1. Falta das DLL's no diretrio do executvel do Tasy. 2. Falta da liberao das portas 20 e 21 do Firewall. 3. A funo Preveno de Execuo de Dados do Windows est habilitada, porm, o executvel do Tasy no est incluso nas excees. 4. Informaes do Proxy (Parmetros [80], [81] e [82] do Menu do Sistema) no foram definidos corretamente. 5. Falha na conexo com a Internet.
Soluo: Analisar os itens, em busca da possvel causa do erro, devido incorreta parametrizao de algum item, ou restrio de acesso gerada por algum programa externo (antivrus, firewall, proxy, etc.).

Mensagem: Failed to load WhebZIP.dll.

Data alterao: 16 / 04 / 2012

8 de 13

Causa: No foi possvel localizar a DLL WhebZIP no diretrio do executvel do Tasy. Soluo: Salvar as DLL's necessrias no diretrio correto. Mensagem: Problema ao tentar enviar anexo(s)!.

Data alterao: 16 / 04 / 2012

9 de 13

Causa: No h as DLL's necessrias no diretrio do executvel do Tasy ou o arquivo a ser enviado anexo est com algum problema. Soluo: Verificar a existncia das DLL's, se o arquivo a ser enviado encontrasse realmente no diretrio especificado e, caso haja mais de um arquivo, se no h arquivos de nomes iguais.

Mensagem: Premature End of File.

Data alterao: 16 / 04 / 2012

10 de 13

Causa: Parametrizao incorreta e/ou executvel incorreto.

Soluo: Verificar se todos os parmetros esto de acordo e se o executvel utilizado est de acordo com o da verso.

Mensagem: 'J existe uma requisio em andamento'.

Causa: Arquivo pendente na base. Soluo: Rodar o comando abaixo no SQL. Verificar se h anexos pendentes para download.

select count(*) from man_ordem_serv_arq where ie_status_anexo = 'P'; Retirar todos os anexos que estiverem pendentes para download
Data alterao: 16 / 04 / 2012 11 de 13

update man_ordem_serv_arq set ie_status_anexo ='O' where ie_status_anexo = 'P'; commit; Alm destas situaes descritas, podem ocorrer outras falhas, no momento de obter as atualizaes. A situao mais comum de voc receber o arquivo anexo da OS, porm, o mesmo ser salvo sem nenhuma informao (0 bytes) em sua OS. Para corrigir esta falha, o Firewall dever ser configurado a fim de permitir a conexo FTP do Tasy com a Wheb, para obter os anexos. 9. Firewall Inicialmente, caso utilize uma regra de firewall para o bloqueio de portas de entrada e sada, necessrio criar algumas excees, permitindo o acesso dos IP's da Wheb s portas 20 e 21. Para realizar a conexo e receber os anexos, o Tasy utiliza uma conexo FTP com a Wheb, que utiliza as portas 20 e 21, responsveis respectivamente pela conexo e listagem de arquivos. Porm, a transferncia dos arquivos no momento do download, ocorre atravs de portas dinmicas, conhecidas como Portas Altas. Caso o modo de implementao do Firewall seja STATELESS, necessrio que sejam criadas regras de mapeamento para as portas. Caso o modo de implementao seja STATEFULL, o processo ser automtico. Para uma melhor compreenso de como estas regras afetam o correto funcionamento do WebService, ser descrito o processo de atualizao: 1. Cliente solicita atualizaes para o WebService da Wheb Sistemas; 2. O WebService retorna um XML contendo todas as atualizaes, bem como o nome dos arquivos anexos a OS; 3. O Tasy percorre o XML e inicia a atualizao das Ordens de Servio (gravar histricos e inserir os registros dos anexos, deixando-os com o status Pendente para Download); 4. No final do processo, o sistema busca quais os arquivos esto com status Pendente para Download; 5. O Tasy cria um arquivo em seu servidor com tamanho ZERADO, e depois efetua a conexo FTP para baixar o contedo do arquivo. Portanto, caso ocorra algum bloqueio para a conexo, o arquivo ficar com o tamanho de 0 bytes, sem nenhuma informao. Muitas vezes, esta situao est relacionada ao mapeamento incorreto das portas, e desta forma, os responsveis pelo Firewall dos hospitais nos informaram que a soluo para esta situao foi a alterao do modo de implementao do firewall para STATEFULL. IMPORTANTE: O responsvel pela segurana da rede/internet do hospital acompanhe o teste, a fim de identificar se algum pacote de informao est sendo bloqueado/perdido, durante o processo de atualizao da OS.
Data alterao: 16 / 04 / 2012 12 de 13

Abaixo, segue um exemplo de regra criado para que seja possvel receber corretamente os arquivos anexos: # FTP modprobe ip_nat_ftp modprobe ip_conntrack_ftp ################## LIBERANDO WHEB iptables -I INPUT -p tcp -s 189.16.169.130 --dport 20 -j ACCEPT iptables -I FORWARD -p tcp -s 189.16.169.130 --dport 20 -j ACCEPT iptables -I INPUT -p udp -s 189.16.169.130 --dport 20 -j ACCEPT iptables -I FORWARD -p udp -s 189.16.169.130 --dport 20 -j ACCEPT iptables iptables iptables iptables iptables iptables iptables iptables -I -I -I -I -I -I -I -I INPUT -p tcp -s 189.16.169.130 --dport 21 -j ACCEPT FORWARD -p tcp -s 189.16.169.130 --dport 21 -j ACCEPT INPUT -p udp -s 189.16.169.130 --dport 21 -j ACCEPT FORWARD -p udp -s 189.16.169.130 --dport 21 -j ACCEPT INPUT -p tcp -s 177.19.229.58 --dport 20 -j ACCEPT FORWARD -p tcp -s 177.19.229.58 --dport 20 -j ACCEPT INPUT -p udp -s 177.19.229.58 --dport 20 -j ACCEPT FORWARD -p udp s 177.19.229.58 --dport 20 -j ACCEPT

iptables -I INPUT -p tcp -s 177.19.229.58 --dport 21 -j ACCEPT iptables -I FORWARD -p tcp -s 177.19.229.58 --dport 21 -j ACCEPT iptables -I INPUT -p udp -s 177.19.229.58 --dport 21 -j ACCEPT iptables -I FORWARD -p udp -s 177.19.229.58 --dport 21 -j ACCEPT ################## FIM WHEB A Wheb Sistemas no possui especialistas em Firewall, portanto, a regra apresentada foi criada por um dos hospitais clientes da Wheb, e que solucionou vrias situaes em que o Firewall bloqueava o recebimento dos arquivos.

Data alterao: 16 / 04 / 2012

13 de 13