Consultingwerk.OERA.ServiceAdapter - SmartComponent Library

Namespace:

Consultingwerk.OERA

Class

ServiceAdapter

Parent classes:

Progress.Lang.Object

Consultingwerk.OERA.ServiceAdapter

Inherits:

Progress.Lang.Object

Implements:

Consultingwerk.OERA.IServiceAdapter, Consultingwerk.OERA.IServiceAdapterWithContextDataset, Consultingwerk.OERA.IServiceAdapterWithContextEvents, Consultingwerk.OERA.IServiceAdapterWithInvokeTask, Consultingwerk.OERA.IServiceAdapterWithInvokeTaskAsync, Consultingwerk.OERA.IServiceAdapterWithSubmitDataParameter

File:	ServiceAdapter
Purpose:	Default OERA ServiceAdapter implementation
Syntax:	Automatically instantiated when accessing the
	Consultingwerk.Framework.FrameworkSettings:ServiceAdapter
	for the first time in a session
Author(s):	Mike Fechner / Consultingwerk Ltd.
Created:	Tue Jun 01 09:27:33 CEST 2010
Notes:	The OERA ServiceAdapter is the only class of the
	SmartComponent Library framework that actually communicates
	with the Backend for Data-Retrieval.
	Supports custom LogEntryType:CustomLogEntries by using
	the Log entry type stored in the CUSTOM_LOG_ENTRY property
	(Default is "ServiceAdapter")

Top Method Summary

Options	Name	Purpose
#	HANDLE ConnectService (character)	Returns the handle to the AppServer partition associated with This SmartDataAdapter
#	HANDLE ConnectService (character, character)	Returns the handle to the AppServer partition associated with This SmartDataAdapter
+	FetchDataset (character, character, dataset-handle)	Returns an Empty Dataset (schema) to the client.
+	FetchDataset (character, character, dataset-handle, handle)	Returns an Empty Dataset (schema) to the client.
#	LOGICAL HandleDisconnection (character, character)	Handles disconnect issues by attempting to reconnect to the AppServer
+	InvokeMethod (character, character, character, dataset-handle, ISerializable)	Invokes a custom method of the BusinessEntity.
+	InvokeMethod (character, character, character, dataset-handle, ISerializable, handle)	Invokes a custom method of the BusinessEntity.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, dataset-handle, dataset-handle, ISerializable)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, dataset-handle, dataset-handle, ISerializable, handle)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, dataset-handle, ISerializable)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, dataset-handle, ISerializable, handle)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, ISerializable)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, ISerializable, handle)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, ISerializable)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, ISerializable, handle)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, ISerializable)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, ISerializable, handle)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, ISerializable)	Invokes a method in a Task class.
+	Progress.Lang.Object InvokeTask (character, character, character, ISerializable, handle)	Invokes a method in a Task class.
+	HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, handle, handle, ISerializable, handle, Object)	Invokes a method in a Task class asynchronously
+	HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, handle, handle, ISerializable, Object)	Invokes a method in a Task class asynchronously
+	HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, handle, ISerializable, handle, Object)	Invokes a method in a Task class asynchronously
+	HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, handle, ISerializable, Object)	Invokes a method in a Task class asynchronously
+	HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, ISerializable, handle, Object)	Invokes a method in a Task class asynchronously
+	HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, ISerializable, Object)	Invokes a method in a Task class asynchronously
+	HANDLE InvokeTaskAsync (character, character, character, handle, handle, ISerializable, handle, Object)	Invokes a method in a Task class asynchronously
+	HANDLE InvokeTaskAsync (character, character, character, handle, handle, ISerializable, Object)	Invokes a method in a Task class asynchronously
+	HANDLE InvokeTaskAsync (character, character, character, handle, ISerializable, handle, Object)	Invokes a method in a Task class.
+	HANDLE InvokeTaskAsync (character, character, character, handle, ISerializable, Object)	Invokes a method in a Task class.
+	HANDLE InvokeTaskAsync (character, character, character, ISerializable, handle, Object)	Invokes a method in a Task class.
+	HANDLE InvokeTaskAsync (character, character, character, ISerializable, Object)	Invokes a method in a Task class.
+	OnAsyncTaskCompleted (AsyncTaskCompletedEventArgs)	Raises the AsyncTaskCompleted
#	OnCollectContextFromServer (EventArgs)	Raises the CollectContextFromServer
#	OnExiting (EventArgs)	Raises the Existing event
#	OnPrepareContextForServer (EventArgs)	Raises the PrepareContextForServer
+	RetrieveData (character, character, IFetchDataRequest, dataset-handle)	Reads data from the Backend
+	RetrieveData (character, character, IFetchDataRequest, dataset-handle, handle)	Reads data from the Backend
+	SubmitData (character, character, dataset-handle)	Saves modified (Create, Update, Delete) data to a Business Entity
+	SubmitData (character, character, dataset-handle, character)	Saves modified (Create, Update, Delete) data to a Business Entity
+	SubmitData (character, character, dataset-handle, character, handle)	Saves modified (Create, Update, Delete) data to a Business Entity
+	SubmitData (character, character, dataset-handle, character, ISerializable)	Saves modified (Create, Update, Delete) data to a Business Entity
+	SubmitData (character, character, dataset-handle, character, ISerializable, handle)	Saves modified (Create, Update, Delete) data to a Business Entity
+	SubmitData (character, character, dataset-handle, ISerializable)	Saves modified (Create, Update, Delete) data to a Business Entity
+	SubmitData (character, character, dataset-handle, ISerializable, handle)	Saves modified (Create, Update, Delete) data to a Business Entity
+	LOGICAL ValidateEntityName (character, character)	Validates a business entity or business task name
#	WriteLogMessage (character, character, character, character)	Writes a message to the log file

