Namespace: Consultingwerk.SmartFramework.Repository.Class
Class 
AttributeBusinessEntity Copy to Clipboard
Parent classes:
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.ISupportsResetState

File:AttributeBusinessEntity
Purpose:Business Entity for Attribute
Author(s):Marko Rüterbories / Consultingwerk Ltd.
Created:21.05.2014 12:50:30

Consultingwerk.SmartFramework.Repository.Class.AttributeBusinessEntity
Consultingwerk.SmartFramework.Repository.Class.AttributeBusinessEntity



Top Method Summary
Options Name Purpose
+ CanFind (dataset-handle, CanFindParameter) Returns a TRUE value if a record is found that meets the specified FIND criteria; otherwise it returns FALSE. CAN-FIND does not make the record available to the Business Entity or it's caller.
Inherited from Consultingwerk.OERA.BusinessEntity
+ LOGICAL CanFind (character, character) Returns a TRUE value if a record is found that meets the specified FIND criteria; otherwise it returns FALSE. CAN-FIND does not make the record available to the Business Entity or it's caller.
Inherited from Consultingwerk.OERA.BusinessEntity
+ CountResultRecords (dataset-handle, ICountRecordsRequest) Counts the number of results of the query
Inherited from Consultingwerk.OERA.BusinessEntity
+ INT64 CountResultRecords (ICountRecordsRequest) Counts the number of results of the query
Inherited from Consultingwerk.OERA.BusinessEntity
# DestroyDataAccessObject () Unloads the DataAccess object
Inherited from Consultingwerk.OERA.BusinessEntity
+ dispose () Destroy/Shutdown/Anti-Initializer
Inherited from Consultingwerk.OERA.BusinessEntity
# FetchChildTableRecords (handle) Populates records in the child table identified by the buffer handle of the child table
Inherited from Consultingwerk.OERA.BusinessEntity
+ FetchData (IFetchDataRequest) Fetch data from the Data Access object
Inherited from Consultingwerk.OERA.BusinessEntity
# FetchData (IFetchDataRequest, handle) Fetch data from the Data Access object
Inherited from Consultingwerk.OERA.BusinessEntity
+ F FetchData (IFetchDataRequest, dataset) Fetch data from the Data Access object
+ F FetchData (IFetchDataRequest, dataset-handle) Fetch data and/or definitions
Inherited from Consultingwerk.OERA.BusinessEntity
+ FetchDataByKeyTable (dataset-handle, IFetchDataByKeyTableParameter) Supports retrieve multiple DB records from a Business Entity based on a temp-table with key values
Inherited from Consultingwerk.OERA.BusinessEntity
# F FetchDataByKeyTable (IFetchDataByKeyTableParameter, handle) Fetch data from the Data Access object
Inherited from Consultingwerk.OERA.BusinessEntity
+ F FetchDataByReference (IFetchDataRequest, dataset) Fetch data from the Data Access object
+ FetchDataByStaticQuery (dataset-handle, IFetchDataByStaticQueryRequest) Retrieves data using a static query.
Inherited from Consultingwerk.OERA.BusinessEntity
# F FetchDataByStaticQuery (IFetchDataByStaticQueryRequest, handle) Retrieves data using a static query.
Inherited from Consultingwerk.OERA.BusinessEntity
+ FetchDataset (dataset-handle) Creates and returns an empty dataset to the caller
Inherited from Consultingwerk.OERA.BusinessEntity
# FetchRelatedRecords (handle, character) Populates records in the named tables based on their relation to the provided record
Inherited from Consultingwerk.OERA.BusinessEntity
+ IBusinessEntityDescriptor GetBusinessEntityDescriptor () Returns the Business Entity Descriptor for this Business Entity
Inherited from Consultingwerk.OERA.BusinessEntity
+ GetBusinessEntityDescriptor (dataset-handle, GetBusinessEntityDescriptorParameter) Returns the Business Entity Descriptor for this Business Entity
Inherited from Consultingwerk.OERA.BusinessEntity
+ IGetDataResponse getData (IGetDataRequest, dataset-handle) Performs a read request
Inherited from Consultingwerk.OERA.BusinessEntity
# Consultingwerk.OERA.IDataAccess GetDataAccessObject () Returns the reference to the DataAccess Object
Inherited from Consultingwerk.OERA.BusinessEntity
+ getDataset (dataset-handle) Returns an empty instance of the primary ProDataset to the caller
Inherited from Consultingwerk.OERA.BusinessEntity
+ Progress.Lang.Class GetDatasetModelType () Returns the class reference of the DatasetModel type associated with this Business Entity
Inherited from Consultingwerk.OERA.BusinessEntity
+ GetInitialValues (dataset-handle, GetInitialValuesParameter) Returns a dataset with one record containing the initial values
Inherited from Consultingwerk.OERA.BusinessEntity
+ ListRestAddress GetRestAddresses () Returns the list of supported rest addresses to the caller
Inherited from Consultingwerk.OERA.BusinessEntity
+ ListRestMethod GetRestMethods () Returns the list of supported rest addresses for methods to the caller
Inherited from Consultingwerk.OERA.BusinessEntity
+ IGetResultCountResponse getResultCount (IGetDataRequest) Returns the count of the total number of result records or a guess of the result count to the caller
Inherited from Consultingwerk.OERA.BusinessEntity
+ Progress.Lang.Class GetTableModelType (character) Returns the class reference of the TableModel type associated with this Business Entity
Inherited from Consultingwerk.OERA.BusinessEntity
+ CHARACTER GetTopNavBuffers () Returns the names of the dataset TOP-NAV-BUFFER's
Inherited from Consultingwerk.OERA.BusinessEntity
+ GetTopNavBuffers (dataset-handle, CharacterHolder) Populates the provided CharacterHolder with a comma-delimited list of the names of the dataset TOP-NAV-BUFFER's
Inherited from Consultingwerk.OERA.BusinessEntity
+ initialize () Initializer/Startup
Inherited from Consultingwerk.OERA.BusinessEntity
# InitializeDataAccessObject () Initializes the DataAccess Object
Overrides Consultingwerk.SmartFramework.SmartBusinessEntity:InitializeDataAccessObject ()
# InvokeReceiveData (RequestTypeEnum, Object) Invokes the ReceiveDataMethod
Inherited from Consultingwerk.OERA.BusinessEntity
# LOGICAL PopulateFromPartialBuffer (handle) Populates a single ProDataset record from the partial record to the complete record
Inherited from Consultingwerk.OERA.BusinessEntity
# PopulatePartialBuffer (handle) Populates a single ProDataset record from the partial record to the complete record
Inherited from Consultingwerk.OERA.BusinessEntity
# ReceiveData () Provides a hook to modify data in the ProDataset after Read and Update operations (i.e. population of aggregated values)
Overrides Consultingwerk.OERA.BusinessEntity:ReceiveData ()
# Consultingwerk.OERA.FetchDataRequest RequestForKeyField (character, character, character) Factory method for the FetchDataRequest class
Inherited from Consultingwerk.OERA.BusinessEntity
# Consultingwerk.OERA.FetchDataRequest RequestForKeyField (character, character, decimal) Factory method for the FetchDataRequest class
Inherited from Consultingwerk.OERA.BusinessEntity
# Consultingwerk.OERA.FetchDataRequest RequestForKeyField (character, character, integer) Factory method for the FetchDataRequest class
Inherited from Consultingwerk.OERA.BusinessEntity
+ ResetState () Resets the state of the Business Entity by emptying temp-tables
Inherited from Consultingwerk.OERA.BusinessEntity
+ ResetState (handle, Object, character) Resets the state of the Business Entity by emptying temp-tables
Inherited from Consultingwerk.OERA.BusinessEntity
# RestoreDatasetHandle () Restores the DatasetHandle property value
Inherited from Consultingwerk.OERA.BusinessEntity
+ SaveChanges () Saves changes using the DataAccess object
Inherited from Consultingwerk.OERA.BusinessEntity
+ F SaveChanges (dataset-handle) Saves changes
Inherited from Consultingwerk.OERA.BusinessEntity
+ F SaveChanges (dataset-handle, Object) Saves changes
Inherited from Consultingwerk.OERA.BusinessEntity
# SaveChanges (IActionType) Saves changes with an Action Type instance
Inherited from Consultingwerk.OERA.BusinessEntity
+ SavePartialChanges (dataset-handle, Object) Saves partial changes to the Business Entity Dataset
Inherited from Consultingwerk.OERA.BusinessEntity
+ CHARACTER SourceColumn (character, character) Returns the database field name matching a temp-table field name
Inherited from Consultingwerk.SmartFramework.SmartBusinessEntity
+ CHARACTER SourceTable (character) Returns the name of the source (database) table for a ProDataset table name
Inherited from Consultingwerk.SmartFramework.SmartBusinessEntity
# CHARACTER UniqueFindPredicateWithValueBuffer (handle, handle, character) Builds a unique find predicate for a prodataset buffer (based on an unique index).
Inherited from Consultingwerk.OERA.BusinessEntity
+ Progress.Lang.Object updateData (dataset-handle, IUpdateDataRequest) Stores data modifications in the persistent storage (typically a database)
Inherited from Consultingwerk.OERA.BusinessEntity
# ValidateAddOnlyColumns (handle, character) Performs AddOnly validation for a list of columns
Inherited from Consultingwerk.OERA.BusinessEntity
# ValidateBasedOnBusinessEntityDescriptor () Performs validation based on the Business Entity Descriptor properties
Inherited from Consultingwerk.OERA.BusinessEntity
# ValidateData () Provides a hook for high level data validation before Update operations
Overrides Consultingwerk.OERA.BusinessEntity:ValidateData ()
+ ValidateData (dataset-handle, IValidateDataContext) Provides a client callable method for data validation
Inherited from Consultingwerk.OERA.BusinessEntity
# ValidateMandatoryColumns (handle, character) Performs Mandatory validation for a list of columns
Inherited from Consultingwerk.OERA.BusinessEntity
+ ValidatePartialData (dataset-handle, IValidateDataContext) Provides a client callable method for partial data validation
Inherited from Consultingwerk.OERA.BusinessEntity
# ValidateReadOnlyColumns (handle, character) Performs ReadOnly validation for a list of columns
Inherited from Consultingwerk.OERA.BusinessEntity

