Configuring Dragon Medical One

Make sure the app configuration file has the same version as the app; don't use an old configuration file when you update to a newer version of Dragon Medical One. The version number can be found in the first line in the app configuration file.

To keep your customized settings after an upgrade, save the existing app configuration file before you upgrade and then manually transfer the respective settings, or create an XML file containing your customized settings and start Dragon Medical One from the command line, specifying the path to this XML file via the config parameter. For more information, see: Providing different configurations for a single standalone deployment.

Configuring the organization token

To set the organization token for Dragon Medical One, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, OrganizationToken setting, specify the organization token.

Providing different configurations for a single standalone deployment

To provide a single standalone package of Dragon Medical One to different user groups using different configuration settings, do the following:

1. Deploy Dragon Medical One using the Windows Installer (MSI package) or via XCOPY deployment.

2. Create a new XML file containing only the configuration settings that are different from the settings in the SoD.exe.config file.

3. Start Dragon Medical One from the command line and use the config parameter to specify the path to this XML file. The settings in this file override the settings specified in the SoD.exe.config file.

Remarks

• For a list of setting elements you can specify, see the SoD.Settings section in the SoD.exe.config file. The elements must be stated exactly as they're in the SoD.exe.config file.

  The setting elements that you add to the SoD.DefaultOptions section override the default settings.

  For example:

  <?xml version="1.0" encoding="utf-8" ?>
  <applicationSettings>
     <SoD.Settings>
       <setting name="Authentication" serializeAs="String">
         <value>native</value>
       </setting>
     </SoD.Settings>
     <SoD.DefaultOptions>
       <setting name="Microphone.Record" serializeAs="String" isLocked="True">
         <value>Toggle</value>
       </setting>
     </SoD.DefaultOptions>
  </applicationSettings>
  

• Dragon Medical One accesses the XML file during startup; hosting the file on a network share can impact startup performance.

Configuring the default options

Dragon Medical One enables you to configure the default settings that the user logs on with. By default, the user can change all settings in the Options dialog box; you can lock specific settings to prevent the user from changing them.

You can configure default options via the Nuance Management Center (NMC) or via the configuration file. Options configured via the configuration file overwrite options configured via NMC.

Configuring default options via NMC

Proceed as follows:

1. Log on to NMC with your administration credentials.

2. On the Dragon Medical One ribbon, select Manage.

3. Select an organization, site or group in the tree view.

4. Select a tab and configure a setting.

5. Optional: Select the Lock check box to prevent users from changing the configured setting.

6. Select Save.

For more information on NMC, select the help icon in the upper right of the NMC page to open the Nuance Management Center Help.

Configuring default options via the configuration file

Proceed as follows:

1. Open the SoD.exe.config file.

2. In the SoD.DefaultOptions section, configure the default settings:

   Specify the setting elements that you want to customize. For a list of setting identifiers and their corresponding values, see the table below.

Example 1: Locking a setting

In the setting element that you want to lock, add the isLocked attribute and set the value to True.

<setting name="Microphone.Record" serializeAs="String" isLocked="True">
  <value>PressAndHold</value>
</setting>

Example 2: Configuring hotkeys

A hotkey value can be specified as a sequence of keys, either separated by spaces and/or plus signs or joined.

<setting name="Hotkeys.NextField" serializeAs="String">
  <value>CtrlALTW</value>
</setting>
<setting name="Hotkeys.PreviousField" serializeAs="String">
  <value>Ctrl + ALT + Q</value>
</setting>

Example 3: Defining a hotkey as the default value of a microphone button

Specify the corresponding setting element and set the value to PressHotKey (key_sequence).

<setting name="Microphone.EnterSelect" serializeAs="String" isLocked="True">
  <value>PressHotkey (CtrlShiftAltA)</value>
</setting>

The following table lists the setting identifiers, their descriptions, possible values and the default values the app is delivered with; the setting identifier has the following format: OptionCategory.IdentifierName:

Disabling CRL validation

