STARS Implementation Guide
0.1.0 - ci-build

STARS Implementation Guide - Local Development build (v0.1.0). See the Directory of published versions

Stars Client

STARS Client Overview

The STARS Client provides a wrapper to communicate with the FHIR server using a simpler file system. This allows a basic integration of non-FHIR based systems to be able to send and receive messages using a simple interface based on csv structured model.

The client is built to match the release of the FHIR server and profiles.

File Formats

  • csv - column structure. templates created (if missing) in data folder path (template_servicerequest.csv, template_diagnosticreport.csv)
  • basic model?
  • FHIR+XML - xml file, complete fhir message, ready to send
  • FHIR+JSON - json file, complete fhir message, ready to send

Setup

Sending files

export strucutured csv file from LIMS. save in OUTGOING folder client will convert csv to fhir based message bundle fhir message will be sent to the fhir server destination client endpoint will receive and process the message message.OK (should?) be sent back to the sender

Receiving files

client will check for new messages either on an interval or via subscription (not yet implemented) message is downloaded message.OK (should?) be sent back to sender client will convert the fhir based message to desired format (csv, fhir+json or fhir+json) file saved to the INCOMING folder

Initial Setup

  • authenticate using a STARS account
  • if the client hasnt yet been configured it will direct you to the Endpoint tab
  • click Get Token
  • a list of node accounts will be shown for your organisation
  • select a node, type its password to gain a node auth token
  • click save

  • your node endpoint node conenction is now configured

  • click Client tab
  • browse to select your root data path. subfolders will be created automatically by the service
  • select your desired input type (provided to the outgoing folder) and output type (created by the incoming folder) (see File Formats above)
  • configure email notifications as desired and test
  • click Save

  • your client is now fully configured

  • click Service tab
  • Install service
  • make any modifications to the service such as run as account using the services snapin (botton right shortcut to open services.msc)
  • start service