Consultingwerk.BusinessEntityDesigner.Plugins.StaticDataAccessQuery.StaticDataAccessQueryPlugin

Namespace:

Consultingwerk.BusinessEntityDesigner.Plugins.StaticDataAccessQuery

Class

StaticDataAccessQueryPlugin

Parent classes:

Progress.Lang.Object

Consultingwerk.BusinessEntityDesigner.Plugins.StaticDataAccessQuery.StaticDataAccessQueryPlugin

Inherits:

Progress.Lang.Object

Implements:

Consultingwerk.BusinessEntityDesigner.IBusinessEntityDesignerPlugin

Top Method Summary

Options	Name	Purpose
#	AfterGenerateSourceHandler (Object, EventArgs)	Event handler for the AfterGenerateSource event of the BusinessEntityDatasetController
#	LONGCHAR BuildFillChildTableCall (character, character, integer)	Builds the calls to the child table fill methods
#	DefineQueryAndBuffer (character, character[], character, character, character, character, character, character[], character[], integer, integer)	Defines the query and buffer names for a table
#	CHARACTER FindOutputFolder ()	Returns the output folder (source code folder for business logic)
#	GenerateDataAccessQueries ()	Generates the DataAccess Fetch include and parameter classes
+	GenerateDataAccessQueries (dataset)	Generates the Constants include file
#	LONGCHAR GenerateFillChildTablesMethod (character, integer, integer)	Generates the Fill method for static query
#	CHARACTER GetFieldMapping (character, character)	Returns the field mapping pairs for the named temp-table, for a db buffer
+	CHARACTER PrettifyName (character)	Removes any "-" or "_" characters from a table or field name, and CamelCases the result; so "order-master" becomes "OrderMaster"
#	CHARACTER RelationTypeConversion (character, character, character)	Returns the ABL function required for the data-type conversion of the parent field to match the child field
+	Shutdown ()	Method called when the Business Entity Designer will get closed
#	CHARACTER SourceDefaultQuery (character)	Builds the "default" SourceDefaultQuery for a Business Entity temp-table
+	Startup (dataset, BusinessEntityDatasetController, BusinessEntityDesignerForm, UltraToolbarsManager)	Method called when the Business Entity Designer is starting and has loaded the plugin.
#	LONGCHAR UpdateDataAccess (character, character, character, character, character, CharacterDictionary)	Adds the static query include to the DataAccess class, if needed
-	WriteFile (character, character, longchar)	Writes a file to disk after publishing a BusinessEntityGenerator event

Top Constructor Summary

	Options	Name	Purpose
	+	StaticDataAccessQueryPlugin ()	Default constructor

Method Detail

Top

PROTECTED AfterGenerateSourceHandler (Object, EventArgs)

Purpose:	Event handler for the AfterGenerateSource event of the
	BusinessEntityDatasetController
Notes:

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

Top

PROTECTED LONGCHAR BuildFillChildTableCall (character, character, integer)

Purpose:	Builds the calls to the child table fill methods
Notes:

Parameters:
pcTableName	CHARACTER
	The name of the parent table
pcApplyCallbackCriteria	CHARACTER
	The criteria to apply to the callback
piSpaces	INTEGER
	The number of spaces to indent the code
Returns	LONGCHAR
	The generated code

Top

PROTECTED DefineQueryAndBuffer (character, character[], character, character, character, character, character, character[], character[], integer, integer)

Purpose:	Defines the query and buffer names for a table
Notes:

Parameters:
pcTableName	CHARACTER
	The name of the table
pcQueryStrings	CHARACTER
	The query strings
pcSourceTableNames	CHARACTER
	The source table names
pcQueryName	CHARACTER
	The name of the query
pcQuery	CHARACTER
	The query string
pcFieldMapping	CHARACTER
	The field mapping
pcBufferCopy	CHARACTER
	The buffer copy
pcBufferName	CHARACTER
	The buffer name
pcBufferDefinition	CHARACTER
	The buffer definition
piBufferCount	INTEGER
	The buffer count
piQueryCount	INTEGER
	The query count

Top

PROTECTED CHARACTER FindOutputFolder ()

Purpose:	Returns the output folder (source code folder for business logic)
Notes:

Returns	CHARACTER
	The output folder, without any trailing path-separator

Top

PROTECTED GenerateDataAccessQueries ()

Purpose:	Generates the DataAccess Fetch include and parameter classes
Notes:

Top