Top Constructor Summary

	Options	Name	Purpose
	+	ServiceAdapter ()	Constructor for the ServiceAdapter class

Top Event Summary

Options	Name	Purpose
+	AsyncTaskCompleted (Object, AsyncTaskCompletedEventArgs)	Raised when an Async Task has completed
+	CollectContextFromServer (Object, EventArgs)	Raised after the ServiceAdapter has performed an Request to the AppServer
+	Exiting (Object, EventArgs)	Raised when Exiting due to a lost AppServer connection
+	PrepareContextForServer (Object, EventArgs)	Raised before the ServiceAdapter performs an Request to the AppServer

Top Property Summary

	Options	Name	Purpose
	+	CHARACTER AppServerPartition
	+	Consultingwerk.OERA.OptionsOnDisconnectEnum BehaviorOnDisconnect
	+	LOGICAL BlockedByReconnectDialog
	+	CHARACTER CUSTOM_LOG_ENTRY
	+	LOGICAL LoggingActive
	+	CHARACTER ServiceInterfacePath

Method Detail

Top

PROTECTED HANDLE ConnectService (character)

Purpose:	Returns the handle to the AppServer partition associated with
	This SmartDataAdapter
Notes:

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition
Returns	HANDLE
	The handle of the AppServer partition of SESSION:HANDLE

Top

PROTECTED HANDLE ConnectService (character, character)

Purpose:	Returns the handle to the AppServer partition associated with
	This SmartDataAdapter
Notes:	This variant of the method should be overridden in case customers
	need to determine the default partion name based on the business
	service accessed

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition
pcBusinessServiceName	CHARACTER
	The name of the Business Service
Returns	HANDLE
	The handle of the AppServer partition of SESSION:HANDLE

Top

PUBLIC FetchDataset (character, character, dataset-handle)

Purpose:	Returns an Empty Dataset (schema) to the client.
Notes:	The caller of this method is responsible to clean up the Dataset
	when no longer used! The called should always invoke this method
	with the dataset output parameter BY-REFERENCE!

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
phDataset	DATASET-HANDLE
	OUTPUT DATASET-HANDLE The empty dataset

Top

PUBLIC FetchDataset (character, character, dataset-handle, handle)

Purpose:	Returns an Empty Dataset (schema) to the client.
Notes:	The caller of this method is responsible to clean up the Dataset
	when no longer used! The called should always invoke this method
	with the dataset output parameter BY-REFERENCE!

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
phDataset	DATASET-HANDLE
	OUTPUT DATASET-HANDLE The empty dataset
phContextDataset	HANDLE
	The handle of the context dataset for this call

Top

PROTECTED LOGICAL HandleDisconnection (character, character)

Purpose:	Handles disconnect issues by attempting to reconnect to the AppServer
Notes:

Parameters:
pcPartition	CHARACTER
	The AppServer partition
pcErrorMessage	CHARACTER
	The original error message
Returns	LOGICAL
	Logicla value indicating if the connection could be re-established or the issue should be ignored

Top

PUBLIC InvokeMethod (character, character, character, dataset-handle, ISerializable)

