Top Method Summary
Options Name Purpose
EntryForGuid (dataset, CharacterHolder) Returns the eSmartValueListEntry row for the given GUID
EntryForKey (dataset, GetValueListEntryByKeyParameter) Returns the eSmartValueListEntry row for the given ValueListKey and ValueListEntryKey
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
FetchValueList (dataset, character) Fetches a ValueList by guid or key Notes : First tries to fetch by ValueListGuid. When no record is returned, falls back to fetching by ValueListKey. @param dsValueList INPUT-OUTPUT DATASET-HANDLE for the response dataset @param pcValue The guid or key value */
FetchValueList (dataset, CharacterHolder) Fetches a ValueList by guid or key using a CharacterHolder value. @param dsValueList INPUT-OUTPUT DATASET-HANDLE for the response dataset @param poValue The CharacterHolder containing the guid or key */
LOGICAL HasDynamicSource (character) Returns whether the value list with the given GUID is dynamically sourced (has any of the four source fields set)
LOGICAL HasPersistedEntries (character) Returns whether the value list with the given GUID has persisted value list entries
ReceiveData () Provides a hook to modify data in the ProDataset after Read and Update operations (i.e. population of aggregated values)
LOGICAL SourceFieldSetAndChanged (handle, character) Returns whether a source field of an eSmartValueList row has been set to a non-empty value that differs from its before-image value
ValidateData () Provides a hook for high level data validation before Update operations

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


Method Detail
Top

EntryForGuid (dataset, CharacterHolder)

Purpose: Returns the eSmartValueListEntry row for the given GUID
Notes:

Parameters:
dsValueList DATASET dsValueList
INPUT-OUTPUT Dataset that will contain the eSmartValueListEntry row
poValueListEntryGuid Consultingwerk.CharacterHolder
A CharacterHolder that contains the GUID for which to return the eSmartValueListEntry row
Top

EntryForKey (dataset, GetValueListEntryByKeyParameter)

Purpose: Returns the eSmartValueListEntry row for the given ValueListKey and ValueListEntryKey
Notes:

Parameters:
dsValueList DATASET dsValueList
INPUT-OUTPUT Dataset that will contain the eSmartValueListEntry row
poEntryByKeyParameter Consultingwerk.SmartFramework.System.GetValueListEntryByKeyParameter
A CharacterHolder that contains the GUID for which to return the eSmartValueListEntry row
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
dsValueList DATASET dsValueList
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:
dsValueList DATASET dsValueList
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
dsValueList DATASET dsValueList
Top

FetchValueList (dataset, character)

Purpose: Fetches a ValueList by guid or key
Notes : First tries to fetch by ValueListGuid. When no record is returned,
falls back to fetching by ValueListKey.

Parameters:
dsValueList DATASET dsValueList
INPUT-OUTPUT DATASET-HANDLE for the response dataset
pcValue CHARACTER
The guid or key value
Top

FetchValueList (dataset, CharacterHolder)

Purpose: Fetches a ValueList by guid or key using a CharacterHolder value.

Parameters:
dsValueList DATASET dsValueList
INPUT-OUTPUT DATASET-HANDLE for the response dataset
poValue Consultingwerk.CharacterHolder
The CharacterHolder containing the guid or key
Top

LOGICAL HasDynamicSource (character)

Purpose: Returns whether the value list with the given GUID is dynamically
sourced (has any of the four source fields set)
Notes: The value list is looked up in the dataset first, then through the
dedicated DatasetModel (not the database directly)

Parameters:
pcValueListGuid CHARACTER
The GUID of the value list
Returns LOGICAL
TRUE when the value list is dynamically sourced
Top

LOGICAL HasPersistedEntries (character)

Purpose: Returns whether the value list with the given GUID has persisted
value list entries
Notes: Looked up through the dedicated DatasetModel (not the database
directly) so the lookup does not disturb this Business Entity's state

Parameters:
pcValueListGuid CHARACTER
The GUID of the value list
Returns LOGICAL
TRUE when at least one persisted SmartValueListEntry exists
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 SourceFieldSetAndChanged (handle, character)

Purpose: Returns whether a source field of an eSmartValueList row has been
set to a non-empty value that differs from its before-image value
Notes: Created rows with a non-empty value count as changed

Parameters:
phBuffer HANDLE
The eSmartValueList buffer-handle
pcField CHARACTER
The name of the source field
Returns LOGICAL
TRUE when the field is non-empty and was changed
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

ValueListBusinessEntity ()

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



ProDataset Detail

ProDataset dsValueList

Member tables: eSmartValueList, eSmartValueListEntry


Temp-Table Detail

Temp-Table eSmartValueList

Defined in:

Temp-Table eSmartValueListEntry

Defined in:


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       20.06.2026 07:28:29