This configuration setting is optional. By default, Dragon Medical One checks that the SSL certificate used for authentication contains a certificate revocation list (CRL). If you're using a self-signed certificate or a signed certificate from an internal CA, this check can cause authentication issues. To disable CRL validation, do the following:

1. Open the SoD.exe.config file.

2. In the appSettings, add the setting CRLValidationEnabled and specify as follows:

<appSettings>
  <add key="CRLValidationEnabled" value="False"/>
</appSettings>

Enabling WPF text controls

By default, if users place the cursor in a text control that isn't fully supported by Dragon Medical One, the Dictation Box opens automatically and the text is written there. Enabling WPF text control allows users to dictate at the cursor in WPF text controls.

To enable WPF text controls, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, WPFSupport setting, change the value to True:

<setting name="WPFSupport" serializeAs="String">
  <value>True</value>
</setting>

Enabling Basic Text Control

By default, if users place the cursor in a text control that isn't fully supported by Dragon Medical One, the Dictation Box opens automatically and the text is written there. Basic Text Control enables users to dictate at the cursor in unsupported text controls. Only basic speech recognition functionality is supported; users won't be able to navigate, edit or format the text using their voice.

If there are issues with Full Text Control, this configuration setting can also be used to enable Basic Text Control in specific, fully supported text controls.

To enable Basic Text Control, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, BasicTextControls setting, specify all text controls (defined as WindowClass elements specific to a process) you want to enable Basic Text Control for.

If you don't specify WindowClass elements for a process, Basic Text Control is enabled for all window classes of that process.

If you specify a wildcard character (*) for a process, Basic Text Control is enabled for all specified WindowClass elements, independent of the process.

Example:

<setting name="BasicTextControls" serializeAs="String">
  <value>
    <BasicTextControls>
      <ProcessName name="Process_1">
        <WindowClass>Sample_class_1</WindowClass>
      </ProcessName>
      <ProcessName name="Process_2">
      </ProcessName>
      <ProcessName name="\*">
        <WindowClass>Sample_class_2</WindowClass>
        <WindowClass>Sample_class_3</WindowClass>
      </ProcessName>
    </BasicTextControls>
  </value>
</setting>

Enabling Basic Text Control for Google Chrome

The web extension for Dragon Medical One 2021.3 or higher must be installed.

You can enable dictation at the cursor using Basic Text Control for apps hosted in the Google Chrome browser that aren't fully supported by Dragon Medical One.

Proceed as follows:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, BasicTextControls setting, add the chrome attribute in the ProcessName element and specify the URLs you want to enable Basic Text Control for in the UrlTextToMatch elements. The setting is applied to any URL containing the value specified in the UrlTextToMatch element.

Example:

<setting name="BasicTextControls" serializeAs="String">
  <value>
    <BasicTextControls>
      <ProcessName name="chrome">
        <UrlTextToMatch>medical</UrlTextToMatch>
      </ProcessName>
    </BasicTextControls>
  </value>
</setting>

Basic Text Control is enabled for any URL containing medical. For example, https://your.medical.web.application.com, https://medical.services.com or https://medical.data.com.

Configuring the text transfer method for text controls that Basic Text Control is enabled for

By default, the text is inserted in the text controls via SimulateKeystrokes; other possible text transfer methods are ShiftInsert, CtrlV and WindowsPaste. Dragon Medical One enables you to configure the text transfer method for all text controls of a process or for specific text controls.

Proceed as follows:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, BasicTextControls setting, configure the text transfer method:

   To apply the setting to all window classes of the process, add the textTransferMethod attribute in the ProcessName element and set the value.

   To apply the setting on a window class level, add the textTransferMethod attribute in the WindowClass element and set the value. The attribute that you set in the WindowClass element overrides the ProcessName text transfer method.

Example:

