Namespace: Consultingwerk.SmartComponents.Implementation
Class 
SmartBusinessEntityAdapter Copy to Clipboard
Parent classes:
Inherits: Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Implements: Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource, Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataTarget, ICustomTypeDescriptor, Consultingwerk.SmartComponents.Implementation.IDatasetControllerConsumer, IDesignGroupCreateSource, IHasDesignerVerbs, Consultingwerk.SmartComponents.Interfaces.IProvidesRecordKey, Consultingwerk.SmartComponents.Implementation.ISmartBusinessEntityAdapter, Consultingwerk.SmartComponents.Implementation.ISmartBusinessEntityAdapterEvents, Consultingwerk.SmartComponents.Interfaces.ISmartCommitTarget, Consultingwerk.SmartComponents.Interfaces.ISmartDataSource, Consultingwerk.SmartComponents.Interfaces.ISmartDataSourceWithDataset, Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget, Consultingwerk.SmartComponents.Interfaces.ISmartFilterTarget, Consultingwerk.SmartComponents.Interfaces.ISmartGroupCreateSource, Consultingwerk.SmartComponents.Interfaces.ISmartNavigationTarget, Consultingwerk.SmartComponents.Interfaces.ISortableDataSource, Consultingwerk.SmartComponents.Interfaces.IStoresCopiedFrom, Consultingwerk.SmartComponents.Implementation.ISupportsFetchAll, Consultingwerk.SmartComponents.Interfaces.ISupportsReposition, Consultingwerk.SmartComponents.Interfaces.ISupportsScrollup, Consultingwerk.SmartComponents.Interfaces.ISupportsSubmitChanges, System.ComponentModel.ISupportInitialize

File:SmartBusinessEntityAdapter
Purpose:Provides navigation and update capabilities for tables
of a Business Entity ProDataset. Manages the Query and
ProBindingSource at runtime and provides design time
support using a custom TypeDescriptor
Author(s):Marko Rüterbories, Mike Fechner / Consultingwerk Ltd.
Created:Mon Apr 06 10:34:27 CEST 2009



Top Method Summary
Options Name Purpose
# ActivateSmartViewerEventHandler () Activates SmartViewer TextChanged/ChechedChanged Event Handlers after a navigation (FetchFirst/FetchNext/FetchPrev/FetchLast)
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# AddRecordInUpdatableGrid () Ensures an updatable browser is in the correct adding state after a record was createrd through the Binding Source event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ AddSmartNavigationSource (ISmartNavigationSource) Adds a(nother) SmartNavigationSource to the SmartDataAdapter instance
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ AttachBindingSource (BindingSource) This Method is used to attach a new BindingSource to a SmartDataTarget. Inside a SmartDataAdapter which can be a SmartDataTarget a new BindingSource is created or borrowed from a Browser.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# AttachQueryToBindingSource () Attaches the Query/ProDataset to the BindingSource
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:AttachQueryToBindingSource ()
# AttachSchemaToBindingSource (BindingSource) Attaches the Data Schema to the BindingSource
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:AttachSchemaToBindingSource (BindingSource)
+ BeginInit () Invoked at the beginning of a Containers InitializeComponents method
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ BeginTransactionState () Begins a transaction when starting update
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:BeginTransactionState ()
+ BeginUpdateState (ISmartDataTarget) The Message to for instance Disable a Browser is send to all SmartDataTargets except the calling one
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:BeginUpdateState (ISmartDataTarget)
# BeginUpdateStateHandler (Object, DataSourceUpdateStateEventArgs) Event handler for the BeginUpdateState event of the SmartDataSource
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ CancelCreateRecord () Invoked from the SmartDataTarget to cancel the creation of a new row
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CancelCreateRecord ()
# A CancelCreateRowHandler (Object, CancelCreateRowEventArgs) Event Handler for the CancelCreateRow event of the ProBindingSource
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CancelCreateRowHandler (Object, CancelCreateRowEventArgs)
+ CancelInDataTargets () Recursively invokes CancelUpdate in all DataTargets that are currently updating
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ ClearPreviousQueryString (logical) Clears the PreviousQueryString information to ensure that the ParentPositionChanged event handler does reopen the query regardless of identical key values
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ CloseQuery () Empty the DATASET inside the DataAdapter and reopen Query.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CloseQuery ()
+ CommitTransaction () Commits the transaction to the backend
# HANDLE ConnectService () Returns the handle of the AppServer partition associated with this SmartDataAdapter
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# CreateBindingSource () CreateBindingSource is to be called inside the RetrieveData Method if no valid BindingSource is present inside the SmartDataAdapter. The newly created BindingSource is then registered to all SmartDataTargets of this SmartDataAdapter.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ CreateParentRecord (character) Creates a parent record when needed for creating a record in a SmartGroupCreateTarget
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ CreateRecord () Invoked from the SmartDataTarget to create a new row
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CreateRecord ()
# A CreateRowHandler (Object, CreateRowEventArgs) Handler for the CreateRow event of the ProBindingSource
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CreateRowHandler (Object, CreateRowEventArgs)
# CreateVerbs () Creates Designer Verbs based on the DesignerVerbs property
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ DeactivateSmartViewerEventHandler () Activates SmartViewer TextChanged/ChechedChanged Event Handlers after a navigation (FetchFirst/FetchNext/FetchPrev/FetchLast) */
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# LOGICAL DeleteQueryRow () This protected method can be used to remove the current row from a Query. This method calls DeleteQueryRow(FALSE).
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# LOGICAL DeleteQueryRow (logical) This protected method can be used to remove the current row from a Query. The parameter is logical and controls if only the first table (FALSE) or all rows shall be removed.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ A DeleteRow () The DeleteRow is an abstract method - that means that it needs to be overridden in a class that inherits from this base class. Enforced by Interface ISmartDataSource.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:DeleteRow ()
+ DeregisterSmartDataTarget (ISmartDataTarget) Deregister a SmartDataTarget with the SmartDataSource. Usually done when a SmartDataTarget is deleted and the SmartDataSource is still running
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ DeregisterSmartGroupCreateTarget (ISmartGroupCreateTarget) Deregister a SmartGroupCreateTarget with the SmartGroupCreateSource *
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# DisposedHandler (Object, EventArgs) Event handler for the Disposed event of this instance
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ EmptyDataset () Empties the ProDataset
+ EndInit () Executed at the end of the initialization of the SmartBusinessEntityAdapter to launch the DatasetController (if any).
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:EndInit ()
+ EndUpdateState (ISmartDataTarget) The Message to for instance enable a Browser is send to all SmartDataTargets except the calling one.
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:EndUpdateState (ISmartDataTarget)
# EndUpdateStateHandler (Object, DataSourceUpdateStateEventArgs) Event handler for the EndUpdateState event of the SmartDataSource
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# EndUpdateStateInDataSource (ISmartDataTarget) Invokes EndUpdateState in the SmartDataSource of this SmartDataAdapter
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:EndUpdateStateInDataSource (ISmartDataTarget)
# CHARACTER EvaluateParentQuery () Evaluates the QueryString based on the Parent Filter Fields
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ EvaluateTableIOState () This Method is enforced by the Interface ISmartDataTarget and is only required for visual DataTargets.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ LOGICAL FetchAll () Fetches all remaining data from the backend
+ LOGICAL FetchFirst () Overrides FetchFirst in SmartDataAdpater. Retrieves the first batch of records when backwards batching
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:FetchFirst ()
+ LOGICAL FetchLast () Overrides FetchLast in SmartDataAdapter to retrieve full business entity result when batching.
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:FetchLast ()
+ FetchLastOnServer () Fetch Last On Server, used by FetchLast when FetchLastOnServer = TRUE
+ FetchMoreRowsForwards (integer) Fetches additional rows forwards
+ LOGICAL FetchNext () This Method moves to the next DataRow inside the BindingSource.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ LOGICAL FetchPrev () Overrides FetchPrev in SmartDataAdpater. Retrieves the previous batch of records when backwards batching
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:FetchPrev ()
+ LOGICAL FindLastRowWhere (character) Finds the last a row in the EntityTable and locates the BindingSource to that row
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ Consultingwerk.SmartComponents.Base.SmartDatasetAdapter FindLinkedDatasetAdapterForEntityTable (character) Searches for a linked SmartDatasetAdpater with the given entity table
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ Consultingwerk.SmartComponents.Interfaces.ISmartDataBrowser FindLinkedSmartDataBrowser () Returns the reference to the linked SmartDataBrowser, if any
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ Consultingwerk.SmartComponents.Interfaces.ISmartTableIOTarget FindLinkedUpdatingSmartDataTarget () Returns the reference to the first linked ISmartDataTarget which is also an ISmartTableIOTarget, that has a valid SmartTableIOSource assigned
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ LOGICAL FindRowWhere (character) Finds a row in the EntityTable and locates the BindingSource to that row
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ LOGICAL FindRowWhere (character, FindRowWhereModeEnum) Finds a row in the EntityTable and locates the BindingSource to that row, optionally requesting the record on the server when not found on the client.
+ Consultingwerk.SmartComponents.Implementation.SmartBusinessEntityAdapter FromDatasetController (IDatasetController) Locates the SmartBusinessEntityAdapter instance that is working with the passed in IDatasetController
+ AttributeCollection GetAttributes () Returns a collection of custom attributes for this instance of a component.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ CHARACTER GetClassName () Returns the class name of this instance of a component.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ CHARACTER GetComponentName () Returns the name of this instance of a component.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ TypeConverter GetConverter () Returns a type converter for this instance of a component.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ CHARACTER GetCurrentRecordKey () Returns a key identifying the current record
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# ROWID GetCurrentRowid () Returns the Current Rowids
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ EventDescriptor GetDefaultEvent () Returns the default event for this instance of a component.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ PropertyDescriptor GetDefaultProperty () Returns the default property for this instance of a component.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
# CHARACTER GetDesignTimeDataSourceClassName () Returns the Class Name used for creating SmartBusinessEntityBindingSource (or derived) components at design time (SCL-1000), using the "Create BindingSource" designer verb
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ System.Object GetEditor (Type) Returns an editor of the specified type for this instance of a component.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
# HANDLE GetEmptyDataset () Retrieves an empty dataset
+ EventDescriptorCollection GetEvents () Returns the events for this instance of a component.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ EventDescriptorCollection GetEvents (Attribute[]) Returns the events for this instance of a component using the specified attribute array as a filter.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ CHARACTER GetFieldValues (character) Returns a CHR(1) delimited list of field values from the DataSource
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:GetFieldValues (character)
# Consultingwerk.ListQueryExpressionByTable GetNewFilterValues () Builds an empty ListQueryExpressionByTable instance and raises the CollectFilterValues event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ PropertyDescriptorCollection GetProperties () Returns the properties for this instance of a component.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ PropertyDescriptorCollection GetProperties (Attribute[]) Returns the properties for this instance of a component using the attribute array as a filter.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ System.Object GetPropertyOwner (PropertyDescriptor) Returns an object that contains the property described by the specified property descriptor.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
# CHARACTER GetRecordPosition () Evaluates the current record position property value
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:GetRecordPosition ()
+ Consultingwerk.SmartComponents.Implementation.RetrieveDataStatusEnum GetRetrieveDataStatus () Evaluates the status of the current RetrieveData operation
+ LOGICAL HasCopiedFromField () Returns if the first table of the Adapter provides a field SmartCopiedFrom
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ LOGICAL HasFields (character) Returns a logical value indicating if the SmartDataAdapter can provide the given fields
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# LOGICAL HasPendingTransaction () Prompts if pending changes should be saved before retrieving new data
# LOGICAL HasPendingUpdate () Prompts if pending update should be saved before retrieving new data, called from RetrieveData
+ InitializeAdapter () Initializes the SmartBusinessEntityAdpater
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:InitializeAdapter ()
+ InitializeAdapter (logical) Initializes the SmartBusinessEntityAdpater
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:InitializeAdapter (logical)
# InitializeServiceAdapter () Initializes the ServiceAdapter property of the SmartBusinessEntityAdapter class
+ InvokeMethod (character, dataset-handle, ISerializable) Invokes a method in the backend OERA business entity
# InvokeParentPositionChanged (Object, EventArgs) Invokes the ParentPositionChanged event handler in all connected SmartDataAdapter instances
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:InvokeParentPositionChanged (Object, EventArgs)
+ LOGICAL IsRowUncommittedAdd () Returns if the current record of the EntityTable is an uncommitted Add (that is ROW-STATE = ROW-CREATED)
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ LOGICAL IsUpdating (logical) Returns if if this Adapter or any of it's Data-Target Adapters are updating (a Data-Target with SmartTableIOState:ModifyingData)
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ LaunchDatasetController () Launches the DatatasetController
# MergeChanges (handle, handle) Invokes the MERGE-CHANGES after data was submitted to the backend
# CHARACTER MergeQueryStrings (character, ListQueryExpressionByTable) Merges two Query Strings
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ Consultingwerk.OERA.IFetchDataRequest NewFetchDataRequest (character, character, character, integer, character) Factory method for IFetchDataRequest objects
# OffEndHandler (Object, OffEndEventArgs) Event handler for the OffEnd event of the ProBindingSource object
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:OffEndHandler (Object, OffEndEventArgs)
+ OffHome () Fetches the Previous Batch of records
# OnAfterAssignRecord (AfterAssignRecordEventArgs) Raises the AfterAssignRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnAfterAutoCommitTransaction (EventArgs) Raises the AfterAutoCommitTransaction event
# OnAfterBatchAvailable (EventArgs) Raises the AfterBatchAvailable event
# OnAfterCancelCreateRecord (AfterCancelCreateRecordEventArgs) Raises the AfterCancelCreateRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnAfterCommitTransaction (EventArgs) Raises the AfterCommitTransaction event
# OnAfterCreateRecord (AfterCreateRecordEventArgs) Raises the AfterCreateRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnAfterDeleteRecord (AfterDeleteRecordEventArgs) Raises the AfterDeleteRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnAfterGetChanges (AfterGetChangesEventArgs) Raises the AfterGetChangesEvent
# OnAfterMergeChanges (MergeChangesEventArgs) Raises the AfterMergeChanges
# OnAfterQueryPositionChanged (EventArgs) Raises the AfterQueryPositionChanged event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnAfterRejectTransaction (EventArgs) Raises the AfterRejectTransaction event
# OnAfterRetrieveData (EventArgs) Raises the AfterRetrieveData event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnAfterUpdateRecord (AfterUpdateRecordEventArgs) Raises the AfterUpdateRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnAssignForeignFields (AssignForeignFieldsEventArgs) Raises the AssignForeignFields
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnAssignKeyFieldError (AssignKeyFieldErrorEventArgs) Raises the AssignKeyFieldError
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnAssignKeyFields (AssignKeyFieldsEventArgs) Raises the AssignKeyFields event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnAutoCommitChanged (EventArgs) Raises the AutoCommitChanged property
# OnBeforeAssignRecord (BeforeAssignRecordEventArgs) Raise the BeforeAssignRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnBeforeCancelCreateRecord (BeforeCancelCreateRecordEventArgs) Raises the BeforeCancelCreateRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnBeforeCommitTransaction (CancelEventArgs) Raises the BeforeCommitTransaction event
# OnBeforeCreateRecord (BeforeCreateRecordEventArgs) Raises the BeforeCreateRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnBeforeCreatingRecord (CancelableEventArgs) Raises the BeforeCreatingRecord
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnBeforeDeleteRecord (BeforeDeleteRecordEventArgs) Raises the BeforeDeleteRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnBeforeGetChanges (BeforeGetChangesEventArgs) Raises the BeforeGetChangesEvent
# OnBeforeMergeChanges (MergeChangesEventArgs) Raises the BeforeMergeChanges event
# OnBeforeRejectTransaction (CancelEventArgs) Raises the BeforeRejectTransaction event
# OnBeforeRetrieveData (CancelEventArgs) Raises the BeforeRetrieveData event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnBeforeUpdateRecord (BeforeUpdateRecordEventArgs) Raises the BeforeUpdateRecord event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnBeginUpdateState (DataSourceUpdateStateEventArgs) Raises the BeginUpdateState event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnBindingSourceChanged (BindingSourceChangedEventArgs) Raises the BindingSourceChanged event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnCollectFilterValues (CollectFilterValuesEventArgs) Raises the CollectFilterValues event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnCurrentChanged (EventArgs) Raises the CurrentChanged event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnDatasetControllerChanged (EventArgs) Raises the DatasetControllerChanged event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnEndUpdateState (DataSourceUpdateStateEventArgs) Raises the EndUpdateState event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnFindCurrentRecordAfterCommitChanges (BufferHandleEventArgs) Raises the FindCurrentRecordAfterCommitChanges
# OnHandleValidationError (HandleValidationErrorEventArgs) Raises the HandleValidationError
# OnNewFetchDataRequest (NewFetchDataRequestEventArgs) Raises the NewFetchDataRequest
# OnNonUpdatableColumnsChanged (EventArgs) Raises the NonUpdatableColumnsChanged event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# OnQueryClosed (EventArgs) Raises the QueryClosed
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnSmartCommitSourceChanged (EventArgs) Raises the SmartCommitSourceChanged event
# OnSmartNavigationTargetPositionChanged (SmartNavigationTargetPositionChangedEventArgs) Raises the SmartNavigationTargetPositionChanged event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnSmartNavigationTargetStateChanged (SmartNavigationTargetStateChangedEventArgs) Raises the SmartNavigationTargetStateChanged event
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# OnSmartTransactionStateChanged (EventArgs) Raises the SmartTransactionStateChanged event
# OnUnableToRepositionAfterUpdateRow (UnableToRepositionAfterUpdateRowEventArgs) Raises the UnableToRepositionAfterUpdateRow
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ OnVerbClicked (character) Event Handler method for Designer Verbs
Overrides Consultingwerk.SmartComponents.Base.SmartComponent:OnVerbClicked (character)
+ ParentBindingSourceChangedHandler (Object, BindingSourceChangedEventArgs) Event Handler for the BindingSourceChanged event of the SmartDataSoruce
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ ParentPositionChanged (Object, EventArgs) This Method is invoked by the ParentPositionChangedBase Event Handler of the SmartDataAdapters base class when the PositionChanged Event of the SmartDataSources BindingSource is fired.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:ParentPositionChanged (Object, EventArgs)
+ F ParentPositionChangedBase (Object, EventArgs) Handler for the PositionChanged Event of the SmartDataSources BindingSource.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# PositionChangedHandler (Object, EventArgs) Handler for the PositionChanged event of the BindingSource attached to this SmartDataAdapter instance.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:PositionChangedHandler (Object, EventArgs)
# PrepareDataBinding () Method used to prepare the BindingSource:Handle object (QUERY or ProDataset).
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:PrepareDataBinding ()
+ LOGICAL PreviousBatchAvailable () Returns true if a previous batch is available.
# RaiseUnableToCommitError (ISmartTableIOTarget) Raises the error when the transaction connect be commited
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# RaiseUnableToRejectError (ISmartTableIOTarget) Raises the error when the transaction connect be rejected
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ RefetchCurrentRow () Refetches the current row from the backend and merges it with the frontend dataset
+ RefetchCurrentRow (character) Refetches the current row from the backend and merges it with the frontend dataset
+ Refresh (logical) Refreshes the SmartDatasetAdapter
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ RefreshAfterRejectTranscation (rowid[]) Reopens the query and refreshes the BindingSource after a transaction has been rejected
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ RegisterSmartDataTarget (ISmartDataTarget) Register a SmartDataTarget with the SmartDataSource. This Method is called by Classes implementing the ISmartDataTarget Interface when a new SmartDataSource is set.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ RegisterSmartGroupCreateTarget (ISmartGroupCreateTarget) Register a SmartGroupCreateTarget with the SmartGroupCreateSource This Method is executed every time a new SmartGroupCreateSource is registered to the corresponding Property of a Class implementing the Interface ISmartGroupCreateSource.
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ RejectTransaction () Reverts the changes of a pending transaction
+ RemoveSmartNavigationSource (ISmartNavigationSource) Removes a SmartNavigationSource from the SmartDataAdapter instance
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# RepositionAfterUpdateRow (rowid, logical) Repositions to the updated record after update
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:RepositionAfterUpdateRow (rowid, logical)
# RepositionCurrentRow () Repositions the Adapters Query to the current row
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ RepositionToRowid (character) Repositions to a Rowid list from a character
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ RepositionToRowid (rowid) Repositions to a single Rowid
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ RepositionToRowid (rowid[]) Repositions to a Rowid Array
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:RepositionToRowid (rowid[])
+ LOGICAL RetrieveData () Reads Data from a Datasource and links the DataHandle with a BindingSource inside the Instance of SmartBusinessEntityAdapter. * If there is no valid instance of a BindigSource a new one is created. After that a Dataset is cleared and then filled with the requested data from the Database. Now a Query is build or reopened and the Handle to this Query is assigned to the BindingSource:Handle. * Enforced by Interface ISmartDataSource
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:RetrieveData ()
# RetrieveData (character, character, IFetchDataRequest, dataset-handle) Bundles calls to ServiceAdapter:RetrieveData
+ SaveFromGroupCreateTarget (ISmartGroupCreateTarget) Saves the data in this ISmartGroupCreateSource related updating ISmartDataTarget so that before saving a new child record, that parent record is created
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ SaveInDataTargets () Recursively invokes SaveChanges in all DataTargets that are currently updating
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
- SetDesignerProperties () Sets properties that affect the Visual Desginer
# SetQuerySort (character) Overridable Setter for QuerySort property
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:SetQuerySort (character)
# SetQueryString (character) Overridable Setter for QueryString property
+ SetSavingData (logical) Assigns the internal flag that data is being saved
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:SetSavingData (logical)
# SetSmartDataSource (ISmartDataSource) SetSmartDataSource sets the SmartDataSource of the current instance of the SmartBusinessEntityAdapter. This Method is called from the Property Setter of SmartDataSource in the Base Class. * Gets the ForeignFields from the hDataset which if not read before is fetched from the Backend. Afterwards the backward handshake with the SmartDataSource is completed and the Handler for the PositionChanged Event is subscribed to be able to recognize that the Parent Data has changed.
Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:SetSmartDataSource (ISmartDataSource)
# SetTrackingChanges (logical) Sets the tracking changes property of all temp-tables
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# ShowBusinessEntityPickerDialog ()
# ShowDatasetControllerDialog () Shows Dialog to select a DatasetController from within the OEA/PDSOE Visual Designer
# ShowTablePickerDialog () Invokes the Table Picker Dialog and sets properties of the SmartBusinessEntityAdapter during Design Time
+ StoreCopiedFrom (character) Stores the source record key information with the new record (copy)
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ SubmitChanges () Creates a dataset containing the modifications of the SmartBusinessEntityAdapter's dataset and submits the changes dataset to the service adapter (and then to the Business Entity).
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:SubmitChanges ()
# SubmitChangesToBackend () Creates a dataset containing the modifications of the SmartBusinessEntityAdapter's dataset and submits the changes dataset to the service adapter (and then to the Business Entity).
+ SubscribeAfterRetrieveData (IAfterRetrieveDataSubscriber) Subscribes an instance of an object to the AfterRetrieveData callback.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ CHARACTER ToString () Returns a String representation of this object instance
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ A UpdateRow () The UpdateRow is an abstract method - that means that it needs to be overridden in a class that inherits from this base class. Enforced by Interface ISmartDataSource.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:UpdateRow ()
+ UpdateRow (logical) UpdateRow submits the changes to a buffer into the Database. Called by SmartViewerControl, SmartUpdatableBrowser Data is updated into the Dataset from the BindingSource. After this the Datasetchanges are submitted to the OERA Backend, merged into the Dataset and the BindingSource gets refreshed.
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# LOGICAL ValidateBusinessEntityName (character) Validates a BusinessEntityName agains the Backend.
# LOGICAL ValidateForeignField (character, ISmartDataSource) Validates that a single field name is available in the SmartDataSource or this Adapter instance
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# ValidateForeignFields () Validates the value of the ForeignFields property when during the first ParentPositionChanged event
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# VerifyTransactionPending () Verifies that after cancelling an update the Transaction State should be PendingChanges