Purpose:	Invokes a custom method of the BusinessEntity.
Notes:	When the poParameter is expected to just return values, it must still
	be passed in to this method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the dataset of the business entity, optionally INPUT, optionally OUTPUT
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method

Top

PUBLIC InvokeMethod (character, character, character, dataset-handle, ISerializable, handle)

Purpose:	Invokes a custom method of the BusinessEntity.
Notes:	The phContextDataset parameter is intended to be passed by-reference

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the dataset of the business entity, optionally INPUT, optionally OUTPUT
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, dataset-handle, dataset-handle, ISerializable)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
phDataset2	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the second dataset to be passed to the task method
phDataset3	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the third dataset to be passed to the task method
phDataset4	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the fourth dataset to be passed to the task method
phDataset5	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the fifth dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, dataset-handle, dataset-handle, ISerializable, handle)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
phDataset2	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the second dataset to be passed to the task method
phDataset3	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the third dataset to be passed to the task method
phDataset4	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the fourth dataset to be passed to the task method
phDataset5	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the fifth dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, dataset-handle, ISerializable)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
phDataset2	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the second dataset to be passed to the task method
phDataset3	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the third dataset to be passed to the task method
phDataset4	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the fourth dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, dataset-handle, ISerializable, handle)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
phDataset2	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the second dataset to be passed to the task method
phDataset3	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the third dataset to be passed to the task method
phDataset4	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the fourth dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, ISerializable)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
phDataset2	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the second dataset to be passed to the task method
phDataset3	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the third dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, dataset-handle, ISerializable, handle)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
phDataset2	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the second dataset to be passed to the task method
phDataset3	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the third dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, ISerializable)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
phDataset2	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the second dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, dataset-handle, ISerializable, handle)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
phDataset2	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the second dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, ISerializable)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, dataset-handle, ISerializable, handle)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The handle of the first dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, ISerializable)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC Progress.Lang.Object InvokeTask (character, character, character, ISerializable, handle)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
Returns	Progress.Lang.Object
	The return object of the method

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, handle, handle, ISerializable, handle, Object)

Purpose:	Invokes a method in a Task class asynchronously
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
phDataset2	HANDLE
	The handle of the second dataset to be passed to the task method
phDataset3	HANDLE
	The handle of the third dataset to be passed to the task method
phDataset4	HANDLE
	The handle of the fourth dataset to be passed to the task method
phDataset5	HANDLE
	The handle of the fifth dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, handle, handle, ISerializable, Object)

Purpose:	Invokes a method in a Task class asynchronously
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
phDataset2	HANDLE
	The handle of the second dataset to be passed to the task method
phDataset3	HANDLE
	The handle of the third dataset to be passed to the task method
phDataset4	HANDLE
	The handle of the fourth dataset to be passed to the task method
phDataset5	HANDLE
	The handle of the fifth dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, handle, ISerializable, handle, Object)

Purpose:	Invokes a method in a Task class asynchronously
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
phDataset2	HANDLE
	The handle of the second dataset to be passed to the task method
phDataset3	HANDLE
	The handle of the third dataset to be passed to the task method
phDataset4	HANDLE
	The handle of the fourth dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, handle, ISerializable, Object)

Purpose:	Invokes a method in a Task class asynchronously
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
phDataset2	HANDLE
	The handle of the second dataset to be passed to the task method
phDataset3	HANDLE
	The handle of the third dataset to be passed to the task method
phDataset4	HANDLE
	The handle of the fourth dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, ISerializable, handle, Object)

Purpose:	Invokes a method in a Task class asynchronously
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
phDataset2	HANDLE
	The handle of the second dataset to be passed to the task method
phDataset3	HANDLE
	The handle of the third dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, handle, handle, ISerializable, Object)

Purpose:	Invokes a method in a Task class asynchronously
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
phDataset2	HANDLE
	The handle of the second dataset to be passed to the task method
phDataset3	HANDLE
	The handle of the third dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, handle, ISerializable, handle, Object)

Purpose:	Invokes a method in a Task class asynchronously
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
phDataset2	HANDLE
	The handle of the second dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, handle, ISerializable, Object)

Purpose:	Invokes a method in a Task class asynchronously
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
phDataset2	HANDLE
	The handle of the second dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, ISerializable, handle, Object)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, handle, ISerializable, Object)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
phDataset1	HANDLE
	The handle of the first dataset to be passed to the task method
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, ISerializable, handle, Object)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
phContextDataset	HANDLE
	The handle of the context dataset for this call
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC HANDLE InvokeTaskAsync (character, character, character, ISerializable, Object)

