LSMRemote installation steps & Integration into the website ? (v4.0)

SUMMARY:

For test labs that receive a request to perform tests (jobs) on a sample from a requester (clinic, hospital, etc), our Lab Service Management (LSM) add-on is the best option. However, to make the process easier we offer our utility LSMRemote which helps both you and the requester. LSMRemote application can be integrated into the website of the requester (clinic, hospital, etc).

LSMremote is an easy web/mobile interface of your Lab Service Manager for your client accessible through your own URL.

This makes it easier for the requester to send and view job requests, results, and reports.

Follow the steps below to install LSMRemote:-

1. Download & install LSMRemote

• Renaming the config_install.ini file
• Updating the wsurl option in config.ini
• Enabling the extension in php.ini file

2. Integrate LSMRemote into your website 

3. Activating report access portal

4. LSMRemote configurable properties

1. Download & install LSMRemote

• To install LSM remote, you can do it directly from your Client Area.
• Once you are in the Client Area, go to DOWNLOADS -> SELECT YOUR LABCOLLECTOR VERSION -> LSMREMOTE
  * Take care to download the LSMRemote according to your LabCollector version.
  
• When you click on the download button, a zip file will be downloaded.
• Extract the zip files contents into the LabCollector installation folder in extra modules.
  (For windows go to OS (C:)->Program Files (x86) ->AgileBio ->LabCollector -> www->your online instance name will be seen on a folder (click on that folder) ->extra_modules (however as LSMRemote can be integrated in you hosting websites you can go to your preferred web hosting provider)
• After this, you need to follow 3 steps, before trying to open the LSMremote:

• 1. Renaming the config_install.ini file

• • Once you have extracted the files, open the installation -> extra modules folder on your computer and click on the LSMremote folder inside extra modules. (however as LSMRemote can be integrated in you hosting websites you can go to your preferred web hosting provider)
    
  • (For windows go to OS (C:) -> Program Files (x86) -> AgileBio -> LabCollector -> www -> your online instance name will be seen on the name of the folder (click on that folder) -> extra_modules -> lsmremote -> config.ini
  • When you open the LSMremote folder search for the file named config_install.ini and rename it to config.ini (.ini is the initiation/configuration file)
    
    

• 2. Updating the wsurl option in config.ini

• • Once you have renamed the config.install.ini file, open the config.ini file (it will open in notepad format).
  • You will see many options, edit the option wsurl = http://xxxxxxxxxxxxxxxxxxxxxxxxx/extra_modules/lsm/ws/service.php?wsdl  by inserting the name of your online instance.
    (however as LSMRemote can be integrated in you hosting websites you can go to your preferred web hosting provider)
    
  • Do Ctrl+S to save the changes made in config.ini file. (*if it asks you for admin permission then you need to have the admin access to save corrections in this file)

• 3. Enabling the extension in php.ini file

• • After the second step, you have to make sure that one of the extensions in the PHP folder is enabled in the php.ini file.
     *Generally, this extension is enabled, but if it is not enabled, you need to enable it by following the explained process.
  • You can choose to perform this step by either way by going to the PHP file in LSMRemote installation folder or editing it from LabCollector server Manager.
    *Please see our KB on how to activate soap extension.

• Now go to your online instance and click on the LSM add-on. You will see this line in your browser URL. Edit the line and add remote in front of LSM and hit enter.
  
• Finally, the login page will open like below, where you can register or login to LSMRemote.

*If the login page doesn’t open, please make sure you have the latest PHP version on your LabCollector Server Manager. 

*Please read our KB on how to log in and register into LSMremote.

2. Integrate LSMRemote into your website

• As explained in the start, LSM is an add-on for test/service labs.
• here you can perform tests on samples.
• These tests or samples can be given to you by clinic or hospitals or patients directly (Requesters).
• These requesters can use the LSMRemote add-on and integrate it into their website to easily keep track of all the jobs(tests) and get reports, etc.
• To integrate LSMRemote into one’s website you need to insert the LSMremote application in a WordPress page, copy this code in the HTML content:

  <script type="text/javascript" src="[path]js/iframeResizer.min.js"></script>
  <iframe width="100%" src="[URL]" frameborder="0" scrolling="auto"
         onload="javascript:iFrameResize({heightCalculationMethod: 'taggedElement'});"></iframe>
  

  * IMPORTANT: Replace [path] in the above code by the app URL. (for example, http://www.mydomain.com/lab/extra_modules/lsmremote)
  (however as LSMRemote can be integrated in you hosting websites you can go to your preferred web hosting provider)
  

• For example, we integrated LSMRemote connected to the above mentioned URL in image above section 2 in our WordPress page using HTML & CSS.
  *The other HTML/CSS  elements that you see are used to style and format the page of our WordPress. It is not necessary to do the same for you. You can adapt as per your requirements.
  
• When we access the link (permalink in the above image), we see the LSMRemote on our website the below way.
  *NOTE: This is just an example, to show you how LSMRemote looks when it is integrated into the website.
  

3. Activating report access portal

• Once you have integrated the LSMRemote website you can also have a portal, for example, patients to directly access their test report.
• This setting can be configured in the config.ini file and please read our KB on configurable options in config.ini to activate this report access portal. (point 32 in the KB link)
  See section one to access the config.ini file.
  When you change the values for token access as true or false, you will see the below option.
  
• This is a convenient option for patients who want to see their report directly, instead of waiting for or visiting the hospital or test lab
• This token is automatically generated when the Job is submitted in LSMRemote, for example you will see it like this.
  * Read our KB on how to submit a job and create a Chain of Custody report.
  
• When you access the report by adding the token number; three things can happen.
    1. If your report is ready it will show a pdf button where you can download your result file.
      2. if your report is not ready it will show you the respective message.
  3. If you have entered a wrong token number then it will show that the token doesn’t exist.
  
• Let’s say that you want to separate the login pages for the “Direct report access” login option from the “provider portal” on separate webpages.
• LabCollectcor allows you to do so. All you have to do is add either login=1 or login=2 at the end of the URL.
• This way you have a different individual webpage for provider and direct report access login pages. 

4. LSMRemote configurable properties

• You can configure LSMRemote as per your requirements.
• For such purposes, LSMRemote offers various options with the help of config.ini file options.
• You can use all the options in the config.ini (explained in section 2 above) to configure your LSMRemote as per your requirements.
• For example, you can configure the LSMRemote to have the “Direct report access” option where the patients can directly add their token number and access their test report.
  *Please check our KB to see LSMRemote configurable options.
• Another example, is you can configure ancestors_domains in config.ini: this directive specifies which domains are permitted to embed your LSMRemote interface using HTML iframes. This security measure helps prevent unauthorized embedding of your application on external site.
  • To allow embedding on any subdomain of example.com: ancestors_domains = *.example.com

   

Related topics:

• Read our KB on how to register/login and see options in LSMRemote.
• Check our KB on LSMremote config.ini.
• Check ou KB on LSMremote configurable options.