Development Notes

Note: This is a developer guide.

Pre-Requisites

• Visual Studio 2017
• .NET Framework 4.7 Runtime
• Oracle Client 11.0.2 or 11.0.3
• Oracle ODT with ODAC 11.2.0.3

Installers are available here: See here:

• \\scansrv1\Global\OBS Logistics\Installs\ODTwithODAC112030.zip
• \\scansrv1\Global\OBS Logistics\Installs\win32_11gR2_client.zip

Oracle Set-up

Install the Oracle Client.

Note: Ensure that the client is installed into a folder within the C:\app structure, for example:

C:\app\UserName\product\11.2.0\client_1

Install Oracle ODT into same base folder.

Set up TNS Names.

Code Set-up

Note: You must be provided access to the correct source control library - contact your .NET development manager for details. The following instructions show an example - TFS settings may vary.

1) Copy \\spekefs2012\Projects\Development\MCS\# Source\Start\Calidus MCS to where you want your project setup locally. Note: This was correct at the time of document creation. There may be updated projects to copy, depending on the version - check the folder \\spekefs2012\Projects\Development\MCS\# Source for updated folders or zip files

2) Startup Visual Studio.

3) Configure TFS server.

4) CALIDUS MCS source can be found underneath Calidus MCS.

5) Once that is setup, open the project from source control.

(You might need to specify a local path at this point – match it up to where you put you local copy of MCS earlier). The system will prompt if you should overwrite existing files – elect to overwrite.

6) Once that’s done, you should have access to all the code.

Project Set-up

7) Click on the CustomServerControls project and open References.

8) Remove OracleDataAccess.

9) Right-click on References and add reference to the installed Oracle.DataAccess.dll. This will be located within the Oracle home directory, usually here:

a. C:\app\UserName\product\11.2.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll

10) Repeat these steps for the DatabaseClassLibrary project.

11) Build the solution.

Runtime Set-up

12) Configure your web.config.

These 2 settings need to point to the files under App_Data.

 <appSettings>
   <add key="MessageFile" value="C:\Users\appadun.ANISA\Documents\Workspace\Projects\Calidus MCS\WebSite\App_Data\msg_file.txt"/>
   <add key="KnownBadListFile" value="C:\Users\appadun.ANISA\Documents\Workspace\Projects\Calidus MCS\WebSite\App_Data\knownBadList.txt"/>

13) The application uses the ASP session state service to handle sessions. You’ll need to ensure that the session state service is enabled and started on your PC.

Advise that you change it to automatic startup if it is currently set to "Manual".

14) Run the app.