Consultingwerk.SmartFramework.System.ValueListDynamicEntryProvider

	Options	Name	Purpose
		CHARACTER BuildDescription (handle, character, character)	Builds the value list entry description from a source buffer
		CHARACTER FieldValue (handle, character)	Returns the character value of a buffer field, or "" when the field does not exist or holds the unknown value
		PopulateDynamicEntries (dataset)	Populates the eSmartValueListEntry temp-table of the passed dsValueList dataset from the dynamically configured source of the eSmartValueList row
		PopulateFromBusinessEntity (handle, character, character, character, character, character, character, character, character, character, character, logical)	Populates the value list entries from a Business Entity source
		PopulateFromServiceMethod (handle, character, character)	Populates the value list entries from a service method source
		HANDLE SourceDataset (character, character, character, character, logical)	Returns the source ProDataset for a Business Entity value list

Top

Purpose:	Builds the value list entry description from a source buffer
Notes:	The description fields are substituted into the pattern (&1, &2, ...);
	when no pattern is configured the first description field is used

Parameters:
phBuffer	HANDLE
	The source buffer-handle
pcDescriptionFields	CHARACTER
	The comma delimited list of description fields
pcDescriptionSubstitute	CHARACTER
	The SUBSTITUTE pattern for the description
Returns	CHARACTER
	The built description

Top

Purpose:	Returns the character value of a buffer field, or "" when the
	field does not exist or holds the unknown value
Notes:

Parameters:
phBuffer	HANDLE
	The source buffer-handle
pcField	CHARACTER
	The field name
Returns	CHARACTER
	The character value of the field

Top

Purpose:	Populates the eSmartValueListEntry temp-table of the passed
	dsValueList dataset from the dynamically configured source of
	the eSmartValueList row
Notes:	When the eSmartValueList row carries no source fields the dataset
	is left unchanged

Parameters:
dsValueList	DATASET dsValueList
	The dsValueList dataset to populate (input-output by-reference)

Top

Purpose:	Populates the value list entries from a Business Entity source
Notes:

Parameters:
phEntry	HANDLE
	The eSmartValueListEntry buffer-handle to create rows in
pcValueListKey	CHARACTER
	The key of the value list (cache key)
pcValueListGuid	CHARACTER
	The GUID of the value list (foreign key of the entries)
pcEntityName	CHARACTER
	The source Business Entity name
pcEntityTable	CHARACTER
	The source Business Entity table name
pcQueryString	CHARACTER
	The source query string
pcKeyField	CHARACTER
	The field providing the value list entry key
pcDescriptionFields	CHARACTER
	The comma delimited list of description fields
pcDescriptionSubstitute	CHARACTER
	The SUBSTITUTE pattern for the description
pcClassField	CHARACTER
	The field providing the entry class list (or "")
pcIconField	CHARACTER
	The field providing the entry icon (or "")
plCacheData	LOGICAL
	Logical value indicating whether the source dataset is cached

Top

Purpose:	Populates the value list entries from a service method source
Notes:	The configured service method outputs its own dataset; its
	eSmartValueListEntry rows are copied into the caller's entry buffer.
	The dynamic-invoke is wrapped so a missing method or a wrong
	signature raises a qualified exception instead of a bare ABL error.

Parameters:
phEntry	HANDLE
	The eSmartValueListEntry buffer-handle to create rows in
pcServiceTypeName	CHARACTER
	The service type (interface) name
pcServiceMethod	CHARACTER
	The name of the method to invoke

Top

Purpose:	Returns the source ProDataset for a Business Entity value list
Notes:	When CacheData is enabled the dataset is kept in memory and reused
	on subsequent calls for the same value list key

Parameters:
pcValueListKey	CHARACTER
	The key of the value list (cache key)
pcEntityName	CHARACTER
	The source Business Entity name
pcEntityTable	CHARACTER
	The source Business Entity table name
pcQueryString	CHARACTER
	The source query string
plCacheData	LOGICAL
	Logical value indicating whether the source dataset is cached
Returns	HANDLE
	The handle of the source ProDataset