Consultingwerk.SmartFramework.Repository.Class.AttributeValueDataAccess

Namespace:

Consultingwerk.SmartFramework.Repository.Class

Class

AttributeValueDataAccess

Parent classes:

Progress.Lang.Object

Consultingwerk.OERA.DataAccess

Consultingwerk.SmartFramework.SmartDataAccess

Consultingwerk.SmartFramework.Repository.Class.AttributeValueDataAccess

Inherits:

Consultingwerk.SmartFramework.SmartDataAccess

Implements:

Consultingwerk.OERA.IDataAccess, Consultingwerk.OERA.IDataAccessCanFind, Consultingwerk.OERA.IDataAccessCountRecords, IDSQueryStringSource, Consultingwerk.OERA.IProvidesSmartRecordInformation

Consultingwerk.SmartFramework.Repository.Class.AttributeValueBusinessEntity

Top Method Summary

	Options	Name	Purpose
		ActivateRelationeSmartAttributeValueeSmartAttributeRelation ()	Activates the eSmartAttributeValueeSmartAttributeRelation DATA-RELATION
		AttachDataSources ()	Attaches the DATA-SOURCE objects to the ProDataset Buffers
		BindDataset (dataset)	Do nothing, just receive the parameter and bind to the received Dataset reference
		CommitChanges (handle)	This procedure is called from saveChanges in the DA to do the actual database commit and any transaction-related validation logic for a buffer.
		DefineReadEvents ()	TO-DO: Subscribe to ProDataset Event Handlers using SET-CALLBACK as needed
		DetachDataSources ()	Detaches the DATA-SOURCE objects to the ProDataset Buffers
		FetchData (IFetchDataRequest)	Fetches data from the database
		FetchDataByStaticQuery (IFetchDataByStaticQueryRequest)	Fetches data for single table, using a static query
		FetchObjectInstanceAttributes (handle)	Fetches Object Instance Attributes
		FetchObjectMasterAttributes (handle)	Fetches Object Master Attributes
		FetchSmartAttributeValueByAttributeValueGuid (character, character)	FetchData method for static query
		FetchSmartAttributeValueByObjectTypeGuidObjectMasterGuidObjectInstanceGuidAttributeLabel (character, character, character, character, character)	FetchData method for static query
		FilleSmartAttributeOfeSmartAttributeValue (character, character, logical)	Fill child tables method for static query
		GetUnsupportedAttributes (table)	Determines unsupported attribute records
		SaveChanges ()	Save changes to physical storage
		CHARACTER SourceColumn (character, character)	Returns the database field name matching a temp-table field name contained in a consumers query string (query string vs. temp-table definition)
		CHARACTER SourceDefaultQuery (character)	Returns the base query string used to retrieve data for the temp tables. This query string will be appended by the query provided by the consumer (FetchDataRequest object).

Top Constructor Summary

	Options	Name	Purpose
		AttributeValueDataAccess ()	Static constructor for the AttributeValueDataAccess class
		AttributeValueDataAccess (handle)	Constructor for the AttributeValueDataAccess class

Method Detail

Top

ActivateRelationeSmartAttributeValueeSmartAttributeRelation ()

Purpose:	Activates the eSmartAttributeValueeSmartAttributeRelation DATA-RELATION
Notes:

Top

AttachDataSources ()

Purpose:	Attaches the DATA-SOURCE objects to the ProDataset Buffers
Notes:	Overrides ABSTRACT method in Consultingwerk.OERA.DataAccess,
	Invoked in FetchData and SaveChanges

Top

BindDataset (dataset)

Purpose:	Do nothing, just receive the parameter and bind to the received
	Dataset reference
Notes:	Invoked from the class constructor

Parameters:
dsAttributeValue	DATASET dsAttributeValue
	DATASET to bind to

Top

CommitChanges (handle)

Purpose:	This procedure is called from saveChanges in the DA
	to do the actual database commit and any transaction-related
	validation logic for a buffer.
Notes:

Parameters:
phBuffer	HANDLE
	The handle of the buffer to commit

Top

DefineReadEvents ()

Purpose:	TO-DO: Subscribe to ProDataset Event Handlers using SET-CALLBACK
	as needed
Notes:	Overrides ABSTRACT method in Consultingwerk.OERA.DataAccess,
	Invoked in FetchData, note that the callback methods need to be
	PUBLIC and need to have the Dataset defined as an INPUT Parameter.
	Errors thrown from or raised in the FILL call-back methods of the
	DataAccess class (SET-CALLBACK) will stop the Dataset from getting
	filled / filled further. However errors thrown from the call-back
	methods are not thrown from the FILL() method further up into a
	catch block or to the client.
	See http://knowledgebase.progress.com/articles/Article/P188375
Sample:	BUFFER eCustomer:SET-CALLBACK (Consultingwerk.DatasetBufferCallbackEnum:AfterFill,
"eCustomerAfterRowFill":U)	U) .

Top

DetachDataSources ()

Purpose:	Detaches the DATA-SOURCE objects to the ProDataset Buffers
Notes:	Overrides ABSTRACT method in Consultingwerk.OERA.DataAccess,
	Invoked in FetchData and SaveChanges

Top

FetchData (IFetchDataRequest)

Purpose:	Fetches data from the database
Notes:

Parameters:
poFetchDataRequest	Consultingwerk.OERA.IFetchDataRequest
	The IFetchDataRequest instance with the arguments for this call

Top

FetchDataByStaticQuery (IFetchDataByStaticQueryRequest)

