{"id":23421286,"url":"https://github.com/nhsdigital/terminologyserveruses","last_synced_at":"2025-04-09T09:40:48.282Z","repository":{"id":40486498,"uuid":"485707228","full_name":"NHSDigital/TerminologyServerUses","owner":"NHSDigital","description":"Code snippets and exemplars to demonstrate use cases for the NHS Digital Terminology Server","archived":false,"fork":false,"pushed_at":"2022-05-05T07:40:14.000Z","size":5115,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-15T03:43:34.229Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NHSDigital.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-26T08:54:54.000Z","updated_at":"2022-11-03T10:43:53.000Z","dependencies_parsed_at":"2022-08-09T22:00:21.651Z","dependency_job_id":null,"html_url":"https://github.com/NHSDigital/TerminologyServerUses","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2FTerminologyServerUses","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2FTerminologyServerUses/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2FTerminologyServerUses/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2FTerminologyServerUses/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NHSDigital","download_url":"https://codeload.github.com/NHSDigital/TerminologyServerUses/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248016633,"owners_count":21034017,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-23T02:14:40.810Z","updated_at":"2025-04-09T09:40:48.260Z","avatar_url":"https://github.com/NHSDigital.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# TerminologyServerUses\nCode snippets and exemplars to demonstrate use cases for the NHS Digital Terminology Server\n\n## FHIRTerminologyConnector\nPower Query connector example code that allows Power BI Desktop to connect to the Terminology Server.\n\n### Trying example connector\n* Copy the [example connector](./FHIRTerminologyConnector/FHIRTerminologyConnector.mez) into [Documents]/Power BI Desktop/Custom Connectors \u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/connector_location.png\"\u003e\n* Follow the [instructions](https://docs.microsoft.com/en-us/power-bi/connect-data/desktop-connector-extensibility) to enable loading of unsigned connectors.\n* Restart Power BI Desktop\n* Select the option to \"Get data from another source --\u003e\"\u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data1.png\"\u003e\n* Select the \"FHIRTerminologyConnector (Beta)\" and click \"Connect\" \u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data2.png\"\u003e\n* Provide the terminology server url that retrieves the terminology content you need (e.g. https://ontology.nhs.uk/production1/fhir/ValueSet/$expand?url=http://snomed.info/sct?fhir_vs=refset/723264001) \u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data3.png\"\u003e\n* Sign in using your normal terminology server user credentials \u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data4.png\"\u003e\u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data5.png\"\u003e\n* Then \"Connect\" \u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data6.png\"\u003e\n* Navigate through the json response (e.g. expansion \"Record\" then contains \"List\") \u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data7.png\"\u003e\u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data8.png\"\u003e\u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data9.png\"\u003e\n* Convert to table \u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data10.png\"\u003e\u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data11.png\"\u003e\n* Show columns \u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data12.png\"\u003e\u003cp\u003e\u003cimg align=\"left\" src=\"./images/get_data15.png\"\u003e\u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data13.png\"\u003e\u003cp\u003e\u003cimg align=\"center\" width=\"50%\" height=\"50%\" src=\"./images/get_data14.png\"\u003e\n  \n### Building example connector\nThe source code is provided for the example connector if you want to take the example further. Visual Studio and [PowerQuery SDK](https://marketplace.visualstudio.com/items?itemName=Dakahn.PowerQuerySDK) are required to build it (note: at the moment the latest version of Visual Studio that is supported by the PowerQuery SDK is 2019). For build instructions/guidance please see: [Create custom power query connectors](https://docs.microsoft.com/en-us/power-query/startingtodevelopcustomconnectors).\n\nFor details on how to sign/certify connectors for safe distribution:\n\nhttps://docs.microsoft.com/en-us/power-query/connectorcertification\n\nhttps://docs.microsoft.com/en-us/power-query/handlingconnectorsigning\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhsdigital%2Fterminologyserveruses","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnhsdigital%2Fterminologyserveruses","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhsdigital%2Fterminologyserveruses/lists"}