project BLF > class Database Component > method GetBusinessFields

Description

Returns a full description of all business fields of a business class, browse or report.


Parameters


icReferenceinputcharacter- <classname> for receiving business field information of a business class
- <classname>.<methodname> for receiving business field information of a browse or report
tBusinessFieldsoutputtemp-table
tCustomRelationoutputtemp-table
oiReturnStatusoutputintegerReturn status of the method.


Internal usage


BLF
method BFieldSecurity.GetBusFieldsNoFS
method Session.GetBusinessFields

QadFinancials
method BDivision.GetBusinessFields
method BProject.GetBusinessFields


program code (program/database.p)

<ANCESTOR-CODE>

if icReference = vcFcComponentName
then do:
    assign vcComponentList = vcFcComponentName
           vcTempList      = {&TARGETPROCEDURE}:super-procedures
           viFcCount1      = num-entries(vcTempList).
           
    do viFcCount2 = 1 to viFcCount1:
        assign vcTempComponent = entry(viFcCount2, vcTempList)
               vhTempComponent = handle(vcTempComponent)
               vcTempComponent = vhTempComponent:file-name.
               
        if not vcTempComponent begins "program/"
        then next.
        
        assign vcTempComponent = entry(2, vcTempComponent, "/")
               vcTempComponent = entry(1, vcTempComponent, ".").
               
        if vcTempComponent <> "business" and
           vcTempComponent <> "database" and
           vcTempComponent <> vcFcComponentName
        then assign vcComponentList = vcComponentList + "," + vcTempComponent.
    end.
    
    assign viFcCount1 = num-entries(vcComponentList).
    
    do viFcCount2 = 1 to viFcCount1:
        assign vcTempComponent = entry(viFcCount2, vcComponentList).
        
        <Q-11 run GetCustomFieldsForTable (all) (Read) (Cache)
           (input '', (TableName)
            input vcTempComponent, (ComponentName)
            output dataset tqCustomFieldsForTable) in BCustomField >

        for each tqCustomFieldsForTable on error undo, throw:
            /* translations are not loaded by the query itself when user setting use object translations is not active */
            /*
            <M-17 run GetTranslationForObject
               (input  novalue (iiObjectID), 
                input  novalue (icLanguageCode), 
                input  'Show Usage' (icOriginal), 
                input  novalue (icFieldName), 
                output novalue (ocTranslation), 
                output novalue (oiReturnStatus)) in ComponentPool>
            */
            if not vlObjectTranslationsActive
            then do:
                run GetTranslationForObject
                   (input tqCustomFieldsForTable.tiCustomField_ID,
                    input current-language,
                    input "",
                    input "",
                    output vcValueList,
                    output viFcReturnSuper).
        
                if viFcReturnSuper <> 0
                then assign oiReturnStatus = viFcReturnSuper.
        
                if viFcReturnSuper < 0
                then return.
        
                if lookup("CustomFieldSideLabel", vcValueList, "|") > 0 and
                   entry(lookup("CustomFieldSideLabel", vcValueList, "|") + 1, vcValueList, "|") <> ""
                then assign tqCustomFieldsForTable.tcCustomFieldSideLabel = entry(lookup("CustomFieldSideLabel", vcValueList, "|") + 1, vcValueList, "|").
        
                if lookup("CustomFieldColumnLabel", vcValueList, "|") > 0 and
                   entry(lookup("CustomFieldColumnLabel", vcValueList, "|") + 1, vcValueList, "|") <> ""
                then assign tqCustomFieldsForTable.tcCustomFieldColumnLabel = entry(lookup("CustomFieldColumnLabel", vcValueList, "|") + 1, vcValueList, "|").
            end.
            
            assign vcValueList = "".
    
            if tqCustomFieldsForTable.tcCustomFieldUIControlType = "ComboBox" and
              (tqCustomFieldsForTable.tiStoredSearch_ID          = 0          or
               tqCustomFieldsForTable.tiStoredSearch_ID          = ?)
            then do:
                <Q-1 run CustomFieldValues (all) (Read) (NoCache)
                   (input tqCustomFieldsForTable.tcCustomFieldFieldName, (BusinessFieldName)
                    input '', (Value)
                    output dataset tqCustomFieldValues) in BCustomField >
    
                for each tqCustomFieldValues by tqCustomFieldValues.tiCustomValueSequence on error undo, throw:
                    assign vcValueList = vcValueList + chr(2) +
                                         tqCustomFieldValues.tcCustomValueCode + chr(2) +
                                         tqCustomFieldValues.tcCustomValueCode.
                end.
    
                assign vcValueList = substr(vcValueList, 2, -1, "CHARACTER").
                empty temp-table tqCustomFieldValues.
            end.
    
            create tBusinessFields.
    
            assign tBusinessFields.tcFcFieldName     = if num-entries(tqCustomFieldsForTable.tcCustomFieldFieldName, ":") = 2
                                                       then entry(2, tqCustomFieldsForTable.tcCustomFieldFieldName, ":")
                                                       else tqCustomFieldsForTable.tcCustomFieldFieldName
                   tBusinessFields.tcSideLabel       = tqCustomFieldsForTable.tcCustomFieldSideLabel
                   tBusinessFields.tcColumnLabel     = tqCustomFieldsForTable.tcCustomFieldColumnLabel
                   tBusinessFields.tcFcFieldType     = "B"
                   tBusinessFields.tcFcDescription   = tqCustomFieldsForTable.tcCustomFieldDescription
                   tBusinessFields.tcDataType        = tqCustomFieldsForTable.tcCustomFieldDataType
                   tBusinessFields.tcDisplayFormat   = tqCustomFieldsForTable.tcCustomFieldDisplayFormat
                   tBusinessFields.tcControlType     = tqCustomFieldsForTable.tcCustomFieldUIControlType
                   tBusinessFields.tiStoredSearch_ID = tqCustomFieldsForTable.tiStoredSearch_ID
                   tBusinessFields.tcValueList       = vcValueList.
    
            if tBusinessFields.tiStoredSearch_ID <> 0 and
               tBusinessFields.tiStoredSearch_ID <> ?
            then do:
                <Q-16 run StoredSearchPrim (all) (Read) (Cache)
                   (input tBusinessFields.tiStoredSearch_ID, (StoredSearchID)
                    input ?, (Name)
                    input ?, (LookupReference)
                    input ?, (UsrId)
                    input ?, (CompanyId)
                    output dataset tqStoredSearchPrim) in BStoredSearch >
    
                find first tqStoredSearchPrim where
                           tqStoredSearchPrim.tiStoredSearch_ID = tBusinessFields.tiStoredSearch_ID
                           no-error.
    
                if available tqStoredSearchPrim
                then do:
                    if tqStoredSearchPrim.tcStoredSearchLookupRef = "QAD.Browse.MfgProLookupProvider"
                    then assign tBusinessFields.tcLookupQuery = tqStoredSearchPrim.tcStoredSearchLookupRef + ":" +
                                                                tqStoredSearchPrim.tcStoredSearchName      + ":" +
                                                                tqCustomFieldsForTable.tcCustomFieldSSReturnField.
                    else
                    if index(tqStoredSearchPrim.tcStoredSearchLookupRef, ":") > 0
                    then assign tBusinessFields.tcLookupQuery = tqStoredSearchPrim.tcStoredSearchLookupRef.
                    else
                    if tqCustomFieldsForTable.tcCustomFieldUIControlType = "ComboBox"
                    then do:
                        <M-78 run GetBusinessFieldsGenCode
                           (input  tqStoredSearchPrim.tcStoredSearchLookupRef (icGenCode), 
                            output vcValueList (ocValueList), 
                            output viFcReturnSuper (oiReturnStatus)) in database>
    
                        if viFcReturnSuper <> 0
                        then assign oiReturnStatus = viFcReturnSuper.
    
                        if viFcReturnSuper < 0
                        then return.
    
                        assign tBusinessFields.tcValueList = vcValueList.
                    end.
                    else
                    if tqStoredSearchPrim.tcStoredSearchName = {&LOOKUPTYPE-GENCODE}
                    then assign tBusinessFields.tcLookupQuery       = "BMfgGeneralizedCodeSAO.SelectGeneralizedCode"
                                tBusinessFields.tcLookupFilterField = "tcode_mstr.code_value"
                                tBusinessFields.tcLookupReturnField = "tqSelectGeneralizedCode.tccode_value"
                                tBusinessFields.tcRelatedObject     = tqStoredSearchPrim.tcStoredSearchLookupRef.
                    else do:
                        assign vcLookupRef = if num-entries(tqStoredSearchPrim.tcStoredSearchLookupRef, "/") > 1
                                             then entry(2, tqStoredSearchPrim.tcStoredSearchLookupRef, "/")
                                             else tqStoredSearchPrim.tcStoredSearchLookupRef.
    
                        if num-entries(vcLookupRef, ".") = 2
                        then do:
                            assign tBusinessFields.tcLookupQuery       = entry(1, vcLookupRef, ".") + "SAO." + entry(2, vcLookupRef, ".")
                                   tBusinessFields.tcLookupFilterField = tqCustomFieldsForTable.tcCustomFieldSSReturnField.
    
                            if tBusinessFields.tcLookupFilterField                  <> "" and
                               tBusinessFields.tcLookupFilterField                  <> ?  and
                               num-entries(tBusinessFields.tcLookupFilterField, ".") = 2
                            then assign tBusinessFields.tcLookupReturnField = "tq" + entry(2, vcLookupRef, ".") + ".t" + tBusinessFields.tcDataType + entry(2, tBusinessFields.tcLookupFilterField, ".").
                        end.
                    end.
                end.
            end.
        end.
    end.
