Namespace: Consultingwerk.SmartFramework.Repository.Tools
Class 
RepositoryObjectImporter Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.SmartFramework.Repository.Tools.RepositoryObjectImporter

Inherits: Progress.Lang.Object

/*&GLOBAL-DEFINE NoUserLobStatistics NoUserLobStatistics

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



Top Method Summary
Options Name Purpose
FlattenNestedInstanceRecords (handle) Flattens nested instance records
CHARACTER GetCustomizationResultCode (character) Returns the customization result code of the object master in the .smartrepo file
CHARACTER GetCustomizationResultGuid (character) Returns the CustomizationResultGuid of the customization result with the given code
CHARACTER GetObjectMasterGuid (character) Gets the GUID of the repository object master in the .smartrepo file
CHARACTER GetObjectName (character) Gets the name of the repository object master in the .smartrepo file
LOGICAL IsCustomizedObjectMaster (character) Returns if the object master in the .smartrepo file is a customized variant of an object master
LOGICAL IsObjectMasterGuidConflict (character, character, character, character, character) Checks if there is a GUID conflict for the object master
LOGICAL IsObjectMasterGuidConflict (character, character, character) Checks if there is a GUID conflict for the object master
Consultingwerk.SmartFramework.Repository.Tools.LoadRepositoryObjectResult LoadRepositoryObject (character, logical, IFlagConflictsHandler) Loads an SmartObjectMaster and related data from a .smartrepo file
LoadRepositoryObject (handle, logical) Loads an SmartObjectMaster and related data from a .smartrepo file
ReadCustomizationResult (character, character, character) Reads the customization result attributes of the object master element of a .smartrepo file
ReadDatasetFromXml (handle, handle) Reads the Dataset
RenameCustomizedObjectInstances (character, character, character) Renames the customized (shadow) instances of a renamed instance of a base object master in all customized variants of that object master
ResolveCustomizationResult (handle) Resolves the customization result of an imported customized variant of an object master
SynchronizeData (handle, handle, character) Synchronizes the data from the source buffer to the target buffer

Top Property Summary
Options Name Purpose
LOGICAL UpdateLastImportDate


Method Detail
Top

FlattenNestedInstanceRecords (handle)
Purpose: Flattens nested instance records
Notes:

Parameters:
phXmlDocument HANDLE
The XML Document with the data
Top

CHARACTER GetCustomizationResultCode (character)
Purpose: Returns the customization result code of the object master in the
.smartrepo file
Notes: SCL-5902: A customized variant of an object master carries the code
of its customization result in the CustomizationResultCode attribute
of the eSmartObjectMaster element, a base object master has no such
attribute. Only the XML document is parsed, no dataset is populated

Parameters:
pcFileName CHARACTER
The name of the .smartrepo file
Returns CHARACTER
The customization result code, empty for a base object master
Top

CHARACTER GetCustomizationResultGuid (character)
Purpose: Returns the CustomizationResultGuid of the customization result
with the given code
Notes: SCL-5902: The customization results are part of the repository
data and are imported before the repository objects. A customized
variant of an object master references the customization result
of the target repository by its code, as the guid may differ
between repositories

Parameters:
pcCustomizationResultCode CHARACTER
The code of the customization result
Returns CHARACTER
The CustomizationResultGuid of the customization result or ? when it does not exist
Top

CHARACTER GetObjectMasterGuid (character)
Purpose: Gets the GUID of the repository object master in the .smartrepo file
Notes:

Parameters:
pcFileName CHARACTER
The name of the .smartrepo file to import
Returns CHARACTER
The GUID of the repository object
Top

CHARACTER GetObjectName (character)
Purpose: Gets the name of the repository object master in the .smartrepo file
Notes:

Parameters:
pcFileName CHARACTER
The name of the .smartrepo file to import
Returns CHARACTER
The name of the repository object
Top

LOGICAL IsCustomizedObjectMaster (character)
Purpose: Returns if the object master in the .smartrepo file is a customized
variant of an object master
Notes: SCL-5902: A customized variant references a customization result
(CustomizationResultGuid and CustomizationResultCode attributes of
the eSmartObjectMaster element). The base object masters have to
be imported before their variants, so that the variants can
reference the pages and instances of the base

Parameters:
pcFileName CHARACTER
The name of the .smartrepo file
Returns LOGICAL
Logical value indicating if the file contains a customized variant of an object master
Top

LOGICAL IsObjectMasterGuidConflict (character, character, character, character, character)
Purpose: Checks if there is a GUID conflict for the object master
Notes: SCL-5902: An object master is identified by its object name and
its customization result. A base object master (no customization
result) is resolved by its name, a customized variant by its name
and the customization result of the target repository that
matches the customization result code of the file (the guid of
the file is used when the code cannot be resolved). A conflict
exists when the object master exists with a different guid

Parameters:
pcObjectMasterGuid CHARACTER
The GUID of the object master to check
pcObjectName CHARACTER
The name of the object
pcCustomizationResultGuid CHARACTER
The CustomizationResultGuid of the object master in the file, empty for a base object master
pcCustomizationResultCode CHARACTER
The CustomizationResultCode of the object master in the file, empty for a base object master
pcCurrentObjectMasterGuid CHARACTER
The GUID of the current object master
Returns LOGICAL
Logical value indicating if there is a GUID conflict
Top

LOGICAL IsObjectMasterGuidConflict (character, character, character)
Purpose: Checks if there is a GUID conflict for the object master
Notes: Kept for compatibility, treats the object master as a base object
master (see the overload with the customization result)

Parameters:
pcObjectMasterGuid CHARACTER
The GUID of the object master to check
pcObjectName CHARACTER
The name of the object
pcCurrentObjectMasterGuid CHARACTER
The GUID of the current object master
Returns LOGICAL
Logical value indicating if there is a GUID conflict
Top

Consultingwerk.SmartFramework.Repository.Tools.LoadRepositoryObjectResult LoadRepositoryObject (character, logical, IFlagConflictsHandler)
Purpose: Loads an SmartObjectMaster and related data from a .smartrepo file
Notes:

Parameters:
pcFileName CHARACTER
The name of the .smartrepo file to import
plSetModifiedStatus LOGICAL
Logical value indicating if the imported object should be set as modified
poFlagConflictsHandler Consultingwerk.SmartFramework.Repository.Tools.IFlagConflictsHandler
Object reference that returns if conflicting imports should be flagged as pending merges
Returns Consultingwerk.SmartFramework.Repository.Tools.LoadRepositoryObjectResult
The LoadRepositoryObjectResult instance with the GUID of the imported repository object
Top

LoadRepositoryObject (handle, logical)
Purpose: Loads an SmartObjectMaster and related data from a .smartrepo file
Notes:

Parameters:
phDataset HANDLE
The handle of the ProDataset to import from
plSetModifiedStatus LOGICAL
Logical value indicating if the imported object should be set as modified
Top

ReadCustomizationResult (character, character, character)
Purpose: Reads the customization result attributes of the object master
element of a .smartrepo file
Notes: SCL-5902: The attributes are only present in the file when they
have a value (the exporter omits initial values)

Parameters:
pcFileName CHARACTER
The name of the .smartrepo file
pcCustomizationResultGuid CHARACTER
OUTPUT The CustomizationResultGuid attribute, empty when not present
pcCustomizationResultCode CHARACTER
OUTPUT The CustomizationResultCode attribute, empty when not present
Top

ReadDatasetFromXml (handle, handle)
Purpose: Reads the Dataset
Notes:

Parameters:
phDataset HANDLE
The ProDataset to import into
phXmlDocument HANDLE
The XML Document with the data
Top

RenameCustomizedObjectInstances (character, character, character)
Purpose: Renames the customized (shadow) instances of a renamed instance of a
base object master in all customized variants of that object master
Notes: SCL-5899: The import clears the instance names of the existing
instances before the names from the file are applied, so the
cascade of the ObjectMasterDataAccess does not see the rename.
The rename is performed by the ObjectMasterBusinessEntity, on
the AppServer when the SmartDB is not connected

Parameters:
pcBaseObjectMasterGuid CHARACTER
The ObjectMasterGuid of the imported base object master
pcOldInstanceName CHARACTER
The previous name of the instance
pcNewInstanceName CHARACTER
The new name of the instance
Top

ResolveCustomizationResult (handle)
Purpose: Resolves the customization result of an imported customized
variant of an object master
Notes: SCL-5902: The customization result code of the file is resolved to
the customization result of the target repository. When no
customization result with that code exists, the guid of the file
is kept

Parameters:
phObjectMasterBuffer HANDLE
The handle of the eSmartObjectMaster buffer of the imported dataset, positioned on the object master
Top

SynchronizeData (handle, handle, character)
Purpose: Synchronizes the data from the source buffer to the target buffer
Notes:

Parameters:
phSourceBuffer HANDLE
The handle of the source buffer (from the .smartrepo file)
phTargetBuffer HANDLE
The handle of the target buffer (current repository data)
pcKeyField CHARACTER
The name of the primary unique key field of the buffer


Property Detail
Top

LOGICAL UpdateLastImportDate

Returns LOGICAL


Temp-Table Detail


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       10.10.2026 15:31:03