PUBLIC GenerateDataAccessQueries (dataset)

Purpose:	Generates the Constants include file
Notes:	This routine is intended to be used from outside of the Business Entity
	designer (automatic source code generation, unit testing)

Parameters:
dsBusinessEntity	DATASET dsBusinessEntity
	Business Entity with the Design dataset, called with the BY-REFERENCE keyword

Top

PROTECTED LONGCHAR GenerateFillChildTablesMethod (character, integer, integer)

Purpose:	Generates the Fill method for static query
Notes:

Parameters:
pcParentTableName	CHARACTER
	The name of the parent table
piBufferCount	INTEGER
	The buffer count
piQueryCount	INTEGER
	The query count
Returns	LONGCHAR
	The generated code

Top

PROTECTED CHARACTER GetFieldMapping (character, character)

Purpose:	Returns the field mapping pairs for the named temp-table, for a db buffer
Notes:

Parameters:
pcTempTableName	CHARACTER
	The name of the temp-table to return the field mappings for
pcBufferName	CHARACTER
	The db table
Returns	CHARACTER
	The list of the field mappings

Top

PUBLIC CHARACTER PrettifyName (character)

Purpose:	Removes any "-" or "_" characters from a table or field name, and CamelCases
	the result; so "order-master" becomes "OrderMaster"
Notes:

Parameters:
pcName	CHARACTER
	The table, buffer or field name to prettify
Returns	CHARACTER
	The prettified name

Top

PROTECTED CHARACTER RelationTypeConversion (character, character, character)

Purpose:	Returns the ABL function required for the data-type
	conversion of the parent field to match the child field
Notes:

Parameters:
pcParentFieldDataType	CHARACTER
	The data type of the parent field
pcChildFieldDataType	CHARACTER
	The data type of the child field
pcChildFieldName	CHARACTER
	The name of the child field
Returns	CHARACTER
	The ABL function required for the data-type conversion of the parent field to match the child field

Top

PUBLIC Shutdown ()

Purpose:	Method called when the Business Entity Designer will get closed
Notes:

Top

PROTECTED CHARACTER SourceDefaultQuery (character)

Purpose:	Builds the "default" SourceDefaultQuery for a Business Entity temp-table
Notes:

Parameters:
pcSourceBufferNames	CHARACTER
	The names of the temp-table's source buffers
Returns	CHARACTER
	The source default query string

Top

PUBLIC Startup (dataset, BusinessEntityDatasetController, BusinessEntityDesignerForm, UltraToolbarsManager)

Purpose:	Method called when the Business Entity Designer is starting and
	has loaded the plugin.
Notes:	Passes references to some key components of the Designer to
	the plugin, use this to initialize the plugin, subscribe to events

Parameters:
dsBusinessEntity	DATASET dsBusinessEntity
	Business Entity with the Design dataset, called with the BIND keyword
poController	Consultingwerk.BusinessEntityDesigner.Services.BusinessEntityDatasetController
	The BusinessEntityDatasetController
poForm	Consultingwerk.BusinessEntityDesigner.UI.BusinessEntityDesignerForm
	The main Form of the BusinessEntityDesigner
poToolbar	Infragistics.Win.UltraWinToolbars.UltraToolbarsManager
	The reference to the UltraToolbarsManager used by the BusinessEntityDesigner

Top

PROTECTED LONGCHAR UpdateDataAccess (character, character, character, character, character, CharacterDictionary)

Purpose:	Adds the static query include to the DataAccess class, if needed
Notes:	If the include name is in the DataAccess class, no changes are made to
	the DataAccess code.

Parameters:
pcStaticQueryInclude	CHARACTER
	The filename of the static query include
pcDataAccessClass	CHARACTER
	The filename of the DataAccess class
pcMethodNames	CHARACTER
	A comma-separated list of the static query method names
pcDatasetIncludeName	CHARACTER
	The relative path dataset include name
pcSourceTableNames	CHARACTER
	The database source tables
poMethodQueryStrings	Consultingwerk.Framework.Collections.CharacterDictionary
	The query strings for each method
Returns	LONGCHAR
	The updated contents of the DataAccess class

Top

PRIVATE WriteFile (character, character, longchar)

Purpose:	Writes a file to disk after publishing a BusinessEntityGenerator event
Notes:

Parameters:
pcDescription	CHARACTER
	Human-friendly description for events
pcFilename	CHARACTER
	The filename to write; an absolute path
plcData	LONGCHAR
	The file contents