project QadFinancials > class BJournal > method ApiReplicateFromDaemon
Description
This method will replicate the journal records to the operational tables (Daybook (dy_mstr) and Number Range Management (nr_mstr)).
All existing journals, based on the ID-List that was passed as input parameter will be loaded into the instance.
All the loaded journals will be replicated to operational tables for the current domain.
If for any reason the journal record already exist, the journal record will be overridden.
PostCondition
All journals from the parameters list are replicated to the operational tables.
PreCondition
The instance of BMfgDaybook can not be started yet.
Parameters
| icListIDs | input | character | Char(4) seperated list of IDs of records that need to be duplicated in MFG/Pro |
| oiReturnStatus | output | integer | Return status of the method. |
Internal usage
QadFinancials
program code (program9/bjournal.p)
/* ========================= */
/* Set default return status */
/* ========================= */
If oiReturnStatus = 0
then assign oiReturnStatus = -98.
/* ========================= */
/* Clear the instance */
/* ========================= */
<M-1 run ClearData (output viFcReturnSuper (oiReturnStatus)) in BJournal>
if viFcReturnSuper <> 0
then assign oiReturnStatus = viFcReturnSuper.
if viFcReturnSuper < 0
then leave.
/* ================ */
/* Get all Journals */
/* ================ */
<Q-15 run JournalPrim (all) (Read) (NoCache)
(input 0, (CompanyId)
input '':U, (JournalCode)
input 0, (JournalID)
output dataset tqJournalPrim) in BJournal >
/* ============================================================================ */
/* Check if the ID's in icListIDs are valid. If not, remove them from the list */
/* ============================================================================ */
empty temp-table tListJournalID.
do viCnt = 1 to num-entries(icListIDs, chr(4)):
create tListJournalID.
assign tListJournalID.tiFieldID = int(entry(viCnt, icListIDs, chr(4))).
end. /* do */
for each tListJournalID:
if can-find(tqJournalPrim where
tqJournalPrim.tiJournal_ID = tListJournalID.tiFieldID)
then assign vcNewListIDs = vcNewListIDs + chr(4) + trim(string(tListJournalID.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 BJournal>
if viFcReturnSuper <> 0
then assign oiReturnStatus = viFcReturnSuper.
if viFcReturnSuper < 0
then leave.
/* ================================================================= */
/* Mark all db-instances as new (needed for the replication) */
/* 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 tJournal :
assign tJournal.tc_status = "N":U.
end. /* for each */
if viBMfgDaybookID = 0 or
viBMfgDaybookID = ?
then do:
<I-3 {bFcStartAndOpenInstance
&ADD-TO-TRANSACTION = "false"
&CLASS = "BMfgDaybook"}>
end.
else do:
assign vcMessage = trim(#T-24'An instance of BMfgDaybook has already started. The system cannot start a new transaction.':255(69647)t-24#)
oiReturnStatus = -3.
<M-23 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-8225':U (icFcMsgNumber),
input '':U (icFcExplanation),
input '':U (icFcIdentification),
input '':U (icFcContext),
output viFcReturnSuper (oiReturnStatus)) in BJournal>
return.
end.
<M-21 run ApiReplicateFromFinancials
(input tJournal (tCopyJournal),
input vcDomainCode (icDomainCode),
output viExternalReturnStatus (oiReturnStatus)) in BMfgDaybook>
<I-32 {bFcCloseAndStopInstance
&CLASS = "BMfgDaybook"}>
if viExternalReturnStatus <> 0
then assign oiReturnStatus = viExternalReturnStatus.
if viExternalReturnStatus < 0
then return.
/* ======= */
/* BmfgNRM */
/* ======= */
if viBMfgNRM6ID = 0 or
viBMfgNRM6ID = ?
then do:
<I-27 {bFcStartAndOpenInstance
&ADD-TO-TRANSACTION = "false"
&CLASS = "BMfgNRM"}>
end.
else do:
assign vcMessage = trim(#T-29'An instance of BMfgNMR has already started. The system cannot start a new transaction.':255(69648)t-29#)
oiReturnStatus = -3.
<M-28 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-8227':U (icFcMsgNumber),
input '':U (icFcExplanation),
input '':U (icFcIdentification),
input '':U (icFcContext),
output viFcReturnSuper (oiReturnStatus)) in BJournal>
return.
end.
<M-30 run ApiReplicateFromFinancials
(input tJournal (tJournalBook),
input vcDomainCode (icDomainCode),
output viExternalReturnStatus (oiReturnStatus)) in BMfgNRM>
<I-31 {bFcCloseAndStopInstance
&CLASS = "BMfgNRM"}>
if viExternalReturnStatus <> 0
then assign oiReturnStatus = viExternalReturnStatus.
if viExternalReturnStatus < 0
then return.
/* ========================= */
/* 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 = "BJournal".
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/bjournal.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.