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. On the server computer, download the integration software (DermSync)
    For Windows
    DermSync-setup-service.msi

    For Windows
    DermSync-setup.msi
    Learn about the differences by clicking here
     
  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.
  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
    The access key can be retrieved on DermEngine under the Account menu.
  5. Select "Best Practice" from the drop down list

    select-bp-1

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

    Password: Enter the database browser password set 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.

Best Practice Clinical View


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 
  • 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-settings-filter-appt
  • Select from the list, appointment types whose patients you would like to transfer to DermEngine.
      
    AppointmentFilter 
  • Patients who have had this appointment type at their most recent appointment will be synced when a new clinical visit starts.
 
To filter by Providers:
  • Filtering the export based on the providers limits 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"

    BP-settings-filter-providers 
  • Select from the list, providers whose patients you would like to transfer to DermEngine:
      
    ProviderFilter

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 Best Practice, 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


  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 "DermEngine report import directory". Select the same path in DermSync.

    BP-import-reports

    bp-timeline-select

Export

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

    bp-timeline-print

    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

    bp-timeline-unchecked

    bp-timeline-report


  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

Updating DermSync:

  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:

No, DermSync should be set up only on the server computer. For DermSync versions before 2.7, DermSync needs to run on each computer that has connection to Best Practice server.
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://dermsync-updates.dermengine.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