How could we get Query Params inside a REST Service with HealthShare?

Hello,

First of all thanks for your time reading this post, and thanks for your help with your answers, thanks.

We have the following doubt: We need to create a REST Service in HealthShare, to process incoming calls with the following URL's format:

https://host:port/api/studies?patientId=11473564
 

To accomplish this task, we have previously read:

https://community.intersystems.com/post/advanced-url-mapping-rest

https://community.intersystems.com/post/how-do-i-process-querystring-par...

https://community.intersystems.com/post/how-get-param-passed-get-rest-query

And even more, we have read deeply, Eduard Lebedyuk's answer:

https://community.intersystems.com/post/rest-how-pass-query-parameters#c...

So then, we have written our code as follows:

/// 		Ahora se accede mediante: 
/// 		https://host:port/api/studies?patientId=XXXX111111111111 
/// 
Class Servicios.REST.DICOM.ConsultarEstudiosVNAv01r00 Extends (EnsLib.REST.Service, Ens.BusinessService)
{

Parameter ADAPTER = "EnsLib.HTTP.InboundAdapter";
// Parameter EnsServicePrefix = "/api";
Parameter EnsServicePrefix = "|/api";
XData UrlMap
{
<Routes>
<Route Url="/:studies" Method="GET" Call="consultarEstudiosDatosPaciente"/>
</Routes>
}

/// 		un JSON con el listado de estudios que tiene el paciente + los datos demográficos del paciente 
/// (nombre, sexo, f.nacimiento, etc...)
Method consultarEstudiosDatosPaciente(pInput As %Stream.Object, Output pOutput As %Stream.Object, pStudies As %String, pPatientId As %String) As %Status
{
	$$$LOGALERT("Entra en consultarEstudiosDatosPaciente")
	Set pOutput  = ##class(%GlobalBinaryStream).%New()
	set claseAux = ##class(%ZEN.Auxiliary.jsonProvider).%New()

	$$$LOGINFO("pStudies: "_pStudies)
	$$$LOGINFO("pPatientId: "_pPatientId)
	
	set objetoEntrada = ##class(Mensajes.Request.DICOM.consultarEstudiosDatosPacienteVNARequest).%New()
	
	set objetoEntrada.identificadorPaciente 	= pPatientId
	
	set tSC      = claseAux.%ConvertJSONToObject(.req,"Mensajes.Request.DICOM.consultarEstudiosDatosPacienteVNARequest",.objetoEntrada,1)
	
	set tSC = ..SendRequestSync("EnrutadorConsultarEstudiosVNAv01r00",objetoEntrada,.objetoSalida)
	
	set tSC = claseAux.%WriteJSONStreamFromObject(.pOutput,.objetoSalida,,,,"aeloqtuw")
	
	Do:$$$ISOK(tSC) pOutput.SetAttribute("Content-Type","application/json")
	do pOutput.SetAttribute("Access-Control-Allow-Origin","*")
	do pOutput.SetAttribute("Access-Control-Allow-Credentials","true")
	do pOutput.SetAttribute("Access-Control-Allow-Methods","GET")
    do pOutput.SetAttribute("Access-Control-Allow-Headers","request,Access-Control-Allow-Headers, Origin,Accept, X-Requested-With, Content-Type, Access-Control-Request-Method, Access-Control-Request-Headers")
	Quit tSC
	
	Quit $$$OK
}

}

However, we do not understand why it does not work as expected. We observe that when we call from POSTMAN:

https://10.136.4.141:10102/api/studies?patientId=11473564
 

The Service's Event Log's shows us:

As you could read from the previously posted Logs, it does enters inside our consultarEstudiosDatosPaciente method, but it print "studies" and we would like to access "11473564" which is the value part from "https://10.136.4.141:10102/api/studies?patientId=11473564"

Furthermore, we have rewrite the code, in a way that we thought it could obtain our patientId's value as, just simply changing the XData as follows:

XData UrlMap
{
<Routes>
<Route Url="/:studies?:patientId" Method="GET" Call="consultarEstudiosDatosPaciente"/>
</Routes>
}

However, we observe the following Event's Log:

Why does it only output "studies"?

Thirdly, we have in addition tried to change the URL for:

XData UrlMap
{
<Routes>
<Route Url="/:studies:patientId" Method="GET" Call="consultarEstudiosDatosPaciente"/>
</Routes>
}

But it stills outputting the exact same Event Log:

Why does it works as it works?

Why it does not show us patientId's value?

How could we fix it?

How could we improve it to be able to process https://host:port/api/studies?patientId=11473564
 

Again thanks for your help and time.

To summarize it: This post discusses creating a HealthShare REST service but encounters issues with extracting Query Parameter "patientId" from the URL in a GET REST method. We've tried various URL configurations and codes but we haven't succeeded. We seek advice on fixing and improving the service. 👁️👁️🛠️🔍👁️👁️