From 39b55ad373efd5ebcbcb16c8250396754ca8bf72 Mon Sep 17 00:00:00 2001
From: Thomas Wood <thomas@fastdatascience.com>
Date: Fri, 21 Jun 2024 13:57:38 +0100
Subject: [PATCH] new post

---
 content/en/blog/harmony-integration.md | 76 ++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 content/en/blog/harmony-integration.md

diff --git a/content/en/blog/harmony-integration.md b/content/en/blog/harmony-integration.md
new file mode 100644
index 0000000..47ccd18
--- /dev/null
+++ b/content/en/blog/harmony-integration.md
@@ -0,0 +1,76 @@
+---
+title: Integrating with Harmony
+date: 2024-07-10
+categories: ["development"]
+image: /images/import-into-harmony.png
+---
+
+# Sending data from another website to Harmony using Javascript
+
+We have exposed functionality for external websites to integrate with Harmony and add an "import to Harmony" button, either generated in Javascript or in Python.
+
+1. Create an Instrument object with at least an `instrument_name` and `questions` property in JSON - the questions must have a `question_no` and `question_text` properties eg:
+
+```
+{
+    "instrument_name": "Smoking behaviour",
+    "questions": [
+        {
+            "question_no": "1",
+            "question_text": "Do you currently smoke or have you ever smoked?"
+        },
+        {
+            "question_no": "2",
+            "question_text": "[Do you currently use] nicotine replacement therapy?"
+        }
+    ]
+}
+```
+
+Encode it to URL safe base64 string - `js-base64` is a good library for this.
+
+Send it to the import URL - to maintain a single instance of the harmony tab / page the target must be set to the harmony URL
+
+```
+<a href="https://harmonydata.ac.uk/#/import/eyJpbnN0cnVtZW50X25hbWUiOiJUcmVhdG1lbnQgLSBtZWRpY2F0aW9uIiwicXVlc3Rpb25zIjpbeyJxdWVzdGlvbl9ubyI6IjEiLCJxdWVzdGlvbl90ZXh0IjoiSGF2ZSB5b3UgZXZlciB0YWtlbiBhbnRpLWRlcHJlc3NhbnRzPyJ9XX0" >Harmonise this scale with harmonydata.ac.uk</a>
+```
+
+## Creating a link to Harmony web UI from the Harmony Python library
+
+
+
+```
+from harmony import create_instrument_from_list, import_instrument_into_harmony_web
+
+instrument = load_instrument_from_list(["Do you currently smoke or have you ever smoked?", "[Do you currently use] nicotine replacement therapy?"])
+web_url = import_instrument_into_harmony_web(instrument)
+
+print (web_url)
+```
+
+## Creating a link to Harmony web UI using pure Python
+
+
+```
+import base64, json
+
+instrument_serialised_as_json = json.dumps({
+    "instrument_name": "Smoking behaviour",
+    "questions": [
+        {
+            "question_no": "1",
+            "question_text": "Do you currently smoke or have you ever smoked?"
+        },
+        {
+            "question_no": "2",
+            "question_text": "[Do you currently use] nicotine replacement therapy?"
+        }
+    ]
+})
+instrument_json_b64_encoded_bytes = base64.b64encode(instrument_serialised_as_json.encode('utf-8'))
+instrument_json_b64_encoded_str = instrument_json_b64_encoded_bytes.decode("utf-8")
+
+url = f"https://harmonydata.ac.uk/#/import/{instrument_json_b64_encoded_str}"
+
+print (url)
+```