Purpose:	Fetches data for single table, using a static query
Notes:

Parameters:
poParameter	Consultingwerk.OERA.IFetchDataByStaticQueryRequest
	The query parameter object

Top

FetchObjectInstanceAttributes (handle)

Purpose:	Fetches Object Instance Attributes
Notes:	The input dataset contains a single buffer per object type to be retrieved
	Each record must reference the object instance using the _ObjectInstanceGuid
	field, ignores the eSmartObjectMaster, eSmartObjectInstance, eSmartLink and
	eSmartPage temp-tables as those might be contained in the ProDataset for
	storing links and pages

Parameters:
phDataset	HANDLE
	The dataset with the repository data to fetch attributes for

Top

FetchObjectMasterAttributes (handle)

Purpose:	Fetches Object Master Attributes
Notes:	The input dataset contains a single buffer per object type to be retrieved
	Each record must reference the object master using the _ObjectMasterGuid
	field, ignores the eSmartObjectMaster, eSmartObjectInstance, eSmartLink and
	eSmartPage temp-tables as those might be contained in the ProDataset for
	storing links and pages

Parameters:
phDataset	HANDLE
	The dataset with the repository data to fetch attributes for

Top

FetchSmartAttributeValueByAttributeValueGuid (character, character)

Purpose:	FetchData method for static query
Notes:

Parameters:
pcAttributeValueGuid	CHARACTER
	The AttributeValueGuid value
pcChildTables	CHARACTER
	a list of the child tables to fill

Top

FetchSmartAttributeValueByObjectTypeGuidObjectMasterGuidObjectInstanceGuidAttributeLabel (character, character, character, character, character)

Purpose:	FetchData method for static query
Notes:

Parameters:
pcObjectTypeGuid	CHARACTER
	The ObjectTypeGuid value
pcObjectMasterGuid	CHARACTER
	The ObjectMasterGuid value
pcObjectInstanceGuid	CHARACTER
	The ObjectInstanceGuid value
pcAttributeLabel	CHARACTER
	The AttributeLabel value
pcChildTables	CHARACTER
	a list of the child tables to fill

Top

FilleSmartAttributeOfeSmartAttributeValue (character, character, logical)

Purpose:	Fill child tables method for static query
Notes:

Parameters:
pcAttributeLabel	CHARACTER
	The AttributeLabel value
pcChildTables	CHARACTER
	The list of child table to fill
plApplyCallback	LOGICAL
	Whether to apply the buffer read callbacks

Top

GetUnsupportedAttributes (table)

Purpose:	Determines unsupported attribute records
Notes:

Parameters:
ttUnsupportedAttributesReport	TEMP-TABLE ttUnsupportedAttributesReport
	OUTPUT TABLE The database with the report data

Top

SaveChanges ()

Purpose:	Save changes to physical storage
Notes:	This implementation of data access save traverses all records in order
to:
	- Allow the DA to control transactions, which cannot be directly
	controlled in distributed BL. Transaction control is a concern of
	the BL, but should not be controlled with TRANSACTION keyword.
	- Offer a course grained save interface from distributed BL
	- The default operation here is just a transaction per record
	- This simple sample does not use child relations to traverse
	the buffers as the OERI BE example. (A property that controls
	update order would give the same effect).
	- Traversing of child data from a parent would make sense if done for
	one parent record at a time.

Top

CHARACTER SourceColumn (character, character)

Purpose:	Returns the database field name matching a temp-table field name
	contained in a consumers query string (query string vs. temp-table
	definition)
Notes:	Call-back used by Consultingwerk.OERA.Query.DSQueryString (part of
DataAccess:FetchData	FetchData () query preparation
TO-DO:	Provide code for alternative mapping

Parameters:
pcTable	CHARACTER
	The temp table name to return the source (database table) field name for
pcColumn	CHARACTER
	The temp table column name to return the source (database table) field name for
Returns	CHARACTER
	The database field name mapped to the passed in temp-table field

Top

CHARACTER SourceDefaultQuery (character)

Purpose:	Returns the base query string used to retrieve data for the temp
	tables. This query string will be appended by the query provided by
	the consumer (FetchDataRequest object).
Notes:	Call-back used by Consultingwerk.OERA.Query.DSQueryString (part of
DataAccess:FetchData	FetchData () query preparation
TO-DO:	Provide code to return the DATA-SOURCE root query string

Parameters:
pcTable	CHARACTER
	The temp table name to return the source default (database) query string for
Returns	CHARACTER
	The base query string used to retrieve data for the given temp-table

Constructor Detail

Top

STATIC AttributeValueDataAccess ()

Purpose:	Static constructor for the AttributeValueDataAccess class
Notes:

Top

AttributeValueDataAccess (handle)

Purpose:	Constructor for the AttributeValueDataAccess class
Notes:	Used by the BusinessEntity, will receive the handle of the dataset
	instance form the BusinessEntity as a parameter. Permanently BIND's
	to that dataset using the PRIVATE BindDataset Method.

Parameters:
phDataset	HANDLE
	The handle of the Business Entity dataset

ProDataset Detail

ProDataset dsAttributeValue

Member tables: eSmartAttributeValue, eSmartAttribute

Temp-Table Detail

Temp-Table eSmartAttribute

Defined in:

Temp-Table eSmartAttributeValue

Defined in:

Temp-Table ttUnsupportedAttributesReport

Defined in:

info@consultingwerk.de http://www.consultingwerk.de 13.04.2026 10:26:00