DataCar Select Application launcher via DataCar Portal TABLE OF CONTENTS 1. INTRODUCTION... 2 2. PREREQUISITE... 2 3. DESCRIPTION... 2 3.1. Launch modes : Connection & Offline... 2 3.2. Setup of company information in DataCar Portal... 5 3.2.1. DataCar Portal - Access to the internal administration and setup... 5 3.2.2. Setup of the DataCar DMS application on DataCar Portal... 5 3.2.3. Addition of the Eris Motors application... 6 3.3. Installation and update of DataCar Select... 7 3.4. Registration as registry key and Path.ini file... 9 3.5. Starting DataCar Select... 12 3.6. Modification of Internet Explorer options... 13 4. DATACAR DMS ON TSE SERVER... 14 4.1. User account... 14 4.2. Installation of the application... 14 4.3. Starting DataCar Select... 14 4.4. Using the DMS icon to start... 15 5. SETTINGS FOR THE ERIS MOTORS DMS... 16 5.1. Company settings... 16 5.2. Application creation... 17 UPDATE HISTORY... 19 DOCUMENT DETAILS / COMMENTS... 19 GLOSSARY... 19 Page 1 on 19
1. INTRODUCTION This guide mainly concerns Installers. It explains in detail the setup of the DataCar Select launcher with Click Once function which enables the start of the DMS and of its external applications via DATAFIRST s DataCar Portal. The auto-deployed DataCar Select launcher is used to start the browser on DataCar Portal and on the applications or to enable the user to start an application that has already been used on his/her workstation, when the Internet connection is not available. The objective of DataCar Select is to start DMS and external applications offline in disconnected mode and thus ensure service continuity when DataCar Portal is not available. Caution: This guide replaces the following documents which have become obsolete with the release of v2.9 of DataCar Portal: 00.144.357 - Connexion via DataCar Portal pour lancer le DMS Guide technique et Utilisateurs (French only) 00.126.640 - Using PROTOCOL to start DataCar DMS via DataCar Portal (EN) 2. PREREQUISITE It is necessary to have the rights to access DataCar Portal using a Super Administrator account to update the parameters linked to the remote connection of the required company. 3. DESCRIPTION 3.1. Launch modes : Connection & Offline Connection mode: The connection to Internet is available the default Web browser starts and launches DataCar Portal. The classic operation is activated to start the User s applications. On the following page, we see the DataCar Portal homepage containing the tiles used to start the applications: Page 2 on 19
(1) Homepage (2) Your applications section containing the launch tiles Offline mode: The connection to Internet is not available the launcher opens a window (example hereunder) to display and select the application that needs to be started with the recorded parameters. The User ID must then be input in the selected application, i.e. the DataCar Portal login and password. At right, example of the window that opens in offline mode, showing the version of DataCar Select: Caution: The connection information are saved only after the User has been connected at least once in Connection mode. The data are then stored to be used in Offline mode. The application start-up history is stored in the following registry: Current_user/Software/Classes et Current_user/Software/DatafirstSAS de la machine locale. Page 3 on 19
Process chart: Page 4 on 19
3.2. Setup of company information in DataCar Portal The setup of the DMS SQL Server and DMS TSE Server fields must be defined in the company parameter to ensure the execution of PROTOCOL. 3.2.1. DataCar Portal - Access to the internal administration and setup To access Administration, go to the My profile menu and click the Management of companies tile: My Profile menu : (1) Administration (2) Management of companies tile 3.2.2. Setup of the DataCar DMS application on DataCar Portal The setup of the User s company affects the creation or modification of the applications. The link fields of the SQL server name and of the TSE server name in the window are no longer available. The information is automatically generated via the company which is selected in a drop-down menu. CAUTION -- To ensure performance in downgraded mode, the company must be defined with the New Token option, enabling the DMS to store the User logins if the contact with DataCar Portal is lost. Application creation/modification window in DataCar Portal: Modification of the application Type Datafirst External Application DataCar DMS Account vr Description DMS Company ABSOLUTE LES ULIS (111025 Optional parameter Access for demonstration Status Active Method Protocol Delete Save The setup remains the same whether the start mode of the application is direct or remote (RDP). TSE sessions in Remote App" mode also require that the RDP Domain be stated for the company. Page 5 on 19
3.2.3. Addition of the Eris Motors application The «Eris Motors» application must be selected in the application list. Then set the login and the company name and select the «Protocol» method: Addition of an application Type Datafirst External Application Eris Motors Account logintest Description Company A Company DEMO DATACAR PARIS 1ER AR Optional parameter Access for demonstration Status Active Method Protocol Save The «Eris Motors» application is added the same way and takes into account the Company information. Addition of an application External * Application Eris Motors Account Description Link Company GARAGE Grenier (106831) Trial version * Status Active Method Protocol Page 6 on 19
3.3. Installation and update of DataCar Select PROTOCOL no longer needs to be installed since that is managed by the launcher. DataCar Select must be installed on EACH User workstation. Contents of the installation directory: The installation consists of running the setup.exe from the following address: http://portal.datacar.com/documents/datacarselect/datacarselect.application or, depending on the browser: http://portal.datacar.com/documents/datacarselect/setup.exe. The installation program retrieves the files that must be loaded: DataCarSelect installation Downloading the requested files Downloading file 1 on 1 Cancel Page 7 on 19
The installation of DataCar Select starts: At each start-up, DataCar Select verifies (on Internet) if an update is available and asks the User if it should be applied: Application update A new version of DataCar Select is available. Do you want to download it now? Name: From: DataCar Select xxxxxxxxxxxxxxxxxxxxxxxxxxxx OK Ignore Authorize the execution when Windows requests it: Windows has protected your computer Windows SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk. Application: Editor: DataCarSelect.exe Unknown Execute anyway Do not execute Page 8 on 19
3.4. Registration as registry key and Path.ini file The connection parameters are stored in the registry key HKEY_CURRENT_USER / Page 9 on 19
A Path.ini file is initiated when connecting to the applications. To find this file, use the address hidden in the window of the launcher: Start DataCar Select: Expand the window downwards to see the file s access path: Then access the directory using that path. Example: C:\Users\vrochard\AppData\Local\Apps\2.0\N6YCL32K.7LP\MG3WLP54.R82\data..tion_7691520ffa55969e_ 0001.0000_07c64e73a33e97a2 Page 10 on 19
The paths required to start the applications are located in the Path.ini file: Page 11 on 19
3.5. Starting DataCar Select Once the installation is finished, the User must access the applications at least once to save the parameters. Should Internet and consequently DataCar Portal be unavailable, DataCar Select will ensure the connection to the applications. Start DataCar Select directly in Windows: OR The icon used to start DataCar Portal is created on the desktop. It also tests the Internet connection of the workstation. If no Internet connection is detected, the application launch window is displayed: Page 12 on 19
3.6. Modification of Internet Explorer options To avoid problems linked to the HTTPS and to the execution of PROTOCOL, verify the following option (especially in the case of IE 8): Internet Explorer options >> Security tab >> Custom level Change the value of the Display mixed content option from Prompt to Enable. Validate the use of PROTOCOL on an HTTPS-type page, WITHOUT an alert message: Page 13 on 19
4. DATACAR DMS ON TSE SERVER DataCar Select may be used directly on a TSE server. 4.1. User account In that case, the Remote App option must NOT be selected in the DataCar Portal User account otherwise, DataCar Select will open on itself an RDP from the TSE when starting the application. 4.2. Installation of the application On the TSE server, the DataCar Select files are installed with the DMS. They are contained in is the [DATACARSELECT] directory located directly below the [PROG] directory. The DataCar Select files are updated by the DMS patches. (Do not use the installation URL on a TSE server.) Caution: The DMS version from which DataCar Select will be available has not yet been determined. To finalize the installation: Place the mouse pointer in the [../PROG/DATACARSELECT] directory and double-click on the DataCar Select executable. This creates the start icon on the Desktop and it also creates the localpath.ini configuration file. This is the file which must be modified to customize the DataCar Select configuration. 4.3. Starting DataCar Select Once the installation is finished, the User must access the applications at least once to record the parameters. If Internet, and consequently DataCar Portal, are unavailable DataCar Select will ensure the connection to the applications. If no Internet connection is detected, the application launch window is displayed Because the User is not in an RDP connection, there is no need to confirm the Widows IDs. Page 14 on 19
4.4. Using the DMS icon to start To accelerate the transition towards using DataCar Select, version 3.63.00 of DataCar DMS enables the coercion of the connection to the DMS via DataCar Portal. When the User starts DataCar DMS by using the DMS icon, the DMS calls DataCar Portal to determine if a given company is linked to the SQL server (i.e. the server that is defined in the DMS icon properties). IF a company does exist for the SQL server AND the Only Portal option is enabled for such company, THEN DataCar Select starts and the User must connect with his/her DataCar Portal account OTHERWISE the DMS connection window is displayed. NOTE Failure to access DataCar Portal displays the DMS connection window. The DMS cannot check if the Only Portal option is enabled for the company. The DataCar Select downgrade mode is not available via the DMS icon. Direct use of DataCar Select is recommended. Page 15 on 19
5. SETTINGS FOR THE ERIS MOTORS DMS The «Eris Motors» DMS can be launched through DataCar Portal since version 21.3.0.11.of the DMS. To do so, follow the steps described below. 5.1. Company settings In Internal administration and Settings, update the company to which the User is linked. Set the «IS NEW TOKEN» parameter to «True» : Page 16 on 19
5.2. Application creation Fields Field Value Description Application Eris Motors To be selected from the drop-down menu. Login Login Login used to start the Eris Motors DMS application. Description Description This name will appear in the application page. Link ERIS This field must contain a value. Company Optional parameter Select from the drop-down menu Parameter that will be used when launching the application Company to which the User is attached. Here is the list of possible parameters to use when launching the application: - SANSFINPROG - LIGHT - SANSIMG - SANSMAJ - AUTOMATE - SANSLANG - SANSMAJAUTO - MOBILE - SAUVE - DATA - ODBC= Method Launch method Always Protocol Note This field is not restricted to launch parameters but can also be used for development and assistance purposes. See further in this guide for the syntax. Page 17 on 19
Optional parameter syntax The «Optional parameter» field is reserved to development or assistance needs. You need to: - Fill the «Link» field. In this case, input ERIS. - Use the following synthax: -TOKEN:{ssotoken} -USERNAME:{username} sansmaj Update and verification of the Eris Motors DMS settings For the User and Profile settings, all the names must have the same value in the OPC tablespace and in the table USER_REC. Exemple : Page 18 on 19
Date YYYY-MM-DD 2016-03-15 1.0 JC UPDATE HISTORY Edition Author Description 2016-04-15 1.1 VR Addition of Eris motors configuration 2016-04-15 1.1 JC Layout Translation of French-language original guide ( - DataCar Select application launcher - (DataCar Portal) ) 2016-05-10 2.0 VR Addition of chap. 4 Settings for the Eris Motors DMS 2016-05-10 2.0 JC Layout 2017-01-05 3.0 JC Addition of information concerning v3 of DataCar Portal. 2017-05-15 3.1 JC Deletion of all reference to version 2 of DataCar Portal. In chap. 3.2.3 Setup of the DataCar DMS application on DataCar Portal, addition of an alert concerning the definition of a company. Addition of chap. 4 DataCar DMS on TSE server: Update to DataCar DMS NON Remote App connection. 2017-08-17 3.2 JCL Addition of chap. 4.4 Using the DMS icon to start. Layout. DOCUMENT DETAILS / COMMENTS Document name/no. DTF product / version Manufacturer Country Project / Request no. Related documents - DataCar Select application launcher (DataCar Portal) DataCar Portal v2.9 and later All All Project PRO-WEB-16-PACKAGING 00.158.238 - DataCar Select Lanceur d'application Guide technique (DataCar Portal) 00.125.750 - DataCar Portal User guide Keywords Comments DTF Select RemoteApp Remote App Publication d application Application publiée - From version 2.9 of DataCar Portal, this guide replaces document 00.126.640 - Using PROTOCOL to start DataCar DMS via DataCar Portal (EN). - Also replaces doc. 00.144.357 OBSOLETE 'Connexion via DataCar Portal pour lancer le DMS' REMPLACE PAR 00.158.238 - DataCar Select Lanceur d'application Guide technique RDP TSE Word Remote Desktop Protocol Terminal Services Environment GLOSSARY Definition Page 19 on 19