project QadFinancials > class BDebtorShipTo > method ApiLoadDebtorShipTo

Description

This method returns all of the Debtor Shipto's for the current entity in tApiDebtorShipto


Parameters


tApiDebtorShipTooutputtemp-tableContains the details for Debtor Shiptos.
tApiDebtorShiptoContactoutputtemp-tableContains any assoicated contacts for the shiptos. tApiDebtorShiptoContact.tc_parentrowid is set to tApiDebtorShipto.tc_rowid
oiReturnStatusoutputintegerReturn status of the method.


Internal usage


unused


program code (program9/bdebtorshipto.p)

assign oiReturnStatus = -98
       viLocalStatus  = 0.

empty temp-table tApiDebtorShipTo.
empty temp-table tApiDebtorShiptoContact.  

<Q-9 run ContactByAddress  (Start) in BBusinessRelation >
<Q-12 run AddressById  (Start) in BBusinessRelation >
<Q-10 run DebtorShiptoByDebtor (all) (Read) (NoCache)
   (input ?, (DebtorId)
    input viCompanyID, (CompanyId)
    output dataset tqDebtorShiptoByDebtor) in BDebtorShipTo>

/* Create tApiMirroringGL records */
for each tqDebtorShiptoByDebtor:

    create tApiDebtorShipTo.
    
    <M-2 run BufferCopy
       (input  buffer tqDebtorShiptoByDebtor:handle (ihFrom), 
        input  buffer tApiDebtorShipTo:handle (ihTo), 
        output viFcReturnSuper (oiReturnStatus)) in BDebtorShipTo>
    if viFcReturnSuper <  0 or 
       viFcReturnSuper <> 0 and 
       viLocalStatus   =  0
    then assign viLocalStatus = viFcReturnSuper.
   
   <Q-13 run AddressById (all) (Read) (NoCache)
                         (input tApiDebtorShipTo.Address_ID, (AddressID)
                          output dataset tqAddressById) in BBusinessRelation >
   for first tqAddressById 
       where tqAddressById.tiaddress_id = tApiDebtorShipTo.address_id:
      
       assign tApiDebtorShipTo.tcAddress_rowid = tqAddressById.tc_rowid
              tApiDebtorShipTo.tcLngCode       = tqAddressById.tcLngCode.     
   end.
     
    /* retrieve all the contacts for this address */
    <Q-7 run ContactByAddress (all) (Read) (NoCache)
       (input tApiDebtorShipto.address_id, (AddressId)
        output dataset tqContactByAddress) in BBusinessRelation >

    /* add the contact to the address if we don't already have it stored */
    for each tqContactByAddress
        where tqContactbyAddress.tiAddress_id = tApiDebtorShipto.address_id:
        if not can-find(tApiDebtorShiptoContact where tApiDebtorShiptoContact.contact_id = tqContactByAddress.ticontact_id)        
        then do:
             create tApiDebtorShiptoContact.             
             <M-8 run BufferCopy
                (input  buffer tqContactByAddress:handle (ihFrom), 
                 input  buffer tApiDebtorShiptoContact:handle (ihTo), 
                 output viFcReturnSuper (oiReturnStatus)) in BDebtorShipTo>
           if viFcReturnSuper <  0 or 
              viFcReturnSuper <> 0 and 
              viLocalStatus   =  0
           then assign viLocalStatus = viFcReturnSuper.
           assign tApiDebtorShiptoContact.tc_ParentRowid = tApiDebtorShipto.tc_rowid. 
        end.
    end. /* end for each contact */   
end.

<Q-6 run ContactByAddress  (Stop) in BBusinessRelation >
<Q-14 run AddressById  (Stop) in BBusinessRelation >

assign oiReturnStatus = viLocalStatus.


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