API query DebtorByDebtorInvControlGL

Description

This query will return the default cost centre and default project code for the invoice control account of the debtor.

query filter (table tFilter)

tcBusinessFieldName	tcDataType	tcOperator
iiCompanyId	i
icDebtorCode	c	=
iiDebtorID	i	=
tCostCentre.CostCentreCode	c	=,>=,>,<>,<=,<,begins,can-do,matches
tDebtor.DebtorCode	c	=,>=,>,<>,<=,<,begins,can-do,matches
tGL.GLCode	c	=,>=,>,<>,<=,<,begins,can-do,matches
tProject.ProjectCode	c	=,>=,>,<>,<=,<,begins,can-do,matches

Parameters (internal)

iiCompanyId	integer	Company id
icDebtorCode	character
iiDebtorID	integer

query condition

each Debtor where

Debtor.SharedSet_Id = vi_DEBTOR_sharedset(iiCompanyId) AND
Debtor.DebtorCode = icDebtorCode AND
Debtor.Debtor_ID = iiDebtorID

first Profile1 (inner-join) where

Profile1.Profile_ID = Debtor.InvControlGLProfile_ID AND

each ProfileLink1 (inner-join) where

ProfileLink1.Profile_ID = Profile1.Profile_ID AND

first GL (inner-join) where

GL.SharedSet_Id = vi_GL_sharedset(iiCompanyId) AND
GL.GL_ID = ProfileLink1.ProfileLinkObject_ID AND

first Profile2 (conditional-join) where

Profile2.Profile_ID = GL.CostCentreProfile_ID AND

each ProfileLink2 (outer-join) where

ProfileLink2.Profile_ID = Profile2.Profile_ID AND
ProfileLink2.SharedSet_ID = vi_COSTCENTRE_sharedsetId

first CostCentre (conditional-join) where

CostCentre.SharedSet_Id = vi_COSTCENTRE_sharedset(iiCompanyId) AND
CostCentre.CostCentre_ID = ProfileLink2.ProfileLinkObject_ID AND

first Profile3 (conditional-join) where

Profile3.Profile_ID = GL.ProjectProfile_ID AND

each ProfileLink3 (outer-join) where

ProfileLink3.Profile_ID = Profile3.Profile_ID AND
ProfileLink3.SharedSet_ID = vi_PROJECT_sharedsetId

first Project (conditional-join) where

Project.SharedSet_Id = vi_PROJECT_sharedset(iiCompanyId) AND
Project.Project_ID = ProfileLink3.ProfileLinkObject_ID AND

query resultset tqDebtorByDebtorInvControlGL

field name	data type	db field	description
tiCostCentre_ID	integer	CostCentre.CostCentre_ID	Record ID
tcCostCentreCode	character	CostCentre.CostCentreCode	Cost Center: A code that identifies the cost center.
tiCostCentreProfile_ID	integer	GL.CostCentreProfile_ID	Link to Profile
tiDebtor_ID	integer	Debtor.Debtor_ID	Record ID
tcDebtorCode	character	Debtor.DebtorCode	A code (maximum eight characters) that identifies a customer. If the code you specify matches an existing supplier code, a warning message displays. You can choose to ignore the warning, and create the record. However, when a supplier and customer share the same code, they must reference the same business relation.
	api annotation:		If you leave the Customer Code field blank, the system automatically generates a number for the record based on the sequence defined in Customer Autonumber Create.
tcGLCode	character	GL.GLCode	A code identifying the GL account.
tiInvControlGLProfile_ID	integer	Debtor.InvControlGLProfile_ID	Control GL Profile (Invoice)
tiProject_ID	integer	Project.Project_ID	Record ID
tcProjectCode	character	Project.ProjectCode	Project
tiProjectProfile_ID	integer	GL.ProjectProfile_ID	Link to Profile
tiSharedSet_ID	integer	ProfileLink2.SharedSet_ID	Link to SharedSet
tiSharedSet_ID2	integer	ProfileLink3.SharedSet_ID	Link to SharedSet
DebtorCustom	character	calculated	custom fields
GLCustom	character	calculated	custom fields
ProfileLink2Custom	character	calculated	custom fields
CostCentreCustom	character	calculated	custom fields
ProfileLink3Custom	character	calculated	custom fields
ProjectCustom	character	calculated	custom fields
ti_sequence	integer	calculated	primary index
tc_rowid	character	calculated	= rowid(Debtor),rowid(Profile1),rowid(ProfileLink1),rowid(GL),rowid(Profile2),rowid(ProfileLink2),rowid(CostCentre),rowid(Profile3),rowid(ProfileLink3),rowid(Project)

Internal usage

QadFinancials

method BDebtor.ApiDefaultCostCentreBaseOnProfileCode
method BDebtor.ApiDefaultProjectBaseOnProfileCode
method BDebtorFinanceCharge.ApplyFilter

Sample code: how to call this query 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 = "BDebtor".
create ttContext.
assign ttContext.propertyName = "methodName"
       ttContext.propertyValue = "DebtorByDebtorInvControlGL".
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/bdebtor.debtorbydebtorinvcontrolgl.i.xsd", ?).
vhParameter = vhInputDS:get-buffer-handle("tParameterI").
vhParameter:buffer-create().

assign vhParameter::icRange = "A"
       vhParameter::icRowid = ""
       vhParameter::iiRownum = 0
       vhParameter::iiNumber = 5 /* Number of records to read */
       vhParameter::icSortColumns = ""
       vhParameter::ilCountOnly = false
       vhParameter::ilForwardRead = true
       vhParameter::iiMaximumBrowseRecordsToCount = 0.

vhParameter = vhInputDS:get-buffer-handle("tFilter").
vhParameter:buffer-create().

assign vhParameter::<field-name-1> = <field-value-1>
       vhParameter::<field-name-2> = <field-value-2>
       ...

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