How the SystmOne Integration works

Most of Patchs is accessed entirely through the browser, with no installation required. Integration with SystmOne, however, requires a small application. This is called an 'agent'. The agent needs to be installed and run on the TPP Gateway machine for your practice.

What the agent does is allow Patchs servers to communicate with your SystmOne instance, so that your practice can match patients and save Patchs requests to SystmOne.

Setting up the integration

1. [Administrator access required] Install the Patchs SystmOne Agent software on the TPP Gateway machine

Note: Often this step will have already been done by your IT team. If you have a desktop shortcut called 'Patchs SystmOne Agent' on your Gateway machine's desktop, then you already have the agent installed and can proceed to Step 2.

1. Log into your gateway machine as the TPP user (this is the Windows user that you use to run SystmOne). It often has a name like 'TPP.[your practice code]'.
2. Check that you do not already have the agent installed. Look for a shortcut called 'Patchs SystmOne Agent' on your desktop:
   
   If you already have this shortcut you can skip straight to '2. Set up your practice on Patchs' below.
3. Download the agent software from: https://patchs-public.s3.eu-west-2.amazonaws.com/installers/tpp/PATCHS+SystmOne+Agent+2.0.2.msi 
4. Install the agent software.
5. Ensure that any firewalls are set up to allow outgoing connections to *.patchs.ai on port 443.
6. Ensure any antivirus software is set to allow the agent software (if it doesn't already).

2. Set up your practice on Patchs

If you haven't already done so, use the links sent to you during your onboarding process to set up your practice on Patchs. See the other articles in this section for further information on this.

3a. Download the SystmOne configuration file (automatically)

Setting up Patchs on your Gateway machine can be completed by following these steps:

1. Log into your gateway machine as the TPP user (this is the Windows user that you use to run SystmOne). It often has a name like 'TPP.[your practice code]'.
2. Log into Patchs. Then visit the Practice Details page (see Practice Details for more information).
3. Click on the 'TPP Installation' tab.
4. From the 'TPP Gateway Machine Config' section, click the 'Set up Patchs on your Gateway machine' button.
5. 
   
   
6. After a few seconds a black screen should appear with the words "Patchs SystmOne Agent connected! Listening for requests..."
   
7. You can now minimise this window. It will run in the background, and must be kept running for the SystmOne integration to work.
8. You should then proceed to Step 6.

If this doesn't work, you should continue to set up the SystmOne Agent manually:

3b. Download the SystmOne configuration file (manually)

1. Log into your gateway machine as the TPP user (this is the Windows user that you use to run SystmOne). It often has a name like 'TPP.[your practice code]'.
2. Log in to Patchs, and visit the Practice Details page (see Practice Details for more information).
3. Click on the 'TPP Installation' tab.
4. Under the 'TPP Gateway Machine Config' section, click the 'Generate new config file' button.
   
   
   
5. In the window that pops up, enter the username of the TPP user on the gateway machine. This is the user you logged in as in step 1.
   
   
   
6. Click 'Generate'. This will download a configuration file called 'agent.yml' to your Downloads folder.
7. a) If you use a generic windows user on your Gateway machine Move this file to the user's home folder (C:\Users\[username of generic user]\agent.yml).
   b) If you do not use a generic windows user on your Gateway machine Ask your IT support desk to move the file to C:\Program Files\PATCHS\agent.yml (requires Admin permissions).
   

4. Set the SystmOne Agent to start when you login to your computer

1. Find 'Patchs SystmOne Agent' on your desktop, right-click and select Copy:

2. Press the Windows logo key + R, then type shell:startup, then select OK. This opens the Startup folder.

3. Right-click in the Startup folder and select Paste:

5. Start the agent software

1. The agent software will start on login, but if it doesn't start you can start it manually by searching 'Patchs SystmOne Agent' in the Windows search bar.
2. If everything is working, the software will show a black window which says "Listening for requests...", like the screenshot below:
   
3. You can now minimise this window. It will run in the background, and must be kept running for the SystmOne integration to work.

6. Ensure the user logged into SystmOne has the correct Local Access Rights

1. All users who log in to the Gateway machine need to have Local Access Rights in SystmOne to 'Retrieves Patients' and 'Saves Records'. To check this, please see the video below:
   

7. Make a test request and approve the Patchs connection

1. On Patchs, register an example patient (the patient does not need to exist in your clinical system)
2. Log in to your TPP Gateway machine and go to SystmOne. SystmOne will ask you to approve the connection with Patchs. You must approve the connection for the integration to work.
3. Log in to Patchs as a staff user, go to the Patients tab and find the test patient that you just registered. You may see a warning like the one below:
   If so, click 'Try again'
4. After a few seconds it should show a message saying either:
   1. 'Patient not found' (if the test patient does not exist in your clinical system)
      
   2. 'Name and DoB, or NHS Number matched' (if the patient does exist in your clinical system)
      
5. The SystmOne integration is now successfully connected.

Best Practices and Troubleshooting

For more troubleshooting tips, please see Troubleshooting SystmOne

• For Patchs to work with SystmOne correctly, the SystmOne Agent software must be running at all times. The Windows user running the SystmOne Agent should be left logged in (can be locked). If another user needs to log in to the TPP Gateway, they should use 'Switch User'.