project QadFinancials > class BCompany > method ApiReplicateFromDaemon

Description

This method will replicate the company records to the operational tables (en_mstr).

All existing companies, based on the ID-List that was passed as input parameter will be loaded into the instance.
All the loaded companies will be replicated to operational tables.
If for any reason the company record already exist, the company record will be overridden.

PostCondition

All companies from the parameters list are replicated to the operational tables.

PreCondition

The instance of BMfgEntity can not be started yet.


Parameters


icListIDsinputcharacterChar(4) seperated list of IDs of records that need to be duplicated in MFG/Pro
oiReturnStatusoutputintegerReturn status of the method.


Internal usage


QadFinancials
method BReplicaDaemonProcessor.PerformWorkItem


program code (program9/bcompany.p)

/* ========================= */
/* Set default return status */
/* ========================= */
If oiReturnStatus = 0 
then assign oiReturnStatus = -98.

/* ========================= */
/* Clear the instance        */
/* ========================= */
<M-1 run ClearData (output viFcReturnSuper (oiReturnStatus)) in BCompany>
if viFcReturnSuper <> 0 
then assign oiReturnStatus = viFcReturnSuper.
if viFcReturnSuper < 0
then leave.

/* ================= */
/* Get all Companies */
/* ================= */
<Q-9 run CompanyPrim (all) (Read) (NoCache)
   (input 0, (LookupCompanyId)
    input '':U, (CompanyCode)
    output dataset tqCompanyPrim) in BCompany >

/* ============================================================================ */
/* Check if the ID's in icListIDs are valid.  If not, remove them from the list */
/* ============================================================================ */
empty temp-table tListCompanyID.
do viCnt = 1 to num-entries(icListIDs, chr(4)):
    create tListCompanyID.
    assign tListCompanyID.tiFieldID = int(entry(viCnt, icListIDs, chr(4))).
end. /* do */

for each tListCompanyID:    
    if can-find(tqCompanyPrim where 
                tqCompanyPrim.tiCompany_ID = tListCompanyID.tiFieldID)
    then assign vcNewListIDs = vcNewListIDs + chr(4) + trim(string(tListCompanyID.tiFieldID)).
end. /* for each */

if vcNewListIDs <> '':U and vcNewListIDs <> ?
then assign icListIDs = substring(vcNewListIDs, 2, -1, "CHARACTER":U).
else do:
    /* Nothing left to replicate */
    assign oiReturnStatus = 0.
    leave.
end.

/* ========================= */
/* Perform DataLoad          */
/* ========================= */
<M-2 run DataLoad (input  '':U (icRowids), 
                   input  icListIDs (icPkeys), 
                   input  '':U (icObjectIds), 
                   input  '':U (icFreeform), 
                   input  false (ilKeepPrevious), 
                   output viFcReturnSuper (oiReturnStatus)) in BCompany>
if viFcReturnSuper <> 0 
then assign oiReturnStatus = viFcReturnSuper.
if viFcReturnSuper < 0
then leave.

/* ================================================================= */
/* Mark all db-instances as new (needed for the replication)         */
/* Move all data in the t-tables to the t_s-tables (temporarely      */
/* solution until BMfgDatabase gets reviewed)                        */
/* Call the MaintainData-method in the Mfg Variant                   */
/* Mark all db-instances as unchanged (needed for the replication)   */
/* Do not save any data in this component: it only needs replication */
/* ================================================================= */
for each tCompany :
    find tCompanyPropertyRef where
         tCompanyPropertyRef.Company_ID = tCompany.Company_ID
         no-error.
    if not available tCompanyPropertyRef
    then do:
        assign vcMessage     = trim(#T-7'The system cannot find the entity attributes for the current entity.':200(32044)t-7#)
               oiReturnStatus = -1.
        <M-8 run SetMessage (input  vcMessage (icMessage), 
                     input  '':U (icArguments), 
                     input  'tCompany.Company_ID':U (icFieldName), 
                     input  string(tCompany.Company_ID) (icFieldValue), 
                     input  'E':U (icType), 
                     input  3 (iiSeverity), 
                     input  tCompany.tc_Rowid (icRowid), 
                     input  'QadFin-4933':U (icFcMsgNumber), 
                     input  '':U (icFcExplanation), 
                     input  '':U (icFcIdentification), 
                     input  '':U (icFcContext), 
                     output viFcReturnSuper (oiReturnStatus)) in BCompany>
        return.                                    
    end.
    assign tCompany.tc_status = "N":U.    
end. /* for each */

if viBMfgEntityID = 0 or
   viBMfgEntityID = ?
then do:
    <I-3 {bFcStartAndOpenInstance
         &ADD-TO-TRANSACTION = "false"
         &CLASS              = "BMfgEntity"}>
end.
else do:
    assign vcMessage      = trim(#T-13'An instance of BMfgEntity has already started. The system cannot start a new transaction.':255(69644)t-13#)
           oiReturnStatus = -3.
    <M-12 run SetMessage
       (input  vcMessage (icMessage), 
        input  '':U (icArguments), 
        input  '':U (icFieldName), 
        input  '':U (icFieldValue), 
        input  'E':U (icType), 
        input  1 (iiSeverity), 
        input  '':U (icRowid), 
        input  'QadFin-8221':U (icFcMsgNumber), 
        input  '':U (icFcExplanation), 
        input  '':U (icFcIdentification), 
        input  '':U (icFcContext), 
        output viFcReturnSuper (oiReturnStatus)) in BCompany>
    return.  
end.                                  

<M-10 run ApiReplicateFromFinancials
   (input  tCompany (tCompany), 
    input  tCompanyPropertyRef (tCompanyProperty), 
    output viExternalReturnStatus (oiReturnStatus)) in BMfgEntity>

<I-14 {bFcCloseAndStopInstance
     &CLASS           = "BMfgEntity"}>
if viExternalReturnStatus <> 0 
then assign oiReturnStatus = viExternalReturnStatus.
if viExternalReturnStatus < 0
then leave.

/* ========================= */
/* Set default return status */
/* ========================= */
if oiReturnStatus = -98 
then assign oiReturnstatus = 0.


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 = "BCompany".
create ttContext.
assign ttContext.propertyName = "methodName"
       ttContext.propertyValue = "ApiReplicateFromDaemon".
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 = "".

/* Create input dataset */
create dataset vhInputDS.
vhInputDS:read-xmlschema("file", "xml/bcompany.apireplicatefromdaemon.i.xsd", ?).
vhParameter = vhInputDS:get-buffer-handle("tParameterI").
vhParameter:buffer-create().
assign vhParameter::icListIDs = <parameter value>.

/* 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.