LSMRemote cofigurable options (v4.0) - LabCollector

Knowledge Base

Search Knowledge Base by Keyword

LSMRemote cofigurable options (v4.0)

You are here:
← All Topics
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 a easy web/mobile interface of your Lab Service Manager for your client accessible through your URL.

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

Follow the steps below to configure different options in LSMRemote:-

1. Install LSMRemote and integrate into your website

2. LSMRemote configurable properties

1. Install LSMRemote and integrate into your website

2. LSMRemote configurable properties

  • Once the LSMRemote is installed you can configure various options by accessing the config.ini file.
    OS (C:) -> Program Files (x86) -> AgileBio -> LabCollector -> www -> your online instance name will be seen on a folder (click on that folder) -> extra_modules -> lsmremote -> config.ini
IMPORTANT: Always remember to take care that both LSMRemote & LSM are of the latest version. If you have a doubt, reinstall both of the add-ons from your client area. This is important for the correct functioning of both LSMremote and LSM. If the LSM and LSMRemote are not of the latest version, some of the below options might not work.

 

  • When you open the config.ini file you will various options whose functions are described below.
    *config.ini will open in a notepad
    * You need to save every change you make.

    1. title = none 19. jobs_order = DESC
    2. logo = ../../getLogo.php 20. hide_purchase_order = false
    3. color = none 21. purchase_order_helper_text = free text
    4. wsurl = [path]/ws/service.php?wsdl 22. recover_password_mode = none
    5. autogenerate_job_number = false 23. recover_password_text = free text
    6. autogenerate_sample_name = false 24. allow_register = true
    7. allow_quote = true 25. hide_submit_link = false
    8. hide_job_date = true 26. hide_user_name = true
    9. hide_expected_date = true 27. hide_priority = true *NEW v4.0
    10. report_html_button = true 28. repeat_job_button = false *NEW v4.0
    11. report_html_label = _default 29. release_partial_results = false *NEW v4.0
    12. report_pdf_button = true 30. grid_width_100 = false *NEW v4.0
    13. report_pdf_label = _default 31. default_lang = en *NEW v4.0
    14. report_files_button = true 32. token_access = false *NEW v4.0
    15. report_files_label = _default 33. security_parameter = none *NEW v4.0
    16. quote_pdf_button = true 34. provider_login_title = _default *NEW v4.0
    17. quote_pdf_label = _default 35. patient_login_title = _default *NEW v4.0
    18. grid_multiple_samples = true 36. grid_tests_mode = _default *NEW v4.0
    37. allow_patient_register = false *NEW
    38. category_tree = false *NEW
    *All the above options are explain in detailed below.

NO.  OPTION NAME DEFAULT VALUES DESCRIPTION VALID VALUES
1 Title none It will appear as a superscript above your logo in LSMRemote free text
 
2. logo none It will be the logo for your lsmremote website image URL
 
  • It will be the logo you add for the lsmremote website.
  • For the image on the computer, you can save the image inside the “img” folder in the lsmremote folder (path shown above). Then for the logo, you can add in front of the logo = img/name of the image.file type
  • For an image on a URL, just add the https://……..
  • *NOTE: Please use HTTPS for more secure protocols.

 

 3.  color none Optional background-color web color
 
  • To see which colors you can put, check this link & scroll down to the table of RGB colors.
  • You can either put the color name. *Remember not to put spaces between the name (lightblue NOT light blue).
  • You can also put the color code with the hashtag
  • After logging in the lsmremote you will see the color like below:

 4. wsurl none  connection to LSM add-on web color
 
  • This option will connect your LSMRemote to your LSM (Lab Service Manager) add-on.
  • It is an important step during the installation of LSMRemote.
  • *Please check our KB on how to install LSMRemote.

5 autogenerate_job_number true  connected to the generation of job number true | false
 
  • The job number is generated when you submit a job. * Read our KB on how to submit a job.
  • If “false” then the Job Number field is displayed in the form (the user can enter manually a text or leave it blank to autogenerate.)
  • If “true” then the Job Number field is not displayed, so it always is generated automatically after the job is submitted.

6 autogenerate_sample_name true  connected to the generation of sample name true | false
 
  • If “false”, a ‘Sample name’ field is displayed in the form (the user can enter manually a text or leave it blank to autogenerate.)
  • If “true” ‘Sample name’ field is generated automatically after the job is submitted.

