Development Notes - Revision history

Anw: Updated Project and Oracle installation details.

2019-09-04T10:42:31Z

Updated Project and Oracle installation details.

← Older revision		Revision as of 12:42, 4 September 2019
Line 15:		Line 15:
	== Oracle Set-up ==		== Oracle Set-up ==
	Install the Oracle Client.		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.		Install Oracle ODT into same base folder.
Line 24:		Line 27:
	{{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.		{{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 \\~~spekefs~~\Projects\Development\MCS\# Source\Start\Calidus MCS to where you want your project setup locally.		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		2) Startup Visual Studio.

	3) Configure TFS server.		3) Configure TFS server.
Line 33:		Line 36:


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

	[[File:MCS_DevNotes_TFS2.png\|Border\|600px]]		[[File:MCS_DevNotes_TFS2.png\|Border\|600px]]


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

	[[File:MCS_DevNotes_TFS3.png\|Border\|600px]]		[[File:MCS_DevNotes_TFS3.png\|Border\|600px]]
Line 49:		Line 52:


	(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.		(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.		6) Once that’s done, you should have access to all the code.
Line 59:		Line 62:
	8) Remove OracleDataAccess.		8) Remove OracleDataAccess.

	9) Right-click on References and add reference to the installed Oracle.DataAccess.dll, usually here:		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:\product\11.2.0\~~dbhome_1~~\odp.net\bin\4\Oracle.DataAccess.dll		: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.		10) Repeat these steps for the DatabaseClassLibrary project.

	11) Build the solution		11) Build the solution.


	== Runtime Set-up ==		== Runtime Set-up ==
	12) Configure your web.config		12) Configure your web.config.
	These 2 settings need to point to the files under App_Data
			These 2 settings need to point to the files under App_Data.

	<appSettings>		<appSettings>
Line 80:		Line 84:


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

	[[File:MCS_DevNotes_Runtime2.png\|Border\|300px]]		[[File:MCS_DevNotes_Runtime2.png\|Border\|300px]]


	14) Run the app		14) Run the app.

	[[Category:Developer Guides]]		[[Category:Developer Guides]]
	[[Category:Technical]]		[[Category:Technical]]

Anw: Categorisation of document pages

2019-09-03T08:14:26Z

Categorisation of document pages

← Older revision		Revision as of 10:14, 3 September 2019
Line 88:		Line 88:

	[[Category:Developer Guides]]		[[Category:Developer Guides]]
			[[Category:Technical]]

Anw: Categorisation of document pages

2019-09-02T10:49:21Z

Categorisation of document pages

← Older revision		Revision as of 12:49, 2 September 2019
Line 87:		Line 87:
	14) Run the app		14) Run the app

	[[Category:Developer]]		[[Category:Developer Guides]]

Anw: Categorisation of document pages

2019-09-02T10:46:12Z

Categorisation of document pages

← Older revision		Revision as of 12:46, 2 September 2019
Line 86:		Line 86:

	14) Run the app		14) Run the app

			[[Category:Developer]]

Anw: Initial creation

2019-09-02T10:42:26Z

Initial creation

New page

{{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.

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 \\spekefs\Projects\Development\MCS\# Source\Start\Calidus MCS to where you want your project setup locally.

2) Startup Visual Studio

3) Configure TFS server.

[[File:MCS_DevNotes_TFS1.png|Border|600px]]

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

[[File:MCS_DevNotes_TFS2.png|Border|600px]]

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

[[File:MCS_DevNotes_TFS3.png|Border|600px]]

[[File:MCS_DevNotes_TFS4.png|Border|300px]]

[[File:MCS_DevNotes_TFS5.png|Border|300px]]

[[File:MCS_DevNotes_TFS6.png|Border|300px]]

(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, usually here:
:a. C:\product\11.2.0\dbhome_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.

[[File:MCS_DevNotes_Runtime1.png|Border|600px]]

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

[[File:MCS_DevNotes_Runtime2.png|Border|300px]]

14) Run the app