Namespace: Consultingwerk.SmartFramework.Repository
Class 
RepositoryBusinessTask Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.OERA.BusinessTask
Consultingwerk.SmartFramework.Repository.RepositoryBusinessTask

Inherits: Consultingwerk.OERA.BusinessTask
Implements: Consultingwerk.OERA.IBusinessService, Consultingwerk.OERA.RestResource.ISupportsRestMethods


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



Top Method Summary
Options Name Purpose
ApplyObjectProperties (character) Applies the edited ttObjectProperty rows to the freshly copied object master
Consultingwerk.CharacterHolder CreateFromTemplate (dataset, CreateFromTemplateParameter) Creates an object based on a repository template
Consultingwerk.CharacterHolder CreateObjectMasterFromInstance (CreateObjectMasterFromInstanceParameter) Creates a new Object Master based on an Object Instance
CreateTemplateRecord (buffer) Creates a template record
CHARACTER DefaultTitleFromDataSourceName (character) Returns the default Title attribute value derived from a data-source object master name
HANDLE FetchEntitySchema (character, character) Fetches the empty schema dataset of a Business Entity
Consultingwerk.CharacterArrayHolder GetChildClasses (CharacterHolder) Returns the list of child classes for the given parent class
GetDataTargets (dataset, GetDataTargetsParameter) Returns the list of data-targets based on a design-time data-source GUID
GetObjectMaster (dataset, GetObjectMasterParameter) Returns the list of object masters based on a design-time filter and class name
GetTemplate (dataset, CharacterHolder) Returns the repository template templates
Consultingwerk.CharacterHolder GetTemplateProperties (dataset, CharacterHolder) Pre-fills the ttObjectProperty temp-table with the editable properties of the template object master and its instances
GetTemplates (dataset, CharacterHolder) Returns the list of repository templates
CHARACTER ProposeForeignFields (character, character, character) Proposes a default ForeignFields value for a MetaDataSource instance that is the data-target of another MetaDataSource instance
CHARACTER ProposeTitle () Proposes a default TITLE for the generated object derived from its (chosen) master data source
Consultingwerk.OERA.RestResource.RestMethodResponse ReplaceObjectInstance (ReplaceObjectInstanceParameter) Replaces an Object instance with a new object master
CHARACTER ResolveDataSourceMaster (character, character) Resolves the object master to use for a data source instance of the object being generated
UpdatePageField (character, integer, character, character) Updates the label or key of a single page of an object master


Method Detail
Top

ApplyObjectProperties (character)
Purpose: Applies the edited ttObjectProperty rows to the freshly copied
object master
Notes: TITLE is stored as a master attribute, the ForeignFields rows are
stored as instance attributes and the Page rows update the label /
key of the corresponding pages

Parameters:
pcObjectMasterGuid CHARACTER
The GUID of the newly copied object master
Top

Consultingwerk.CharacterHolder CreateFromTemplate (dataset, CreateFromTemplateParameter)
Purpose: Creates an object based on a repository template
Notes:

Parameters:
dsTemplates DATASET dsTemplates
The dataset with the template data
poParameter Consultingwerk.SmartFramework.Repository.CreateFromTemplateParameter
The CreateFromTemplateParameter instance
Returns Consultingwerk.CharacterHolder
The CharacterHolder containing the GUID of the new object
Top

Consultingwerk.CharacterHolder CreateObjectMasterFromInstance (CreateObjectMasterFromInstanceParameter)
Purpose: Creates a new Object Master based on an Object Instance
Notes:

Parameters:
poParameter Consultingwerk.SmartFramework.Repository.CreateObjectMasterFromInstanceParameter
The CreateObjectMasterFromInstanceParameter instance
Returns Consultingwerk.CharacterHolder
The CharacterHolder containing the GUID of the new Object Master
Top

CreateTemplateRecord (buffer)
Purpose: Creates a template record
Notes:

Parameters:
eSmartObjectMaster buffer
The smart object master to create a template record for
Top

CHARACTER DefaultTitleFromDataSourceName (character)
Purpose: Returns the default Title attribute value derived from a data-source
object master name
Notes: Strips the "DataSource" suffix and resolves the remaining CamelCase
name into space separated words (e.g. "OrderDataSource" -> "Order",
"SalesOrderLineDataSource" -> "Sales Order Line")

Parameters:
pcObjectMasterName CHARACTER
The name of the data-source object master
Returns CHARACTER
The defaulted Title value
Top

HANDLE FetchEntitySchema (character, character)
Purpose: Fetches the empty schema dataset of a Business Entity
Notes: Uses the in-process ServiceInterface so it works both on the AppServer (wizard)
and in the MCP server session. When the Business Entity cannot be loaded (e.g.
its class is missing on the PROPATH) the data source is recorded in
cMissingEntities (so callers can report it) and the unknown value is returned.
The caller is responsible for deleting the returned dataset.

Parameters:
pcEntityName CHARACTER
The name of the Business Entity
pcInstanceName CHARACTER
The name of the data source instance using the entity
Returns HANDLE
The handle of the empty schema dataset, or the unknown value when it could not be loaded
Top

Consultingwerk.CharacterArrayHolder GetChildClasses (CharacterHolder)
Purpose: Returns the list of child classes for the given parent class
Notes:

Parameters:
poParentClass Consultingwerk.CharacterHolder
The parent class as a CharacterHolder
Returns Consultingwerk.CharacterArrayHolder
The list of child classes as a CharacterArrayHolder
Top

GetDataTargets (dataset, GetDataTargetsParameter)
Purpose: Returns the list of data-targets based on a design-time data-source GUID
Notes:

