The following command-line arguments are allowed. Quotes around the information are required if there are any spaces, otherwise optional. Order is unimportant. They are listed alphabetically.
AptNum: Corresponds to the visit Id in eCW.
ChartNumber: Causes the current patient to change. If a PatNum is passed in, then this is ignored.
DatabaseName: For a direct db connection.
EcwConfigPath: Path to the eCW Configuration.xml file.
JSESSIONID and JSESSIONIDSSO: Only used by eCW.
IsSilentUpdate: Allows you to forcefully update the database without any prompt. To use, specify "True". You will also need to pass in ServerName, DatabaseName, MySqlUser, MySqlPassword, OdUser, OdPassHash or OdPassword. For a list of codes the program will use to relay any problems, see Exit Codes at the bottom of this page.
To prevent accidental updates of Open Dental when multiple locations potentially run different Open Dental versions, set an Update Server Name (also known as Middle Tier Server Name) in Miscellaneous Setup. This computer will be the one and only computer that has permission to execute updates.
Module: This will open the module of your choosing ("Appt", "Family", "Account", "TxPlan", "TreatPlan", "Chart", "Images", "Module"), case insensitive. Ex: Module="Account" opens the account module.
MySqlUser: For a direct db connection. Typically "root".
MySqlPassHash: For a direct db connection so user doesn't have to manually type the MySQL password on the Choose Database window in plain text. Uses the obfuscated MySql password from the FreeDentalConfig.xml file. The FreeDentalConfig.xml file and the obfuscated password must already exist.
MySqlPassword: For a direct db connection. Can be omitted if blank.
OdPassword: The Open Dental password for the specified UserName. The Log On window will be skipped. Used in conjunction with the UserName argument.
PassHash: This argument only works if the eCW bridge is turned on in tight integration mode; it is not functional for regular customers not using the eCW bridge. If both UserName and PassHash are passed in, then the current user in OD will change. It is the MD5 hash of the user password, base-16 encoded. The PassHash is the hash of the password as it is stored in the eCW database. eCW and OD use slightly different encodings for storing the password hash. eCW hashes the ASCII text and encodes it as base-16. OD hashes the Unicode text and encodes it as base 64 text. In order to allow simple bridging, if the eCW bridge is turned on, then OD will change its behavior to store passwords in a manner identical to eCW. That way, the hashed passwords will always exactly match in both databases. If the eCW bridge is turned off, none of the existing passwords will work. And if a user turns on the eCW bridge, the existing passwords will also stop working. So before turning on the bridge, you must make sure that the admin password in OD is blank. After the bridge is turned on, then you may set a password.
PatNum: This is the primary key, the patient internal patient id. It is visible to users, but cannot be changed. Passing in this parameter causes the current patient in OD to change. If the PatNum passed in cannot be found, then the current patient is cleared from the Open Dental screen. When this parameter is used for eCW, it is both the internal ID for eCW and the external ID for OD.
ServerName: For a direct db connection. Can be name or ip address.
Show: Conditionally displays a patient's popups, patient select window or appointment list (the same list that opens when selecting "View Pat Appts" in the appointment module). The appointment list will only open if the starting module is the appointment module, and both forms will only open if the user also has a PatNum argument. Allows "Popup", "Popups", "ApptsForPatient", and "SearchPatient". SearchPatient will open the Patient Select window and doesn't require any other command line arguments
SSN: Causes the current patient to change. If a PatNum or ChartNumber is passed in, then this is ignored.
UserId: Only used with eCW, it's the primary key for the user in eCW.
UserName: The Open Dental user that is logging in. Capitalization must match. This is usually used in combination with OdPassword. If the username and password do not match, then the Log On window will be displayed as usual. When this argument is used for eCW with tight integration, the PassHash is used instead of the OdPassword. In that case, if the user does not exist, then a user with the specified UserName and PassHash will be created. The new user will have the permissions of the default user group set in the eCW setup window. If the username does exist, but the password does not match, then the user will be presented with the login screen in OD. After the user logs in with their old password, they will need to change their password in OD to their new one.
WebServiceUri: The URI to the Middle Tier.
WebServiceIsEcw: If not using eCW, omit this argument. If using eCW, specify "True".
Example 2 (a shortcut to open a webservice at a remote location, using eCW)
Example 3 (a shortcut to a direct database connection on the current computer)
Example 4 (a shortcut to a database connection, including Open Dental username and password)
The name of the shortcut can be set in the General tab. For eCW installs, the Target has the following text:
For other installs, the Start in path may include Program Files, giving the Target the following text:
There is no way yet to reuse the current window in Open Dental. Passing in command line arguments will always result in a new instance of Open Dental being launched. Multiple instances of Open Dental can run simultaneously without any conflict.
0 No Failures (Default)
100 Database could not be accessed for cache refresh
200 Convert Database has failed during execution (Unknown Error)
300 AtoZ folder not found (Warning)
999 Unknown Problem
Open Dental Software 1-503-363-5432