Top Constructor Summary
Options Name Purpose
+ AttributeBusinessEntity () Constructor of the AttributeBusinessEntity class

Top Property Summary
Options Name Purpose
+ Progress.Lang.Enum ActionType
Inherited from Consultingwerk.OERA.BusinessEntity
+ CHARACTER ContextID
Inherited from Consultingwerk.OERA.BusinessEntity
+ CHARACTER DataAccessName
Inherited from Consultingwerk.OERA.BusinessEntity
+ Consultingwerk.OERA.IDataAccess DataAccessObject
Inherited from Consultingwerk.OERA.BusinessEntity
+ HANDLE DatasetHandle
Inherited from Consultingwerk.OERA.BusinessEntity
# Consultingwerk.OERA.IFetchDataRequest FetchDataRequest
Inherited from Consultingwerk.OERA.BusinessEntity
# HANDLE OriginalDatasetHandle
Inherited from Consultingwerk.OERA.BusinessEntity
+ Consultingwerk.OERA.Enum.RequestTypeEnum RequestType
Inherited from Consultingwerk.OERA.BusinessEntity
# Progress.Lang.Object SaveChangesParameter
Inherited from Consultingwerk.OERA.BusinessEntity
+ LOGICAL TrackingChanges
Inherited from Consultingwerk.OERA.BusinessEntity
# Consultingwerk.OERA.IValidateDataContext ValidateDataContext
Inherited from Consultingwerk.OERA.BusinessEntity