Parameters:
dsObjectMaster DATASET dsObjectMaster
The dataset with the object masters
poParameter Consultingwerk.SmartFramework.Repository.GetDataTargetsParameter
The GetDataTargetsParameter
Top

GetObjectMaster (dataset, GetObjectMasterParameter)
Purpose: Returns the list of object masters based on a design-time filter and class name
Notes:

Parameters:
dsObjectMaster DATASET dsObjectMaster
The dataset with the object masters
poParameter Consultingwerk.SmartFramework.Repository.GetObjectMasterParameter
The GetDataTargetsParameter
Top

GetTemplate (dataset, CharacterHolder)
Purpose: Returns the repository template templates
Notes:

Parameters:
dsTemplates DATASET dsTemplates
The dataset with the templates
poTemplateName Consultingwerk.CharacterHolder
CharacterHolder with the name of the template to return
Top

Consultingwerk.CharacterHolder GetTemplateProperties (dataset, CharacterHolder)
Purpose: Pre-fills the ttObjectProperty temp-table with the editable
properties of the template object master and its instances
Notes: Reads the TITLE attribute of the master (defaulted from the first
MetaDataSource instance), the ForeignFields attribute of each
MetaDataSource instance and the label / key of each page
is filled with one row per editable property
per line) whose Business Entity could not be loaded, or an empty value when all loaded

Parameters:
dsTemplates DATASET dsTemplates
The dataset carrying the selected template; ttObjectProperty
poTemplateName Consultingwerk.CharacterHolder
CharacterHolder with the name of the template to return the properties for
Returns Consultingwerk.CharacterHolder
A CharacterHolder with the list of data sources (one "InstanceName: EntityName"
Top

GetTemplates (dataset, CharacterHolder)
Purpose: Returns the list of repository templates
Notes:

Parameters:
dsTemplates DATASET dsTemplates
The dataset with the templates
poFilter Consultingwerk.CharacterHolder
The filter string
Top

CHARACTER ProposeForeignFields (character, character, character)
Purpose: Proposes a default ForeignFields value for a MetaDataSource instance
that is the data-target of another MetaDataSource instance
Notes: The masters of both the data-source (parent) and data-target (child) are
resolved from the placeholders the user replaced in the wizard (so the
proposal is based on the data sources of the generated object, not the
template's). The schema of both entities is fetched; for each unique-index
field of the data-source table that also exists in the data-target table a
parentField,childField pair (both the same field name) is returned. The
data-target is identified through the placeholder's DataSourceName (or, as a
fallback, the template's "Data" SmartLink). When the data-target entity
cannot be loaded its schema check is skipped and all data-source unique-index
fields are proposed. Any error degrades to an empty proposal.

Parameters:
pcDataTargetInstanceName CHARACTER
The InstanceName of the data-target instance
pcDataTargetInstanceGuid CHARACTER
The ObjectInstanceGuid of the data-target instance
pcDataTargetMasterGuid CHARACTER
The template ObjectMasterGuid the data-target instance is based on
Returns CHARACTER
The proposed ForeignFields value, or "" when there is no data-source or no matching fields
Top

CHARACTER ProposeTitle ()
Purpose: Proposes a default TITLE for the generated object derived from its
(chosen) master data source
Notes: Uses the first MetaDataSource instance (by ObjectSequence), resolves the
replacement object master the user picked for it, and derives the title
from that data source's object name (e.g. "CustomerDataSource" -> "Customer").
Any error degrades to an empty proposal.

Returns CHARACTER
The proposed TITLE, or "" when no master data source can be resolved
Top

Consultingwerk.OERA.RestResource.RestMethodResponse ReplaceObjectInstance (ReplaceObjectInstanceParameter)
Purpose: Replaces an Object instance with a new object master
Notes: Keeps compatible attributes

Parameters:
poParameter Consultingwerk.SmartFramework.Repository.ReplaceObjectInstanceParameter
The ReplaceObjectInstanceParameter instance
Returns Consultingwerk.OERA.RestResource.RestMethodResponse
The RestMethodResponse with the status code
Top

CHARACTER ResolveDataSourceMaster (character, character)
Purpose: Resolves the object master to use for a data source instance of the
object being generated
Notes: Prefers the replacement object master the user picked for the matching
placeholder (ttPlaceHolder.InstanceMaster); falls back to the passed
template master when the instance is not a (replaced) placeholder

Parameters:
pcInstanceName CHARACTER
The name of the data source instance / placeholder
pcFallbackMasterGuid CHARACTER
The object master GUID to use when the instance is not a replaced placeholder
Returns CHARACTER
The object master GUID of the data source to use
Top

UpdatePageField (character, integer, character, character)
Purpose: Updates the label or key of a single page of an object master
Notes:

Parameters:
pcObjectMasterGuid CHARACTER
The GUID of the container object master
piPageSequence INTEGER
The sequence of the page to update
pcField CHARACTER
The field to update ("Label" or "Key")
pcValue CHARACTER
The new value for the field


ProDataset Detail

ProDataset dsObjectMaster

Member tables: eSmartObjectMaster, eSmartLink, eSmartObjectInstance, eSmartPage

ProDataset dsTemplates

Member tables: ttTemplate, ttPlaceHolder, ttObjectProperty


Temp-Table Detail

Temp-Table eSmartLink

Defined in:

Temp-Table eSmartObjectInstance

Defined in:

Temp-Table eSmartObjectMaster

Defined in:

Temp-Table eSmartPage

Defined in:

Temp-Table ttObjectProperty

Defined in:

Temp-Table ttPlaceHolder

Defined in:

Temp-Table ttTemplate

Defined in:


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       06.07.2026 14:31:39