Part 1: Create the Joy Portal within the URL builder (5-25 mins)
The first step of this installation guide is to create a new Joy URL within SystmOne. Once that has been created, you can publish it across all practices.
Step by step guide:
Open SystmOne and load up a patient.
Go to Setup → URL & Program Maintenance.
3. Search “Joy” from the list of available programs - press the ’Name’ field to alphabetise the list
4. If you can see a Heart-Shaped icon ❤️ titled “Joy” in the list of available URLs and Programs, then someone has already created the button for you and you can skip to the next section.
5. If you cannot see a heart-shaped icon, titled Joy then please continue Click the New URL button in the top left of the URL & Program Maintenance screen and choose the ‘New URL’.
6. On the create URL dialog enter “Joy” to the “Name” field, select the heart icon ❤️
7. Enter “Joy single sign-on” to the description field.
8. Choose either ‘Chrome’ or ‘firefox’ as the browser and and tick the ‘Private browsing mode’ (prevents URL being stored in browser history)
9. Also select “Encrypt parameters” checkbox.
10. Copy and paste the following information into the Key and IV fields:
Key: af1491dc41a7c31c616e51ea12f28ce7
IV: 35eecdc3f12ce956bc63e937cd8ee770
11. Amend the first text field that is created automatically so that: “https://” is replaced with https://services.thejoyapp.com/integrations/s_ones/retrieve_session?input=
(please use forward slashes not backward slashes)
12. Click “Add Field” and select a Text field.
13. Add this text: login=
14. Click “Add Field” and select Organisation ID.
15. Click “Add Field” and select a Text field.
16. Add this text: &password=SingleSignOn2
17. Click “Add Field” and select a Text field.
18. Add this text: &last_name=
19. Click “Add Field” and select a Patient Surname
20. Click 'Add Field' and select a Text field.
21. Add this text: &birth=
22. Click “Add Field” and select a Patient's Date of Birth.
23. A format pop-up will appear. Select the DD-MM-CCYY option. This is the date with the dashes.
24. Click “Add Field” and select a Text field.
25. Add this text: &post_code=
26. Click “Add Field” and select a Patient Postcode
27. Click 'Add Field' and select a Text field.
28. Add this text: &nhs=
29.Click “Add Field” and select a Patient NHS Number and select “without spaces”
30.Click 'Add Field' and select a Text field. Add &sone_username=
31. Click 'Add Field' and select SystmOne username
32. Tick the “Base64 Encoded” and “Encrypted” check boxes for every row except the first row
33. Press Test
34. It should load Joy app with your surgery logged in
Note: At this stage it is common to see an error message ☹ If this happens, please check the following:
You have a patient loaded in SystmOne
There are no typos or spaces in any of the fields
You have selected the correct format for the Date of Birth and NHS number fields
The order of the rows is correct
If it has worked continue below!
35. Go back into SystmOne and press OK
36. Find “Joy” in the list of “Available URLs & Programs”.
37. Right-click on the URL and select “Publish URL”.
38. Choose Publish System-wide - you want to publish this in as many GP surgeries as possible, this will mean they don’t need to complete these steps!
Congratulations! You have completed the first step of this implementation!