====== decimal Ordering Tool User Guide ======

===== 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|decimal Direct]].

===== Purpose =====

The purpose of this document is to provide guidance on the setup, access, and usage of decimal Ordering Tool.

===== Getting Started =====

Review each of the sections below for how to get started with the decimal Ordering Tool.

==== Initial Setup ====

The decimal Ordering Tool application must be licensed and added to your account by .decimal staff. Please contact .decimal customer support (1-800-255-1613) for access to this applicaiton.

==== Access Control ====

decimal Ordering Tool uses [[https://auth0.com/security|Auth0]] as an Identity-as-a-Service provider for user account management. All user accounts and credentials are managed by the Auth0 service including user creation, password policies, password resets, and secure authentication. 

As decimal Ordering Tool is deployed on customer workstations the site administrator will be responsible for the installation of the software on the appropriate workstations and the account management of all users at the facility. Each employee should have an individual login and password to access the application that prevents unauthorized access, and account sharing should be strictly prohibited.

=== User Authentication ===

Users authenticate and launch the decimal Ordering Tool application using the [[decimalauncher:decimallauncher#authentication | decimal Launcher]]. 

=== Account Management ===

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 ===

When decimal Ordering Tool is launched from the decimal Launcher, the application is given an JWT authentication token for the logged in user. This token is used to authenticate and perform [[https://direct.dotdecimal.com|decimal Direct API]] requests. This JWT token is issued by decimal Direct and Auth0 and has a built in expiration. When this token expires the user will be logged out of the application and be forced to re-authenticate and relaunch the application using the decimal Launcher. Refer to [[decimalauncher:decimallauncher#inactivity_and_session_timeout|decimal Launcher's User Guide]] for details on this authentication token and its expiration. 

Auth0 user credentials are authenticated and validated using the decimal Direct API by decimal Ordering Tool each time a user logs in and on recurring timer events. If user credentials are invalid or expired, users will automatically be logged out of the application and prevented from using or accessing any data within the application/system.

=== 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#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 ====

The decimal Ordering Tool application is installed via the [[decimalauncher:decimallauncher|decimal Launcher]] client application. Refer to the decimal Launcher [[decimalauncher:decimallauncher|user guide]] for details on using the decimal Launcher. 

The main high level requirements for using the decimal Launcher and decimal Ordering Tool application are:
  - .decimal Direct account credentials
    - This account needs association with a Site ID (.decimal Customer Account number) that has been licensed for use of the decimal Ordering Tool application
    - This account needs specific .decimal Permission for accessing the application
  - The decimal Launcher installed 

Please refer to the decimal Ordering Tool [[decimal_ordering_tool:userguide:systemrequirements|System Requirements]] page for complete details on hardware and network requirements.

==== Release Management (decimal Launcher) ====

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.

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.

=== Releasing a new App Version ===

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 =====

When using decimal Ordering, as with any complex program, there is the potential for misuse. The decimal Ordering Tool is a radiotherapy medical device ordering tool that is intended to be used by experienced and knowledgeable professionals working in the field of radiation therapy.

===== Known Application Limitations =====

Below are listed the known application limitations, defects, or inconsistencies.

==== General ====

^ ID  ^ Affected Version(s)  ^  Description   ^
|  1  | All | The following order fields have character limits when creating an order:<WRAP> 
  * Patient: 50 characters
  * Beam Desc: 50 characters
  * Comp ID: 50 characters
</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.