end.
else do:
    run appinfo/classtables.p (input "", output vcFcMaskList, output vcDBTables).

    for each businessFields where
             num-entries(businessFields.tcFcFieldName, ".") = 2
             break by entry(1, businessFields.tcFcFieldName, ".")
            on error undo, throw:
        if first-of(entry(1, businessFields.tcFcFieldName, "."))
        then do:
            vcQTable2 = entry(1, businessFields.tcFcFieldName, ".").
            vcQTable1 = substring (vcQTable2, 2, -1, "CHARACTER").
            vcQTable2 = substring (vcQTable1, 1, length(vcQTable1,"CHARACTER") - 1, "CHARACTER").
            if can-do (vcDBTables,vcQTable1)
            then assign vcCustomTables = vcCustomTables + "," + entry(1, businessFields.tcFcFieldName, ".")
                                                        + "," + entry(1, businessFields.tcFcFieldName, ".")
                        vcFieldType    = businessFields.tcFcFieldType.
            else
            if can-do (vcDBTables,vcQTable2)
            then assign vcCustomTables = vcCustomTables + "," + entry(1, businessFields.tcFcFieldName, ".")
                                                        + "," + substring (entry(1, businessFields.tcFcFieldName, "."), 1, length(entry(1, businessFields.tcFcFieldName, "."),"CHARACTER") - 1, "CHARACTER")
                        vcFieldType    = businessFields.tcFcFieldType.
        end.
    end.

    do viFcCount1 = 2 to num-entries(vcCustomTables) by 2:
        assign vcDBTables = entry(viFcCount1 + 1, vcCustomTables).

        <Q-2 run GetCustomFieldsForTable (all) (Read) (Cache)
           (input vcDBTables, (TableName)
            input '', (ComponentName)
            output dataset tqCustomFieldsForTable) in BCustomField >

        for each tqCustomFieldsForTable on error undo, throw:
        
            if entry(1,tqCustomFieldsForTable.tcCustomFieldFieldName,".") = vcDBTables
            then entry(1,tqCustomFieldsForTable.tcCustomFieldFieldName,".") = entry(viFcCount1, vcCustomTables).
            
            /* translations are not loaded by the query itself when user setting use object translations is not active */
            /*
            <M-66 run GetTranslationForObject
               (input  novalue (iiObjectID), 
                input  novalue (icLanguageCode), 
                input  'Show Usage' (icOriginal), 
                input  novalue (icFieldName), 
                output novalue (ocTranslation), 
                output novalue (oiReturnStatus)) in ComponentPool>
            */
            if not vlObjectTranslationsActive
            then do:
                run GetTranslationForObject
                   (input tqCustomFieldsForTable.tiCustomField_ID,
                    input current-language,
                    input "",
                    input "",
                    output vcValueList,
                    output viFcReturnSuper).
    
                if viFcReturnSuper <> 0
                then assign oiReturnStatus = viFcReturnSuper.
    
                if viFcReturnSuper < 0
                then return.
    
                if lookup("CustomFieldSideLabel", vcValueList, "|") > 0 and
                   entry(lookup("CustomFieldSideLabel", vcValueList, "|") + 1, vcValueList, "|") <> ""
                then assign tqCustomFieldsForTable.tcCustomFieldSideLabel = entry(lookup("CustomFieldSideLabel", vcValueList, "|") + 1, vcValueList, "|").
    
                if lookup("CustomFieldColumnLabel", vcValueList, "|") > 0 and
                   entry(lookup("CustomFieldColumnLabel", vcValueList, "|") + 1, vcValueList, "|") <> ""
                then assign tqCustomFieldsForTable.tcCustomFieldColumnLabel = entry(lookup("CustomFieldColumnLabel", vcValueList, "|") + 1, vcValueList, "|").
            end.
            
            assign vcValueList = "".

            if tqCustomFieldsForTable.tcCustomFieldUIControlType = "ComboBox" and
              (tqCustomFieldsForTable.tiStoredSearch_ID          = 0          or
               tqCustomFieldsForTable.tiStoredSearch_ID          = ?)
            then do:
                <Q-3 run CustomFieldValues (all) (Read) (NoCache)
                   (input tqCustomFieldsForTable.tcCustomFieldFieldName, (BusinessFieldName)
                    input '', (Value)
                    output dataset tqCustomFieldValues) in BCustomField >

                for each tqCustomFieldValues by tqCustomFieldValues.tiCustomValueSequence on error undo, throw:
                    assign vcValueList = vcValueList + chr(2) +
                                         tqCustomFieldValues.tcCustomValueCode + chr(2) +
                                         tqCustomFieldValues.tcCustomValueCode.
                end.

                assign vcValueList = substr(vcValueList, 2, -1, "CHARACTER").
                empty temp-table tqCustomFieldValues.
            end.

            vcside = tqCustomFieldsForTable.tcCustomFieldSideLabel.
            viside = 0.
            do while can-find (first tBusinessFields where tBusinessFields.tcSideLabel = vcside):
                viside = viside + 1.
                vcside = tqCustomFieldsForTable.tcCustomFieldSideLabel + " (" + string(viside) + ")".
            end.
            
            vccol = tqCustomFieldsForTable.tcCustomFieldColumnLabel.
            vicol = 0.
            do while can-find (first tBusinessFields where tBusinessFields.tcColumnLabel = vccol):
                vicol = vicol + 1.
                vccol = tqCustomFieldsForTable.tcCustomFieldColumnLabel + " (" + string(vicol) + ")".
            end.
            
            create tBusinessFields.

            assign tBusinessFields.tcFcFieldName     = tqCustomFieldsForTable.tcCustomFieldFieldName
                   tBusinessFields.tcSideLabel       = vcside
                   tBusinessFields.tcColumnLabel     = vccol
                   tBusinessFields.tcFcFieldType     = vcFieldType
                   tBusinessFields.tcFcDescription   = tqCustomFieldsForTable.tcCustomFieldDescription
                   tBusinessFields.tcDataType        = tqCustomFieldsForTable.tcCustomFieldDataType
                   tBusinessFields.tcDisplayFormat   = tqCustomFieldsForTable.tcCustomFieldDisplayFormat
                   tBusinessFields.tcControlType     = tqCustomFieldsForTable.tcCustomFieldUIControlType
                   tBusinessFields.tiStoredSearch_ID = tqCustomFieldsForTable.tiStoredSearch_ID
                   tBusinessFields.tcValueList       = vcValueList.

            if tBusinessFields.tiStoredSearch_ID <> 0 and
               tBusinessFields.tiStoredSearch_ID <> ?
            then do:
                <Q-10 run StoredSearchPrim (all) (Read) (Cache)
                   (input tBusinessFields.tiStoredSearch_ID, (StoredSearchID)
                    input ?, (Name)
                    input ?, (LookupReference)
                    input ?, (UsrId)
                    input ?, (CompanyId)
                    output dataset tqStoredSearchPrim) in BStoredSearch >

                find first tqStoredSearchPrim where
                           tqStoredSearchPrim.tiStoredSearch_ID = tBusinessFields.tiStoredSearch_ID
                           no-error.

                if available tqStoredSearchPrim
                then do:
                    if tqStoredSearchPrim.tcStoredSearchLookupRef = "QAD.Browse.MfgProLookupProvider"
                    then assign tBusinessFields.tcLookupQuery = tqStoredSearchPrim.tcStoredSearchLookupRef + ":" +
                                                                tqStoredSearchPrim.tcStoredSearchName      + ":" +
                                                                tqCustomFieldsForTable.tcCustomFieldSSReturnField.
                    else
                    if index(tqStoredSearchPrim.tcStoredSearchLookupRef, ":") > 0
                    then assign tBusinessFields.tcLookupQuery = tqStoredSearchPrim.tcStoredSearchLookupRef.
                    else
                    if tqCustomFieldsForTable.tcCustomFieldUIControlType = "ComboBox"
                    then do:
                        <M-23 run GetBusinessFieldsGenCode
                           (input  tqStoredSearchPrim.tcStoredSearchLookupRef (icGenCode), 
                            output vcValueList (ocValueList), 
                            output viFcReturnSuper (oiReturnStatus)) in database>

                        if viFcReturnSuper <> 0
                        then assign oiReturnStatus = viFcReturnSuper.

                        if viFcReturnSuper < 0
                        then return.

                        assign tBusinessFields.tcValueList = vcValueList.
                    end.
                    else
                    if tqStoredSearchPrim.tcStoredSearchName = {&LOOKUPTYPE-GENCODE}
                    then assign tBusinessFields.tcLookupQuery       = "BMfgGeneralizedCodeSAO.SelectGeneralizedCode"
                                tBusinessFields.tcLookupFilterField = "tcode_mstr.code_value"
                                tBusinessFields.tcLookupReturnField = "tqSelectGeneralizedCode.tccode_value"
                                tBusinessFields.tcRelatedObject     = tqStoredSearchPrim.tcStoredSearchLookupRef.
                    else do:
                        assign vcLookupRef = if num-entries(tqStoredSearchPrim.tcStoredSearchLookupRef, "/") > 1
                                             then entry(2, tqStoredSearchPrim.tcStoredSearchLookupRef, "/")
                                             else tqStoredSearchPrim.tcStoredSearchLookupRef.

                        if num-entries(vcLookupRef, ".") = 2
                        then do:
                            assign tBusinessFields.tcLookupQuery       = entry(1, vcLookupRef, ".") + "SAO." + entry(2, vcLookupRef, ".")
                                   tBusinessFields.tcLookupFilterField = tqCustomFieldsForTable.tcCustomFieldSSReturnField.

                            if tBusinessFields.tcLookupFilterField                  <> "" and
                               tBusinessFields.tcLookupFilterField                  <> ?  and
                               num-entries(tBusinessFields.tcLookupFilterField, ".") = 2
                            then assign tBusinessFields.tcLookupReturnField = "tq" + entry(2, vcLookupRef, ".") + ".t" + tBusinessFields.tcDataType + entry(2, tBusinessFields.tcLookupFilterField, ".").
                        end.
                    end.
                end.
            end.

            if vcFieldType = "F"
            then do:
                find first tBusinessFields where
                           tBusinessFields.tcFcFieldType = "B"
                           no-error.

                if available tBusinessFields
                then do:
                    assign vcTable                           = entry(1, tBusinessFields.tcFcFieldName, ".").

                    create tBusinessFields.
                    assign tBusinessFields.tcFcFieldName     = vcTable + "." + replace(substr(tqCustomFieldsForTable.tcCustomFieldFieldName, 2, -1, "CHARACTER"), ".", "_")
                           tBusinessFields.tcSideLabel       = vcside
                           tBusinessFields.tcColumnLabel     = vccol
                           tBusinessFields.tcFcFieldType     = "C"
                           tBusinessFields.tcFcDescription   = tqCustomFieldsForTable.tcCustomFieldDescription
                           tBusinessFields.tcDataType        = tqCustomFieldsForTable.tcCustomFieldDataType
                           tBusinessFields.tcDisplayFormat   = tqCustomFieldsForTable.tcCustomFieldDisplayFormat
                           tBusinessFields.tcControlType     = tqCustomFieldsForTable.tcCustomFieldUIControlType
                           tBusinessFields.tiStoredSearch_ID = tqCustomFieldsForTable.tiStoredSearch_ID
                           tBusinessFields.tcValueList       = vcValueList.
                    
                    /* BLF-4362: make sure user-defined date fields are displayed correctly on the browse report */
                    if tBusinessFields.tcDataType = "t"
                    then assign tBusinessFields.tcDataType      = "c"
                                tBusinessFields.tcDisplayFormat = "x(10)".
                end.
            end.
        end.
    end.
