decimal App Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Sandbox Testing ======

decimal eRT provides a Sandbox isolated testing environment for evaluation of new application versions on non-clinical patient data. This testing mode is recommended to evaluate new release versions of the application prior to distribution to a site and it's users. The physics team at each site should evaluate all new application versions in the Sandbox environment to determine clinical acceptability of the new version following the all industry regulations and professional guidelines as well as the decimal eRT [[electronrt:instructions_for_use:instructions_for_use#clinical_safety| Instructions for Use]] (including but not limited to: comparison of plan dose, device design, QA, etc). Once the application version is deemed clinically acceptable by testing it in the Sandbox environment, the version can then be deployed for use by clinical staff.

Clinical data can be optionally copied into the Sandbox environment (see the [[electronrt:userguide:tutorials:all_tutorials#configuring_clinical_data_for_sandbox|Configuring Clinical Data for Sandbox]] section) or users can choose to start the Sandbox environment with no preexisting data.

The patient data storage and database for the Sandbox environment is completely isolated from the Clinical data. Any changes made within the decimal eRT application while in Sandbox mode will not transfer to the Clinical patient data (and vise versa, updates to Clinical data will not impact Sandbox data).

When in Sandbox mode, users will have full access to all application options as they are available to the user in the Clinical mode.

<WRAP center round info 60%>
**Note:**\\ The Sandbox feature is accessible only for users with Elevated Physics access or higher.
</WRAP>


===== Configuring Clinical Data for Sandbox =====

Users have the option to set Clinical patients for use in the Sandbox testing environment. When in the Clinical app privileged users can toggle on the advanced Patient Search option to Configure Sandbox Patients (shown in <imgref sandbox_patient_config> at #1). When this option is toggled on each patient in the filtered display can be set to Use for Sandbox (shown in <imgref sandbox_patient_config> at #2). Patients with this option set will automatically be imported into new Sandbox environments. 

If no patients have been configured for use with the Sandbox environment an empty Sandbox environment will be created with only the site configuration.

<imgcaption sandbox_patient_config|Use Patient in Sandbox>{{ :electronrt:userguide:tutorials:sandbox_clinical_config.png?direct&400 |}}</imgcaption>

===== Installing the Sandbox Version =====

Refer to the [[decimalauncher:decimallauncher#sandbox_mode|decimal Launcher Sandbox User Guide]] for installing an app version to the Sandbox environment. 

===== Running Sandbox Testing =====

When the decimal eRT application is opened in Sandbox mode the application heading will be Orange and contain a warning that the user is in the Sandbox Testing Environment. This is to ensure there is no confusion to the user about which environment the application is in.

<imgcaption sandbox_warnning|Sandbox UI Warning>{{ :electronrt:userguide:tutorials:sandbox_ui.png?direct&400 |}}</imgcaption>

==== First Time Sandbox Use ====

The first time the Sandbox environment is created the Clinical site data will be imported into the Sandbox data store. Then any clinical patients flagged for 'Use in Sandbox' will be copied into the sandbox data store. The patients, courses, and plans will be copied to the sandbox environment exactly as they were last modified/approved in the clinical environment.

<imgcaption sandbox_import|Sandbox Initial Setup>{{ :electronrt:userguide:tutorials:sandbox_setting_up.png?direct&400 |}}</imgcaption>

==== Consecutive Sandbox Use ====

The next time decimal eRT in Sandbox mode is used the application will detect an existing sandbox installation and will prompt the user for how to proceed:
  - **Use the existing sandbox:**
    - The existing sandbox environment will be used exactly how the user last left it
  - **Make new sandbox:**
    - This will completely wipe the existing sandbox environment and reimport the Clinical data following the [[electronrt:userguide:tutorials:all_tutorials#first_time_sandbox_use|First Time Sandbox Use]] process.
    - Note: This step can not be undone and all sandbox data will be completely removed. Ensure to manually [[electronrt:instructions_for_use:instructions_for_use#data_duplication_or_backup|backup your patient data]] prior to performing this action if you believe you may need the previous sandbox environment.