BP

DermEngine Integration for Best Practice

Introductions:

This page explains how to set-up the DermSync software to sync patient demography from the Best Practice software to DermEngine.

While using this software, patients opened on Best Practice will be transferred to the DermEngine platform. On DermEngine, images and lesions can be added to each patient. After the visit is over, you can also export a PDF report from DermEngine to Best Practice.

In order for DermSync to automatically receive updates and patches, Run from startup needs to be selected after the installation.

 

Requirements:

  • A Windows machine with Best Practice Software installed
  • The user needs to have permission to install DermSync
  • The database browser password is required to read patient data from the Best Practice database. This password can be set for the first time in Best Practice. From the menu bar at the top, select "Setup", then select "Configuration".
    bp1.png
    From the left side menu, select "Database". Click on the button "Database browser" to set the password.
    bp2.png


Installation Steps:

 

  1. Download the integration software installer (DermSync-setup.msi)

    For Windows
    DermSync-setup.msi
  2. Install DermSync on your machine (Default Folder: C:\Program Files (x86)\DermSync\).
    Users need to have write permissions on this folder.
    Note: We recommend installing DermSync for all users.

    allusers
  3. Double click to run the DermSync application.
    This step and following steps will need to be repeated for each computer user.
  4. Enter your DermEngine credentials including your email and either your password or access key.
    If you don't already have an account, visit https://app.dermengine.com/ or download the mobile app.
    To learn how to create an account click here. 

    DE-login.png
    The access key can be retrieved on DermEngine under the Account menu.
  5. Select "Best Practice" from the drop down list

    select-bp.png

  6. Enter the database password and the server name/IP for Best Practice.

    Password: Enter the database browser password set in Step 1 in the DermSync application.
    Server: If Best Practice is installed on the local machine, leave the server field empty. Otherwise, enter the IP address or name of the machine that Best Practice Server is installed on. The server name can be found under the Setup - Configuration screen where the database password is set.

    bp4-1.png

  7. From Settings, select Run from startup to ensure the application will restart after the computer reboots.
  8. Once you have successfully logged in, any patients opened with the clinical view on Best Practice will be available on your Patient List on DermEngine and the mobile apps.

Transfer Patients

Patients will be sent to DermEngine when the clinical visit starts.

clinical.png


By default, there is no filtering and all the patients will be sent to DermEngine. Patients can be filtered by appointment type (requires DermSync v2.5 or higher).
 
To filter by appointment:
  • On BP, add a new appointment. Select “Appointment type” from the list.

    bp-appt.png
  • On DermSync, click the application icon in Taskbar (by default at the bottom right of the screen).
    Select Settings and then Filter by Appointment Types

    bp-appt-filter.png
  • Select from the list, appointment types whose patients you would like to transfer to DermEngine.

    bp-appt-filter2.png
  • Patients who have had this appointment type before will be synced to BP when a new clinical visit starts.
 
To filter by Providers:
  • To filter the export based on the providers to limit the patients sent to DermEngine (by default all patients from all doctors will be transferred):
  • Click the application icon in Taskbar (by default the bottom right of the screen)
    Select settings and and then Filter by providers

    image-1
  • Select from the list, providers whose patients you would like to transfer to DermEngine:

    2
 

Import Timeline Reports to Best Practice:

Setup

  1. Create a folder that will be used for patient transfer files, and allow write access for any accounts using Best Practice.
  2. On the Best Practice Client, set up Results Import. From the menu bar at the top, select "Setup", then select "Configuration". From the left side menu, select "Results import".
    Check the box for "Import investigation results on this computer" and add the folder to the "Report file search paths".

    bp-timeline-setup.png


  3. On the Best Practice Server, run the BPLink utility to automatically check for results.
  4. Set up DermSync. Click on the taskbar icon, then select "Set up results import directory". Select the same path in DermSync.

    bp-timeline-menu.png

    bp-timeline-select.png


Export

  1. On DermEngine web, create a Timeline Report. Press the button to Print Report and export to Best Practice.

    bp-timeline-print.png



    DermSync will save the report to the selected folder. When Best Practice imports the report, the file will be deleted automatically.
  2. The report can be found in the patient's file, under Clinical > Unchecked reports and from the main screen, under View > Incoming Reports.
    With the BPLink utility, the folder will be synced every 5 minutes, or there is a button on Incoming Reports to refresh manually.
    Best Practice will notify that there are unchecked reports for the patients the next time the patient is open.

    bp-timeline-unchecked-notification.png

    bp-timeline-unchecked.png

    bp-timeline-report.png


  3. The doctor under the Addressed To column is the logged in doctor on DermEngine. The doctor under the Allocated to is set on BestPractice.

    timeline-doctor.png

Updates:

  1. When a new version of DermSync is available, the message below will pop up.
    By simply clicking "Update", DermSync will download the most recent version and restart.

    update
  2. If you are using DermSync v1.x, please make sure to first close the app by right clicking on the icon in the bottom right corner and selecting "Close". 

    bp5.pngbp6.png

FAQ:

Yes, DermSync needs to run on each computer that has connection to Best Practice server. Note that Best Practice configuration step (step #1) is only needed to be done once.
There is no limit on using DermEngine accounts simultaneously.
The only port that DermSync uses to communicate with DermEngine is 443 (HTTPS). In order for DermSync to work seamlessly, make sure all the connections through port 443 are allowed on the firewall settings.
Here is the list of hosts that DermSync needs access to:
  • https://app.dermengine.com
  • https://socket-au.dermengine.com
  • https://parse.dermengine.com
  • https://s3-ap-southeast-2.amazonaws.com
On DermEngine each doctor/provider needs to have their own account. For DermSync, any account can be used. On DermEngine, all patients are shared within the clinic, so they can all use one DermEngine account. However, it is important to note that this doctor will be listed as the patient's doctor. As a result, if the doctor wants the patients under their own account each DermSync needs to have the corresponding doctor's DermEngine account.
One way to test that you have reliable connection to Best Practice database is to:
    1. Open “ODBC Data Sources Administrator” - It should be installed on your machine by default.
    2. Add the database server using appropriate driver (SQL Server)
    3. Try testing the data source as below:
bp-odbc-test.png
The list of fields transferred is: First name, Last name, Date Of birth, Gender, Health number (Medicare), Address, City, Postal code, Phone number, Email, Ethnicity, Cancer history