end.

if vlFieldSecurityActive     and
   vlFieldSecurityActiveOnBC and
   icReference = vcFcComponentName
then do:
    /* FIELD SECURITY */
    <Q-7 run FieldSecurityForCompActivity (all) (Read) (NoCache)
       (input '', (ActivityCode)
        input icReference, (BusCompName)
        input viUsrId, (UsrID)
        output dataset tqFieldSecurityForCompActivity) in BFieldSecurity >

    for each tqFieldSecurityForCompActivity,
        each tBusinessFields where
             tBusinessFields.tcFcFieldName = tqFieldSecurityForCompActivity.tcFieldSecurityBusFieldName
             on error undo, throw:
        if not tqFieldSecurityForCompActivity.tlFieldSecurityIsUpdateable
        then if tBusinessFields.tcDisabledForActivities = ""
             then assign tBusinessFields.tcDisabledForActivities = tqFieldSecurityForCompActivity.tcBusActivityCode.
             else if not can-do(tBusinessFields.tcDisabledForActivities, tqFieldSecurityForCompActivity.tcBusActivityCode)
                  then assign tBusinessFields.tcDisabledForActivities = tBusinessFields.tcDisabledForActivities + "," + tqFieldSecurityForCompActivity.tcBusActivityCode.

        if tqFieldSecurityForCompActivity.tlFieldSecurityIsHidden
        then if tBusinessFields.tcHiddenForActivities = ""
             then assign tBusinessFields.tcHiddenForActivities = tqFieldSecurityForCompActivity.tcBusActivityCode.
             else if not can-do(tBusinessFields.tcHiddenForActivities, tqFieldSecurityForCompActivity.tcBusActivityCode)
                  then assign tBusinessFields.tcHiddenForActivities = tBusinessFields.tcHiddenForActivities + "," + tqFieldSecurityForCompActivity.tcBusActivityCode.
    end.

    empty temp-table tqFieldSecurityForCompActivity.
