Viewing resources

Once resources have been created and saved to the server, the question then becomes – “How can we look at those resources?” – and the answer is that there are a number of different ways.

If you have a bowser plugin like Postman, and are familiar with the FHIR RESTful query syntax, then you can issue the appropriate query syntax directly. But many aren’t that familiar (and don’t want to be), so clinFHIR offers a simpler way.

Load the Resource builder, select the patient you have been entering data against, and take a look in the upper left hand corner. You’ll see 2 buttons labelled ‘Resources’ and ‘New’. Click the ‘Resources’ button.

What you’ll get is a list of all the different resource types that this patient has, and the number of instances. There should be at least one of the type that you have entered. Click it.

Alongside the first list is now a list of the specific resource instances of that type – eg if you clicked the ‘Condition’ resource type, you’ll see a list of all the Condition resources for this patient. A couple of things:

• Under the hood, clinFHIR uses a special operation called Fetch Patient Record to return these resources. It’s possible that the server is not including the resource type you used and it isn’t in the list. Let us know (via the support group) if this happens to you.
• Each entry in the list is using the resource narrative as the display. This can result in some really ugly displays. Try to ignore that – we’ll fix it before too long.

Select one of the resource instances – perhaps the one you created earlier. To the right of the screen are 3 tabs.

• The JSON tab shows the rsource in JSON format
• The XML tab shows the resource in XML format
• The 3^rd tab – References is much more interesting.

As we’ve discussed before, FHIR is all about references between resources creating a ‘web’ of interconnected resources. The references tab allows you to visualize these references – albeit in a simple way. Select the tab.

There are 3 columns in the tab.

• ‘Inward references’ shows the resources that have a reference to the one you just selected (chances are it’s empty)
• ‘Focal resource’ is the one you just selected
• ‘Outward resources’ shows resources that are references from the selected one – you should see at least the patient resource in there.

Now click on a resource in the ‘Outward references’ column – maybe the Patient resource. That will cause it to become the focal resource and all the columns adjust themselves accordingly (and the XML & JSON tabs will update as well). In this way you can browse amongst the resources to see how they are interconnected – which can be fun!

A few caveats:

• Because this works by pulling all of the resources into memory, it will likely fall over if there are too many of them (or at least become very slow). It might be advisable to use a new patient if you want a more complex web of resources (or a ‘graph’ of resources, if you are geeky)
• When the resource is not one directly linked to a patient (like a Medication resource), clinFHIR has to go grab it from the server – this can take a few seconds, and explains why sometimes there will be a delay and then a resource just pops into view.
• For various reasons, the app can get a bit confused – especially if you are creating a new resource and then immediately viewing them. It’s quite safe to re-start the app and see if that solves the problem.