Purpose:	Invokes a method in a Task class.
Notes:	When no MethodName is passed then "Invoke" will be executed as the
	default task method

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcTaskName	CHARACTER
	The name of the task class
pcMethodName	CHARACTER
	The name of the business entity method to invoke
poParameter	Consultingwerk.ISerializable
	The serializable parameter object to the method
poContext	Progress.Lang.Object
	The reference to the context object to be returned with the AsyncTaskCompleted event
Returns	HANDLE
	The handle of the async AppServer request

Top

PUBLIC OnAsyncTaskCompleted (AsyncTaskCompletedEventArgs)

Purpose:	Raises the AsyncTaskCompleted
Notes:	This method is public because it's invoked by the async request handler
	procedure

Parameters:
e	Consultingwerk.OERA.AsyncTaskCompletedEventArgs
	The AsyncTaskCompletedEventArgs with the data for the event

Top

PROTECTED OnCollectContextFromServer (EventArgs)

Purpose:	Raises the CollectContextFromServer
Notes:

Parameters:
e	Consultingwerk.EventArgs
	The Consultingwerk.EventArgs with the data for the event

Top

PROTECTED OnExiting (EventArgs)

Purpose:	Raises the Existing event
Notes:

Parameters:
e	Consultingwerk.EventArgs
	The Consultingwerk.EventArgs with the data for this event

Top

PROTECTED OnPrepareContextForServer (EventArgs)

Purpose:	Raises the PrepareContextForServer
Notes:

Parameters:
e	Consultingwerk.EventArgs
	The Consultingwerk.EventArgs with the data for the event

Top

PUBLIC RetrieveData (character, character, IFetchDataRequest, dataset-handle)

Purpose:	Reads data from the Backend
Notes:	Request Parameters are send using the IFetchDataRequest object

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
poFetchDataRequest	Consultingwerk.OERA.IFetchDataRequest
	The IFetchDataRequest object with the data for this request
phDataSet	DATASET-HANDLE
	OUTPUT DATASET-HANDLE The resulting dataset

Top

PUBLIC RetrieveData (character, character, IFetchDataRequest, dataset-handle, handle)

Purpose:	Reads data from the Backend
Notes:	Request Parameters are send using the IFetchDataRequest object
	The phContextDataset parameter is intended to be passed by-reference

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
poFetchDataRequest	Consultingwerk.OERA.IFetchDataRequest
	The IFetchDataRequest object with the data for this request
phDataSet	DATASET-HANDLE
	OUTPUT DATASET-HANDLE The resulting dataset
phContextDataset	HANDLE
	The handle of the context dataset for this call

Top

PUBLIC SubmitData (character, character, dataset-handle)

Purpose:	Saves modified (Create, Update, Delete) data to a Business Entity
Notes:	It's recommended but not required to just pass a changes dataset

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
hChangesDataset	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The dataset with the modifications to the submitted

Top

PUBLIC SubmitData (character, character, dataset-handle, character)

Purpose:	Saves modified (Create, Update, Delete) data to a Business Entity
Notes:	It's recommended but not required to just pass a changes dataset

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
hChangesDataset	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The dataset with the modifications to the submitted
pcContext	CHARACTER
	INPUT-OUTPUT The context to be passed to the business entity

Top

PUBLIC SubmitData (character, character, dataset-handle, character, handle)

Purpose:	Saves modified (Create, Update, Delete) data to a Business Entity
Notes:	It's recommended but not required to just pass a changes dataset
	The phContextDataset parameter is intended to be passed by-reference

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
hChangesDataset	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The dataset with the modifications to the submitted
pcContext	CHARACTER
	INPUT-OUTPUT The context to be passed to the business entity
phContextDataset	HANDLE
	The handle of the context dataset for this call

Top

PUBLIC SubmitData (character, character, dataset-handle, character, ISerializable)

Purpose:	Saves modified (Create, Update, Delete) data to a Business Entity
Notes:	It's recommended but not required to just pass a changes dataset

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
hChangesDataset	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The dataset with the modifications to the submitted
pcContext	CHARACTER
	INPUT-OUTPUT The context to be passed to the business entity
poParameter	Consultingwerk.ISerializable
	An optional serializable parameter object to be exchanged with the business entity

Top

PUBLIC SubmitData (character, character, dataset-handle, character, ISerializable, handle)

