FHIR Chat · Sydney Connectathon - I'll be remote · subscriptions

Stream: subscriptions

Topic: Sydney Connectathon - I'll be remote


view this post on Zulip Gino Canessa (Jan 30 2020 at 22:23):

Hi everyone! Unfortunately, I won't be at the Connectathon this weekend, so I wanted to post something here.

For anyone who hasn't used it yet, there is a client/server test combo available at subscriptions.argo.run.

Below is some short-ish info for using them. While I won't be there, feel free to ping me on Zulip, I'll check periodically if there are any problems or requests with those tools.

Anyway, are three projects accessed there: a UI, a proxy-server, and the "client host" server. Together everything does the whole loop, but each piece can be used to test against something else (e.g., use the UI as a subscriptions client with a different server or use the server to test a different client).

UI:

  • TypeScript React App (link to repo is on the hosted page)
  • Everything possible runs in the browser
    • Can't have REST endpoints in the browser, so those are in the Client Host
    • Creating endpoints in the UI sets one up in the client host and shows that URL
    • Notifications sent to endpoints in the session get forwarded to the UI

UI: Config Tab

  • Settings (e.g., URLs, light/dark look, etc.)
    • FHIR Server URL can be set to your test URL
    • Since everything runs in the browser, it can point to localhost, etc.
    • Connecting gets the Capabilities Statement and checks for needed capabilities based on the operations in the UI
    • If you are having trouble connecting to your server, turn on the 'Skip FHIR Server Capabilities Check' toggle
  • Useful links (e.g., to the current and previous Connectathons, to the GitHub repos of this software, etc.)
  • Connect/Disconnect button: connect to the server and client host (required for all other operations)

UI: Patient + REST

  • Walks through a single-patient encounter notification and REST notifications
  • "On Rails" version, only options available are valid for the scenario

UI: Group + REST

  • Same as above, but uses the Group resource for filtering events instead of Patient

UI: Playground

  • Named appropriately :-)
  • Allows for testing of things like Websockets, Email, etc.

UI: DevDays

  • The most BASIC client tutorials I could figure out.
  • More info can be found on my DevDays slides

Server Proxy:

  • Thin proxy server that points to hapi.fhir.org.
  • Intercepts everything it needs for Subscriptions
  • Can be used directly, FHIR endpoint is: server.subscriptions.argo.run

Client Host:

  • Public hosted endpoints for testing
  • Only useful paired with this UI

Hope everything goes well this weekend, and safe travels!


Last updated: Apr 12 2022 at 19:14 UTC