Environment: custo diagnostic 5.x (5.3.3 and above),
Subject to change without notice.
Introduction
custo diagnostic is a universal platform for cardiopulmonary diagnostic (e.g. ECG). In many environments, a Hospital Information System (HIS) is used to create orders which are processed/fulfilled in custo diagnostic and transferred back to the HIS (order entry workflow). This document describes the call of custo diagnostic client from an external system (e.g. a Hospital Information System HIS) and directly show the evaluation, referenced by the specific order-identification.
custo diagnostic client / custo manager.exe
While custo diagnostic is the platform, custo diagnostic client is the name of the client to access this platform. custo diagnostic client is a windows 32bit application ("custo manager.exe") which must be installed on the windows workstation or Terminal Server.
"custo manager.exe" can be controlled by several command line parameters.
The default installation location is: %ProgramFiles(x86)%\custo diagnostic client\
Hence, the executable can be referenced as: %ProgramFiles(x86)%\custo diagnostic client\Exe\custo manager.exe
OrderId
The OrderId can be specified by the command line parameter /orderId=
This order-id normally comes from HIS while placing the order (e.g. HL7 Placer Order Number, ORC-2-1).
"custo manager.exe" /orderId=ORD2020000123
User
custo diagnostic covers a user database, which can be linked via LDAP interface to an enterprise directory. This means, that there might be "LDAP users" and manually entered users in the same custo diagnostic installation.
There are several Approach which user/password is handed over when calling custo diagnostic client.
General behavior: When custo diagnostic is called with appropriate user/password - the application will not show any login dialog and perform directly the actions specified by command line (if not specified, the main menu will appear). In case the given username and/or password is not correct, the application will remain in the login dialog, enables the user to enter differing credentials.
| Approach | Behavior | |
|---|---|---|
| No Username | In general custo diagnostic will ask the user to select/type in the username and the password. After entering this information, custo diagnostic will perform the actions specified by command line or show the main menu. | |
| Hard coded User wtih/without password | In environments, where a login by particular name is not necessary, the user-name with/without a password can be given. e.g. "custo manager.exe" /User=icu /orderId=ORD2020000123 or "custo manager.exe" /User=icu /pwd=icu /OrderId=ORD2020000123 When no password is given, the application will remain in the login dialog. The specified user is preselected. | |
| Windows User Name by environment variable | In most environments, custo diagnostic is called from a HIS to either read or report the recorded evaluation by doctors. In case these doctors are particular by their login name logged in to the windows system, the environment variable may be used: e.g. "custo manager.exe" /User=%USERNAME% /orderId=ORD2020000123 When the custo diagnostic database is linked to the ActiveDirectroy and the appropriate users are configured, the user only has to enter his windows password. After entering this information, custo diagnostic will perform the actions specified by command line or show the main menu, after authenticating against the user database / Active Directory. Remark: The replacement of the environment variable %USERNAME% with the correct value is done outside of custo manager by the caller. |
Tenant (Mandant)
In installations, where a tenant system is used, the internal tenantID should be passed as parameter.
e.g. "custo manager.exe" /User=%USERNAME% /orderId=ORD2020000123 /tenantID=1
References
A comprehensive list of all command line parameters can be obtained from custo med service, service@customed.de
(Internal: DC-7422, DC-7442)