Differences

This shows you the differences between two versions of the page.

--- decimal_ordering_tool:userguide:userguide [2022/06/03 14:58] – [User Authentication] dpatenaude
+++ decimal_ordering_tool:userguide:userguide [2022/07/20 18:47] (current) – [Account Management] dpatenaude
@@ Line 3: / Line 3: @@
 ===== Overview =====
-decimal Ordering Tool (DOT) is used for selecting and ordering files to .decimal for manufacturing. The decimal Ordering Tool app allows users to specificy the file, order meta data, and place the order to [[https://direct.dotdecimal.com|decial Direct]].
+decimal Ordering Tool (DOT) is used for selecting and ordering files to .decimal for manufacturing. The decimal Ordering Tool app allows users to specificy the file, order meta data, and place the order to [[https://direct.dotdecimal.com|decimal Direct]].
 ===== Purpose =====
@@ Line 29: / Line 29: @@
 === Account Management ===
-decimal Ordering Tool site managers have the ability to [[https://direct.dotdecimal.com/guide#site-management|add and remove users]] to their site. When adding a new user an .decimal account will be created for the new user and automatically linked to the site. The user will then be notified to set their password following the .decimal password reset process. Removing a user from a site does not delete the user's .decimal account, but removes the account from the site, effectively removing all access to the site's apps, data, and device order history. Refer to the [[https://direct.dotdecimal.com/guide#site-management|decimal Direct User Guide]] for more information.
+decimal Ordering Tool site managers have the ability to [[direct:userguide#managing_users_on_your_site|add and remove users]] to their site. When adding a new user an .decimal account will be created for the new user and automatically linked to the site. The user will then be notified to set their password following the .decimal password reset process. Removing a user from a site does not delete the user's .decimal account, but removes the account from the site, effectively removing all access to the site's apps, data, and device order history. Refer to the [[direct:userguide|decimal Direct User Guide]] for more information.
 === User Sessions ===
@@ Line 39: / Line 39: @@
 === Inactivity Timeout ===
-decimal Ordering Tool has a built in inactivity timeout that will automatically log the user out if no mouse/keyboard activity has occurred. The timeout setting can be changed in the [[decimal_ordering_tool:userguide:tutorials:app_settings#app_settings|decimal Ordering Tool application settings]]. Idle workstation locking at the OS level is also recommended for all workstations with access to decimal Ordering Tool. While there are inactivity and session timeouts built into the application, workstation idle locking will further protect the system from unauthorized access in-between session timeouts.
+decimal Ordering Tool has a built in inactivity timeout that will automatically log the user out if no mouse/keyboard activity has occurred. The timeout setting can be changed in the [[decimal_ordering_tool:userguide:tutorials#application_settings|decimal Ordering Tool application settings]]. Idle workstation locking at the OS level is also recommended for all workstations with access to decimal Ordering Tool. While there are inactivity and session timeouts built into the application, workstation idle locking will further protect the system from unauthorized access in-between session timeouts.
 ==== Installation ====
@@ Line 54: / Line 54: @@
 ==== Release Management (decimal Launcher) ====
-FIXME
+The decimal Ordering Tool app is installed and launched from the [[decimalauncher:decimallauncher|decimal Launcher]]. The Launcher program provides the following functionality in regards to decimal Ordering Tool:
+  - Ensures that all users at a site are using the same version of the application
+  - Ensures that the local app client stays in sync with the latest release version (as set via decimal Direct)
+  - Provides user authentication and password management
+  - Provides binary file security to ensure that the application files are not tampered with on .decimal's server or on client workstations (via hashes and checksums). Refer to [[decimalauncher:decimallauncher#application_security|decimal Launcher's Application Security]] page for further details.
+When an application update is available via the decimal Launcher, the users will be required to install the app in the Launcher. This is accomplished by selecting the //Download// button for the specific app. Within a few minutes, the app should be downloaded and installed locally for the current user account. The user will then be able to launch the released app version from the Launcher.
-===== Application Usage =====
+Details regarding the specific requirements for computers on which the decimal Launcher and decimal eRT client applications will be installed can be found on the [[decimalauncher:decimallauncher#system_requirements|decimal Launcher System Requirements]] and [[decimal_ordering_tool:userguide:systemrequirements|decimal Ordering Tool System Requirements]] page.
-The following task descriptions are thorough guides providing complete information about each task within the decimal Ordering Tool application.
+=== Releasing a new App Version ===
-FIXME
+When a new application version of decimal Ordering Tool is released, users will be notified in the [[decimalauncher:decimallauncher#updating_applications|decimal Launcher]]. This notification serves only to notify users of a newer version of the application and does not result in a newer version being installed for use.
+Currently the decimal Ordering Tool does not store any data within the client workstation or network. So there is no requirement for clinical staff to ensure data forward compatibility prior to releasing a new update.
+Once a new app version is available, the application will be deployed to the decimal Launcher following the [[decimalauncher:decimallauncher#updating_applications|Updating Applications]] guide. This will immediately push the app update to all decimal Ordering Tool users (via the decimal Launcher) and all users will be required to update to the released version to continue using the software.
+=== Release Notes ===
+For the release notes for each version of the decimal Ordering Tool application, please refer to the [[decimal_ordering_tool:dot_versions|decimal Ordering Tool Version History]] page.
+===== Application Tutorials =====
+The following sections are thorough guides providing complete information about each task within the decimal Ordering Tool application.
+  * [[decimal_ordering_tool:userguide:tutorials#launching_the_application|Launching decimal Ordering Tool]]
+  * [[decimal_ordering_tool:userguide:tutorials#ordering_a_device|Ordering a Device]]
+    * [[decimal_ordering_tool:userguide:tutorials#order_information|Order Information]]
+    * [[decimal_ordering_tool:userguide:tutorials#placing_an_order|Placing an Order]]
+  * [[decimal_ordering_tool:userguide:tutorials#application_settings|App Settings]]
 ==== Keyboard and Mouse Controls ====
 The decimal Ordering Tool app utilizes keyboard shortcuts to help streamline many commonly used functions and display controls. A complete listing of these shortcuts along with a full description of the mouse controls is located at the [[decimal_ordering_tool:userguide:keyboard_controls| Keyboard and Mouse Controls page]].
+===== Application Data Management =====
+The decimal Ordering Tool application does not store any data on the local client workstations or end user network other than the calculation cache described below. As such, there is no need to perform data backups or guarantee data integrity for this application.
+==== Internet Data Transfer ====
+Since radiation therapy using .decimal requires frequent use of patient-specific devices that are fabricated within our facility, there is a necessity to transmit device manufacturing parameters and information to .decimal servers to all for fabrication of the custom devices. In order to protect patient privacy, .decimal's proprietary order file format contains only the minimal data necessary to manufacture each requested device. .decimal values the privacy of patients and security of our customer's sensitive information and we believe the best safeguard to protect critical data is to ensure it doesn’t leave your facility. As such, no PHI, PII, or any sensitive customer billing/payment information is contained in the order files sent to .decimal.
+<imgcaption internet_data_transfer|Internet Data Transfer>{{ :decimal_ordering_tool:userguide:dot_internet_data_transmission.png?400 |}}</imgcaption>
+Data is transferred to and from the decimal Direct servers using secure HTTPS transfer protocols that guarantee error-free transfer using common industry standard techniques. All data passed to and from .decimal's ordering servers is encrypted during transit and does not contain patient identifying data.
+==== Local Data Cache ====
+Currently the decimal Ordering Tool doesn't not utilize computationally intense calculations. So there is no need to use the local or shared network cache options within the application's settings.
 ===== Improper System Usage =====
@@ Line 83: / Line 123: @@
 </WRAP>|
+===== System Requirements =====
+Details regarding the specific requirements for computers on which the decimal Launcher and decimal eRT client applications will be installed can be found on the [[decimalauncher:decimallauncher#system_requirements|decimal Launcher System Requirements]] and [[decimal_ordering_tool:userguide:systemrequirements|decimal Ordering Tool System Requirements]] pages.