<setting name="BasicTextControls" serializeAs="String">
  <value>
    <BasicTextControls>
      <ProcessName name="\*" textTransferMethod="ShiftInsert">
        <WindowClass textTransferMethod="SimulateKeystrokes">Sample_class_2</WindowClass>
        <WindowClass>Sample_class_3</WindowClass>
      </ProcessName>
      <ProcessName name="Process_1">
        <WindowClass textTransferMethod="CtrlV">Sample_class_1</WindowClass>
      </ProcessName>
      <ProcessName name="chrome" textTransferMethod="ShiftInsert">
        <UrlTextToMatch>your.web.application</UrlTextToMatch>
      </ProcessName>
    </BasicTextControls>
  </value>
</setting>

Disabling auto-text formatting for specific text controls

By default, if users insert a formatted auto-text in a text control that doesn't support text formatting, the formatting isn't displayed correctly. To avoid any issues, this configuration setting can be used to disable auto-text formatting for specific text controls.

To disable auto-text formatting for specific text controls, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, TextControlsWithFormattedAutoTextsDisabled setting, specify all text controls (defined as WindowClass elements specific to a process) where you want to disable formatting in auto-texts.

If you don't specify WindowClass elements for a process, formatting is disabled for all formatted auto-texts for all window classes of that process.

If you specify a wildcard character (*) for a process, formatting is disabled for all formatted auto-texts for all specified WindowClass elements, independent of the process.

Example:

<setting name="TextControlsWithFormattedAutoTextsDisabled" serializeAs="String">
  <value>
    <TextControlsWithFormattedAutoTextsDisabled>
      <ProcessName name="Process_1">
        <WindowClass>Sample_class_1</WindowClass>
      </ProcessName>
      <ProcessName name="Process_2">
      </ProcessName>
      <ProcessName name="\*">
        <WindowClass>Sample_class_2</WindowClass>
        <WindowClass>Sample_class_3</WindowClass>
      </ProcessName>
    </TextControlsWithFormattedAutoTextsDisabled>
  </value>
</setting>

Configuring timeout for end users

You can configure Dragon Medical One to automatically log a user off if they haven't worked with the app for the specified period of time. When a user is logged off automatically, any unsaved changes are lost.

By default, this setting is empty and a user is never logged off automatically, no matter how long they don't use Dragon Medical One.

Proceed as follows:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, AutoLogOffTimeout setting, set the time period in minutes. Range: 5-120 minutes.

Example:

<setting name="AutoLogOffTimeout" serializeAs="String">
  <value>10</value>
</setting>

If the user doesn't work with Dragon Medical One for more than 10 minutes, they're logged off.

Enabling Clinical Content Search

Clinical Content Search is part of the virtual assistant capabilities embedded in Dragon Medical One. It enables users to retrieve clinically relevant information from the clinical decision support resource UpToDate by Wolters Kluwer. For more information, see the Fact Sheet on Clinical Content Search.

To enable Clinical Content Search for your organization, Nuance Technical Support requires the following information:

• Your organization's UpToDate Site ID, if your organization has given UpToDate its IP address.

• Your organization's Security Agent URL and UpToDate Site ID, if your organization authenticates using a Security Agent URL.

If you don't have the required information, please contact UpToDate support to obtain it.

Disabling PowerMic Mobile support

The PowerMic Mobile feature enables users to use their mobile devices as a microphone. If your system is set up to use this feature, users can select PowerMic Mobile from the list of available microphones during logon. To hide PowerMic Mobile from the list, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, EnablePowerMicMobile setting, set the value to False.

Configuring the language

You can configure the language used for speech recognition and the user interface. Proceed as follows:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, SupportedLanguages setting, specify the language as an IETF language tag.

If you specify a language that is only available for speech recognition, the user interface is displayed in a related language.

If you want to present a list of available languages to the end user, specify all supported languages in the setting and separate them with the pipe charater (for example, de-DE|en-US|sv-SE). The end user can then choose one of the specified languages when they start the app.

For more information, see: Supported languages.

Configuring the speech recognition topic/specialty

To configure the speech recognition topic for Dragon Medical One, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, SupportedTopics setting, specify the speech recognition topic.

