Namespace: Consultingwerk.Web2.Services.Rendering.Components
Class 
SmartBusinessEntityLookupWebRendering Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.Web2.Services.Rendering.Components.SmartBusinessEntityLookupWebRendering

Inherits: Progress.Lang.Object
Implements: Consultingwerk.Web2.Services.Rendering.IWebRenderingService

/*&GLOBAL-DEFINE NoUserLobStatistics NoUserLobStatistics

Navigate to: Methods | Constructors | Events | Properties | ProDatasets | Temp-Tables



Top Method Summary
Options Name Purpose
HANDLE GetDataset (character) Fetches the ProDataset of the given Business Entity, used for resolving the proper-cased field names of the Lookup bindings.
LOGICAL IsFilterField (character, character, character, character) Returns if a lookup grid column is one of the lookup dialog filter fields
Progress.Json.ObjectModel.JsonObject RenderJson (character, character, character, character, logical, logical, logical, handle, handle, character) Renders a repository object as JSON
Progress.Json.ObjectModel.JsonObject RenderLookupGridLayout (character, character, character, character) Renders the lookup grid layout
Progress.Json.ObjectModel.JsonObject RenderLookupGridLayout (character, character, character, character, character) Renders the lookup grid layout
Progress.Json.ObjectModel.JsonObject RenderLookupGridLayout (handle) Renders the lookup grid layout
RenderNumericOptions (JsonObject, JsonObject, handle, handle, character) Renders the numeric options of a lookup bound to an INTEGER, INT64 or DECIMAL field
HANDLE ResolveBoundField (character, handle, character) Returns the handle of the viewer field the lookup is bound to
CHARACTER ResolveFieldName (character, handle, character) Returns the properly-cased SERIALIZE-NAME (or NAME) of a buffer field as defined in the given ProDataset, so that the JSON rendering of the Lookup uses the casing of the schema.


Method Detail
Top

HANDLE GetDataset (character)
Purpose: Fetches the ProDataset of the given Business Entity, used for
resolving the proper-cased field names of the Lookup bindings.
Notes: The caller is responsible for deleting the returned dataset
handle. Returns the unknown value when pcEntityName is empty.

Parameters:
pcEntityName CHARACTER
The name of the Business Entity
Returns HANDLE
The handle of the Business Entity's ProDataset
Top

LOGICAL IsFilterField (character, character, character, character)
Purpose: Returns if a lookup grid column is one of the lookup dialog
filter fields
Notes: SCL-6178. A filter field matches the column name as written in
the grid columns, the field name or the qualified table.field
name of the column

Parameters:
pcFilterFields CHARACTER
The comma delimited list of the lookup dialog filter fields
pcColumnName CHARACTER
The column name as written in the grid columns
pcTableName CHARACTER
The name of the buffer of the column
pcFieldName CHARACTER
The name of the buffer field of the column
Returns LOGICAL
Logical value indicating if the column is a filter field
Top

Progress.Json.ObjectModel.JsonObject RenderJson (character, character, character, character, logical, logical, logical, handle, handle, character)
Purpose: Renders a repository object as JSON
Notes:

Parameters:
pcObjectName CHARACTER
The name of the repository field
pcScope CHARACTER
The scope to bind the field to
pcFieldModel CHARACTER
The model to bind the field to
pcFieldName CHARACTER
The name of the field
plMandatory LOGICAL
Logical value indicating if the field is mandatory
plReadOnly LOGICAL
Logical value indicating if the field is mandatory
plAddOnly LOGICAL
Logical value indicating if the field is only enable during add
phAttributes HANDLE
The record buffer with the object attributes
phDataset HANDLE
The handle of the Business Entity Dataset
pcTables CHARACTER
The list of tables (entity table + entity view)
Returns Progress.Json.ObjectModel.JsonObject
The JSON representation of the field
Top

Progress.Json.ObjectModel.JsonObject RenderLookupGridLayout (character, character, character, character)
Purpose: Renders the lookup grid layout
Notes: SCL-6166: Also used for the lookup definition of an
UpdateLookupDefinitionUiAction, which has no attribute buffer.
All columns of the grid layout are filterable

Parameters:
pcEntityName CHARACTER
The name of the lookup Business Entity
pcEntityTable CHARACTER
The name of the lookup entity table
pcEntityView CHARACTER
The name of the lookup entity view (optional)
pcGridColumns CHARACTER
The comma delimited list of the lookup grid columns
Returns Progress.Json.ObjectModel.JsonObject
The JsonObject representing the Grid layout
Top

Progress.Json.ObjectModel.JsonObject RenderLookupGridLayout (character, character, character, character, character)
Purpose: Renders the lookup grid layout
Notes: SCL-6178: When filter fields are given, every column that is not
one of them is rendered with filterable = false, so the filter
row of the lookup dialog offers the LookupDialogFilterFields only
(as the GUI for .NET lookup dialog does). Without filter fields
all columns are filterable

Parameters:
pcEntityName CHARACTER
The name of the lookup Business Entity
pcEntityTable CHARACTER
The name of the lookup entity table
pcEntityView CHARACTER
The name of the lookup entity view (optional)
pcGridColumns CHARACTER
The comma delimited list of the lookup grid columns
pcFilterFields CHARACTER
The comma delimited list of the lookup dialog filter fields (optional)
Returns Progress.Json.ObjectModel.JsonObject
The JsonObject representing the Grid layout
Top

Progress.Json.ObjectModel.JsonObject RenderLookupGridLayout (handle)
Purpose: Renders the lookup grid layout
Notes:

Parameters:
phAttributes HANDLE
The lookup's attribute's buffer
Returns Progress.Json.ObjectModel.JsonObject
The JsonObject representing the Grid layout
Top

RenderNumericOptions (JsonObject, JsonObject, handle, handle, character)
Purpose: Renders the numeric options of a lookup bound to an INTEGER, INT64
or DECIMAL field
Notes: SCL-5792. Adds the dataType to the lookupOptions and - like the
DataFieldWebRendering does for numeric fields - the Kendo number
format (from the FORMAT attribute, falling back to the format of
the bound field) and the step to the inputSettings

Parameters:
poInputSettings Progress.Json.ObjectModel.JsonObject
The inputSettings JsonObject of the field
poLookupOptions Progress.Json.ObjectModel.JsonObject
The lookupOptions JsonObject of the field
phAttributes HANDLE
The record buffer with the object attributes
phBoundField HANDLE
The handle of the viewer field the lookup is bound to (may be invalid)
pcDataType CHARACTER
The ABL data type (INTEGER, INT64, DECIMAL)
Top

HANDLE ResolveBoundField (character, handle, character)
Purpose: Returns the handle of the viewer field the lookup is bound to
Notes: SCL-5792. The field name is the qualified name of the bound
field (table.field) or the unqualified field name, which is
located in the given list of tables. Returns the unknown value
when the field cannot be resolved in the dataset

Parameters:
pcFieldName CHARACTER
The (qualified) name of the bound field
phDataset HANDLE
The handle of the Business Entity Dataset of the viewer
pcTables CHARACTER
The list of tables (entity table + entity view)
Returns HANDLE
The handle of the buffer field or the unknown value
Top

CHARACTER ResolveFieldName (character, handle, character)
Purpose: Returns the properly-cased SERIALIZE-NAME (or NAME) of a buffer
field as defined in the given ProDataset, so that the JSON
rendering of the Lookup uses the casing of the schema.
Notes: When the dataset, table or field cannot be resolved, the
original field name is returned unchanged.

Parameters:
pcFieldName CHARACTER
The name of the field to resolve
phDataset HANDLE
The handle of the Business Entity's ProDataset
pcTableName CHARACTER
The name of the entity table the field belongs to
Returns CHARACTER
The properly-cased field name


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       09.11.2026 08:17:20