Method Detail
Top

PUBLIC CanFind (dataset-handle, CanFindParameter)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns a TRUE value if a record is found that meets the specified
FIND criteria; otherwise it returns FALSE. CAN-FIND does not make
the record available to the Business Entity or it's caller.
Notes: Invokable method
Result will be assigned to the Result property of the CanFindParameter
instance

Parameters:
phDataset DATASET-HANDLE
Not used, do not pass in a DATASET or DATASET-HANDLE
poParameter Consultingwerk.OERA.CanFindParameter
The CanFindParameter with the parameters for this call
Top

PUBLIC LOGICAL CanFind (character, character)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns a TRUE value if a record is found that meets the specified
FIND criteria; otherwise it returns FALSE. CAN-FIND does not make
the record available to the Business Entity or it's caller.
Notes:

Parameters:
pcTableName CHARACTER
The name of the temp-table
pcFindString CHARACTER
The find string
Returns LOGICAL
Logical value indicating if the record can be found
Top

PUBLIC CountResultRecords (dataset-handle, ICountRecordsRequest)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Counts the number of results of the query
Notes: Used by the Generic JSDO Service to support the Count feature
Supports STOP-AFTER: When STOP-AFTER occurs, the StopAfterNumResults
value of the parameter object is returns as the Results
https://consultingwerk.atlassian.net/wiki/spaces/SCL/pages/8094448/Generic+Service+Interface+for+JSDO+with+Kendo+UI+dialect#GenericServiceInterfaceforJSDOwithKendoUIdialect-ResourceCount //consultingwerk.atlassian.net/wiki/spaces/SCL/pages/8094448/Generic+Service+Interface+for+JSDO+with+Kendo+UI+dialect#GenericServiceInterfaceforJSDOwithKendoUIdialect-ResourceCount

Parameters:
phDataset DATASET-HANDLE
The dataset handle (not used)
poParameter Consultingwerk.OERA.ICountRecordsRequest
The CharacterHolder to receive the list of TOP-NAV-BUFFERS
Top