If you want to present a list of available speech recognition topics to the end user, specify all supported speech recognition topics in the setting and separate them with the pipe character (for example, GeneralMedicine|ClinicalAdministration). The end user is then able to choose a topic when they start the app.

Supported speech recognition topics

The following topics are available:

GeneralMedicine, ClinicalAdministration, Cardiology, Emergency, InternalMedicine, MentalHealth, Neurology, ObstetricsAndGynecology, Oncology, Orthopaedics, Pathology, Pediatrics, Surgery.

Configuring microphones

To configure the microphones the end user is allowed to use in Dragon Medical One, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, AllowedMicrophones setting, specify all microphones the end user is allowed to use and separate them with the pipe character, |.

When the end user starts the app, the list of connected microphones is filtered based on this setting. If you don't configure this setting, the end user can choose from all connected microphones.

Configure SpeechMike and PowerMic 4 to use the same button mappings

In environments where both Philips SpeechMike and Nuance PowerMic 4 devices are used, you can change the mappings of SpeechMike physical buttons so that they trigger the same actions as the equivalent PowerMic 4 physical buttons. To change the mappings of SpeechMike physical buttons, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, SpeechMikeButtonMappingAsPowerMicEnabled setting, set the value to True.

Disabling the crash dump notification to end users

When Dragon Medical One shuts down unexpectedly, crash dump information is saved. The next time the user starts the app, they're informed that log files containing information about the crash are available and can be sent to their system administrator for analysis.

We recommend that you ask your users to send crash dump files to you; send the files, along with an error report if possible, to Nuance Technical Support for further analysis.

If you do not want your users to receive this crash dump notification, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, EnableCrashNotification setting, set the value to False.

Disabling registration of the Microsoft Word add-in

When starting, Dragon Medical One calls the regsvr32.exe executable to register the Microsoft Word add-in. To disable registration of the Microsoft Word add-in, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, add the setting RegisterWordAddIn and specify as follows:

<setting name="RegisterWordAddIn" serializeAs="String">
  <value>False</value>
</setting>

Registering the Microsoft Word add-in for individual users

If registration of the Microsoft Word add-in is disabled, you can enable it for an individual user. Log on to the corresponding user account and run the following command:

regsvr32.exe /s SoD.WordAddin.dll

If a user works with a 64-bit version of Microsoft Word, run the following command:

regsvr32.exe /s SoD.WordAddin_x64.dll

Customizing the splash screen

You can lay a custom image over the Dragon Medical One splash screen; the overlay image is placed in the lower left corner of the splash screen.

Requirements:

• Size: 320x130 pixels

• Format: PNG

• File name: SoD.OEM.png

Location:

• Standalone: The app directory (same location as the configuration file)

Configuring the user interface color theme

The color theme for Dragon Medical One can be one of the following:

• Blue: Default color theme, used when this setting is empty.

• Light or Dark: Monochrome color themes with high contrast.

• System: Follows the monochrome color theme set in Microsoft Windows under Choose your default app mode.

To configure the color theme, do the following:

1. Open the SoD.exe.config file.

2. In the SoD.Settings, DefaultTheme setting, specify the color theme, for example:

<setting name="DefaultTheme" serializeAs="String">
  <value>Light</value>
</setting>

Configuring the microphone hotkey

If users use the same PowerMic or SpeechMike to dictate in Dragon Medical One and Dragon Copilot, the button press might be recognized in Dragon Medical One rather than Dragon Copilot, or dictation might go into both apps. The user can press CTRL + ALT + P in Dragon Medical One to disable the microphone buttons there; the same hotkey also enables the microphone buttons when they're disabled.

To configure the hotkey, do the following:

1. Open the app configuration file that the app should use (for example, SoD.exe.configuration on your web server or SoD.exe.config for the standalone package).

2. Open the SoD.exe.config file.

3. In the SoD.Settings, HotkeyTogglePowermicInput setting, specify the hotkey, for example:

<setting name="HotKeyTogglePowermicInput" serializeAs="String"\>
  <value>Ctrl + Alt + P</value>
</setting>