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\| QPD\|Q22^Find Candidates\|\|@ProcessNumber^99319276\|\|\|\|\| RCP\|I\|20^RD\| DSC\|1\|

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||
MSA|AA|2e59188e-4632-40d3-9529-badb75fb251c||
QAK||OK|Q22^Find Candidates|1|1|0||
QPD|Q22^Find Candidates||@ProcessNumber^99319276||||||
PID|1||267765^^^HOS^NS~375346331^^^HAS^SNS~121750927^^^SS^NISS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19470712000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRN^PH^^^^^^^^^243429775|||M||99319276^^^HOS|||||PT 141909 141900|||PT^^ISO 3166||||N||
NK1|1|LAST_NAME^FIRST_NAME|FTH^Mae^HL70063||^EMR^PH^^^^^^^^^999999999|
NK1|2|LAST_NAME^FIRST_NAME|MTH^Pai^HL70063||^EMR^PH^^^^^^^^^999999999|

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|
MSA|AA|093a2bde-9bf8-4ff1-8637-66232455479a|
QAK||OK|Q22^Find Candidates|1|1|0|
QPD|Q22^Find Candidates||@SessionID^22754567||||||
PID|1||272223^^^HOS^NS~2304745^^^IRN^B||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19730620000000|M|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999|||||||17005749^^^HOS|||||BR|||BR^^ISO 3166||||N|
NK1|1|LAST_NAME^FIRST_NAME|EXF^Familiar^HL70063||^EMR^CP^^^^^^^^^999999999|

Browser not supported