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".
  • If you are using BP Indigo or a previous version to BP Indigo, click on the button "Database browser" to set the password. You will enter this password into DermSync's database settings window.
    bp-database-select-1
    Alternatively, if you are using BP Jade or a version of BP after Jade, you will need to click  'Setup third-party integrations' and then from the window that appears select 'MetaOptima (DermEngine)'setup third party-1
    (for version BP Jade and after)save third party

Installation Steps:

  1. On the server* computer, download the integration software (DermSync)
    For Windows
    DermSync-setup-service.msi
    *Not compatible with terminal servers
    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. You will be prompted to fill in database settings (this window can also be found through DermSync by clicking Settings > Database settings through the menu)
    There are two differences based on what version of BP you are using but in both cases you will enter the server name which will include the IP address or name of the machine that Best Practice Server is installed on. If Best Practice is installed on the local machine, server name will be (local)\BPSINSTANCE. The server name can also be found in BP under Setup > Configuration 

    Additionally, for BP versions Indigo or before:
    • Select 'BP Indigo or before' at the top.
      Password: Enter the database browser password set in the DermSync application.bp indigo

    For BP versions Jade or after:
    • Have 'BP Jade or after' selected at the top.bp jade
  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 every 5 minutes.
  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. After this, there are two different ways you can import reports exported from DermEngine to your selected folder.
    • One way is to have 'BPLink' utility running. This utility will check every 5 minutes to see if there are any reports in the folder you set previously (under 'Report file search paths') and if found will import them into Best Practice and remove them from the folder.
    • Alternatively, to avoid waiting, you can manually import reports from your selected folder by selecting View > Incoming Reports from the main Best Practice screen. This will force an import of any reports found in the folder that you set.

      incoming_reportsHere you will find that the doctor under the 'Addressed To' column is the logged in doctor on DermEngine. The doctor under 'Allocated To' is set on BestPractice.
      timeline-doctor
  3. Best Practice will notify that there are unchecked reports for the patients the next time the patient is open. When you open a patient and they have unchecked reports, you will see it indicated to you as below:bp-timeline-unchecked-notification
  4. Next, the report can be found in the patient's file, under Clinical > Unchecked reports.

    bp-timeline-unchecked

    bp-timeline-report

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:

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