I don't have the 'PATCHS SystmOne Agent' icon on my Gateway machine desktop
In many cases the PATCHS SystmOne Agent will have been deployed to your Gateway machine by your local IT team. If this is the case please check with the IT team.
Otherwise, please see Installing and running the PATCHS SystmOne Agent on your TPP Gateway Machine for the download link. You will need administrator access on your Gateway machine to install the agent.
Where do I download the SystmOne settings file?
To download the settings file:
- log in to PATCHS (you must have PATCHS Admin permissions)
- click on your name at the top-right of the screen and select 'Edit Practice' from the dropdown
- Go to the 'TPP Installation' tab
- Click 'Generate new config file'
- Enter the Windows username that you use to log into the Gateway machine
- Click 'Generate'
This will download a file, called 'agent.yml' to your Downloads folder
When I run the PATCHS SystmOne Agent I get an error message
The most common error you might see when starting the PATCHS SystmOne Agent for the first time is shown in the screenshot below:
In this case the error is because the agent cannot find the settings file you downloaded (please see Installing and running the PATCHS SystmOne Agent on your TPP Gateway Machine step 3). To fix this, do the following:
- Delete any existing 'agent.yml' files in your Downloads directory
- Generate and download the settings file in PATCHS
- Copy the file to your user home folder as shown here:
- Close and re-open the PATCHS SystmOne Agent
The 'Device Approval' pop-up in SystmOne does not give me the option to approve the connection
If you see the 'Device Approval' pop-up in SystmOne but it doesn't have an option to 'Approve', this is because your current user doesn't have permission to approve devices. To solve this, please:
- Log in to SystmOne as a user with administrative permissions
- Go to Setup -> Mobile Working & Integration > Device Manager
- Look in the 'Waiting for Approval' or 'Blocked' folders for a device called 'PATCHS' and mark it as approved
When a patient is registered they are shown as 'Not Known'
If a patient is shown with a yellow question mark (see below) this means they have not yet been matched against the clinical system.
If you click on the patient and see 'Searching for patient in clinical system' (see below) if PATCHS cannot connect to the clinical system to check the record.
To fix this issue, please check the following:
- Check that there is a green 'tick' in at the top of the page in PATCHS.
If you see a cross or do not see a tick, please check that your Gateway machine is switched on, the PATCHS SystmOne Agent is running, and SystmOne is logged in on the Gateway machine. - Check that the user logged into SystmOne on the Gateway machine has 'Retrieves Patients' and 'Saves Records' in the Local Access Rights setting in SystmOne (please see video below)
- Check that the user on SystmOne has not blocked PATCHS. On the Gateway machine, in SystmOne go to 'Setup' > 'Mobile Working & Integration' > 'Device Manager' and check the 'Blocked' folder to make sure that PATCHS does not appear
Once you have checked the above, you can trigger another lookup by adding the patient's NHS number and clicking 'Update'.
If you have already added an NHS number, you can also trigger another lookup by clicking the 'Refresh' button next to 'Searching for patient in clinical system...'
Patient requests are not being filed to the record
- Check that there is a green 'tick' in at the top of the page in PATCHS.
If you see a cross or do not see a tick, please check that your Gateway machine is switched on, the PATCHS SystmOne Agent is running, and SystmOne is logged in on the Gateway machine. - Check that the request is from a patient who has been matched with SystmOne. You can tell this because you will see the following two options when you come to save the request:
PATCHS will only save the request directly to the clinical system if you click 'Complete message & save to clinical system' - Check for any error messages. Some common error messages are shown below in the 'When I try to save a request to the record I see an error message' section.
- Close PATCHS SystmOne Agent on the gateway machine and open it again.
When I try to save a request to the record I see an error message
The solution depends on which error message is displayed. Some common error messages are shown below.
The user currently logged into to SystmOne has blocked the PATCHS connection. Please approve the PATCHS connection in Device Manager in SystmOne
This means that the user who is logged into SystmOne on the Gateway machine has blocked PATCHS. On the Gateway machine, in SystmOne go to 'Setup' > 'Mobile Working & Integration' > 'Device Manager' and check the 'Blocked' folder to make sure that PATCHS does not appear. If it does appear in the 'Blocked' folder, right click on the PATCHS entry and click 'Approve Device'. Then select 'Yes' when prompted.
The user currently logged in to SystmOne on the gateway machine does not have permission to read the patient record. Please amend the user's permissions in SystmOne and try again
This means that the user currently logged into SystmOne on the Gateway machine does not have 'Retrieves Patients' and 'Saves Records' in the Local Access Rights setting in SystmOne. To fix this, the user must be given these permissions in SystmOne (please see video below):
Could not connect to SystmOne. Please check that the PATCHS SystmOne Agent is running and SystmOne is logged in on your Gateway machine
This means that SystmOne is not running and logged in on your Gateway machine. Please log into your Gateway machine, start SystmOne and log into it.
The connection between PATCHS and SystmOne keeps dropping
- Please check that someone is always logged in to your Gateway machine and is logged in to SystmOne
- Please check that no one is accidentally closing the PATCHS SystmOne Agent software
- Please check your Gateway machine's hiberation/sleep settings, as follows:
- Search for 'Power & sleep settings' in the Windows search bar and click on it
- Go to the 'Sleep' section and ensure that 'When plugged in, PC goes to sleep after' is set to 'Never'
- Search for 'Power & sleep settings' in the Windows search bar and click on it