Top Constructor Summary
Options Name Purpose
+ SmartBusinessEntityAdapter () Constructor for the SmartBusinessEntityAdapter class
+ SmartBusinessEntityAdapter (IContainer) Constructor for the SmartBusinessEntityAdapter class

Top Event Summary
Options Name Purpose
+ AfterAssignRecord (Object, AfterAssignRecordEventArgs) Event raised after a record has been assigned
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ AfterAutoCommitTransaction DELEGATE System.EventHandler Raised after an AutoCommit=TRUE transaction has been Commited
+ AfterBatchAvailable DELEGATE System.EventHandler Event fired whenever the SmartDataAdapter has received a new batch of data
+ AfterCancelCreateRecord (Object, AfterCancelCreateRecordEventArgs) Event fired after the creation of a record has been cancelled
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ AfterCommitTransaction DELEGATE System.EventHandler Raised after an AutoCommit=FALSE transaction has been Commited
+ AfterCreateRecord (Object, AfterCreateRecordEventArgs) Event fired after a record has been created
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ AfterDeleteRecord (Object, AfterDeleteRecordEventArgs) Event raised after a record has been deleted
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ AfterGetChanges (Object, AfterGetChangesEventArgs) Raised before the SmartBusinessEntityAdapter gets the Changes of the ProDataset
+ AfterMergeChanges (Object, MergeChangesEventArgs) Raised after the processed changes from the backend are merged with the local data
+ AfterQueryPositionChanged DELEGATE System.EventHandler Event fired whenever the QueryPosition has changed (i.e. Add or Delete and Grids etc. need to update the current position)
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ AfterRejectTransaction DELEGATE System.EventHandler Raised after a transaction has been Rejected
+ AfterRetrieveData DELEGATE System.EventHandler Event fired whenever the SmartDataAdapter has opened a new query
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ AfterUpdateRecord (Object, AfterUpdateRecordEventArgs) Event raised after a record has been updated
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ AssignForeignFields (Object, AssignForeignFieldsEventArgs) Raised while creating a new record in a child SmartDatasetAdapter
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ AssignKeyFieldError (Object, AssignKeyFieldErrorEventArgs) Raised when the SmartDatasetAdapter catches an error while assigning the fields from the BindindSource
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ AssignKeyFields (Object, AssignKeyFieldsEventArgs) Event raised when a ISmartGroupCreateSource needs to create a record to allow creation of a child record in a ISmartGroupCreateTarget instance.
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ AutoCommitChanged DELEGATE System.EventHandler Raised when the AutoCommit property is changed
+ BeforeAssignRecord (Object, BeforeAssignRecordEventArgs) Event raised before assigning to a record
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ BeforeCancelCreateRecord (Object, BeforeCancelCreateRecordEventArgs) Raised before the creation of the record will be cancelled
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ BeforeCommitTransaction DELEGATE System.ComponentModel.CancelEventHandler Raised before a transaction will be commited
+ BeforeCreateRecord (Object, BeforeCreateRecordEventArgs) Raised before the a record is created
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ BeforeCreatingRecord (Object, CancelableEventArgs) Raised before the SmartDatasetAdapter is about to create a new record in the CreateRecord method
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ BeforeDeleteRecord (Object, BeforeDeleteRecordEventArgs) Raised before the a record is deleted
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ BeforeGetChanges (Object, BeforeGetChangesEventArgs) Raised before the SmartBusinessEntityAdapter gets the Changes of the ProDataset
+ BeforeMergeChanges (Object, MergeChangesEventArgs) Raised before the processed changes from the backend are merged with the local data
+ BeforeRejectTransaction DELEGATE System.ComponentModel.CancelEventHandler Raised before a transaction will be rejected
+ BeforeRetrieveData DELEGATE System.ComponentModel.CancelEventHandler Event fired before the SmartDataAdapter is about to open a new query
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ BeforeUpdateRecord (Object, BeforeUpdateRecordEventArgs) Raised before the a record is updated
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ BeginUpdateState (Object, DataSourceUpdateStateEventArgs) Event raised when a ISmartDataTarget of this SmartDataAdapter instance begins the update state
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ BindingSourceChanged (Object, BindingSourceChangedEventArgs) Event fired whenever the SmartDataAdapters BindingSource property changes
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ CollectFilterValues (Object, CollectFilterValuesEventArgs) Event raised to collect Filter Values from Filter Sources
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ CurrentChanged DELEGATE System.EventHandler Raised whenever the Data Adapter is positioned on a new row.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ DatasetControllerChanged DELEGATE System.EventHandler Raised when the DatasetController property is changed
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ EndUpdateState (Object, DataSourceUpdateStateEventArgs) Event raised when a ISmartDataTarget of this SmartDataAdapter instance ends the update state
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ FindCurrentRecordAfterCommitChanges (Object, BufferHandleEventArgs) Raised after an AutoCommit=FALSE SmartBusinessEntityAdapter has submitted changes to the backend.
+ HandleValidationError (Object, HandleValidationErrorEventArgs) Raised to allow subscribers to handle validations errors caused by a non AutoCommit transaction commit
+ NewFetchDataRequest (Object, NewFetchDataRequestEventArgs) Raised before an actual call to the Service Adapter is made to read data from the backend
+ NonUpdatableColumnsChanged DELEGATE System.EventHandler Raised when the NonUpdatableColumns property is changed
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ QueryClosed DELEGATE System.EventHandler Raised when the CloseQuery method is called
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ SmartCommitSourceChanged DELEGATE System.EventHandler Event fired whenever the SmartCommitSource property has changed
+ SmartNavigationTargetPositionChanged (Object, SmartNavigationTargetPositionChangedEventArgs) Event fired whenever the RecordPositon properties has changed
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ SmartNavigationTargetStateChanged (Object, SmartNavigationTargetStateChangedEventArgs) Event fired whenever the SmartDataSourceState property has changed
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ SmartTransactionStateChanged DELEGATE System.EventHandler Event fired whenever the SmartTransactionState property has changed
+ UnableToRepositionAfterUpdateRow (Object, UnableToRepositionAfterUpdateRowEventArgs) Raised when the SmartDatasetAdapter is unable to reposition to the updated row after update (typically the key values of the record have changed so that it does no longer match the query criteria)
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter

