JoyConnect Universal is currently in a closed pilot. Please do not follow these instructions unless you have been provided with this information and asked to do so. The information is currently provided for broader context and current msis are not linked.
Interested? Follow this link.
Installation / Permissions Process (Guide)
📌 Note: This guide should be followed by people with two sets of permissions:
The Organisation-level admins within the Microsoft Organisation the end-users of JCU will be part of
The individuals with admin rights to install software on the machines that JCU needs to be available on.
Microsoft Admin - Setting up Entra ID
Access the Admin Center - Administrators sign in to the Microsoft Entra admin center using an account with appropriate permissions (such as Cloud Application Administrator or Application Administrator)
Locate the Application - Navigate to Identity > Applications > Enterprise applications and search for JoyConnect Universal
Configure Single Sign-On - In the application's management page, they select "Single sign-on" from the left menu and choose the appropriate SSO method (typically SAML for many enterprise applications)
Set Up SAML Configuration - The administrator configures the SAML settings, including:
User Assignment Administrators assign users or groups to the application, granting them access via SSO or allowing all users to access.
Software rollout - Installing the widget
📌 Note: If you have any questions or issues please reach out to our technical team via your Customer Success manager.
This content is subject to change.
Joy is provided as an MSI comprised of its widget bundled with an auto-updater. We would recommend downloading and installing an older version to validate that the automated patch process is working.
Latest Version. (installation will update to this)
For a per-machine installation, execute the file with the following command:
msiexec /i JoyConnect.Installer.[installation_version].msi ALLUSERS=1
During the closed pilot there is an additional command parameter required to set location for the site.
An example of this in powershell would be:
<br style="box-sizing: border-box;">msiexec /i JoyConnectUniversal.Installer.1.0.2.msi POSTCODE='"SW1A 2AA"'
Please note that we do not support the use of Administrative Installation Images as they interfere with the automated patch process. We recommend that you download and execute the installer directly on the machine instead.
The patch process requires that the original msi installer is available at the location it was last executed (the windows installer cache is not enough!). We therefore recommend that you copy and execute the installer in a safe place on the user's harddrive. If this is not possible and you have to move/rename/delete the original installation file, it is your responsibility to provide a reliable alternative location, e.g. by specifying a persistent network location using the SOURCELIST attribute.
Sample powershell script for a machine wide installation:
# jcinstallation.ps1 - requires elevated privilleges to run
$msiName = 'JoyConnect.Installer.[installation_version].msi'
$outFile = "$env:SystemDrive\$msiName"
Start-BitsTransfer -Source https://builds.thejoyapp.com/joyconnect/installers/$msiName -Destination $outFile
msiexec /i $outFile ALLUSERS=1 /q
JoyConnect Universal Guide (End User)
Introduction
Welcome to the JoyConnect Universal installation guide! This guide will walk you through the steps needed to install the tool, ensuring you're set up for success. JoyConnect Universal is designed to help you easily connect patients with non-clinical care by referring them to local services and support options.
🕒Time required: The entire installation process should take no longer than 3–5 minutes.
Before you begin
Before starting the installation, make sure you have everything you need:
The download link (provided by the Joy team)
The computer where you’d like to install the tool
Your Microsoft login credentials
Installation Steps
Follow these steps to install JoyConnect Universal:
Step 1: Access the Installation Link
Open the installation link provided in your browser (e.g. Edge, Google Chrome, Internet Explorer)
The download should automatically start
Step 2: Download and Install
Go to your "Downloads" Folder and look for JoyConnect Universal file
Make a right click and select "Install" or double click on the file to start the installation process
A window should pop up with a loading bar. Once the loading bar is loaded the installation is completed
Step 3: Start JoyConnect Universal
JoyConnect Universal should be now visible in the task bar in the bottom of your screen
Once the installation is complete, log into your clinical system (if not already logged in)
Once you're logged in, JoyConnect Universal should appear as form of a pink button with a "+" on the bottom right-hand corner of your screen
Step 4: Test the Setup
Open JoyConnect Universal to verify that it’s working properly. You can do this by clicking on the pink Joy button. Once that's done the window should open.
Login with your Microsoft credentials to get started.
Once logged in, run a quick test referral to ensure everything is set up and ready to use
How to send a referral or signpost?
Enter an NHS number (this can be a fake patient)
Once the patient is loaded, click on a service
Scroll down on the details and click on "refer"
Fill out any missing information in the referral form and click on "Send referral"
You should then receive a confirmation screen
Finally, you can click on the "Copy" button to copy and paste the information into your clinical system (if you have one).