Stream: subscriptions
Topic: Sydney Connectathon - I'll be remote
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 ofPatient
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