Top Property Summary
Options Name Purpose
+ CHARACTER AppServerPartition Gets/Sets the name of the AppServer Partition to be used by this SmartDataAdapter instance
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ LOGICAL AutoCommit Controls the AutoCommit functionality of the SmartBusinessEntityAdapter
+ LOGICAL Available Returns if the DataSource currently has a record available
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ INTEGER BatchSize Gets/Sets the BatchSize used when reading data from the Business Entity.
# CHARACTER BindableProperties Property that is used to mark properties (comma-delimited list) that should be Data-Bindable
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ Progress.Data.BindingSource BindingSource Get/Set the BindingSource of the current Class. The BindingSource can be set to any class derived from Progress.Data.BindingSource. This Property is set internaly if the SmartDataAdapter is attached to a Browser where a DesignTime BindingSource is attached or if the developer calls RetrieveData (). * If a valid BindingSource exists inside the SmartDataAdapter the EventHandlers get unsubscribe from that instance and it is replaced with the new one. After that the Handlers for the Events of the BindingSource are subscribed to the new instance.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ CHARACTER BindingSourceExcludeFields Get/Set the Exclude Fields for the BindingSource created by the CreateBindingSource method.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ CHARACTER BindingSourceIncludeFields Get/Set the Include Fields for the BindingSource created by the CreateBindingSource method.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ CHARACTER BindTo Binding the BusinessEntityBindingSource to a Query or a Dataset. This Property is set by the Developer during DesignTime.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:BindTo
# CHARACTER CategorizedProperties Property that is used to mark properties (comma-delimited list) that should receive a Category attribute
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
# CHARACTER CategoryProperties Categories of the Property in the CategorizedProperty list
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ HANDLE ContextDataset Gets/Sets the reference to an optionally used Context Dataset
+ CHARACTER ContextID Gets/Sets the ContextID to recognize the instance of the Business Entity on the Backend
+ CHARACTER ContextString Gets/Sets the ContextString used for the communication with the Business Entity.
+ LOGICAL CreatingRecord Returns if this SmartDatasetAdapter is currently creating a new record
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ CHARACTER CustomContext Gets/Sets the CustomContext used for the communication with the Business Entity.
+ HANDLE DataSet Returns the handle to the ProDataset instance managed by the SmartBusinessEntityAdapter
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:DataSet
+ Consultingwerk.SmartComponents.Interfaces.IDatasetController DatasetController A Reference to the DatasetController that is is owning the Dataset on which this SmartBusinessEntityAdapter is operating.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:DatasetController
+ CHARACTER DatasetControllerType The typename of the DatasetController that is is owning the Dataset on which this SmartBusinessEntityAdapter is operating.
+ Progress.Data.BindingSource DataSourceBindingSource Returns a reference to the BindingSource of the SmartDataSource
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
# CHARACTER DescribedProperties Property that is used to mark properties (comma-delimited list) that should receive a Description attribute
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
# CHARACTER DescriptionProperties Description of the Property in the DescribedProperties list
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
# CHARACTER DesignerVerbs Property that is used to generate Designer Verbs (actions for the Visual Designer)
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
# CHARACTER DesignerVisibilityAttributes The CHARACTER representation of the DesignerSerializationVisibiltiy attribute (Content/Visible/Hidden), see .NET Enumeration System.ComponentModel.DesignerSerializationVisibility
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
# CHARACTER DesignerVisibilityProperties Property that is used to mark properties (comma-delimited list) that should receive a DesignerSerializationVisibility Attribute
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ LOGICAL DesignTime Propery flags if the current instance of the SmartBindingSource is running at design time or runtime.
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
# LOGICAL DesingerHostLoading Propery returns if the component's DesignerHost is currently loading the document
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ LOGICAL EmptyDatasetOnRetrieveData Controls if the SmartBusinessEntityAdapter instance empties the ProDataset at the beginning of a call to RetrieveData
+ CHARACTER EntityJoin A List in the same order as EntityView which defines Join (YES or NO) for each Table of pcEntityView. This Property is set by the Developer during DesignTime.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:EntityJoin
+ CHARACTER EntityName Name of the BusinessEntity. This Property is set by the Developer during DesignTime.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:EntityName
+ CHARACTER EntityTable RootTable for this Instance of the BusinessEntity. This Property is set by the Developer during DesignTime.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:EntityTable
+ CHARACTER EntityView List of Tables to read with the EntityTable. This Property is set by the Developer during DesignTime.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:EntityView
+ Consultingwerk.ListQueryExpressionByTable FetchFilterValues Returns the list of Query Expressions by Table of the previous RetrieveData
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ LOGICAL FetchLastOnServer Controls if the FetchLast method will fetch all remaining records (behaviour until July 2011) or directly fetch the last batch using the current batch size and the ability to perform backwards batching for retrieving the records before the last batch
# CHARACTER FetchQueryString This is the QueryString for the next Fetch operation. This Property is set by the ParentPositionChanged Method every time the Parent Data changes.
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# CHARACTER FindString Specifies a record to be repositioned from the server (FIND-FIRST)
# LOGICAL FirstTime Indicates if a DataAdapters Query is being opened for the First time
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ CHARACTER ForeignFields ForeignFields related to the Parent SmartDataSource.
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
# CHARACTER HiddenProperties Property that is used to mark properties (comma-delimited list) that will be excluded from the .NET TypeDescriptor properties list
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ LOGICAL Initializing Indicates that the SmartDataAdapter is currrently being Initialized
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ Consultingwerk.SmartComponents.Interfaces.Design.IDesignCommitSource LinkCommitSource Represents the SmartCommitSource property casted to a .NET Interface
+ Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource LinkDataSource Represents the SmartDataSource property casted to a .NET Interface
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ Consultingwerk.SmartComponents.Interfaces.Design.IDesignNavigationSource LinkNavigationSource Represents the SmartNavigationSource property casted to a .NET Interface
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ Consultingwerk.OERA.INamedQueryParameter NamedQuery Gets and sets the reference to the Named Query Parameter instance used for the next invokation of the RetrieveData method
# CHARACTER NextContext The context for the next Fetch next call
# CHARACTER NonBrowsableProperties Property that is used to mark properties (comma-delimited list) that should not show up in the Visual Designers Property Grid
Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
+ CHARACTER NonUpdatableColumns Get's/set's Columns that will not get updated by UpdateRow (TRUE)
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ INTEGER PrefetchOnFindRowWhere Specifies the number of records the a FindRowWhere (FindRowWhereModeEnum FindOnServer) should read from the backend
# CHARACTER PrevContext The context for the next Fetch prev call
# CHARACTER PreviousFetchQueries Provides access to the last query used by the SmartBusinessEntityAdapter to retrieve data from the backend
# INTEGER PreviousPosition Get/Set if the Position of this Adapters BindingSource's position prio to the last RetrieveData call.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ LOGICAL PromptWhenRetrieveDataInUpdateState Allows to show a prompt when RetrieveData is called while an update is pending in the BusinessEntityAdapter instance
+ HANDLE QueryHandle Returns the handle to the Query used to navigate the selected tables of the ProDataset instance managed by the SmartBusinessEntityAdapter
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ CHARACTER QuerySort Controls the sort-order used at the client
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ CHARACTER QueryString This is a base query string.
Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:QueryString
+ CHARACTER RecordPosition Returns a Value of RecordPositionEnum representing the current position The Property is read in the Method PositionChangedHandler () of a Class implementing the Interface ISmartNavigationTarget. Enforced by Interface ISmartNavigationTarget.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ LOGICAL RetrieveDataOnChangeSortOrder This property allows to subspend the call to RetrieveData in the setter of QuerySort (SetQuerySort method)
+ Consultingwerk.ISerializable SaveChangesParameter Gets and sets the referecence to an optional parameter object passed to the Business Entity during SaveChanges/SubmitChanges
+ LOGICAL SelectTables This property is depricated since the addition of Designer Verbs
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ Consultingwerk.OERA.IServiceAdapter ServiceAdapter Returns the reference to the ServiceAdapter that is being used by this SmartBusinessEntityAdapter
+ Consultingwerk.SmartComponents.Interfaces.ISmartCommitSource SmartCommitSource A reference to the SmartCommitSource of this SmartBusinessEntityAdapter
+ Consultingwerk.SmartComponents.Interfaces.ISmartDataSource SmartDataSource Get/Set the SmartDataSource of the current Class. The SmartDataSource can be set to any class implementing the Interface ISmartDataSource. This Property is set by the developer when initializing a Control implementing the Interface ISmartDataTarget. Enforced by Interface ISmartDataTarget.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ LOGICAL SmartDataSourceActive Get/Set if this instance of the SmartDataAdapter is subscribed to the PositionChanged event of the SmartDataSource's BindingSource
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ CHARACTER SmartDataSourceState Get/Set the SmartDataSourceState of the current Class. This Property is set to Updating if the Method BeginUpdateState () of the SmartDataAdapter instance is called and it is set to Navigatable during initialization and if the Property SmartTableIOState of a Viewer is set to anything but ModifyingData.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ Consultingwerk.SmartComponents.Base.ListISmartDataTarget SmartDataTargets Returns the list of SmartDataTargets as a generic list
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ Consultingwerk.SmartComponents.Base.ListISmartGroupCreateTarget SmartGroupCreateTargets Returns the list of SmartGroupAssignTargets as a generic list
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ Consultingwerk.SmartComponents.Interfaces.ISmartNavigationSource SmartNavigationSource Get and Set the current SmartNavigationSource of the SmartDataAdapter. Every SmartNavigationTarget is registered with handshake and kept in a collection. This Property is set by the developer when initializing a Control implementing the Interface ISmartDataSource. Enforced by Interface ISmartDataSource.
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
+ Consultingwerk.SmartComponents.Enum.TransactionStateEnum SmartTransactionState Returns the current Transaction State
+ INTEGER StopAfter Value for StopAfter to be passed to the Service Interface
+ LOGICAL ThrowErrorsFromRetrieveData Gets/Sets if errors from RetrieveData (in childs of this abstract base class) should be THROWN or Shown from the DataAdapter class (Using ErrorHelper)
Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
+ Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget UpdatingSmartDataTarget Returns a reference to the SmartDataTarget which is currently in update mode
Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter


Method Detail
Top

PROTECTED ActivateSmartViewerEventHandler ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Activates SmartViewer TextChanged/ChechedChanged Event Handlers
after a navigation (FetchFirst/FetchNext/FetchPrev/FetchLast)
Notes:

Top

PROTECTED AddRecordInUpdatableGrid ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Ensures an updatable browser is in the correct adding state after
a record was createrd through the Binding Source event
Notes: SCL-826

Top

PUBLIC AddSmartNavigationSource (ISmartNavigationSource)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Adds a(nother) SmartNavigationSource to the SmartDataAdapter
instance
Notes: Enabled multiple SmartNavigationSources to the SmartDataAdapter.

Parameters:
poSmartNavigationSource Consultingwerk.SmartComponents.Interfaces.ISmartNavigationSource
The ISmartNavigationSource to add to the list of NavigationSources
Top

PUBLIC AttachBindingSource (BindingSource)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: This Method is used to attach a new BindingSource to a SmartDataTarget.
Inside a SmartDataAdapter which can be a SmartDataTarget a new
BindingSource is created or borrowed from a Browser.
Notes: Enforced by Interface ISmartDataTarget

Parameters:
poBindingSource Progress.Data.BindingSource
The BindingSource to be attached to the Grids DataSource Property
Top

PROTECTED AttachQueryToBindingSource ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:AttachQueryToBindingSource ()
Purpose: Attaches the Query/ProDataset to the BindingSource
Notes:

Top

PROTECTED AttachSchemaToBindingSource (BindingSource)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:AttachSchemaToBindingSource (BindingSource)
Purpose: Attaches the Data Schema to the BindingSource
Notes: Do not call this method from an overloaded method when the
overloaded method does set the Except fields

Parameters:
poBindingSource Progress.Data.BindingSource
The BindingSource to attach the Schema to
Top

PUBLIC BeginInit ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Invoked at the beginning of a Containers InitializeComponents
method
Notes: Enforced by System.ComponentModel.ISupportInitialize
http://msdn.microsoft.com/de-de/library/system.componentmodel.isupportinitialize.begininit(VS.80).aspx

Top

PUBLIC BeginTransactionState ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:BeginTransactionState ()
Purpose: Begins a transaction when starting update
Notes: Allows SmartDatasetChildAdapter to initiate TransactionState in a
parent SmartBusinessEntityAdapter

Top

PUBLIC BeginUpdateState (ISmartDataTarget)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:BeginUpdateState (ISmartDataTarget)
Purpose: The Message to for instance Disable a Browser is send to all
SmartDataTargets except the calling one
Notes: This Method is called from the SmartViewerControl derived Class when
starting to Modify or Add data.
Enforced by Interface ISmartDataSource.

Parameters:
poSmartDataTarget Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget
The reference to the ISmartDataTarget which is in UpdateState now
Top