7 allow_quote false  connected to the creation of a quote true | false
 
  • If “false”, the job status will be seen as requested and no quote will be present.
  • If “true” then the job status will be visible as quote & quoted. (a new Boolean field is added to the form, to allow order just a quote instead of a job.)


8 hide_job_date true  connected to the job date  true | false
 
  • If “false”, the job date is displayed
  • If “true” then the job date is not displayed.

9 hide_expected_date true  connected to the expected date of job finishing true | false
 
  • If “false”, the expected date is displayed. The expected date is when the job needs to be finished.
  • If “true” then the expected date is not displayed.

10 report_html_button Obsolete functions. Please delete them in case you find them in your config.ini file
11 report_html_label
12 report_pdf_button true  connected to the report button for results true | false
 
  • If “false”, the report button is displayed. This button will show the result report of a finished (validated) job in LSM add-on.
  • If “true” the report button is not displayed.

13 report_pdf_label _default  connected to the report button label text _default | free text
 
  • If “_default”, the report pdf button shows “report” text.
  • If “free text” the report pdf button shows pre-configured text. As in the below image.

14 report_files_button true  connected to the attached files with results true | false
 
  • If “false”, the file button is not displayed. These files can be image files or pdf, etc that are attached before finishing the job in the LSM add-on.
  • If “true” the file button is displayed.

15 report_files_label _default  connected to the attached files with the results button text _default | free text
 
  • If “_default”, the file button shows text “files”
  • If “free text” the file button shows the text pre-configured text as below.

16 quote_pdf_button true  connected to the quote button true | false
 
  • If “false”, the quote button is not displayed.
  • If “true” then the quote button is displayed.

17 quote_pdf_label _default  connected to the text on the quote button _default | free text
 
  • If “_default”, the quote button shows the text “Quote”
  • If “free text” then the quote button shows the pre-configured text, like in the below example image.

18 grid_multiple_samples false  connected to the number of samples/job true | false
 
  • If “false”, only one sample per job is supported and the grid of sample data is not visible like in the “true” situation.
  • If “true” many samples per job are supported, like in the example image below.

19 Jobs_order DESC  connected to the number of samples/job DESC | ASC
 
  • If “ASC”, jobs are arranged from low to high
  • If “DESC” jobs are arranged from high to low

20 hide_purchase_order true  connected to ‘purchase order’ option true | false
 
  • If “false”, Purchase order option appears
  • If the “true” Purchase order option disappears

IMPORTANT:

The purchase order option will not show in either true/false property if it is not selected in the LSM ADD-ON -> ADMIN -> PREFERENCES -> COSTS -> PAYMENT MODE 
       

21 purchase_order_helper_text free text  connected to helper text of purchase order free text
 
  • You can add the text as you prefer.

22 recover_password_mode none  connected to recover password option mail | text | none
 
  • If “none”, the “forgot your password” option doesn’t appear
  • If “mail” the password will be recovered by email
  • If “text” the password can be recovered by contacting your administrator

23 recover_password_text text  connected to recover password option text text
 
  • If “text”, the password text can be changed as per your choice, for example, like below.

24 allow_register true  connected to register option true | false
 
  • If “true”, the register option appears
  • If “false” the register option doesn’t appear

25 hide_submit_link false  connected to ‘submit order’ option for job true | false
 
  • If “true”, the submit order button does not appear
  • If “false” the submit order button appears

26 hide_user_name false  connected to user name for a job true | false
 
  • If “true”, then the ‘User’ option won’t appear under the requester name.
  • If “false”, then if a user adds a test to an existing job (via the Workflow Manager for example) then the user’s name option will appear under the Requester name.

  • *NOTE: In relation to the user name option that allows you to add samples from workflow add-on, for example, you can also add a sample to existing jobs in LSMRemote.
    You can use the link below and add (append) the samples to an existing job. You just need to modify your URL (orange part) like below.
    https://your online instance name/extra_modules/lsmremote/addfromlc.php?append=1&jobNumber=JOB-106
27 hide_priority false  connected to the priority option for a job. true | false
 
  • If “true”, then the option of ‘priority level’ won’t appear under the requester name.
  • If “false” then in a case where the user adds a test to an existing job (via the Workflow Manager for example) then the user’s name will appear under the Requester name.