end.


Sample code: how to call this method through RPCRequestService (QXtend Inbound)

define temp-table ttContext no-undo
    field propertyQualifier as character
    field propertyName as character
    field propertyValue as character
    index entityContext is primary unique
        propertyQualifier
        propertyName
    index propertyQualifier
        propertyQualifier.

define dataset dsContext for ttContext.

define variable vhContextDS as handle no-undo.
define variable vhExceptionDS as handle no-undo.
define variable vhServer as handle no-undo.
define variable vhInputDS as handle no-undo.
define variable vhInputOutputDS as handle no-undo.
define variable vhOutputDS as handle no-undo.
define variable vhParameter as handle no-undo.

/* Create context */
create ttContext.
assign ttContext.propertyName = "programName"
       ttContext.propertyValue = "database".
create ttContext.
assign ttContext.propertyName = "methodName"
       ttContext.propertyValue = "GetBusinessFields".
create ttContext.
assign ttContext.propertyName = "applicationId"
       ttContext.propertyValue = "fin".
create ttContext.
assign ttContext.propertyName = "entity"
       ttContext.propertyValue = "1000".
create ttContext.
assign ttContext.propertyName = "userName"
       ttContext.propertyValue = "mfg".
create ttContext.
assign ttContext.propertyName = "password"
       ttContext.propertyValue = "".

/* Connect the AppServer */
create server vhServer.
vhServer:connect("-URL <appserver-url>").

if not vhServer:connected()
then do:
    message "Could not connect AppServer" view-as alert-box error title "Error".
    return.
end.

/* Run */
assign vhContextDS = dataset dsContext:handle.

run program/rpcrequestservice.p on vhServer
    (input-output dataset-handle vhContextDS by-reference,
           output dataset-handle vhExceptionDS,
     input        dataset-handle vhInputDS by-reference,
     input-output dataset-handle vhInputOutputDS by-reference,
           output dataset-handle vhOutputDS).

/* Handle output however you want, in this example, we dump it to xml */
if valid-handle(vhExceptionDS)
then vhExceptionDS:write-xml("file", "Exceptions.xml", true).

if valid-handle(vhOutputDS)
then vhOutputDS:write-xml("file", "Output.xml", true).

/* Cleanup */
vhServer:disconnect().
assign vhServer = ?.

if valid-handle(vhInputDS)
then delete object vhInputDS.

if valid-handle(vhOutputDS)
then delete object vhOutputDS.

if valid-handle(vhExceptionDS)
then delete object vhExceptionDS.