PROTECTED BeginUpdateStateHandler (Object, DataSourceUpdateStateEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event handler for the BeginUpdateState event of the SmartDataSource
Notes:

Parameters:
sender System.Object
The reference to the System.Object that raised the event
e Consultingwerk.SmartComponents.Implementation.DataSourceUpdateStateEventArgs
The DataSourceUpdateStateEventArgs with the data for this event
Top

PUBLIC CancelCreateRecord ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CancelCreateRecord ()
Purpose: Invoked from the SmartDataTarget to cancel the creation of a new
row
Notes:

Top

PROTECTED CancelCreateRowHandler (Object, CancelCreateRowEventArgs)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CancelCreateRowHandler (Object, CancelCreateRowEventArgs)
Purpose: Event Handler for the CancelCreateRow event of the ProBindingSource
Notes: This method is abstract and needs to be overridden by the actual
implementation of the BindingSource.

Parameters:
sender System.Object
The reference to the System.Object that raised the event
args Progress.Data.CancelCreateRowEventArgs
The CancelCreateRowEventArgs with the data for this event
Top

PUBLIC CancelInDataTargets ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Recursively invokes CancelUpdate in all DataTargets that are currently
updating
Notes: Throws an Exception, when of the DataTargets remains updating
Used during RejectChanges

Top

PUBLIC ClearPreviousQueryString (logical)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Clears the PreviousQueryString information to ensure that the
ParentPositionChanged event handler does reopen the query regardless
of identical key values
Notes: SCL-402

Parameters:
plIncludeCurrent LOGICAL
Clear cPreviousQueryString also for the current instance or only for Data Targets
Top

PUBLIC CloseQuery ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CloseQuery ()
Purpose: Empty the DATASET inside the DataAdapter and reopen Query.
Notes:

Top

PUBLIC CommitTransaction ()

Purpose: Commits the transaction to the backend
Notes: See http://jira.consultingwerkcloud.com/browse/SCL-407 for details
on how errors are handled

Top

PROTECTED HANDLE ConnectService ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns the handle of the AppServer partition associated with
this SmartDataAdapter
Notes:

Returns HANDLE
The handle of the AppServer partition used by this SmartDataAdapter
Top

PROTECTED CreateBindingSource ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: CreateBindingSource is to be called inside the RetrieveData Method
if no valid BindingSource is present inside the SmartDataAdapter.
The newly created BindingSource is then registered to all
SmartDataTargets of this SmartDataAdapter.
Notes: This method is not indended to be executed during Design time

Top

PUBLIC CreateParentRecord (character)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Creates a parent record when needed for creating a record in a
SmartGroupCreateTarget
Notes: Creates a record and attempts to assign the primary key values

Parameters:
pcKeyFields CHARACTER
The Key Fields to assign
Top

PUBLIC CreateRecord ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CreateRecord ()
Purpose: Invoked from the SmartDataTarget to create a new row
Notes:

Top

PROTECTED CreateRowHandler (Object, CreateRowEventArgs)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:CreateRowHandler (Object, CreateRowEventArgs)
Purpose: Handler for the CreateRow event of the ProBindingSource
Notes: This method is abstract and needs to be overridden by the actual
implementation of the BindingSource.

Parameters:
sender System.Object
The reference to the System.Object that raised the event
args Progress.Data.CreateRowEventArgs
The reference to the CreateRowEventArgs instance with the data for this event
Top

PROTECTED CreateVerbs ()

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Creates Designer Verbs based on the DesignerVerbs property
Notes:

Top

PUBLIC DeactivateSmartViewerEventHandler ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Activates SmartViewer TextChanged/ChechedChanged Event Handlers
after a navigation (FetchFirst/FetchNext/FetchPrev/FetchLast)

Top

PROTECTED LOGICAL DeleteQueryRow ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: This protected method can be used to remove the current row from a
Query. This method calls DeleteQueryRow(FALSE).
Notes:

Returns LOGICAL
Logical value indicating if the method was successful
Top

PROTECTED LOGICAL DeleteQueryRow (logical)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: This protected method can be used to remove the current row from a
Query. The parameter is logical and controls if only the first
table (FALSE) or all rows shall be removed.
Notes: Any error (like AppError from a Database trigger will not be catched
so that the caller cna

Parameters:
plRemoveAll LOGICAL
Logical value indicating if all buffers should be deleted (TRUE) or just the first query buffer (FALSE)
Returns LOGICAL
Logical value indicating if the method was successful
Top

PUBLIC DeleteRow ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:DeleteRow ()
Purpose: The DeleteRow is an abstract method - that means that it needs
to be overridden in a class that inherits from this base class.
Enforced by Interface ISmartDataSource.
Notes:

Top

PUBLIC DeregisterSmartDataTarget (ISmartDataTarget)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Deregister a SmartDataTarget with the SmartDataSource. Usually done
when a SmartDataTarget is deleted and the SmartDataSource is still
running
Notes:

Parameters:
poSmartDataTarget Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget
The reference to the ISmartDataTarget to deregister
Top

PUBLIC DeregisterSmartGroupCreateTarget (ISmartGroupCreateTarget)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Deregister a SmartGroupCreateTarget with the SmartGroupCreateSource
Notes: Enforced by Interface ISmartGroupCreateSource.

Parameters:
poSmartGroupCreateTarget Consultingwerk.SmartComponents.Interfaces.ISmartGroupCreateTarget
The ISmartGroupCreateTarget to deregister
Top

PROTECTED DisposedHandler (Object, EventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event handler for the Disposed event of this instance
Notes:

Parameters:
sender System.Object
The reference to the object that raised the Disposed event
e System.EventArgs
The System.EventArgs with the data for this event
Top

PUBLIC EmptyDataset ()

Purpose: Empties the ProDataset
Notes: Only supported when EmptyDatasetOnRetrieveData = FALSE

Top

PUBLIC EndInit ()

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:EndInit ()
Purpose: Executed at the end of the initialization of the
SmartBusinessEntityAdapter to launch the DatasetController (if any).
Notes:

Top

PUBLIC EndUpdateState (ISmartDataTarget)

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:EndUpdateState (ISmartDataTarget)
Purpose: The Message to for instance enable a Browser is send to all
SmartDataTargets except the calling one.
Notes: This Method is called from the SmartViewerControl derived Class when
starting to Modify or Add data.
Enforced by Interface ISmartDataSource.

Parameters:
poSmartDataTarget Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget
The reference to the ISmartDataTarget that ends the UpdateState
Top

PROTECTED EndUpdateStateHandler (Object, DataSourceUpdateStateEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event handler for the EndUpdateState event of the SmartDataSource
Notes:

Parameters:
sender System.Object
The reference to the System.Object that raised the event
e Consultingwerk.SmartComponents.Implementation.DataSourceUpdateStateEventArgs
The DataSourceUpdateStateEventArgs with the data for this event
Top

PROTECTED EndUpdateStateInDataSource (ISmartDataTarget)

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:EndUpdateStateInDataSource (ISmartDataTarget)
Purpose: Invokes EndUpdateState in the SmartDataSource of this SmartDataAdapter
Notes: Suspends the call to EndUpdateState when there is a pending transaction

Parameters:
poSmartDataTarget Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget
The reference to the ISmartDataTarget that ends the UpdateState
Top

PROTECTED CHARACTER EvaluateParentQuery ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Evaluates the QueryString based on the Parent Filter Fields
Notes: Used during the ParentPositionChanged event handler but also at
the end of the UpdateRow method to handle situations in a
GroupCreate link when the parent record has been created and the
final primary key values in the parent table are changed during
saving the record to the database

Returns CHARACTER
The parent filter query string
Top

PUBLIC EvaluateTableIOState ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: This Method is enforced by the Interface ISmartDataTarget and is
only required for visual DataTargets.
Notes: Required only for visual DataTagets (Viewer)

Top

PUBLIC LOGICAL FetchAll ()

Purpose: Fetches all remaining data from the backend
Notes:

Returns LOGICAL
Logical value indicating if more rows have been fetched
Top

PUBLIC LOGICAL FetchFirst ()

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:FetchFirst ()
Purpose: Overrides FetchFirst in SmartDataAdpater. Retrieves the first batch
of records when backwards batching
Notes: Method enforced by ISmartNavigationTarget

Returns LOGICAL
Logical value indicating if the operation was successful
Top

PUBLIC LOGICAL FetchLast ()

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:FetchLast ()
Purpose: Overrides FetchLast in SmartDataAdapter to retrieve full business
entity result when batching.
Notes: Method enforced by ISmartNavigationTarget

Returns LOGICAL
Logical value indicating if the operation was successful
Top

PUBLIC FetchLastOnServer ()

Purpose: Fetch Last On Server, used by FetchLast when FetchLastOnServer = TRUE
Notes:

Top

PUBLIC FetchMoreRowsForwards (integer)

Purpose: Fetches additional rows forwards
Notes: Useful to fill up the Dataset for data export operations (Excel Export)
When we are actually backwards-batching we will start fetching the
number of rows forward

Parameters:
piNumRows INTEGER
The number of rows to fetch forwards
Top

PUBLIC LOGICAL FetchNext ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: This Method moves to the next DataRow inside the BindingSource.
Notes: It is called by The Navigation Tools of the Toolbars.
Enforced by Interface ISmartNavigationTarget.

Returns LOGICAL
Logical value, currently not used
Top

PUBLIC LOGICAL FetchPrev ()

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:FetchPrev ()
Purpose: Overrides FetchPrev in SmartDataAdpater. Retrieves the previous batch
of records when backwards batching
Notes: Method enforced by ISmartNavigationTarget

Returns LOGICAL
Logical value indicating if the operation was successful
Top

PUBLIC LOGICAL FindLastRowWhere (character)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Finds the last a row in the EntityTable and locates the BindingSource
to that row
Notes: The record is actually located using a dynamic query instead of a
FIND so that sorting is also supported (typically sorting should
be passed in with the same value as the QuerySort property of
this SmartBusinessEntityAdapter instance
Returns the LAST record that matches the criteria

Parameters:
pcFindString CHARACTER
The find criteria, should not contain a BY phrase, as the Sort order of the Adapter will be used.
Returns LOGICAL
Logical value indicating if a record was found
Top

PUBLIC Consultingwerk.SmartComponents.Base.SmartDatasetAdapter FindLinkedDatasetAdapterForEntityTable (character)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Searches for a linked SmartDatasetAdpater with the given entity table
Notes: Also returns THIS-OBJECT, when THIS-OBJECT is using the given EntityTable

Parameters:
pcEntityTable CHARACTER
The Entity Table to locate
Returns Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
The reference to the lined SmartDatasetAdapter for the given entity table
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartDataBrowser FindLinkedSmartDataBrowser ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns the reference to the linked SmartDataBrowser, if any
Notes: Returns ? when no browser is linked

Returns Consultingwerk.SmartComponents.Interfaces.ISmartDataBrowser
The reference to the linked ISmartDataBrowser or ? when no browser is linked
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartTableIOTarget FindLinkedUpdatingSmartDataTarget ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns the reference to the first linked ISmartDataTarget which is
also an ISmartTableIOTarget, that has a valid SmartTableIOSource assigned
Notes: Returns ? when no updating ISmartDataTarget is linked

Returns Consultingwerk.SmartComponents.Interfaces.ISmartTableIOTarget
The reference to the linked updating ISmartDataTarget as a ISmartTableIOTarget or ? when no updating ISmartDataTarget is linked
Top

PUBLIC LOGICAL FindRowWhere (character)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Finds a row in the EntityTable and locates the BindingSource
to that row
Notes: The record is actually located using a dynamic query instead of a
FIND so that sorting is also supported (typically sorting should
be passed in with the same value as the QuerySort property of
this SmartBusinessEntityAdapter instance
Returns the FIRST record that matches the criteria

Parameters:
pcFindString CHARACTER
The find criteria, should not contain a BY phrase, as the Sort order of the Adapter will be used.
Returns LOGICAL
Logical value indicating if a record was found
Top

PUBLIC LOGICAL FindRowWhere (character, FindRowWhereModeEnum)

Purpose: Finds a row in the EntityTable and locates the BindingSource
to that row, optionally requesting the record on the server
when not found on the client.
Notes: Overloads FindRowWhere (pcFindString) in SmartDatasetAdapter
The record is actually located using a dynamic query instead of a
FIND so that sorting is also supported (typically sorting should
be passed in with the same value as the QuerySort property of
this SmartBusinessEntityAdapter instance
When FindRowWhere (FindRowEhereModeEnum:FindOnServer) is called before
any previous invokation of RetrieveData if will act like FindRowWhere
(FindOnServerOnly).
A FindRowWhere (FindOnClient) is called before any previous invokation
of RetrieveData an error message is raised.

Parameters:
pcFindString CHARACTER
The find criteria, optionally including a sort phrase (BY)
poFindMode Consultingwerk.SmartComponents.Enum.FindRowWhereModeEnum
The FindRowWhereModeEnum value indicating if the search should be done on the client first, client then server or server only
Returns LOGICAL
Logical value indicating if a record was found
Top

PUBLIC Consultingwerk.SmartComponents.Implementation.SmartBusinessEntityAdapter FromDatasetController (IDatasetController)

Purpose: Locates the SmartBusinessEntityAdapter instance that is working
with the passed in IDatasetController
Notes: This method may be removed using the NoStaticsInHybrids setting
in Consultingwerk/products.i. This allows to avoid static members
in hybrid classes SmartDataBrowser and SmartBusinessEntityAdapter
to avoid issues with the combination of static and hybrids on 11.2
and 11.3, OE defect OE00240707 http://knowledgebase.progress.com/articles/Article/000042229?popup=true

Parameters:
poDatasetController Consultingwerk.SmartComponents.Interfaces.IDatasetController
The IDatasetController instance that was launched by a SmartBusinessEntityAdapter
Returns Consultingwerk.SmartComponents.Implementation.SmartBusinessEntityAdapter
The SmartBusinessEntityAdapter that has launched the IDatasetController or the unknown value
Top

PUBLIC AttributeCollection GetAttributes ()

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns a collection of custom attributes for this instance of a
component.
Notes:

Returns AttributeCollection
The System.ComponentModel.AttributeCollection describing the types attributes
Top

PUBLIC CHARACTER GetClassName ()

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns the class name of this instance of a component.
Notes:

Returns CHARACTER
The class name of the Component
Top

PUBLIC CHARACTER GetComponentName ()

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns the name of this instance of a component.
Notes:

Returns CHARACTER
The Component Name of this instance
Top

PUBLIC TypeConverter GetConverter ()

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns a type converter for this instance of a component.
Notes:

Returns TypeConverter
The System.ComponentModel.TypeConverter for this instance of a component.
Top

PUBLIC CHARACTER GetCurrentRecordKey ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns a key identifying the current record
Notes: Returns either the SmartRecordKey value if populated or the result of the
BufferHelper:UniqueFindPredicate UniqueFindPredicate function

Returns CHARACTER
The single character key that represents the current record
Top

PROTECTED ROWID GetCurrentRowid ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns the Current Rowids
Notes: Neeeds to be a Method instead of a Property Get to return an
undimensioned Array

Returns ROWID
The Array of the current query ROWID's
Top

PUBLIC EventDescriptor GetDefaultEvent ()

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns the default event for this instance of a component.
Notes:

Returns EventDescriptor
The System.ComponentModel.EventDescriptor for the default event of this component
Top

PUBLIC PropertyDescriptor GetDefaultProperty ()

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns the default property for this instance of a component.
Notes:

Returns PropertyDescriptor
The System.ComponentModel.PropertyDescriptor for the default property of the component
Top

PROTECTED CHARACTER GetDesignTimeDataSourceClassName ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns the Class Name used for creating SmartBusinessEntityBindingSource
(or derived) components at design time (SCL-1000), using the
"Create BindingSource" designer verb
Notes:

Returns CHARACTER
The Class Name used for creating SmartBusinessEntityBindingSource components at design time
Top

PUBLIC System.Object GetEditor (Type)

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns an editor of the specified type for this instance of a
component.
Notes:

Parameters:
editorBaseType System.Type
A System.Type that represents the editor for this object.
Returns System.Object
The reference to the Editor of the type of the component instance
Top

PROTECTED HANDLE GetEmptyDataset ()

Purpose: Retrieves an empty dataset
Notes: Used in the GET implementation of the DataSet property
This dataset can be used to bind UI components to before calling
RetrieveData

Returns HANDLE
The handle of the empty ProDataset
Top

PUBLIC EventDescriptorCollection GetEvents ()

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns the events for this instance of a component.
Notes:

Returns EventDescriptorCollection
The System.ComponentModel.EventDescriptorCollection describing the events of the component
Top

PUBLIC EventDescriptorCollection GetEvents (Attribute[])

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns the events for this instance of a component using the
specified attribute array as a filter.
Notes:

Parameters:
attributes System.Attribute[]
A System.Attribute[] that is used as a filter.
Returns EventDescriptorCollection
The System.ComponentModel.EventDescriptorCollection describing the events of the component
Top

PUBLIC CHARACTER GetFieldValues (character)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:GetFieldValues (character)
Purpose: Returns a CHR(1) delimited list of field values from the
DataSource
Notes: The fields parameter is a CHR(1) delimited list of field names.
Unqualified field names (CustNum) must exist in the first buffer
of the data source (e.g. Entity Table), qualified field names are
expected in the named buffer (eCustomer.CustNum)

Parameters:
pcFields CHARACTER
The comma delimited list of fields to return
Returns CHARACTER
The CHR(1) delimited list of field values
Top

PROTECTED Consultingwerk.ListQueryExpressionByTable GetNewFilterValues ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Builds an empty ListQueryExpressionByTable instance and raises the
CollectFilterValues event
Notes: Will return ? when the event was cancelled by a subscriber

Returns Consultingwerk.ListQueryExpressionByTable
The ListQueryExpressionByTable with the filters per table
Top

PUBLIC PropertyDescriptorCollection GetProperties ()

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns the properties for this instance of a component.
Notes:

Returns PropertyDescriptorCollection
A System.ComponentModel.PropertyDescriptorCollection that represents the properties for this component instance.
Top

PUBLIC PropertyDescriptorCollection GetProperties (Attribute[])

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns the properties for this instance of a component using the
attribute array as a filter.
Notes:

Parameters:
attributes System.Attribute[]
A System.Attribute[] that is used as a filter.
Returns PropertyDescriptorCollection
A System.ComponentModel.PropertyDescriptorCollection that represents the properties for this component instance.
Top

PUBLIC System.Object GetPropertyOwner (PropertyDescriptor)

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Returns an object that contains the property described by the
specified property descriptor.
Notes:

Parameters:
pd PropertyDescriptor
A System.ComponentModel.PropertyDescriptor that represents the property whose owner is to be found.
Returns System.Object
An System.Object that represents the owner of the specified property.
Top

PROTECTED CHARACTER GetRecordPosition ()

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:GetRecordPosition ()
Purpose: Evaluates the current record position property value
Notes: Overrides standard implementation in SmartDataAdapter to allow
Backwards Batching

Returns CHARACTER
The current record position as a CHARACTER representing an RecordPositionEnum value
Top

PUBLIC Consultingwerk.SmartComponents.Implementation.RetrieveDataStatusEnum GetRetrieveDataStatus ()

Purpose: Evaluates the status of the current RetrieveData operation
Notes: NotBatching / BackwardsBatching / ForwardBatching

Returns Consultingwerk.SmartComponents.Implementation.RetrieveDataStatusEnum
The RetrieveDataStatusEnum value that describes the current data status
Top

PUBLIC LOGICAL HasCopiedFromField ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns if the first table of the Adapter provides a field
SmartCopiedFrom
Notes: Used by the SmartViewerControl and SmartUpdatableBrowser during copy

Returns LOGICAL
Logical value indicating if the first table of the Adapter provides a field SmartCopiedFrom
Top

PUBLIC LOGICAL HasFields (character)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns a logical value indicating if the SmartDataAdapter can provide
the given fields
Notes: Useful to validate if the GetFieldValues methos can return vslues for
the given fields

Parameters:
pcFields CHARACTER
Comma delimited list of field names
Returns LOGICAL
Logical value indicating if the given fields are available in the Data Adapter instance
Top

PROTECTED LOGICAL HasPendingTransaction ()

Purpose: Prompts if pending changes should be saved before retrieving new
data
Notes:

Returns LOGICAL
Logical value indicating if we still have a pending transaction
Top

PROTECTED LOGICAL HasPendingUpdate ()

Purpose: Prompts if pending update should be saved before retrieving new
data, called from RetrieveData
Notes: Only used when property PromptWhenRetrieveDataInUpdateState = TRUE

Returns LOGICAL
Logical value indicating if RetrieveData should be cancelled
Top

PUBLIC InitializeAdapter ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:InitializeAdapter ()
Purpose: Initializes the SmartBusinessEntityAdpater
Notes: Useful to initalize the BindingSource and Query before calling
RetrieveData. Defaults to InitializeAdpater(TRUE) to empty the
dataset
It's not recommended to call this method prior to the Form's OnLoad
or OnShown event as the ProBindingSource seems to reset the Handle
Property (Query or Dataset) that was assigned to early during
initialization

Top

PUBLIC InitializeAdapter (logical)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:InitializeAdapter (logical)
Purpose: Initializes the SmartBusinessEntityAdpater
Notes: Useful to initalize the BindingSource and Query before calling
RetrieveData. When the dataset requieres to be emptied, we need need
to turn off tracking-changes.
It's not recommended to call this method prior to the Form's OnLoad
or OnShown event as the ProBindingSource seems to reset the Handle
Property (Query or Dataset) that was assigned to early during
initialization

Parameters:
plEmptyDataset LOGICAL
Logical flag to indicate if the dataset should be emptied or not.
Top

PROTECTED InitializeServiceAdapter ()

Purpose: Initializes the ServiceAdapter property of the SmartBusinessEntityAdapter
class
Notes: Invoked by the constructor, defaults to FrameworkSettings:ServiceAdapter but
allows for customization in a child class

Top

PUBLIC InvokeMethod (character, dataset-handle, ISerializable)

Purpose: Invokes a method in the backend OERA business entity
Notes:

Parameters:
pcMethodName CHARACTER
The method to be invoked in the Business Entity
phDataset DATASET-HANDLE
INPUT-OUTPUT DATASET-HANDLE The handle of the dataset to be passed to the Business Entity method
poParameter Consultingwerk.ISerializable
The ISerializable parameter object to be passed to the Business Entity method
Top

PROTECTED InvokeParentPositionChanged (Object, EventArgs)

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:InvokeParentPositionChanged (Object, EventArgs)
Purpose: Invokes the ParentPositionChanged event handler in all connected
SmartDataAdapter instances
Notes: SCL-402: Clears pending cPreviousFetchQueryString in linked
SmartDatasetChildAdpater instances

Parameters:
sender System.Object
The reference to the sender associated with the event
e System.EventArgs
The reference to the System.EventArgs with the data for the event
Top

PUBLIC LOGICAL IsRowUncommittedAdd ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns if the current record of the EntityTable is an uncommitted
Add (that is ROW-STATE = ROW-CREATED)
Notes: SCL-1340, used to distinguish between Update and edit of previously
added row before committing to the backend

Returns LOGICAL
LOGICAL
Top

PUBLIC LOGICAL IsUpdating (logical)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns if if this Adapter or any of it's Data-Target Adapters are
updating (a Data-Target with SmartTableIOState:ModifyingData)
Notes:

Parameters:
plIndirectOnly LOGICAL
Logical value indicating if only TableIOChilds of linked data adapters are tested
Returns LOGICAL
Logical value indicating if this Adapter or any of it's Data-Target Adapters are updating
Top

PUBLIC LaunchDatasetController ()

Purpose: Launches the DatatasetController
Notes: Throws an error when the DatasetController is already running.

Top

PROTECTED MergeChanges (handle, handle)

Purpose: Invokes the MERGE-CHANGES after data was submitted to the backend
Notes:

Parameters:
phChangesDataset HANDLE
The handle of the dataset with the changes returned back from the backend
phDataset HANDLE
The handle of the dataset to merge the changes into
Top

PROTECTED CHARACTER MergeQueryStrings (character, ListQueryExpressionByTable)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Merges two Query Strings
Notes:

Parameters:
pcFetchQueryString CHARACTER
The first QueryString
poQueryExpressions Consultingwerk.ListQueryExpressionByTable
The List of QueryExpressions by Table to be merged with the first QueryString
Returns CHARACTER
The resulting Query String
Top

PUBLIC Consultingwerk.OERA.IFetchDataRequest NewFetchDataRequest (character, character, character, integer, character)

Purpose: Factory method for IFetchDataRequest objects
Notes: Allows creation of alternative implementations of IFetchDataRequest
Used by RetrieveData and OffEndHandler in preparation of calls to
the ServiceAdapter

Parameters:
pcTables CHARACTER
The tables to be requested
pcQueries CHARACTER
The queries to be requested
pcRequests CHARACTER
The requests parameter
piNumRecords INTEGER
The number of records to be requested
pcContext CHARACTER
The context to be passed to the Business Entity
Returns Consultingwerk.OERA.IFetchDataRequest
The new IFetchDataRequest instance
Top

PROTECTED OffEndHandler (Object, OffEndEventArgs)

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:OffEndHandler (Object, OffEndEventArgs)
Purpose: Event handler for the OffEnd event of the ProBindingSource object
Notes: Overrides OffEndHandler in SmartDataAdapter base class

Parameters:
sender System.Object
The reference to the object that raised the event
e Progress.Data.OffEndEventArgs
The OffEndEventArgs with the data for the event
Top

PUBLIC OffHome ()

Purpose: Fetches the Previous Batch of records
Notes:

Top

PROTECTED OnAfterAssignRecord (AfterAssignRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the AfterAssignRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.AfterAssignRecordEventArgs
The AfterAssignRecordEventArgs with the data for this event
Top

PROTECTED OnAfterAutoCommitTransaction (EventArgs)

Purpose: Raises the AfterAutoCommitTransaction event
Notes:

Parameters:
e System.EventArgs
A System.EventArgs with the Event-Data
Top

PROTECTED OnAfterBatchAvailable (EventArgs)

Purpose: Raises the AfterBatchAvailable event
Notes:

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

PROTECTED OnAfterCancelCreateRecord (AfterCancelCreateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the AfterCancelCreateRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.AfterCancelCreateRecordEventArgs
The AfterCancelCreateRecordEventArgs with the data for this event
Top

PROTECTED OnAfterCommitTransaction (EventArgs)

Purpose: Raises the AfterCommitTransaction event
Notes:

Parameters:
e System.EventArgs
A System.EventArgs with the Event-Data
Top

PROTECTED OnAfterCreateRecord (AfterCreateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the AfterCreateRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.AfterCreateRecordEventArgs
The AfterCreateRecordEventArgs with the data for thie event
Top

PROTECTED OnAfterDeleteRecord (AfterDeleteRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the AfterDeleteRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.AfterDeleteRecordEventArgs
The AfterDeleteRecordEventArgs with the data for this event
Top

PROTECTED OnAfterGetChanges (AfterGetChangesEventArgs)

Purpose: Raises the AfterGetChangesEvent
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.AfterGetChangesEventArgs
The AfterGetChangesEventArgs with the data for this event
Top

PROTECTED OnAfterMergeChanges (MergeChangesEventArgs)

Purpose: Raises the AfterMergeChanges
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.MergeChangesEventArgs
The MergeChangesEventArgs with the data for the event
Top

PROTECTED OnAfterQueryPositionChanged (EventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the AfterQueryPositionChanged event
Notes:

Parameters:
e System.EventArgs
The System.EventArgs with the data for the event
Top

PROTECTED OnAfterRejectTransaction (EventArgs)

Purpose: Raises the AfterRejectTransaction event
Notes:

Parameters:
e System.EventArgs
A System.EventArgs with the Event-Data
Top

PROTECTED OnAfterRetrieveData (EventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the AfterRetrieveData event
Notes: Invokes the AfterRetrieveDataCallack method in all subscribers

Parameters:
e System.EventArgs
The System.EventArgs with the data for the event
Top

PROTECTED OnAfterUpdateRecord (AfterUpdateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the AfterUpdateRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.AfterUpdateRecordEventArgs
The AfterUpdateRecordEventArgs with the data for this event
Top

PROTECTED OnAssignForeignFields (AssignForeignFieldsEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the AssignForeignFields
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.AssignForeignFieldsEventArgs
The AssignForeignFieldsEventArgs with the data for the event
Top

PROTECTED OnAssignKeyFieldError (AssignKeyFieldErrorEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the AssignKeyFieldError
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.AssignKeyFieldErrorEventArgs
The AssignKeyFieldErrorEventArgs with the data for the event
Top

PROTECTED OnAssignKeyFields (AssignKeyFieldsEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the AssignKeyFields event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.AssignKeyFieldsEventArgs
The AssignKeyFieldsEventArgs with the data for this event
Top

PROTECTED OnAutoCommitChanged (EventArgs)

Purpose: Raises the AutoCommitChanged property
Notes:

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

PROTECTED OnBeforeAssignRecord (BeforeAssignRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raise the BeforeAssignRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.BeforeAssignRecordEventArgs
The BeforeAssignRecordEventArgs with the data for this event
Top

PROTECTED OnBeforeCancelCreateRecord (BeforeCancelCreateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the BeforeCancelCreateRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.BeforeCancelCreateRecordEventArgs
The BeforeCancelCreateRecordEventArgs with the data for this event
Top

PROTECTED OnBeforeCommitTransaction (CancelEventArgs)

Purpose: Raises the BeforeCommitTransaction event
Notes:

Parameters:
e System.ComponentModel.CancelEventArgs
The CancelEventArgs with the data for this event
Top

PROTECTED OnBeforeCreateRecord (BeforeCreateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the BeforeCreateRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.BeforeCreateRecordEventArgs
The BeforeCreateRecordEventArgs with the data for this event
Top

PROTECTED OnBeforeCreatingRecord (CancelableEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the BeforeCreatingRecord
Notes:

Parameters:
e Consultingwerk.CancelableEventArgs
The Consultingwerk.CancelableEventArgs with the data for the event
Top

PROTECTED OnBeforeDeleteRecord (BeforeDeleteRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the BeforeDeleteRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.BeforeDeleteRecordEventArgs
The BeforeDeleteRecordEventArgs with the data for this event
Top

PROTECTED OnBeforeGetChanges (BeforeGetChangesEventArgs)

Purpose: Raises the BeforeGetChangesEvent
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.BeforeGetChangesEventArgs
The BeforeGetChangesEventArgs with the data for this event
Top

PROTECTED OnBeforeMergeChanges (MergeChangesEventArgs)

Purpose: Raises the BeforeMergeChanges event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.MergeChangesEventArgs
The MergeChangesEventArgs with the data for the event
Top

PROTECTED OnBeforeRejectTransaction (CancelEventArgs)

Purpose: Raises the BeforeRejectTransaction event
Notes:

Parameters:
e System.ComponentModel.CancelEventArgs
The CancelEventArgs with the data for this event
Top

PROTECTED OnBeforeRetrieveData (CancelEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the BeforeRetrieveData event
Notes:

Parameters:
e System.ComponentModel.CancelEventArgs
The CancelEventArgs with the data for the event
Top

PROTECTED OnBeforeUpdateRecord (BeforeUpdateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the BeforeUpdateRecord event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.BeforeUpdateRecordEventArgs
The BeforeUpdateRecordEventArgs with the data for this event
Top

PROTECTED OnBeginUpdateState (DataSourceUpdateStateEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the BeginUpdateState event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.DataSourceUpdateStateEventArgs
The DataSourceUpdateStateEventArgs with the data for the event
Top

PROTECTED OnBindingSourceChanged (BindingSourceChangedEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the BindingSourceChanged event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.BindingSourceChangedEventArgs
The BindingSourceChangedEventArgs with the data for the event
Top

PROTECTED OnCollectFilterValues (CollectFilterValuesEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the CollectFilterValues event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.CollectFilterValuesEventArgs
The CollectFilterValuesEventArgs with the data for this event
Top

PROTECTED OnCurrentChanged (EventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the CurrentChanged event
Notes:

Parameters:
e System.EventArgs
The System.EventArgs with the data for the event
Top

PROTECTED OnDatasetControllerChanged (EventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the DatasetControllerChanged event
Notes:

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

PROTECTED OnEndUpdateState (DataSourceUpdateStateEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the EndUpdateState event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.DataSourceUpdateStateEventArgs
The DataSourceUpdateStateEventArgs with the data for the event
Top

PROTECTED OnFindCurrentRecordAfterCommitChanges (BufferHandleEventArgs)

Purpose: Raises the FindCurrentRecordAfterCommitChanges
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.BufferHandleEventArgs
The BufferHandleEventArgs with the data for the event
Top

PROTECTED OnHandleValidationError (HandleValidationErrorEventArgs)

Purpose: Raises the HandleValidationError
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.HandleValidationErrorEventArgs
The HandleValidationErrorEventArgs with the data for the event
Top

PROTECTED OnNewFetchDataRequest (NewFetchDataRequestEventArgs)

Purpose: Raises the NewFetchDataRequest
Notes:

Parameters:
e Consultingwerk.SmartComponents.Implementation.NewFetchDataRequestEventArgs
The NewFetchDataRequestEventArgs with the data for the event
Top

PROTECTED OnNonUpdatableColumnsChanged (EventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the NonUpdatableColumnsChanged event
Notes:

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

PROTECTED OnQueryClosed (EventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the QueryClosed
Notes:

Parameters:
e System.EventArgs
The eventargs with the data for the event
Top

PROTECTED OnSmartCommitSourceChanged (EventArgs)

Purpose: Raises the SmartCommitSourceChanged event
Notes:

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

PROTECTED OnSmartNavigationTargetPositionChanged (SmartNavigationTargetPositionChangedEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the SmartNavigationTargetPositionChanged event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.SmartNavigationTargetPositionChangedEventArgs
The SmartNavigationTargetPositionChangedEventArgs with the data for the event
Top

PROTECTED OnSmartNavigationTargetStateChanged (SmartNavigationTargetStateChangedEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raises the SmartNavigationTargetStateChanged event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.SmartNavigationTargetStateChangedEventArgs
The SmartNavigationTargetStateChangedEventArgs with the data for the event
Top

PROTECTED OnSmartTransactionStateChanged (EventArgs)

Purpose: Raises the SmartTransactionStateChanged event
Notes:

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

PROTECTED OnUnableToRepositionAfterUpdateRow (UnableToRepositionAfterUpdateRowEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the UnableToRepositionAfterUpdateRow
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.UnableToRepositionAfterUpdateRowEventArgs
The UnableToRepositionAfterUpdateRowEventArgs with the data for the event
Top

PUBLIC OnVerbClicked (character)

Overrides Consultingwerk.SmartComponents.Base.SmartComponent:OnVerbClicked (character)
Purpose: Event Handler method for Designer Verbs
Notes:

Parameters:
pcVerbText CHARACTER
The name (Label) of the Designer Verb that was invoked
Top

PUBLIC ParentBindingSourceChangedHandler (Object, BindingSourceChangedEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event Handler for the BindingSourceChanged event of the
SmartDataSoruce
Notes:

Parameters:
sender Progress.Lang.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Base.BindingSourceChangedEventArgs
The BindingSourceChangedEventArgs with the data for this event
Top

PUBLIC ParentPositionChanged (Object, EventArgs)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:ParentPositionChanged (Object, EventArgs)
Purpose: This Method is invoked by the ParentPositionChangedBase Event Handler
of the SmartDataAdapters base class when the PositionChanged Event of
the SmartDataSources BindingSource is fired.
Notes: Refresh Data when a new line is selected inside the Parent
SmartDataSource.

Parameters:
sender System.Object
The reference to the object that raised the event
e System.EventArgs
The System.EventArgs with the data for this event
Top

PUBLIC ParentPositionChangedBase (Object, EventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Handler for the PositionChanged Event of the SmartDataSources
BindingSource.
Notes: Calls the ParentPositionChanged Method which is implemented in the
specialized classes to refresh data.
The PositionChanged or CloseQuery Method is invoked
in all existing ChildSmartDataAdapter to refresh the Dataset inside
of them.

Parameters:
sender System.Object
The reference to the object that raised the event
e System.EventArgs
The System.EventArgs with the data for this event
Top

PROTECTED PositionChangedHandler (Object, EventArgs)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:PositionChangedHandler (Object, EventArgs)
Purpose: Handler for the PositionChanged event of the BindingSource attached
to this SmartDataAdapter instance.
Notes: The current RecordPosition is passed to the SmartNavigationSource.

Parameters:
sender System.Object
The reference to the object that raised the event
e System.EventArgs
The System.EventArgs with the data for this event
Top

PROTECTED PrepareDataBinding ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:PrepareDataBinding ()
Purpose: Method used to prepare the BindingSource:Handle object (QUERY or ProDataset).
Notes: Implemented in the SmartBusinessEntityAdapter and SmartDatasetChildAdapter
Called from RetrieveData or CreateRecord (when called before RetrieveData)

Top

PUBLIC LOGICAL PreviousBatchAvailable ()

Purpose: Returns true if a previous batch is available.
Notes:

Returns LOGICAL
Logical value indicating if a previous batch is available
Top

PROTECTED RaiseUnableToCommitError (ISmartTableIOTarget)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the error when the transaction connect be commited
Notes:

Parameters:
poTarget Consultingwerk.SmartComponents.Interfaces.ISmartTableIOTarget
The ISmartTableIOTarget instance that caused the error
Top

PROTECTED RaiseUnableToRejectError (ISmartTableIOTarget)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raises the error when the transaction connect be rejected
Notes:

Parameters:
poTarget Consultingwerk.SmartComponents.Interfaces.ISmartTableIOTarget
The ISmartTableIOTarget instance that caused the error
Top

PUBLIC RefetchCurrentRow ()

Purpose: Refetches the current row from the backend and merges it with the
frontend dataset
Notes:

Top

PUBLIC RefetchCurrentRow (character)

Purpose: Refetches the current row from the backend and merges it with the
frontend dataset
Notes: The pcViewTables parameter is evaluated as the Tables parameter of
the FetchDataRequest class

Parameters:
pcViewTables CHARACTER
The comma delimited list of tables to refetch in addition to the EntityTable
Top

PUBLIC Refresh (logical)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Refreshes the SmartDatasetAdapter
Notes: Reopens the client side query (does not retrieve data from the backend)
and optionally repositions to the record that is current before
the refrsh

Parameters:
plRepositionToCurrent LOGICAL
Logical value indicating if we the method should reposition to the row that was current before re-opening the query after the query has been reopened
Top

PUBLIC RefreshAfterRejectTranscation (rowid[])

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Reopens the query and refreshes the BindingSource after a transaction
has been rejected
Notes:

Parameters:
proDatasetRowids ROWID
The ROWID[] with all ROWID's of the ProDataset to reposition to
Top

PUBLIC RegisterSmartDataTarget (ISmartDataTarget)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Register a SmartDataTarget with the SmartDataSource.
This Method is called by Classes implementing the ISmartDataTarget
Interface when a new SmartDataSource is set.
Notes: After a new SmartDataTargetCollection Row is created this routine
tests if there is a valid BindingSource inside the new SmartDataTarget.
If there is one, the BindingSource of the SmartDataAdapter is disposed
and replaced by the one of the SmartDataTarget. A new BindingSource is
then populated to all SmartDataTargets of this SmartDataAdapter.
Enforced by Interface ISmartDataSource.

Parameters:
poSmartDataTarget Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget
The reference to the ISmartDataTarget to add to this SmartDataAdapter
Top

PUBLIC RegisterSmartGroupCreateTarget (ISmartGroupCreateTarget)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Register a SmartGroupCreateTarget with the SmartGroupCreateSource
This Method is executed every time a new SmartGroupCreateSource is
registered to the corresponding Property of a Class implementing the
Interface ISmartGroupCreateSource.
Notes: Enforced by Interface ISmartGroupCreateSource.

Parameters:
poSmartGroupCreateTarget Consultingwerk.SmartComponents.Interfaces.ISmartGroupCreateTarget
The ISmartGroupCreateTarget to register
Top

PUBLIC RejectTransaction ()

Purpose: Reverts the changes of a pending transaction
Notes:

Top

PUBLIC RemoveSmartNavigationSource (ISmartNavigationSource)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Removes a SmartNavigationSource from the SmartDataAdapter
instance
Notes: Enabled multiple SmartNavigationSources to the SmartDataAdapter.

Parameters:
poSmartNavigationSource Consultingwerk.SmartComponents.Interfaces.ISmartNavigationSource
The reference to the ISmartNavigationSource to be removed
Top

PROTECTED RepositionAfterUpdateRow (rowid, logical)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:RepositionAfterUpdateRow (rowid, logical)
Purpose: Repositions to the updated record after update
Notes:

Parameters:
proRowid ROWID
The rowid of the record to position to
plCreated LOGICAL
Logical value indicating if the current record was created
Top

PROTECTED RepositionCurrentRow ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Repositions the Adapters Query to the current row
Notes: Based on a previously stored row as some ProDataset methods invalidate
the current record buffers

Top

PUBLIC RepositionToRowid (character)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Repositions to a Rowid list from a character
Notes:

Parameters:
pcRowids CHARACTER
A comma delimited list of ROWIDs
Top

PUBLIC RepositionToRowid (rowid)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Repositions to a single Rowid
Notes:

Parameters:
prRowid ROWID
The ROWID to reposition to
Top

PUBLIC RepositionToRowid (rowid[])

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:RepositionToRowid (rowid[])
Purpose: Repositions to a Rowid Array
Notes:

Parameters:
prRowid ROWID
An Array of ROWIDs
Top

PUBLIC LOGICAL RetrieveData ()

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:RetrieveData ()
Purpose: Reads Data from a Datasource and links the DataHandle
with a BindingSource inside the Instance of SmartBusinessEntityAdapter.
If there is no valid instance of a BindigSource a new one is created.
After that a Dataset is cleared and then filled with the requested
data from the Database. Now a Query is build or reopened and the
Handle to this Query is assigned to the BindingSource:Handle.
Enforced by Interface ISmartDataSource
Notes: Do NOT call SUPER:RetrieveData() in the overriding method.
Remember to test if a BindingSource exists. If not call
CreateBindingSource from the base class.

Returns LOGICAL
Logical value indicating the success of the method
Top

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

Purpose: Bundles calls to ServiceAdapter:RetrieveData
Notes: Simplifies modifications on the ServiceAdapter / ServiceInterface
as we can centrally add or modify parameters

Parameters:
pcPartition CHARACTER
The AppServer partition to be used for this call
pcEntity CHARACTER
The name of the Business Entity
poFetchDataRequest Consultingwerk.OERA.IFetchDataRequest
The IFetchDataRequest with the parameter for this call
phDataSet DATASET-HANDLE
OUTPUT DATASET-HANDLE The result set
Top

PUBLIC SaveFromGroupCreateTarget (ISmartGroupCreateTarget)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Saves the data in this ISmartGroupCreateSource related updating
ISmartDataTarget so that before saving a new child record, that
parent record is created
Notes:

Parameters:
poSmartGroupCreateTarget Consultingwerk.SmartComponents.Interfaces.ISmartGroupCreateTarget
The ISmartGroupCreateTarget that invoked this Save operation
Top

PUBLIC SaveInDataTargets ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Recursively invokes SaveChanges in all DataTargets that are currently
updating
Notes: Throws an Exception, when of the DataTargets remains updating
Used during CommitChanges

Top

PRIVATE SetDesignerProperties ()

Purpose: Sets properties that affect the Visual Desginer
Notes:

Top

PROTECTED SetQuerySort (character)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:SetQuerySort (character)
Purpose: Overridable Setter for QuerySort property
Notes:

Parameters:
arg CHARACTER
The new value for the QuerySort property
Top

PROTECTED SetQueryString (character)

Purpose: Overridable Setter for QueryString property
Notes: Resets the FetchQueryString property to empty string, so that the
RetrieveData method rebuilds the FetchQueryString by concatenating
QueryString and QuerySort

Parameters:
arg CHARACTER
The new value for the QueryString property
Top

PUBLIC SetSavingData (logical)

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:SetSavingData (logical)
Purpose: Assigns the internal flag that data is being saved
Notes: Enforced by ISupportsSubmitChanges

Parameters:
plSaving LOGICAL
The new value for the flag that data is being saved
Top

PROTECTED SetSmartDataSource (ISmartDataSource)

Overrides Consultingwerk.SmartComponents.Base.SmartDataAdapter:SetSmartDataSource (ISmartDataSource)
Purpose: SetSmartDataSource sets the SmartDataSource of the current instance
of the SmartBusinessEntityAdapter.
This Method is called from the Property Setter of SmartDataSource in
the Base Class.
Gets the ForeignFields from the hDataset which if not read before is
fetched from the Backend. Afterwards the backward handshake with the
SmartDataSource is completed and the Handler for the PositionChanged
Event is subscribed to be able to recognize that the Parent Data has
changed.
Notes: You do not need to call SetSmartDataSource () in the overriding method.

Parameters:
arg Consultingwerk.SmartComponents.Interfaces.ISmartDataSource
The SmartDataSource for this instance
Top

PROTECTED SetTrackingChanges (logical)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Sets the tracking changes property of all temp-tables
Notes: Tables without a valid BEFORE-BUFFER will not be handled. For static
temp-tables this is typically understood as read-only temp-tables
(and the attempt to enable TRACKING-CHANGES would cause a runtime
error). Dynamic temp-tables that have never been set to
TRACKING-CHANGES = TRUE will never have a valid BEFORE-BUFFER. As
such it's expected that dynamic temp-tables that should be updatable
will be set to TRACKING-CHANGES briefly in their factory method.

Parameters:
plTrackingChanges LOGICAL
LOGICAL value indicating if tracking changes should be turned on or off
Top

PROTECTED ShowBusinessEntityPickerDialog ()

Purpose:
Notes:

Top

PROTECTED ShowDatasetControllerDialog ()

Purpose: Shows Dialog to select a DatasetController from within the
OEA/PDSOE Visual Designer
Notes: Stores the chosen class name in the DatasetControllerType property

Top

PROTECTED ShowTablePickerDialog ()

Purpose: Invokes the Table Picker Dialog and sets properties of the
SmartBusinessEntityAdapter during Design Time
Notes: Only intended for DesignTime

Top

PUBLIC StoreCopiedFrom (character)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Stores the source record key information with the new record (copy)
Notes:

Parameters:
pcSourceRecordKey CHARACTER
The record key of the source record to store with the copied record
Top

PUBLIC SubmitChanges ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:SubmitChanges ()
Purpose: Creates a dataset containing the modifications of the
SmartBusinessEntityAdapter's dataset and submits the changes dataset
to the service adapter (and then to the Business Entity).
Notes: Used from UpdateRow after every modification from the UI.

Top

PROTECTED SubmitChangesToBackend ()

Purpose: Creates a dataset containing the modifications of the
SmartBusinessEntityAdapter's dataset and submits the changes dataset
to the service adapter (and then to the Business Entity).
Notes: Used from UpdateRow after every modification from the UI.

Top

PUBLIC SubscribeAfterRetrieveData (IAfterRetrieveDataSubscriber)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Subscribes an instance of an object to the AfterRetrieveData
callback.
Notes: The object needs to implement the IAfterRetrieveDataSubscriber interface

Parameters:
poSubscriber Consultingwerk.SmartComponents.Interfaces.IAfterRetrieveDataSubscriber
The reference to the IAfterRetrieveDataSubscribe to add to the list of subscribers
Top

PUBLIC CHARACTER ToString ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns a String representation of this object instance
Notes: Userful for logging purposes, contains class name, entity name and entity table

Returns CHARACTER
The String representation of the object instance
Top

PUBLIC UpdateRow ()

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:UpdateRow ()
Purpose: The UpdateRow is an abstract method - that means that it needs
to be overridden in a class that inherits from this base class.
Enforced by Interface ISmartDataSource.
Notes: Do NOT call SUPER:UpdateRow() in the overriding method.

Top

PUBLIC UpdateRow (logical)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: UpdateRow submits the changes to a buffer into the Database.
Called by SmartViewerControl, SmartUpdatableBrowser
Data is updated into the Dataset from the BindingSource. After this
the Datasetchanges are submitted to the OERA Backend, merged into
the Dataset and the BindingSource gets refreshed.
Notes: Do NOT call SUPER:UpdateRow() in the overriding method.

Parameters:
plAssignFromBindingSource LOGICAL
Logical flag indicating of the value from the attached BindingSource should be assigned to the current record
Top

PROTECTED LOGICAL ValidateBusinessEntityName (character)

Purpose: Validates a BusinessEntityName agains the Backend.
Notes: This method is intended to be overridden by different backend
adapters (i.e. ticEnterprise)

Parameters:
pcEntityName CHARACTER
The name of the Business Entity
Returns LOGICAL
Logical value indicating if the business entity name is valid
Top

PROTECTED LOGICAL ValidateForeignField (character, ISmartDataSource)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Validates that a single field name is available in the SmartDataSource
or this Adapter instance
Notes:

Parameters:
pcFieldName CHARACTER
The current field name entry
poSmartDataSource Consultingwerk.SmartComponents.Interfaces.ISmartDataSource
The reference to the SmartDatasetAdapter instance that needs to contain the field
Returns LOGICAL
Logical value indicating that the field can be found
Top

PROTECTED ValidateForeignFields ()

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Validates the value of the ForeignFields property when during the
first ParentPositionChanged event
Notes:

Top

PROTECTED VerifyTransactionPending ()

Purpose: Verifies that after cancelling an update the Transaction State
should be PendingChanges
Notes: Tests if the ProDataset actually has changes or any of the
SmartDatasetChildAdapters are ModifyingData



Constructor Detail
Top

PUBLIC SmartBusinessEntityAdapter ()

Purpose: Constructor for the SmartBusinessEntityAdapter class
Notes:

Top

PUBLIC SmartBusinessEntityAdapter (IContainer)

Purpose: Constructor for the SmartBusinessEntityAdapter class
Notes:

Parameters:
poContainer System.ComponentModel.IContainer
The IContainer to add the SmartBusinessEntityAdapter to.


Event Detail
Top

PUBLIC AfterAssignRecord (Object, AfterAssignRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Event raised after a record has been assigned
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.AfterAssignRecordEventArgs
The AfterAssignRecordEventArgs with the data for this event
Top

PUBLIC AfterAutoCommitTransaction DELEGATE System.EventHandler

Purpose: Raised after an AutoCommit=TRUE transaction has been Commited
Notes:

Delegate: System.EventHandler
Top

PUBLIC AfterBatchAvailable DELEGATE System.EventHandler

Purpose: Event fired whenever the SmartDataAdapter has received a new batch
of data
Notes: This event will be raised also with the initial batch of data (when
the AfterReviewData event is raised as well)

Delegate: System.EventHandler
Top

PUBLIC AfterCancelCreateRecord (Object, AfterCancelCreateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Event fired after the creation of a record has been cancelled
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.AfterCancelCreateRecordEventArgs
The AfterCancelCreateRecordEventArgs with the data for this event
Top

PUBLIC AfterCommitTransaction DELEGATE System.EventHandler

Purpose: Raised after an AutoCommit=FALSE transaction has been Commited
Notes:

Delegate: System.EventHandler
Top

PUBLIC AfterCreateRecord (Object, AfterCreateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Event fired after a record has been created
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.AfterCreateRecordEventArgs
The AfterCreateRecordEventArgs with the data for this event
Top

PUBLIC AfterDeleteRecord (Object, AfterDeleteRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Event raised after a record has been deleted
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.AfterDeleteRecordEventArgs
The AfterDeleteRecordEventArgs with the data for this event
Top

PUBLIC AfterGetChanges (Object, AfterGetChangesEventArgs)

Purpose: Raised before the SmartBusinessEntityAdapter gets the Changes of the ProDataset
Notes: The AfterGetChanges Event allows manipulation of the Changes dataset
on the client after it has been populated using the GET-CHANGES method

Parameters:
sender Progress.Lang.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.AfterGetChangesEventArgs
The AfterGetChangesEventArgs with the data for this event
Top

PUBLIC AfterMergeChanges (Object, MergeChangesEventArgs)

Purpose: Raised after the processed changes from the backend are merged with
the local data
Notes:

Parameters:
sender System.Object
The object that raised the AfterMergeChanges event
e Consultingwerk.SmartComponents.Implementation.MergeChangesEventArgs
The MergeChangesEventArgs with the data for the event
Top

PUBLIC AfterQueryPositionChanged DELEGATE System.EventHandler

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event fired whenever the QueryPosition has changed (i.e. Add or
Delete and Grids etc. need to update the current position)
Notes:

Delegate: System.EventHandler
Top

PUBLIC AfterRejectTransaction DELEGATE System.EventHandler

Purpose: Raised after a transaction has been Rejected
Notes:

Delegate: System.EventHandler
Top

PUBLIC AfterRetrieveData DELEGATE System.EventHandler

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event fired whenever the SmartDataAdapter has opened a new query
Notes:

Delegate: System.EventHandler
Top

PUBLIC AfterUpdateRecord (Object, AfterUpdateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Event raised after a record has been updated
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.AfterUpdateRecordEventArgs
The AfterUpdateRecordEventArgs with the data for this event
Top

PUBLIC AssignForeignFields (Object, AssignForeignFieldsEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised while creating a new record in a child SmartDatasetAdapter
Notes: The event is raised just before the foreign field values are assigned.
Setting the Handled property of the event argument to TRUE will prevent
the Adapter for assigning the foreign field values as it is assumed
that an event subscribed has done so already.

Parameters:
sender Progress.Lang.Object
The object that raised the AssignForeignFields event
e Consultingwerk.SmartComponents.Base.AssignForeignFieldsEventArgs
The AssignForeignFieldsEventArgs with the data for the event
Top

PUBLIC AssignKeyFieldError (Object, AssignKeyFieldErrorEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised when the SmartDatasetAdapter catches an error while assigning
the fields from the BindindSource
Notes: This event allows the UI to review the error and provide more appropriate
error handling than just showing the Progress Error message. From this
event you may actually throw an error message which is more informational
to the end user

Parameters:
sender Progress.Lang.Object
The object that raised the AssignKeyFieldError event
e Consultingwerk.SmartComponents.Base.AssignKeyFieldErrorEventArgs
The AssignKeyFieldErrorEventArgs with the data for the event
Top

PUBLIC AssignKeyFields (Object, AssignKeyFieldsEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Event raised when a ISmartGroupCreateSource needs to create a
record to allow creation of a child record in a ISmartGroupCreateTarget
instance.
Notes: The purpose of this event is that an event handler can create
meaningful key values. When done an event handler is supposed to
ASSIGN e:Assigned = TRUE .

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Base.AssignKeyFieldsEventArgs
The AssignKeyFieldEventArgs with the data for this event
Top

PUBLIC AutoCommitChanged DELEGATE System.EventHandler

Purpose: Raised when the AutoCommit property is changed
Notes: Required for ISmartCommitTarget

Delegate: System.EventHandler
Top

PUBLIC BeforeAssignRecord (Object, BeforeAssignRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Event raised before assigning to a record
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.BeforeAssignRecordEventArgs
The BeforeAssignRecordEventArgs with the data for this event
Top

PUBLIC BeforeCancelCreateRecord (Object, BeforeCancelCreateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised before the creation of the record will be cancelled
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.BeforeCancelCreateRecordEventArgs
The BeforeCancelCreateRecordEventArgs with the data for this event
Top

PUBLIC BeforeCommitTransaction DELEGATE System.ComponentModel.CancelEventHandler

Purpose: Raised before a transaction will be commited
Notes:

Delegate: System.ComponentModel.CancelEventHandler
Top

PUBLIC BeforeCreateRecord (Object, BeforeCreateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised before the a record is created
Notes: The BeforeCreateRecord event handler are NOT allowed to contain
MESSAGE statements. This will cause the Buffer to no longer
point to the (right) record!

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.BeforeCreateRecordEventArgs
The BeforeCreateRecordEventArgs with the data for this event
Top

PUBLIC BeforeCreatingRecord (Object, CancelableEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised before the SmartDatasetAdapter is about to create a new record
in the CreateRecord method
Notes: Unlike the BeforeCreateRecord (which allows to assign new values
to the newly created record), this event is raised before any new
record is created

Parameters:
sender Progress.Lang.Object
The object that raised the CreatingRecord event
e Consultingwerk.CancelableEventArgs
The Consultingwerk.CancelableEventArgs with the data for the event
Top

PUBLIC BeforeDeleteRecord (Object, BeforeDeleteRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised before the a record is deleted
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.BeforeDeleteRecordEventArgs
The BeforeDeleteRecordEventArgs with the data for this event
Top

PUBLIC BeforeGetChanges (Object, BeforeGetChangesEventArgs)

Purpose: Raised before the SmartBusinessEntityAdapter gets the Changes of the ProDataset
Notes: The BeforeGetChanges Event allows manipulation of the Data on the client
prior to calling the GET-CHANGES method on the Dataset

Parameters:
sender Progress.Lang.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.BeforeGetChangesEventArgs
The BeforeGetChangesEventArgs with the data for this event
Top

PUBLIC BeforeMergeChanges (Object, MergeChangesEventArgs)

Purpose: Raised before the processed changes from the backend are merged with
the local data
Notes:

Parameters:
sender System.Object
The object that raised the BeforeMergeChanges event
e Consultingwerk.SmartComponents.Implementation.MergeChangesEventArgs
The MergeChangesEventArgs with the data for the event
Top

PUBLIC BeforeRejectTransaction DELEGATE System.ComponentModel.CancelEventHandler

Purpose: Raised before a transaction will be rejected
Notes:

Delegate: System.ComponentModel.CancelEventHandler
Top

PUBLIC BeforeRetrieveData DELEGATE System.ComponentModel.CancelEventHandler

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event fired before the SmartDataAdapter is about to open a new query
Notes:

Delegate: System.ComponentModel.CancelEventHandler
Top

PUBLIC BeforeUpdateRecord (Object, BeforeUpdateRecordEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised before the a record is updated
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.BeforeUpdateRecordEventArgs
The BeforeUpdateRecordEventArgs with the data for this event
Top

PUBLIC BeginUpdateState (Object, DataSourceUpdateStateEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event raised when a ISmartDataTarget of this SmartDataAdapter instance
begins the update state
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.DataSourceUpdateStateEventArgs
The DataSourceUpdateStateEventArgs instance with the data for this event
Top

PUBLIC BindingSourceChanged (Object, BindingSourceChangedEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event fired whenever the SmartDataAdapters BindingSource property
changes
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Base.BindingSourceChangedEventArgs
The BindingSourceChangedEventArgs instance with the data for this event
Top

PUBLIC CollectFilterValues (Object, CollectFilterValuesEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Event raised to collect Filter Values from Filter Sources
Notes: Required by IFilterTarget

Parameters:
sender Progress.Lang.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.CollectFilterValuesEventArgs
The CollectFilterValuesEventArgs with the data for this event
Top

PUBLIC CurrentChanged DELEGATE System.EventHandler

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raised whenever the Data Adapter is positioned on a new row.
Notes: The event is raised, when the BindingSource PositionChanged event
is raised, when the ParentPosition has changed and the Query is closed
etc.

Delegate: System.EventHandler
Top

PUBLIC DatasetControllerChanged DELEGATE System.EventHandler

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised when the DatasetController property is changed
Notes:

Delegate: System.EventHandler
Top

PUBLIC EndUpdateState (Object, DataSourceUpdateStateEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event raised when a ISmartDataTarget of this SmartDataAdapter instance
ends the update state
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.DataSourceUpdateStateEventArgs
The DataSourceUpdateStateEventArgs instance with the data for this event
Top

PUBLIC FindCurrentRecordAfterCommitChanges (Object, BufferHandleEventArgs)

Purpose: Raised after an AutoCommit=FALSE SmartBusinessEntityAdapter has submitted
changes to the backend.
Notes: Allows developers to influence the record to which the
SmartBusinessEntityAdapter and linked SmartDataBrowsers should be located
after the commit operation

Parameters:
sender Progress.Lang.Object
The object that raised the FindCurrentRecordAfterCommitChanges event
e Consultingwerk.SmartComponents.Base.BufferHandleEventArgs
The BufferHandleEventArgs with the data for the event
Top

PUBLIC HandleValidationError (Object, HandleValidationErrorEventArgs)

Purpose: Raised to allow subscribers to handle validations errors caused by
a non AutoCommit transaction commit
Notes: Set the e:Handled = TRUE to avoid error handling by the SmartBusinessEntityAdpater
instance

Parameters:
sender Progress.Lang.Object
The object that raised the HandleValidationError event
e Consultingwerk.SmartComponents.Implementation.HandleValidationErrorEventArgs
The HandleValidationErrorEventArgs with the data for the event
Top

PUBLIC NewFetchDataRequest (Object, NewFetchDataRequestEventArgs)

Purpose: Raised before an actual call to the Service Adapter is made to read
data from the backend
Notes: Allows modification of the FetchDataRequest object

Parameters:
sender Progress.Lang.Object
The object that raised the NewFetchDataRequest event
e Consultingwerk.SmartComponents.Implementation.NewFetchDataRequestEventArgs
The NewFetchDataRequestEventArgs with the data for the event
Top

PUBLIC NonUpdatableColumnsChanged DELEGATE System.EventHandler

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised when the NonUpdatableColumns property is changed
Notes:

Delegate: System.EventHandler
Top

PUBLIC QueryClosed DELEGATE System.EventHandler

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Raised when the CloseQuery method is called
Notes: E.g. when the parent SmartDataAdapter of the current instance does
not hold any record anymore

Delegate: System.EventHandler
Top

PUBLIC SmartCommitSourceChanged DELEGATE System.EventHandler

Purpose: Event fired whenever the SmartCommitSource property has
changed
Notes:

Delegate: System.EventHandler
Top

PUBLIC SmartNavigationTargetPositionChanged (Object, SmartNavigationTargetPositionChangedEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event fired whenever the RecordPositon properties has changed
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Base.SmartNavigationTargetPositionChangedEventArgs
The SmartNavigationTargetPositionChangedEventArgs with the data for this event
Top

PUBLIC SmartNavigationTargetStateChanged (Object, SmartNavigationTargetStateChangedEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Event fired whenever the SmartDataSourceState property has changed
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Base.SmartNavigationTargetStateChangedEventArgs
The SmartNavigationTargetStateChangedEventArgs with the data for this event
Top

PUBLIC SmartTransactionStateChanged DELEGATE System.EventHandler

Purpose: Event fired whenever the SmartTransactionState property has
changed
Notes:

Delegate: System.EventHandler
Top

PUBLIC UnableToRepositionAfterUpdateRow (Object, UnableToRepositionAfterUpdateRowEventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Raised when the SmartDatasetAdapter is unable to reposition to the
updated row after update (typically the key values of the record
have changed so that it does no longer match the query criteria)
Notes: For sample event handler code, see SCL-500

Parameters:
sender Progress.Lang.Object
The object that raised the UnableToRepositionAfterUpdateRow event
e Consultingwerk.SmartComponents.Base.UnableToRepositionAfterUpdateRowEventArgs
The UnableToRepositionAfterUpdateRowEventArgs with the data for the event


Property Detail
Top

PUBLIC CHARACTER AppServerPartition

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Gets/Sets the name of the AppServer Partition to be used
by this SmartDataAdapter instance
Notes: The property is defined in the abstract SmartDataAdapter base
class - even when some implementations may not require an AppServer
connection

Returns CHARACTER
Top

PUBLIC LOGICAL AutoCommit

Purpose: Controls the AutoCommit functionality of the SmartBusinessEntityAdapter
Notes:

Returns LOGICAL
Top

PUBLIC LOGICAL Available

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns if the DataSource currently has a record available
Notes:

Returns LOGICAL
Top

PUBLIC INTEGER BatchSize

Purpose: Gets/Sets the BatchSize used when reading data from the Business
Entity.
Notes: Batching is used for the EntityTable, not the view tables!
Set to 0 to fetch all data and disable Batching
The default value for this property may be set using the DefaultBatchSize
preprocessor variable in Consultingwerk/products.i

Returns INTEGER
Top

PROTECTED CHARACTER BindableProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Property that is used to mark properties (comma-delimited list) that
should be Data-Bindable
Notes: C# Annotation: [Bindable(true)]

Returns CHARACTER
Top

PUBLIC Progress.Data.BindingSource BindingSource

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Get/Set the BindingSource of the current Class. The BindingSource
can be set to any class derived from Progress.Data.BindingSource.
This Property is set internaly if the SmartDataAdapter is attached
to a Browser where a DesignTime BindingSource is attached or if
the developer calls RetrieveData ().
If a valid BindingSource exists inside the SmartDataAdapter the
EventHandlers get unsubscribe from that instance and it is replaced
with the new one. After that the Handlers for the Events of the
BindingSource are subscribed to the new instance.
Notes: Enforced by Interface ISmartDataSource.

Returns Progress.Data.BindingSource
Top

PUBLIC CHARACTER BindingSourceExcludeFields

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Get/Set the Exclude Fields for the BindingSource created by the
CreateBindingSource method.
Notes: As optional parameters, the constructors of the BindingSource can accept
comma-separated lists of data object fields, in display order, to make
available to or exclude from the UI. If you want to make only a few fields
available, list them in the included field list. If you want to make most
fields available, set the available fields to be all fields and list
the remaining fields in the excluded field list. When the included field
list is an asterisk (*), all fields in the data object are made available
to any bound UI control.
The excluded field list is only meaningful when the included field list is
an asterisk (*). If the included field list contains specific fields,
the excluded field list is ignored. However, when you are not specifying
any excluded fields, you still must specify a blank value ("") to match the
constructor's signature.

Returns CHARACTER
Top

PUBLIC CHARACTER BindingSourceIncludeFields

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Get/Set the Include Fields for the BindingSource created by the
CreateBindingSource method.
Notes: See BindingSourceExcludeFields for further comments

Returns CHARACTER
Top

PUBLIC CHARACTER BindTo

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:BindTo
Purpose: Binding the BusinessEntityBindingSource to a Query or a Dataset.
This Property is set by the Developer during DesignTime.
Notes:

Returns CHARACTER
Top

PROTECTED CHARACTER CategorizedProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Property that is used to mark properties (comma-delimited list) that
should receive a Category attribute
Notes: C# Annotation: [Category("...")]
This is a comma delimited list

Returns CHARACTER
Top

PROTECTED CHARACTER CategoryProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Categories of the Property in the CategorizedProperty list
Notes: C# Annotation: [Category("...")]
This is a comma delimited list

Returns CHARACTER
Top

PUBLIC HANDLE ContextDataset

Purpose: Gets/Sets the reference to an optionally used Context Dataset
Notes: The Context Dataset provides an simple way to exchange custom context
between the client and the server (user interface to business logic)

Returns HANDLE
Top

PUBLIC CHARACTER ContextID

Purpose: Gets/Sets the ContextID to recognize the instance of the
Business Entity on the Backend
Notes: Allows multiple instances of the Business Entities on the
backend

Returns CHARACTER
Top

PUBLIC CHARACTER ContextString

Purpose: Gets/Sets the ContextString used for the communication with the
Business Entity.
Notes:

Returns CHARACTER
Top

PUBLIC LOGICAL CreatingRecord

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns if this SmartDatasetAdapter is currently creating a new
record
Notes:

Returns LOGICAL
Top

PUBLIC CHARACTER CustomContext

Purpose: Gets/Sets the CustomContext used for the communication with the
Business Entity.
Notes: While the ContextString is part of the Business Entity context (and
thus mixing the Business Entity internal context with sort of custom
context the property CustomContext is 100% reserved for the use
in your own Business Entities / Data Access Objects

Returns CHARACTER
Top

PUBLIC HANDLE DataSet

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:DataSet
Purpose: Returns the handle to the ProDataset instance managed by the
SmartBusinessEntityAdapter
Notes:

Returns HANDLE
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.IDatasetController DatasetController

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:DatasetController
Purpose: A Reference to the DatasetController that is is owning the Dataset
on which this SmartBusinessEntityAdapter is operating.
Notes: The property can only be set at long as this
SmartBusinessEntityAdapter does not already have a valid dataset
handle (DatasetHandle property)

Returns Consultingwerk.SmartComponents.Interfaces.IDatasetController
Top

PUBLIC CHARACTER DatasetControllerType

Purpose: The typename of the DatasetController that is is owning the Dataset
on which this SmartBusinessEntityAdapter is operating.
Notes: The property can only be set at long as this
SmartBusinessEntityAdapter is not already connected to a
DatasetController.

Returns CHARACTER
Top

PUBLIC Progress.Data.BindingSource DataSourceBindingSource

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns a reference to the BindingSource of the SmartDataSource
Notes:

Returns Progress.Data.BindingSource
Top

PROTECTED CHARACTER DescribedProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Property that is used to mark properties (comma-delimited list) that
should receive a Description attribute
Notes: C# Annotation: [Description("...")]
This is a comma delimited list

Returns CHARACTER
Top

PROTECTED CHARACTER DescriptionProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Description of the Property in the DescribedProperties list
Notes: C# Annotation: [Description("...")]
This is a CHR(1) delimited list

Returns CHARACTER
Top

PROTECTED CHARACTER DesignerVerbs

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Property that is used to generate Designer Verbs (actions for the
Visual Designer)
Notes:

Returns CHARACTER
Top

PROTECTED CHARACTER DesignerVisibilityAttributes

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: The CHARACTER representation of the DesignerSerializationVisibiltiy
attribute (Content/Visible/Hidden), see .NET Enumeration
System.ComponentModel.DesignerSerializationVisibility
Notes: C# Annotation: [DesignerSerializationVisibility(...)]
This is a comma delimited list

Returns CHARACTER
Top

PROTECTED CHARACTER DesignerVisibilityProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Property that is used to mark properties (comma-delimited list) that
should receive a DesignerSerializationVisibility Attribute
Notes: C# Annotation: [DesignerSerializationVisibility(...)]
This is a comma delimited list

Returns CHARACTER
Top

PUBLIC LOGICAL DesignTime

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Propery flags if the current instance of the SmartBindingSource
is running at design time or runtime.
Notes: Set during constructor using a check at the
System.ComponentModel.LicenseManager

Returns LOGICAL
Top

PROTECTED LOGICAL DesingerHostLoading

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Propery returns if the component's DesignerHost is currently
loading the document
Notes:

Returns LOGICAL
Top

PUBLIC LOGICAL EmptyDatasetOnRetrieveData

Purpose: Controls if the SmartBusinessEntityAdapter instance empties the
ProDataset at the beginning of a call to RetrieveData
Notes: Set this to true to be able to aggregate data from multiple RetrieveData
call (e.g. when the SmartBusinessEntityAdapter is used as the source
for a tree view). In those cases it's expected that the BatchSize is
set to 0. The use of a NavigationSource is also questionable in those
cases, SCL-1099

Returns LOGICAL
Top

PUBLIC CHARACTER EntityJoin

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:EntityJoin
Purpose: A List in the same order as EntityView which defines Join (YES or NO)
for each Table of pcEntityView.
This Property is set by the Developer during DesignTime.
Notes:

Returns CHARACTER
Top

PUBLIC CHARACTER EntityName

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:EntityName
Purpose: Name of the BusinessEntity.
This Property is set by the Developer during DesignTime.
Notes:

Returns CHARACTER
Top

PUBLIC CHARACTER EntityTable

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:EntityTable
Purpose: RootTable for this Instance of the BusinessEntity.
This Property is set by the Developer during DesignTime.
Notes:

Returns CHARACTER
Top

PUBLIC CHARACTER EntityView

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:EntityView
Purpose: List of Tables to read with the EntityTable.
This Property is set by the Developer during DesignTime.
Notes:

Returns CHARACTER
Top

PUBLIC Consultingwerk.ListQueryExpressionByTable FetchFilterValues

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns the list of Query Expressions by Table of the previous
RetrieveData
Notes: Required for batching capabilities

Returns Consultingwerk.ListQueryExpressionByTable
Top

PUBLIC LOGICAL FetchLastOnServer

Purpose: Controls if the FetchLast method will fetch all remaining records
(behaviour until July 2011) or directly fetch the last batch using
the current batch size and the ability to perform backwards batching
for retrieving the records before the last batch
Notes: Default is FALSE, which performs the old behaviour (until July 2011
the only behaviour)

Returns LOGICAL
Top

PROTECTED CHARACTER FetchQueryString

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: This is the QueryString for the next Fetch operation.
This Property is set by the ParentPositionChanged Method every time
the Parent Data changes.
Notes:

Returns CHARACTER
Top

PROTECTED CHARACTER FindString

Purpose: Specifies a record to be repositioned from the server (FIND-FIRST)
Notes:

Returns CHARACTER
Top

PROTECTED LOGICAL FirstTime

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Indicates if a DataAdapters Query is being opened for the First time
Notes:

Returns LOGICAL
Top

PUBLIC CHARACTER ForeignFields

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: ForeignFields related to the Parent SmartDataSource.
Notes: This Property is set by the SetSmartDataSource Method when a new
SmartDataSource is registered.

Returns CHARACTER
Top

PROTECTED CHARACTER HiddenProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Property that is used to mark properties (comma-delimited list) that
will be excluded from the .NET TypeDescriptor properties list
Notes:

Returns CHARACTER
Top

PUBLIC LOGICAL Initializing

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Indicates that the SmartDataAdapter is currrently being
Initialized
Notes:

Returns LOGICAL
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.Design.IDesignCommitSource LinkCommitSource

Purpose: Represents the SmartCommitSource property casted to a .NET Interface
Notes: Implementation of Interface in Consultingwerk.SmartComponents.dll

Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignCommitSource
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource LinkDataSource

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Represents the SmartDataSource property casted to a .NET Interface
Notes: Implementation of Interface in Consultingwerk.SmartComponents.dll
SCL-725 - code moved from LinkDataSource.i directly into class file

Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.Design.IDesignNavigationSource LinkNavigationSource

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Represents the SmartNavigationSource property casted to a .NET Interface
Notes: Implementation of Interface in Consultingwerk.SmartComponents.dll
SCL-725 - code moved from LinkNavigationSource.i directly into class file

Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignNavigationSource
Top

PUBLIC Consultingwerk.OERA.INamedQueryParameter NamedQuery

Purpose: Gets and sets the reference to the Named Query Parameter instance
used for the next invokation of the RetrieveData method
Notes: Named queries are a concept where the actual query criteria is
constructed within the Business Entity or the Data Access class.
The consumer simply passes in a query name and a list of arguments
(similar to Dictionary of <PrimitiveHolder> classes). The Business
Entity or the Data Access class will convert this into the actual
query parameters. This moves the responsibility of handling the
complexity when building complex query strings into the Business
Entity or alternatively into the Data Access class - allowing the
back end developer to also decide on optimal use of indexes etc.
http://confluence.consultingwerkcloud.com/wiki/display/SCL/Named+Queries

Returns Consultingwerk.OERA.INamedQueryParameter
Top

PROTECTED CHARACTER NextContext

Purpose: The context for the next Fetch next call
Notes:

Returns CHARACTER
Top

PROTECTED CHARACTER NonBrowsableProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartComponent
Purpose: Property that is used to mark properties (comma-delimited list) that
should not show up in the Visual Designers Property Grid
Notes:

Returns CHARACTER
Top

PUBLIC CHARACTER NonUpdatableColumns

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Get's/set's Columns that will not get updated by UpdateRow (TRUE)
Notes:

Returns CHARACTER
Top

PUBLIC INTEGER PrefetchOnFindRowWhere

Purpose: Specifies the number of records the a FindRowWhere
(FindRowWhereModeEnum FindOnServer) should read from the backend
Notes: This is helpful to signal in a browser etc. that the user can
scroll up - beyond the found row.

Returns INTEGER
Top

PROTECTED CHARACTER PrevContext

Purpose: The context for the next Fetch prev call
Notes:

Returns CHARACTER
Top

PROTECTED CHARACTER PreviousFetchQueries

Purpose: Provides access to the last query used by the SmartBusinessEntityAdapter
to retrieve data from the backend
Notes: Allows customers to use this information in a derived SmartBusinessEntityAdpater
class, e.g. to count the records returned by the previous query

Returns CHARACTER
Top

PROTECTED INTEGER PreviousPosition

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Get/Set if the Position of this Adapters BindingSource's position
prio to the last RetrieveData call.
Notes: The value of this property is used to invoke the ParentPosition
Changed event of Child-DataAdapters after this DataAdapter
has refetched data

Returns INTEGER
Top

PUBLIC LOGICAL PromptWhenRetrieveDataInUpdateState

Purpose: Allows to show a prompt when RetrieveData is called while an update
is pending in the BusinessEntityAdapter instance
Notes: Typically it's not required to prompt if RetrieveData should be
executed - as the default UI functions (Browser navigation, Browser
sort, Smart Filter) that would cause RetrieveData to be called are
sensitive to a pending update state. This property is to support
customers that call RetrieveData from custom code

Returns LOGICAL
Top

PUBLIC HANDLE QueryHandle

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns the handle to the Query used to navigate the selected tables
of the ProDataset instance managed by the SmartBusinessEntityAdapter
Notes:

Returns HANDLE
Top

PUBLIC CHARACTER QuerySort

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Controls the sort-order used at the client
Notes:

Returns CHARACTER
Top

PUBLIC CHARACTER QueryString

Overrides Consultingwerk.SmartComponents.Base.SmartDatasetAdapter:QueryString
Purpose: This is a base query string.
Notes:

Returns CHARACTER
Top

PUBLIC CHARACTER RecordPosition

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns a Value of RecordPositionEnum representing the current position
The Property is read in the Method PositionChangedHandler () of a
Class implementing the Interface ISmartNavigationTarget.
Enforced by Interface ISmartNavigationTarget.
Notes: Possible Values (RecordPositionEnum):
NoRecordAvailable, OnlyRecord, FirstRecord, LastRecord, NotFirstOrLast

Returns CHARACTER
Top

PUBLIC LOGICAL RetrieveDataOnChangeSortOrder

Purpose: This property allows to subspend the call to RetrieveData in
the setter of QuerySort (SetQuerySort method)
Notes: Defaults to TRUE

Returns LOGICAL
Top

PUBLIC Consultingwerk.ISerializable SaveChangesParameter

Purpose: Gets and sets the referecence to an optional parameter object passed
to the Business Entity during SaveChanges/SubmitChanges
Notes: Requires the ServiceAdapter to implement the IServiceAdapterWithSubmitDataParameter
interface

Returns Consultingwerk.ISerializable
Top

PUBLIC LOGICAL SelectTables

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: This property is depricated since the addition of Designer Verbs
Notes:

Returns LOGICAL
Top

PUBLIC Consultingwerk.OERA.IServiceAdapter ServiceAdapter

Purpose: Returns the reference to the ServiceAdapter that is being used by this
SmartBusinessEntityAdapter
Notes: See InitializeServiceAdapter method

Returns Consultingwerk.OERA.IServiceAdapter
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartCommitSource SmartCommitSource

Purpose: A reference to the SmartCommitSource of this SmartBusinessEntityAdapter
Notes:

Returns Consultingwerk.SmartComponents.Interfaces.ISmartCommitSource
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartDataSource SmartDataSource

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Get/Set the SmartDataSource of the current Class. The SmartDataSource
can be set to any class implementing the Interface ISmartDataSource.
This Property is set by the developer when initializing a Control
implementing the Interface ISmartDataTarget.
Enforced by Interface ISmartDataTarget.
Notes:

Returns Consultingwerk.SmartComponents.Interfaces.ISmartDataSource
Top

PUBLIC LOGICAL SmartDataSourceActive

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Get/Set if this instance of the SmartDataAdapter is subscribed
to the PositionChanged event of the SmartDataSource's BindingSource
Notes:

Returns LOGICAL
Top

PUBLIC CHARACTER SmartDataSourceState

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Get/Set the SmartDataSourceState of the current Class.
This Property is set to Updating if the Method BeginUpdateState () of the
SmartDataAdapter instance is called and it is set to Navigatable
during initialization and if the Property SmartTableIOState of a
Viewer is set to anything but ModifyingData.
Notes: Possible Values (DataSourceStateEnum) are Navigatable, Updating

Returns CHARACTER
Top

PUBLIC Consultingwerk.SmartComponents.Base.ListISmartDataTarget SmartDataTargets

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns the list of SmartDataTargets as a generic list
Notes:

Returns Consultingwerk.SmartComponents.Base.ListISmartDataTarget
Top

PUBLIC Consultingwerk.SmartComponents.Base.ListISmartGroupCreateTarget SmartGroupCreateTargets

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Returns the list of SmartGroupAssignTargets as a generic list
Notes:

Returns Consultingwerk.SmartComponents.Base.ListISmartGroupCreateTarget
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartNavigationSource SmartNavigationSource

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Get and Set the current SmartNavigationSource of the SmartDataAdapter.
Every SmartNavigationTarget is registered with handshake and kept in a
collection.
This Property is set by the developer when initializing a Control
implementing the Interface ISmartDataSource.
Enforced by Interface ISmartDataSource.
Notes:

Returns Consultingwerk.SmartComponents.Interfaces.ISmartNavigationSource
Top

PUBLIC Consultingwerk.SmartComponents.Enum.TransactionStateEnum SmartTransactionState

Purpose: Returns the current Transaction State
Notes:

Returns Consultingwerk.SmartComponents.Enum.TransactionStateEnum
Top

PUBLIC INTEGER StopAfter

Purpose: Value for StopAfter to be passed to the Service Interface
Notes: Allows limiting the execution time of queries executed on the backend
Not supported on OpenEdge 10.2B
The default value for this property may be set using the DefaultStopAfter
preprocessor variable in Consultingwerk/products.i

Returns INTEGER
Top

PUBLIC LOGICAL ThrowErrorsFromRetrieveData

Inherited from Consultingwerk.SmartComponents.Base.SmartDatasetAdapter
Purpose: Gets/Sets if errors from RetrieveData (in childs of this abstract
base class) should be THROWN or Shown from the DataAdapter class
(Using ErrorHelper)
Notes: The default is to Show the error message (FALSE), not to throw it.

Returns LOGICAL
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget UpdatingSmartDataTarget

Inherited from Consultingwerk.SmartComponents.Base.SmartDataAdapter
Purpose: Returns a reference to the SmartDataTarget which is currently in
update mode
Notes: This might be a SmartDataTarget actually linked to a different
SmartDataAdapter. This SmartDataTarget is supposed to end the
UpdateState before this SmartDataAdapter becomes navigatable again

Returns Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget


©2006-2016 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       26.08.2016 08:31:57