28 repeat_job_button true  connected to repeating a job true | false
 
  • If “true”, then the repeat option will be seen, which allows you to repeat a certain job. You can also add more samples while repeating the same job.
  • If “false” then the repeat option will not be seen.

29 release_partial_results true  connected to a job with multiple samples true | false
 
  •  If “true”, then the job info option will appear. If a job has multiple samples then it will show the number of samples validated/total number of samples. Also, you will be able to download the report of samples whose job is ‘Validated“.
  • (*This option makes sense in jobs with multiple samples, the provider does not have to wait until the full job is finished, he can access a report of validated samples meanwhile and also notice the job is still In progress, with the button report still visible)
  • If “false” then the repeat option will not be seen.

 

30 grid_width_100 true  connected to a job with multiple samples true | false
 
  • If “true”, then the “submit order” & “Get results” page will adjust its width to 100% (meaning it will fit the page width.)
  • If “false” then the pages will be of default width.

31 default_lang en  connected to the language of lsmremote language initials
 
  • You can see the language initials on the homepage of LSMRemote. (like in the below image in red)

32 token_access true  connected to the token for patients to access the report true | false
 
  • If “True” you can see the token access option on the login page where the patients can have direct access to their report, by accessing the token number.
  • *This is a convenient option for patients who want to see their report directly, instead of waiting or visiting the hospital or test lab.
  • If “False” you cannot see the token access option.
  • *Please read our KB to see how to activate the report access portal. Section 3

33 security_parameter none  connected to the access for login none | any sample custom parameter
 
  •  If “None” you can only see the token access option and no other security parameter.
  • 1. To have a security parameter, you need to go to LSM ADD-ON-> ADMIN ->PREFERENCES ->PARAMETERS ->LEVEL SAMPLE & create the parameter as per your requirement.
  • 2. Add the same name in the config.ini file under the security parameter option and save the file.
  • 3. Access the lsmremote login page and you will be able to see the newly made security parameter.
    *Remember that this security parameter will also be present while filling the “submit order” form, under the sample data section.

34 provider_login_title _default  connected to the access for login _default | free text
 
  • If “_default” you can see on the login page “Providers portal”
  • OR you can add your lab name as a free text.

35 patient_login_title None  connected to the access for login none | free text
 
  • If “none” you can see on ht login page “Direct Report Access”
  • If “free text” you can add the heading for the login page for the token as you want.

36 grid_tests_mode _default  connected to the test mode _default | checkboxes
 
  • LSM and LSM remote have 3 modes for tests. When you go to LSMREMOTE -> SUBMIT ORDER -> SAMPLE DATA -> ASSIGN TESTS

  • Category grid mode allows you to select a test in a small pop-up.
  • Test grid mode, allows you to select tests in the form of checkboxes.

  • When you add the “_default’ option in config.ini then you will see a pop-up to search the test.
  • When you add the “checkboxes” option then you will see the tests related to samples in the form of small checkboxes. 

 

37 allow_patient_register  false  connected to the case record in LSM true | false
 
    • If “True” you can see the Patient pre-register option on the login page where the patients can register themselves before going to the clinic for giving blood, urine, swab, etc samples. in connection to token access option. See point 32 above.
    • If “False” you cannot see the Patient pre-register option.

    • When you click on pre-register, for example the patients can register themselves before going to the clinic to give the sample.
      *Below is just an example to show you. 

    • The information entered in the above form will be seen in the custom module, for example the Patients module created in LabCollector.

    • The fields in pre-register form will be the ones that you will in the LSM create job and add case record. (LSM -> CREATE JOB -> CREATE NEW CASE RECORD)
      *Remember your case record option in LSM needs to be activated before LSM -> ADMIN -> SETUP -> CASE RECORD. Please see our KB to activate case record.
    • When you type the name, in this case the example name is 47 you will see the case record in your list.
    39 category_tree  false  connected to the test categories in LSM true | false
     
        • While submitting order you can add samples and the tests that you need to perform on those samples.
        • In point 36 above, we could previous see the test in a grid or checkbox format.
        • For better representation and easy searching we have the option of “tree” format where the tests will be displayed in the tree hierarchy format.

       

      Related topics: