Namespace: Consultingwerk.SmartFramework.System
Class 
RelationBusinessEntity Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.OERA.BusinessEntity
Consultingwerk.SmartFramework.SmartBusinessEntity
Consultingwerk.SmartFramework.System.RelationBusinessEntity

Inherits: Consultingwerk.SmartFramework.SmartBusinessEntity
Implements: Ccs.BusinessLogic.IBusinessEntity, Ccs.BusinessLogic.IUpdatableBusinessEntity, Consultingwerk.OERA.IBusinessEntity, Consultingwerk.OERA.IBusinessService, Consultingwerk.OERA.IFetchDataByReference, Consultingwerk.OERA.IHasContextID, IProvidesBusinessEntityDescriptor, Consultingwerk.OERA.IProvidesDatasetModel, ISupportsETagValue, Consultingwerk.OERA.ISupportsResetState, Consultingwerk.OERA.ISupportsStaticQueryRequests


Consultingwerk.SmartFramework.System.RelationBusinessEntity
Consultingwerk.SmartFramework.System.RelationBusinessEntity

Navigate to: Methods | Constructors | Events | Properties | ProDatasets | Temp-Tables



Top Method Summary
Options Name Purpose
CreateMissingDatabaseRelations (dataset, GetMissingDatabaseRelationsParameter) Creates missing SmartRelation records
F FetchData (IFetchDataRequest, dataset) Fetch data from the Data Access object
FetchDataByKeyTable (dataset, IFetchDataByKeyTableParameter) Supports to retrieve multiple DB records from a Business Entity based on a temp-table with key values
F FetchDataByReference (IFetchDataRequest, dataset) Fetch data from the Data Access object
GetMissingDatabaseRelations (dataset, GetMissingDatabaseRelationsParameter) Returns a list of missing Database Relations to the caller
Consultingwerk.OERA.IFetchDataByStaticQueryRequest GetStaticQueryRequest (character, character, character, character) Returns a strong-typed static query request instance for the given table and field combination
ReceiveData () Provides a hook to modify data in the ProDataset after Read and Update operations (i.e. population of aggregated values)
LOGICAL TryGetQualifiedTableName (character, character) Resolves the QualifiedTableName for a SmartTable GUID, caching the result so relations sharing a table are resolved in memory.
ValidateData () Provides a hook for high level data validation before Update operations

Top Constructor Summary
Options Name Purpose
RelationBusinessEntity () Constructor of the RelationBusinessEntity class


Method Detail
Top

CreateMissingDatabaseRelations (dataset, GetMissingDatabaseRelationsParameter)
Purpose: Creates missing SmartRelation records
Notes:

Parameters:
dsMissingRelations DATASET dsMissingRelations
INPUT-OUTPUT DATASET
poParameter Consultingwerk.SmartFramework.System.GetMissingDatabaseRelationsParameter
The Parameter Object for this method
Top

FetchData (IFetchDataRequest, dataset)
Purpose: Fetch data from the Data Access object
Notes:

Parameters:
poFetchDataRequest Consultingwerk.OERA.IFetchDataRequest
The IFetchDataRequest object with the parameters for this call
dsRelation DATASET dsRelation
Top

FetchDataByKeyTable (dataset, IFetchDataByKeyTableParameter)
Purpose: Supports to retrieve multiple DB records from a Business Entity based on
a temp-table with key values
Notes:

Parameters:
dsRelation DATASET dsRelation
poParameter Consultingwerk.OERA.IFetchDataByKeyTableParameter
The IFetchDataByKeyTableParameter with the data for this call
Top

FetchDataByReference (IFetchDataRequest, dataset)
Purpose: Fetch data from the Data Access object
Notes:

Parameters:
poFetchDataRequest Consultingwerk.OERA.IFetchDataRequest
The IFetchDataRequest object with the parameters for this call
dsRelation DATASET dsRelation
Top

GetMissingDatabaseRelations (dataset, GetMissingDatabaseRelationsParameter)
Purpose: Returns a list of missing Database Relations to the caller
Notes:

Parameters:
dsMissingRelations DATASET dsMissingRelations
INPUT-OUTPUT DATASET
poParameter Consultingwerk.SmartFramework.System.GetMissingDatabaseRelationsParameter
The Parameter Object for this method
Top

Consultingwerk.OERA.IFetchDataByStaticQueryRequest GetStaticQueryRequest (character, character, character, character)
Purpose: Returns a strong-typed static query request instance for the
given table and field combination
Notes: Returns the unknown value when no static query covers the
given table / field combination

Parameters:
pcTableName CHARACTER
The name of the (temp-)table the request is for
pcFieldNames CHARACTER
Comma-separated list of temp-table field names
pcFieldValues CHARACTER
CHR(1)-separated list of field values, positionally matching pcFieldNames
pcChildTables CHARACTER
Comma-separated list of child table names to be filled
Returns Consultingwerk.OERA.IFetchDataByStaticQueryRequest
The IFetchDataByStaticQueryRequest instance or the unknown value
Top

ReceiveData ()
Purpose: Provides a hook to modify data in the ProDataset after Read and
Update operations (i.e. population of aggregated values)
Notes: Invoked during FetchData () and SaveChanges ()

Top

LOGICAL TryGetQualifiedTableName (character, character)
Purpose: Resolves the QualifiedTableName for a SmartTable GUID, caching the
result so relations sharing a table are resolved in memory.
Notes: Reads SmartTable directly (read-only, separate table) for speed - a
per-relation DatasetModel fetch does not scale to a bulk import.

Parameters:
pcTableGUID CHARACTER
The SmartTable TableGUID to resolve
pcQualifiedTableName CHARACTER
Output: the qualified DatabaseName.TableName name
Returns LOGICAL
TRUE when the table GUID exists in SmartTable
Top

ValidateData ()
Purpose: Provides a hook for high level data validation before Update
operations
Notes: Invoked during SaveChanges (). When the ERROR flag of the ProDataset
is set, the Update operation will be cancelled before writing back
the data to the database using the DataAccess object



Constructor Detail
Top

RelationBusinessEntity ()
Purpose: Constructor of the RelationBusinessEntity class
Notes: Passes the handle of the dataset instance to the base class and
sets the default DataAccessName



ProDataset Detail

ProDataset dsMissingRelations

Member tables: ttRelation

ProDataset dsRelation

Member tables: eSmartRelation


Temp-Table Detail

Temp-Table eSmartRelation

Defined in:

Temp-Table ttRelation

Defined in:


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       10.10.2026 15:31:57