PUBLIC INT64 CountResultRecords (ICountRecordsRequest)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Counts the number of results of the query
Notes: Used by the Generic JSDO Service to support the Count feature
Supports STOP-AFTER: When STOP-AFTER occurs, the StopAfterNumResults
value of the parameter object is returns as the Results
https://consultingwerk.atlassian.net/wiki/spaces/SCL/pages/8094448/Generic+Service+Interface+for+JSDO+with+Kendo+UI+dialect#GenericServiceInterfaceforJSDOwithKendoUIdialect-ResourceCount //consultingwerk.atlassian.net/wiki/spaces/SCL/pages/8094448/Generic+Service+Interface+for+JSDO+with+Kendo+UI+dialect#GenericServiceInterfaceforJSDOwithKendoUIdialect-ResourceCount

Parameters:
poParameter Consultingwerk.OERA.ICountRecordsRequest
The CharacterHolder to receive the list of TOP-NAV-BUFFERS
Returns INT64
The number of records returned by the query
Top

PROTECTED DestroyDataAccessObject ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Unloads the DataAccess object
Notes:

Top

PUBLIC dispose ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Destroy/Shutdown/Anti-Initializer
Notes:

Top

PROTECTED FetchChildTableRecords (handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Populates records in the child table identified by the buffer handle
of the child table
Notes: Calls into a second instance of the Business Entity and performs a
FetchDataRequest based on the current record in the parent buffer
Performs no action, when the Child table record for the parent is
already available

Parameters:
phChildBuffer HANDLE
The child buffer
Top

PUBLIC FetchData (IFetchDataRequest)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Fetch data from the Data Access object
Notes:

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

PROTECTED FetchData (IFetchDataRequest, handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Fetch data from the Data Access object
Notes: This variant of FetchData is used by strong-typed
methods in the actual Business Entity class and provides
the handle of a BY-REFERENCE DATASET Parameter received
from the caller (typically the Service Interface class)
IMPORTANT: If the calling code uses &SUFFIX on the dataset and/or
temp-table includes, or otherwise changes the names of the
temp-tables, then the DataAccess object MUST specify the
canonical/defined buffer names in the DataAccess' (protected)
DefinedBufferNames property. Failure to do so may result in
queries failing For more information see the Consultingwerk.OERA.DataAccess
class documentation.

Parameters:
poFetchDataRequest Consultingwerk.OERA.IFetchDataRequest
The IFetchDataRequest object with the parameters for this call
phDataset HANDLE
The handle of the DATASET received BY-REFERENCE from the caller
Top

PUBLIC 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
dsAttribute DATASET dsAttribute
Top

PUBLIC FetchData (IFetchDataRequest, dataset-handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Fetch data and/or definitions
Notes:

Parameters:
poFetchDataRequest Consultingwerk.OERA.IFetchDataRequest
The IFetchDataRequest object with the parameter for this call
phDataset DATASET-HANDLE
OUTPUT Dataset with the resulting data
Top

PUBLIC FetchDataByKeyTable (dataset-handle, IFetchDataByKeyTableParameter)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Supports retrieve multiple DB records from a Business Entity based on
a temp-table with key values
Notes: Proxy method to calling the same method in the data access class
SCL-647

Parameters:
phDataset DATASET-HANDLE
INPUT-OUTPUT DATASET-HANDLE, only used for OUTPUT of the resulting dataset
poParameter Consultingwerk.OERA.IFetchDataByKeyTableParameter
The IFetchDataByKeyTableParameter with the data for this call
Top

PROTECTED FetchDataByKeyTable (IFetchDataByKeyTableParameter, handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Fetch data from the Data Access object
Notes: This variant of FetchDataByKeyTable is used by strong-typed
methods in the actual Business Entity class and provides
the handle of a BY-REFERENCE DATASET Parameter received
from the caller (typically the Service Interface class)

Parameters:
poParameter Consultingwerk.OERA.IFetchDataByKeyTableParameter
The IFetchDataByKeyTableParameter with the data for this call
phDataset HANDLE
The handle of the DATASET received BY-REFERENCE from the caller
Top

PUBLIC 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
dsAttribute DATASET dsAttribute
Top

PUBLIC FetchDataByStaticQuery (dataset-handle, IFetchDataByStaticQueryRequest)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Retrieves data using a static query.
Notes:

Parameters:
phDataset DATASET-HANDLE
INPUT-OUTPUT DATSET-HANDLE, only used for OUTPUT of the resulting dataset
poParameter Consultingwerk.OERA.IFetchDataByStaticQueryRequest
The IFetchDataByStaticQueryRequest query for this call
Top

PROTECTED FetchDataByStaticQuery (IFetchDataByStaticQueryRequest, handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Retrieves data using a static query.
Notes: This variant of FetchDataByStaticQuery is used by strong-typed
methods in the actual Business Entity class and provides
the handle of a BY-REFERENCE DATASET Parameter received
from the caller (typically the Service Interface class)

Parameters:
poParameter Consultingwerk.OERA.IFetchDataByStaticQueryRequest
The IFetchDataByStaticQueryRequest with the data for this call
phDataset HANDLE
The handle of the DATASET received BY-REFERENCE from the caller
Top

PUBLIC FetchDataset (dataset-handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Creates and returns an empty dataset to the caller
Notes: Useful for dynamic callers that need access to the dataset schema prior to calling FetchData

Parameters:
phDataset DATASET-HANDLE
OUTPUT Dataset with the resulting data
Top

PROTECTED FetchRelatedRecords (handle, character)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Populates records in the named tables based on their relation to
the provided record
Notes:

Parameters:
phBufferHandle HANDLE
The source buffer handle
pcRelatedTables CHARACTER
Comma delimited list of temp-table names to populate
Top

PUBLIC IBusinessEntityDescriptor GetBusinessEntityDescriptor ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns the Business Entity Descriptor for this Business Entity
Notes: https://consultingwerk.atlassian.net/wiki/spaces/SCL/pages/8094518/Business+Entity+Descriptor

Returns IBusinessEntityDescriptor
The IBusinessEntityDescriptor of the Business Entity
Top

PUBLIC GetBusinessEntityDescriptor (dataset-handle, GetBusinessEntityDescriptorParameter)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns the Business Entity Descriptor for this Business Entity
Notes: Invokable Method
https://consultingwerk.atlassian.net/wiki/spaces/SCL/pages/8094518/Business+Entity+Descriptor //consultingwerk.atlassian.net/wiki/spaces/SCL/pages/8094518/Business+Entity+Descriptor

Parameters:
phDataset DATASET-HANDLE
The dataset of the Business Entity
poParameter GetBusinessEntityDescriptorParameter
The GetBusinessEntityDescriptorParameter with the data for this call
Top

PUBLIC IGetDataResponse getData (IGetDataRequest, dataset-handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Performs a read request
Notes:

Parameters:
poRequest IGetDataRequest
The IGetDataRequest instance with the getData request parameters
phDataset DATASET-HANDLE
OUTPUT Dataset
Returns IGetDataResponse
The IGetDataResponse instance
Top

PROTECTED Consultingwerk.OERA.IDataAccess GetDataAccessObject ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns the reference to the DataAccess Object
Notes: If THIS-OBJECT:DataAccessObject is not valid, this
method will invoke InitializeDataAccessObject before
returning the reference

Returns Consultingwerk.OERA.IDataAccess
The reference to the Data Access object
Top

PUBLIC getDataset (dataset-handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns an empty instance of the primary ProDataset to the caller
Notes: Used for catalog generation or initialization of dynamic user
interfaces etc.

Parameters:
phDataset DATASET-HANDLE
OUTPUT Dataset (not intended to be called BY-REFERENCE)
Top

PUBLIC Progress.Lang.Class GetDatasetModelType ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns the class reference of the DatasetModel type
associated with this Business Entity
Notes:

Returns Progress.Lang.Class
The Progress.Lang.Class reference
Top

PUBLIC GetInitialValues (dataset-handle, GetInitialValuesParameter)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns a dataset with one record containing the initial values
Notes: Can be overridden in Business Entity implementations to provide
dynamic initial values. The base class implementation will return
the buffer fields initial values. The parameter object's TableNames
is a comma-delimited list. The parameter object's ForeignKeyFields
property is a character array (one element per table) of comma delimited
lists of the provided foreign field names. The ForeignKeyValues property is a
character array (one element per table) of CHR(1) delimited field
values

Parameters:
phDataset DATASET-HANDLE
Used to return the dataset
poParameter Consultingwerk.OERA.GetInitialValuesParameter
The GetInitialValuesParameter instance with the parameters for this call
Top

PUBLIC ListRestAddress GetRestAddresses ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns the list of supported rest addresses to the caller
Notes:

Returns ListRestAddress
The list of supported rest addresses to the caller
Top

PUBLIC ListRestMethod GetRestMethods ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns the list of supported rest addresses for methods
to the caller
Notes:

Returns ListRestMethod
The list of supported rest methods to the caller
Top

PUBLIC IGetResultCountResponse getResultCount (IGetDataRequest)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns the count of the total number of result records or a guess
of the result count to the caller
Notes:

Parameters:
poRequest IGetDataRequest
The IGetDataRequest instance with the getResultCount request parameters
Returns IGetResultCountResponse
The IGetResultCountResponse instance
Top

PUBLIC Progress.Lang.Class GetTableModelType (character)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns the class reference of the TableModel type
associated with this Business Entity
Notes:

Parameters:
pcTableName CHARACTER
The name of the temp-table
Returns Progress.Lang.Class
The Progress.Lang.Class reference
Top

PUBLIC CHARACTER GetTopNavBuffers ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Returns the names of the dataset TOP-NAV-BUFFER's
Notes:

Returns CHARACTER
The list of TOP-NAV-BUFFERS
Top

PUBLIC GetTopNavBuffers (dataset-handle, CharacterHolder)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Populates the provided CharacterHolder with a comma-delimited list
of the names of the dataset TOP-NAV-BUFFER's
Notes:

Parameters:
phDataset DATASET-HANDLE
The dataset handle (not used)
poParameter CharacterHolder
The CharacterHolder to receive the list of TOP-NAV-BUFFERS
Top

PUBLIC initialize ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Initializer/Startup
Notes:

Top

PROTECTED InitializeDataAccessObject ()

Overrides Consultingwerk.SmartFramework.SmartBusinessEntity:InitializeDataAccessObject ()
Purpose: Initializes the DataAccess Object
Notes: Uses the DataAccessName property

Top

PROTECTED InvokeReceiveData (RequestTypeEnum, Object)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Invokes the ReceiveDataMethod
Notes: This method is on purpose overridable. This method allows to
control centrally if ReceiveData should be called or not by
deciding if SUPER:InvokeReceiveData (poRequestType, poRequest)
is called or not

Parameters:
poRequestType RequestTypeEnum
The RequestTypeEnum describing the type of the current call
poRequest Progress.Lang.Object
The request argument, IFetchDataRequest, IFetchDataByKeyTableRequest or the parameter argument passed to the SaveChanges methods
Top

PROTECTED LOGICAL PopulateFromPartialBuffer (handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Populates a single ProDataset record from the partial record to the complete
record
Notes: Used during SavePartialChanges and ValidatePartialData before SaveChanges
(for a single record) or ValidateData are called

Parameters:
phPartialBuffer HANDLE
The buffer of the partial dataset to use as the source
Returns LOGICAL
Logical value indicating if the operation was successful
Top

PROTECTED PopulatePartialBuffer (handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Populates a single ProDataset record from the partial record to the complete
record
Notes: Used during SavePartialChanges and ValidatePartialData before SaveChanges
(for a single record) or ValidateData are called

Parameters:
phPartialBuffer HANDLE
The buffer of the partial dataset to use as the source
Top

PROTECTED ReceiveData ()

Overrides Consultingwerk.OERA.BusinessEntity: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

PROTECTED Consultingwerk.OERA.FetchDataRequest RequestForKeyField (character, character, character)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Factory method for the FetchDataRequest class
Notes: Return a request instance based on a table, key field and value

Parameters:
pcTableName CHARACTER
The name of the temp-table to request
pcKeyFieldName CHARACTER
The name of the key field
pcKeyFieldValue CHARACTER
The value of the key field
Returns Consultingwerk.OERA.FetchDataRequest
The FetchDataRequest instance
Top

PROTECTED Consultingwerk.OERA.FetchDataRequest RequestForKeyField (character, character, decimal)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Factory method for the FetchDataRequest class
Notes: Return a request instance based on a table, key field and value

Parameters:
pcTableName CHARACTER
The name of the temp-table to request
pcKeyFieldName CHARACTER
The name of the key field
pdeKeyFieldValue DECIMAL
The value of the key field
Returns Consultingwerk.OERA.FetchDataRequest
The FetchDataRequest instance
Top

PROTECTED Consultingwerk.OERA.FetchDataRequest RequestForKeyField (character, character, integer)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Factory method for the FetchDataRequest class
Notes: Return a request instance based on a table, key field and value

Parameters:
pcTableName CHARACTER
The name of the temp-table to request
pcKeyFieldName CHARACTER
The name of the key field
piKeyFieldValue INTEGER
The value of the key field
Returns Consultingwerk.OERA.FetchDataRequest
The FetchDataRequest instance
Top

PUBLIC ResetState ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Resets the state of the Business Entity by emptying temp-tables
Notes: If the dataset or any temp-tables have been passed BY-REFERENCE and
a reference. This method is typically called from an AppServer's
deactivate procedure via the ServiceInterface's RequestEnded event

Top

PUBLIC ResetState (handle, Object, character)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Resets the state of the Business Entity by emptying temp-tables
Notes: If the dataset or any temp-tables have been passed BY-REFERENCE and
a reference. This method is typically called from an AppServer's
deactivate procedure via the ServiceInterface's RequestEnded event

Parameters:
phDataset HANDLE
The handle of the ProDataset
poThisObject Progress.Lang.Object
The reference to the service instance calling into this method
pcServiceType CHARACTER
The type of Business Service for logging purposes
Top

PROTECTED RestoreDatasetHandle ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Restores the DatasetHandle property value
Notes:

Top

PUBLIC SaveChanges ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Saves changes using the DataAccess object
Notes: This method saves changes contained in the dataset currently present
in the Business Entity

Top

PUBLIC SaveChanges (dataset-handle)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Saves changes
Notes: This method is called from consumers of the Business Entity and
receives the dataset. It calls into the SaveChanges() method with no
parameters after the internal dataset has been set
This method is called by the ServiceInterface when no parameter object
has been passed in

Parameters:
phDataset DATASET-HANDLE
INPUT-OUTPUT Dataset with changes
Top

PUBLIC SaveChanges (dataset-handle, Object)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Saves changes
Notes: This method is called from consumers of the Business Entity and
receives the dataset. It calls into the SaveChanges() method with no
parameters after the internal dataset has been set
This method is called by the ServiceInterface when a parameter object
has been passed in. The parameter object will be accessible from within
the business entity using the protected property SaveChangesParameter

Parameters:
phDataset DATASET-HANDLE
INPUT-OUTPUT Dataset with changes
poParameter Progress.Lang.Object
Optional Parameter object for the SaveChanges method
Top

PROTECTED SaveChanges (IActionType)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Saves changes with an Action Type instance
Notes: This method is called from consumers of the Business Entity and
receives the dataset. It calls into the SaveChanges() method with no
parameters after the internal dataset has been set
Validation is completely delegated to the Action Type instance

Parameters:
poActionType Consultingwerk.OERA.IActionType
The Action Type instance
Top

PUBLIC SavePartialChanges (dataset-handle, Object)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Saves partial changes to the Business Entity Dataset
Notes: Saves only those fields from the provided Dataset. Does fetch the
complete dataset first, then applies changes from the provided
dataset to the complete dataset and saves this using SaveChanges.
Relies on ROW-STATE in the partial dataset as well! A separate method
may be added in the future, that only expects current values from the
passed in ProDataset
When multiple records are provided in the partial dataset, currently
each record is processed alone
For simplicity of the partial dataset, we do not expect this dataset to
have indexes defined. However, we do expect that the partial dataset
contains the columns of the primary unique key of the business entity
dataset columns
Flow of actions:
- Fetch the whole Dataset Records
- Manipulate the "before"
- Manipulate the "after"
- SaveChanges()
- Transfer ERROR, ERROR-STRING attributes
- Return updated partial records to the caller
SCL-987

Parameters:
phDataset DATASET-HANDLE
INPUT-OUTPUT Dataset with changes
poParameter Progress.Lang.Object
Optional Parameter object for the SavePartialChanges method (BusinessEntity:SaveChangesParameter)
Top

PUBLIC CHARACTER SourceColumn (character, character)

Inherited from Consultingwerk.SmartFramework.SmartBusinessEntity
Purpose: Returns the database field name matching a temp-table field name
Notes:

Parameters:
pcTempTableName CHARACTER
The temp-table buffer name to return the source column for
pcColumn CHARACTER
The temp-table field name
Returns CHARACTER
The database field name
Top

PUBLIC CHARACTER SourceTable (character)

Inherited from Consultingwerk.SmartFramework.SmartBusinessEntity
Purpose: Returns the name of the source (database) table for a ProDataset
table name
Notes:

Parameters:
pcTempTableName CHARACTER
The temp-table buffer name to return the source table for
Returns CHARACTER
The database table name of the source table
Top

PROTECTED CHARACTER UniqueFindPredicateWithValueBuffer (handle, handle, character)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Builds a unique find predicate for a prodataset buffer (based on an
unique index).
Notes: Based on BufferHelper:UniqueFindPredicateWithValueBuffer. Called from
SavePartialChanges. Extracted from SavePartialChanges to allow injecting
missing key field values (e.g. tenant related fields) by overriding
this method.

Parameters:
phBuffer HANDLE
The Business Entity ProDataset member buffer
phPartialBuffer HANDLE
The buffer of the partial dataset, values will be used from it's before-buffer
pcBufferName CHARACTER
The name of the buffer for the find string
Returns CHARACTER
The unique find predicate used to locate the ProDataset buffer for the partial update
Top

PUBLIC Progress.Lang.Object updateData (dataset-handle, IUpdateDataRequest)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Stores data modifications in the persistent storage (typically a
database)
Notes: The output dataset will contain validation error messages in the
ERROR-STRING attributes of the record buffers. Records with Errors
will also have the ERROR attribute set to TRUE. When at least a single
record has a validation error, the ERROR attribute of the ProDataset
is assigned to TRUE as well

Parameters:
phDataset DATASET-HANDLE
INPUT-OUTPUT Dataset containing modified records to be processed (should be passed BY-REFERENCE)
poUpdateDataRequest IUpdateDataRequest
The optional request object that allows to provide custom instructions to the method
Returns Progress.Lang.Object
An optional response object returned by the method
Top

PROTECTED ValidateAddOnlyColumns (handle, character)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Performs AddOnly validation for a list of columns
Notes:

Parameters:
phBuffer HANDLE
The handle of the buffer to validate
pcColumns CHARACTER
The list of columns to validate
Top

PROTECTED ValidateBasedOnBusinessEntityDescriptor ()

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Performs validation based on the Business Entity Descriptor
properties
Notes:

Top

PROTECTED ValidateData ()

Overrides Consultingwerk.OERA.BusinessEntity: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

Top

PUBLIC ValidateData (dataset-handle, IValidateDataContext)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Provides a client callable method for data validation
Notes: Invokes ValidateData(), but not linked to any SaveChanges invocation
The poContext parameter is available during the method execution through
the ValidateDataContext property
See SCL-1030

Parameters:
phDataset DATASET-HANDLE
The DATASET-HANDLE with the data to validate
poContext Consultingwerk.OERA.IValidateDataContext
The IValidateDataContext instance with the context for this call
Top

PROTECTED ValidateMandatoryColumns (handle, character)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Performs Mandatory validation for a list of columns
Notes:

Parameters:
phBuffer HANDLE
The handle of the buffer to validate
pcColumns CHARACTER
The list of columns to validate
Top

PUBLIC ValidatePartialData (dataset-handle, IValidateDataContext)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Provides a client callable method for partial data validation
Notes: Invokes ValidateData(), but not linked to any SaveChanges invocation
The poContext parameter is available during the method execution through
the ValidateDataContext property
See SCL-1030, SCL-1034

Parameters:
phDataset DATASET-HANDLE
The DATASET-HANDLE with the data to validate
poContext Consultingwerk.OERA.IValidateDataContext
The IValidateDataContext instance with the context for this call
Top

PROTECTED ValidateReadOnlyColumns (handle, character)

Inherited from Consultingwerk.OERA.BusinessEntity
Purpose: Performs ReadOnly validation for a list of columns
Notes: ReadOnly columns may not be updated on Add and Update

Parameters:
phBuffer HANDLE
The handle of the buffer to validate
pcColumns CHARACTER
The list of columns to validate


Constructor Detail
Top

PUBLIC AttributeBusinessEntity ()

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



Property Detail
Top

PUBLIC Progress.Lang.Enum ActionType

Inherited from Consultingwerk.OERA.BusinessEntity

Returns Progress.Lang.Enum
Top

PUBLIC CHARACTER ContextID

Inherited from Consultingwerk.OERA.BusinessEntity

Returns CHARACTER
Top

PUBLIC CHARACTER DataAccessName

Inherited from Consultingwerk.OERA.BusinessEntity

Returns CHARACTER
Top

PUBLIC Consultingwerk.OERA.IDataAccess DataAccessObject

Inherited from Consultingwerk.OERA.BusinessEntity

Returns Consultingwerk.OERA.IDataAccess
Top

PUBLIC HANDLE DatasetHandle

Inherited from Consultingwerk.OERA.BusinessEntity

Returns HANDLE
Top

PROTECTED Consultingwerk.OERA.IFetchDataRequest FetchDataRequest

Inherited from Consultingwerk.OERA.BusinessEntity

Returns Consultingwerk.OERA.IFetchDataRequest
Top

PROTECTED HANDLE OriginalDatasetHandle

Inherited from Consultingwerk.OERA.BusinessEntity

Returns HANDLE
Top

PUBLIC Consultingwerk.OERA.Enum.RequestTypeEnum RequestType

Inherited from Consultingwerk.OERA.BusinessEntity

Returns Consultingwerk.OERA.Enum.RequestTypeEnum
Top

PROTECTED Progress.Lang.Object SaveChangesParameter

Inherited from Consultingwerk.OERA.BusinessEntity

Returns Progress.Lang.Object
Top

PUBLIC LOGICAL TrackingChanges

Inherited from Consultingwerk.OERA.BusinessEntity

Returns LOGICAL
Top

PROTECTED Consultingwerk.OERA.IValidateDataContext ValidateDataContext

Inherited from Consultingwerk.OERA.BusinessEntity

Returns Consultingwerk.OERA.IValidateDataContext


ProDataset Detail

ProDataset dsAttribute

Member tables: eSmartAttribute


Temp-Table Detail

Temp-Table eSmartAttribute

Defined in:


©2006-2023 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       27.03.2024 00:38:12