Purpose:	Saves modified (Create, Update, Delete) data to a Business Entity
Notes:	It's recommended but not required to just pass a changes dataset
	The phContextDataset parameter is intended to be passed by-reference

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
hChangesDataset	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The dataset with the modifications to the submitted
pcContext	CHARACTER
	INPUT-OUTPUT The context to be passed to the business entity
poParameter	Consultingwerk.ISerializable
	An optional serializable parameter object to be exchanged with the business entity
phContextDataset	HANDLE
	The handle of the context dataset for this call

Top

PUBLIC SubmitData (character, character, dataset-handle, ISerializable)

Purpose:	Saves modified (Create, Update, Delete) data to a Business Entity
Notes:	It's recommended but not required to just pass a changes dataset

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
hChangesDataset	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The dataset with the modifications to the submitted
poParameter	Consultingwerk.ISerializable
	An optional serializable parameter object to be exchanged with the business entity

Top

PUBLIC SubmitData (character, character, dataset-handle, ISerializable, handle)

Purpose:	Saves modified (Create, Update, Delete) data to a Business Entity
Notes:	It's recommended but not required to just pass a changes dataset
	The phContextDataset parameter is intended to be passed by-reference

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
hChangesDataset	DATASET-HANDLE
	INPUT-OUTPUT DATASET-HANDLE The dataset with the modifications to the submitted
poParameter	Consultingwerk.ISerializable
	An optional serializable parameter object to be exchanged with the business entity
phContextDataset	HANDLE
	The handle of the context dataset for this call

Top

PUBLIC LOGICAL ValidateEntityName (character, character)

Purpose:	Validates a business entity or business task name
Notes:	Typically used by the extensions to the OpenEdge Architect Visual
	Designer

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition for this call or "" for the default partition
pcEntityName	CHARACTER
	The name of the business entity
Returns	LOGICAL
	Logical value indicating if the Business Entity name if valid

Top

PROTECTED WriteLogMessage (character, character, character, character)

Purpose:	Writes a message to the log file
Notes:

Parameters:
pcPartition	CHARACTER
	The name of the AppServer partition
pcServiceName	CHARACTER
	The name of the business entity or business task
pcMethodName	CHARACTER
	The name of the method in the service adapter
pcComments	CHARACTER
	Additional comments

Constructor Detail

Top

PUBLIC ServiceAdapter ()

Purpose:	Constructor for the ServiceAdapter class
Notes:

Event Detail

Top

PUBLIC AsyncTaskCompleted (Object, AsyncTaskCompletedEventArgs)

Purpose:	Raised when an Async Task has completed
Notes:

Parameters:
sender	Progress.Lang.Object
	The object that raised the AsyncTaskCompleted event
e	Consultingwerk.OERA.AsyncTaskCompletedEventArgs
	The AsyncTaskCompletedEventArgs with the data for the event

Top

PUBLIC CollectContextFromServer (Object, EventArgs)

Purpose:	Raised after the ServiceAdapter has performed an Request to the AppServer
Notes:

Parameters:
sender	Progress.Lang.Object
	The object that raised the CollectContextFromServer event
e	Consultingwerk.EventArgs
	The Consultingwerk.EventArgs with the data for the event

Top

PUBLIC Exiting (Object, EventArgs)

Purpose:	Raised when Exiting due to a lost AppServer connection
Notes:

Parameters:
sender	Progress.Lang.Object
	The object that raised the AsyncTaskCompleted event
e	Consultingwerk.EventArgs
	The Consultingwerk.EventArgs with the data for the event

Top

PUBLIC PrepareContextForServer (Object, EventArgs)

Purpose:	Raised before the ServiceAdapter performs an Request to the AppServer
Notes:

Parameters:
sender	Progress.Lang.Object
	The object that raised the PrepareContextForRequest event
e	Consultingwerk.EventArgs
	The Consultingwerk.EventArgs with the data for the event

Property Detail

Top

PUBLIC CHARACTER AppServerPartition

Returns	CHARACTER

Top

PUBLIC Consultingwerk.OERA.OptionsOnDisconnectEnum BehaviorOnDisconnect

Returns	Consultingwerk.OERA.OptionsOnDisconnectEnum

Top

PUBLIC LOGICAL BlockedByReconnectDialog

Returns	LOGICAL

Top

PUBLIC CHARACTER CUSTOM_LOG_ENTRY

Returns	CHARACTER

Top

PUBLIC LOGICAL LoggingActive

Returns	LOGICAL

Top

PUBLIC CHARACTER ServiceInterfacePath

Returns	CHARACTER

info@consultingwerk.de http://www.consultingwerk.de 04.02.2020 23:14:56