Using a post co-ordinated expression library

This guidance explains how to include a post co-odinated expression from your PCE in a FHIR value set. You may find it useful to read the create a post co-ordinated expression library before you start.   

1. Create a new FHIR ValuesSet. Here we have called it Value Set using PCE Library.  Make sure you add in a Value Set URI so the Value Set can be successfully uploaded to the Terminology Server.

When you first create a ValueSet, you will be presented with the include codes tab by default which is the tab we will be using to include the PCE. 

Enter the Code System Version. The Code System is already defaulting to SNOMED-CT which is what we require.  In steps 2 and 3 of Create a post co-ordinated expression library, we located the Code System and Code System Version that we need to use here. 

This time we need to provide the version in a separate field. When you put the cursor in the Code System Version field, it will give you a drop-down with all available versions.  Choose one, or paste in the value. 

Here we choose http://snomed.info/sct/999000031000000106/version/ 20200204. This is the same example we used in our code system supplement example. 

3. Copy the required PCEs from the PCE Library Supplement and paste them into the code column of the table.

4. So far we have linked the ValueSet to the SNOMED-CT CodeSystem, but we also need to link it to the PCE Library supplement.

Click the Additional Metadata tab and then the + Supplement button to reveal the supplement fields.

In the Code System field, we enter the URI of the PCE Library supplement we created http://csiro.au/fhir/ CodeSystem/pce-library-supplement

If the supplement has a version number, we can enter that in the Code System Version field. Ours didn't, so we leave it blank.

5 Upload your ValueSet to the Terminology Server to make it available for use. Click on the Upload to FHIR Server tab, then click on Validate Value Set to validate before uploading, then click on Upload Value Set.

If your ValueSet with PCEs is successfully uploaded you will see a confirmation message.