GetCustOrders Sample
====================

This sample allows the user to specify the AppServer hostname,
AppServer Broker name, and the quantity of Customer records to 
retrieve.  There is a "Get Orders" push button that causes the 
application to call the 4GL procedure and receives an ADO.NET 
DataSet that contains the three DataTables (Customer, Orders, 
and OrderLine) as well as the data relations between them.  
The resulting DataSet is then placed on a DataGrid which is 
visible in the application.

The application uses the Progress .NET Open Client to obtain Customers, 
Orders, and OrderLines records from an Progress AppServer that is 
connected to a sports2000 database


Steps to run the sample:  
======================== 

1) Run ProxyGen (Start->Programs->OpenEdge->Proxy Generator)
   a) Open the file CustOrders.xpxg found in: 
	<yourInstallDir>\samples\open4gl\dotnet\AppService\GetCustOrders

   b) Select File->Generate and press OK. 
      This will generate the .NET proxy dll in 
	<yourInstallDir>\samples\open4gl\dotnet\GetCustOrders\CustOrdersProxy\CustProxy.dll

   	If your install directory is different than C:\Progress\OpenEdge, you need
      to do the following changes before generating:

	- Select Tools->Change Propath
	  Change the propath component
		C:\Progress\OpenEdge\src\samples\dotnet\AppService
	  to:
		<yourInstallDir>\samples\dotnet\AppService

   	- Change the Output dir on the General tab of the Generate dialog to
		<yourInstallDir>\samples\dotnet\GetCustOrders\

2) Setup a Progress AppServer that is connected to a 
   sports2000 database.

3) Copy the .p files from the ..\AppService\GetCustOrders directory
   into the AppServer's work directory - typically C:\OpenEdge\WRK.
   Keep the 4GL files in the GetCustOrders subdirectory.

4) Open the 'GetCustOrders.sln' in Visual Studio .NET

5) Update the references in the project if necessary. This sample
   assumes that OpenEdge was installed to the default location
   C:\Progress\OpenEdge. If your install directory is different, 
   you must remove and re-add the following references:
	<yourInstallDir>\samples\dotnet\GetCustOrders\CustOrdersProxy\Progress.o4glrt.dll
	<yourInstallDir>\samples\dotnet\GetCustOrders\CustOrdersProxy\CustProxy.dll
	
5) Build & run the sample.




Related Files:
==============

.NET Solution/Project Files
	GetCustOrders.sln
	GetCustOrders.suo
	GetCustOrders.csproj

.NET Client Code
	Form1.cs
	Form1.resx

Proxy File (built in step 1)
	CustOrdersProxy\CustOrders.dll
		Contains the .NET Open Client Object classes in the 
		CustOrdersProxy namespace:
		  	CustOrders

		This also includes the .NET Strongly-typed DataSet class
		in the CustOrdersProxy.StrongTypesNS namespace:
			CustOrdLinDataSet
			CustOrdLinDataSet.ttCustDataTable
			CustOrdLinDataSet.ttCustRow
			CustOrdLinDataSet.ttOrderDataTable
			CustOrdLinDataSet.ttOrderRow
			CustOrdLinDataSet.ttOrdLinDataTable
			CustOrdLinDataSet.ttOrdLinRow

4GL File 
	<yourInstallDir>\samples\open4gl\dotnet\AppService\GetCustOrders\GetCustOrds.p

Open Client Runtime
	<yourInstallDir>\dotnet\deploy\signed\*
		Open Client Runetime files needed for deployment.
		By default OpenEdge is installed to C:\Progress\OpenEdge


