QBP^Q22 – Pesquisa Utentes
- Ana Maria Alves Baião (Unlicensed)
- Maria Isabel Barbosa
- Artur Longo (Unlicensed)
A pesquisa de utentes é implementada através do envio de uma mensagem QBP^Q22, como se pode verificar nos exemplos seguintes, este código tem de ser passado no campo MSH-9 (ver tabela para mais detalhes) e vai ser igual para todas as pesquisas de utentes.
No segmento QPD (verificar tabela para mais detalhes sobre os parâmetros de pesquisa suportados) da mensagem vão ser passadas todas as informações acerca da query, mais precisamente no campo QPD-3 vão ser passados os parâmetros da pesquisa, estes parâmetros vão ser relativos a cada tipo de pesquisa.
Numa pesquisa de utentes o campo QPD-3 aceita os seguintes parâmetros:
| Parâmetros aceites | Descrição |
|---|---|
| @PatientID | Nº Sequencial |
| @Name | Nome |
| @Gender | Sexo |
| @BirthDate | Data de Nascimento |
| @AgeFrom | Idade de |
| @AgeTo | Idade a |
| @ProcessNumber | Nº do Processo |
| @HealthCardNumber | Nº Utente (SNS) |
| @DocumentType | Tipo do Documento |
| @DocumentNumber | Nº do Documento |
| @NISS | NISS |
| @FiscalNumber | Nº Identificação Fiscal |
| @Nationality | Nacionalidade |
| @PrimaryCareUnit | Centro de Saúde |
| @VisitNumber | Nº Episódio |
| @SessionID | Nº Sessão |
| @DomainCode | Módulo |
Esta pesquisa irá devolver uma resposta (RSP^K22) com o(s) segmento(s) de identificação do(s) utente(s) (PID) que satisfaçam as condições da pesquisa efetuada assim como os dados de contacto de familiares (NK1). A seguinte tabela mostra mais detalhes acerca desta mensagem.
Query Profile
Query Statement ID (Query ID=Q22): | Q22 |
Type: | Query |
Query Name: | Find Candidates |
Query Trigger (= MSH-9): | QBP^Q22^QBP_Q21 |
Query Mode: | Both |
Response Trigger (= MSH-9): | RSP^K22^RSP_K21 |
Query Characteristics: | @PatientID ; @Name; @Gender; @BirthDate; @AgeFrom; @AgeTo; @ProcessNumber; @HealthCardNumber; @DocumentType; @DocumentNumber; @NISS; @FiscalNumber; @Nationality; @PrimaryCareUnit; @VisitNumber; @SessionID; @DomainCode |
Purpose: | Pesquisa todos os utentes |
Response Characteristics: | Envia o utente com as características pedidas |
Exemplo de uma mensagem Pesquisa de Utente simples
Esta mensagem representa uma pesquisa de utentes pelo número de processo "99319276". Neste caso o campo QPD-3 apenas contem o parâmetro "@ProcessNumber^99319276" e a referência à pesquisa de utentes é feita do campo QPD-1 "Q22^Find Candidates".
MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20160420120315||QBP^Q22^QBP_Q21|2e59188e-4632-40d3-9529-badb75fb251c|D|2.5| |
|---|
Na resposta é devolvida a informação da utente "LAST_NAME" relativa aos seus dados de identificação, assim como a informação de contactos dos pais, apresentados nos segmentos NK1.
Resposta:
MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20160420120316||RSP^K22^RSP_K21|6beb1c17-ff8e-45cb-9809-38f68acfe9dd|D|2.5|| |
|---|
Exemplo de uma mensagem Pesquisa de Utente composta
Esta mensagem representa uma pesquisa de Utentes complexa, por nome "@Name^Marte", sexo "@Gender^F" e intervalo de idades "@AgeFrom^40" e "@AgeTo^50".
| MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20160414113850||QBP^Q22^QBP_Q21|6fdda5e9-a1ac-4227-944b-469d07ac1651|D|2.5| QPD|Q22^Find Candidates||@Name^Marte~@Gender^F~@AgeFrom^40~@AgeTo^50||||| RCP|I|20^RD| DSC|1| |
|---|
A resposta devolve a informação relativa a todos os utentes que satisfazem os critérios de pesquisa utilizados na mensagem acima, neste caso em particular a pesquisa devolveu dois utentes, discriminados nos segmentos PID e com a informação de contactos apresentados nos segmentos NK1.
| MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20160414113851||RSP^K22^RSP_K21|793829a8-5d28-46b8-9969-965a7cfd5ffb|D|2.5| MSA|AA|6fdda5e9-a1ac-4227-944b-469d07ac1651| QAK||OK|Q22^Find Candidates|2|2|0| QPD|Q22^Find Candidates||@Name^Marte~@Gender^F~@AgeFrom^40~@AgeTo^50||||| PID|1||76195^^^HOS^NS~395749401^^^HAS^SNS~9999991^^^IRN^B~147030048^^^AT^NIF~095146767^^^SS^NISS||MARTELO ^FIRST_NAME^MIDDLE_NAME^^^^^L||19760313000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRN^PH^^^^^^^^^916783779|||S||99189569^^^HOS|||||PT 140604 140600|||PT^^ISO 3166||||N| NK1|1|LAST_NAME^FIRST_NAME|EMC^Contacto de emergencia^HL70063||^EMR^CP^^^^^^^^^999999999| PID|2||295239^^^HOS^NS~395379037^^^HAS^SNS~9999999^^^IRN^B||LAST_NAME^MARTE^MIDDLE_NAME^^^^^L||19680924000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRN^PH^^^^^^^^^770375|||||99323872^^^HOS|||||PT 141612 141600|||PT^^ISO 3166||||N| NK1|2|LAST_NAME^FIRST_NAME|EXF^Familiar^HL70063||^EMR^CP^^^^^^^^^999999999| |
|---|
Exemplo de uma mensagem Pesquisa de Utente não encontrado
Esta mensagem representa uma pesquisa de Utente por número de Cartão de cidadão usando a combinação de parâmetros "@DocumentType^B" e "@DocumentNumber^158800702".
| MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20160414113802||QBP^Q22^QBP_Q21|1ae4662e-67fd-4289-8d28-660307ad833a|D|2.5| QPD|Q22^Find Candidates||@DocumentType^B~@DocumentNumber^158800702||||| RCP|I|20^RD| DSC|1| |
|---|
Como não foi encontrado nenhum utente que satisfaça o critério de pesquisa utilizado na mensagem anterior, a mensagem de resposta indica no campo QAK-2 com o código "NF" que o utente não foi encontrado, e no campo QAK-4.1 que foram encontrados "0" registos.
Resposta:
| MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20160414113802||RSP^K22^RSP_K21|4349363d-24a9-4d64-a530-89857386773c|D|2.5| MSA|AA|1ae4662e-67fd-4289-8d28-660307ad833a|Utente n\XE3\o encontrado| QAK||NF|Q22^Find Candidates|0|0| QPD|Q22^Find Candidates||@DocumentType^B~@DocumentNumber^158800702||||| |
|---|
Exemplo de uma mensagem Pesquisa de Utente pouco restrita
Esta mensagem representa uma pesquisa de Utente por nome, apenas com o parâmetro "@Name^Marta" no campo QPD-3.
| MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20160414112236||QBP^Q22^QBP_Q21|12a23442-1d4f-48d3-9afe-ae0c1d2f7eb0|D|2.5| QPD|Q22^Find Candidates||@Name^Marta||||| RCP|I|20^RD| DSC|1| |
|---|
Este tipo de pesquisa é considerado vago e pode debilitar as Base de Dados, pelo que a plataforma não o permite dando indicação disso mesmo na mensagem de resposta através do erro "Pesquisa pouco restrita", este erro é passado na segmento MSA.
Resposta:
| MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20160414112236||RSP^K22^RSP_K21|d8c3628e-6a76-4e38-b00f-4f53eb4f6f09|D|2.5| MSA|AE|12a23442-1d4f-48d3-9afe-ae0c1d2f7eb0|(108) PESQUISA POUCO RESTRITA\.br\causa: \.br\acao: | QAK||AE|Q22^Find Candidates|0|0| QPD|Q22^Find Candidates||@Name^Marta||||| |
|---|
Exemplo de uma mensagem Pesquisa de Utente inconsistente
Esta mensagem representa uma pesquisa de Utente por nome "@Name^Marta" e sexo "@Gender^7". No entanto, o código usado para identificar o sexo do utente é inválido, tendo sido colocado um valor numérico "7".
| MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20160414112352||QBP^Q22^QBP_Q21|f9ea9a30-6c73-40a6-9228-b6b2939e95b5|D|2.5| QPD|Q22^Find Candidates||@Name^Marta~@Gender^7||||| RCP|I|20^RD| DSC|1| |
|---|
Neste caso, a mensagem de resposta indica, que no campo MSA-3, foram introduzidos dados inconsistentes na pesquisa.
Resposta:
| MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20160414112352||RSP^K22^RSP_K21|a679d975-63a2-465b-a882-5ddb9ee11480|D|2.5| MSA|AE|f9ea9a30-6c73-40a6-9228-b6b2939e95b5|(122) DADOS INCONSISTENTES\.br\causa: \.br\acao: | QAK||AE|Q22^Find Candidates|0|0| QPD|Q22^Find Candidates||@Name^Marta~@Gender^7||||| |
|---|
Exemplo de pesquisa por número de sessão
No seguinte exemplo é realizada uma pesquisa pelo número de sessão 22754567.
| MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20170515145100||QBP^Q22^QBP_Q11|093a2bde-9bf8-4ff1-8637-66232455479a|D|2.5| QPD|Q22^Find Candidates||@SessionID^22754567|||||| RCP|I|3^RD| DSC|1| |
|---|
Resposta:
É devolvida uma mensagem de resposta com 1 resultado encontrado e apresentado para a pesquisa efetuada, do utente "LAST_NAME" e respetivo contacto familiar do utente.
MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20170515182431||RSP^K22^RSP_K21|84d2fbd3-e2c6-4ffd-a06a-bb1fd2fec7ca|D|2.5| |
|---|