API query DomainByCompanyForPosting (optimised)

Description

Returns posting records for a domain using the PostingOriginReference and the PostingOriginTransType. t can be optionally run by company.

query filter (table tFilter)

tcBusinessFieldName	tcDataType	tcOperator
iiCompanyId	i
icCompanyCode	c	=
icTransType	c	=
icFromOriginReference	c	>=
icToOriginReference	c	<=
icDomainCode	c	=
tCompany.CompanyCode	c	=,>=,>,<>,<=,<,begins,can-do,matches
tDomains.DomainCode	c	=,>=,>,<>,<=,<,begins,can-do,matches
tPosting.PostingDate	t	=,>=,>,<>,<=,<
tPosting.PostingOriginReference	c	=,>=,>,<>,<=,<,begins,can-do,matches
tPosting.PostingOriginTransType	c	=,>=,>,<>,<=,<,begins,can-do,matches
tPosting.PostingSystemDate	t	=,>=,>,<>,<=,<

Parameters (internal)

iiCompanyId	integer	Company id
icCompanyCode	character	Company code for the company
icTransType	character	The transaction type for the PostingOriginTransType
icFromOriginReference	character	From criteria for the search on PostingOriginReference.
icToOriginReference	character	To criteria for the search on PostingOriginReference.
icDomainCode	character	The domain code to be used by the query

query condition

each Domains where

Domains.DomainCode = icDomainCode

each Company (inner-join) where

Company.Company_Id = iiCompanyId AND
Company.Domain_ID = Domains.Domain_ID AND
Company.CompanyCode = icCompanyCode

each Posting (inner-join) where

Posting.Company_Id = iiCompanyId AND
Posting.Company_ID = Company.Company_ID AND
Posting.PostingOriginTransType = icTransType AND
Posting.PostingOriginReference >= icFromOriginReference AND
Posting.PostingOriginReference <= icToOriginReference

query resultset tqDomainByCompanyForPosting

field name	data type	db field	description
tiCompany_ID	integer	Company.Company_ID	Record ID
tcCompanyCode	character	Company.CompanyCode	Entity Code
tiDomain_ID	integer	Domains.Domain_ID	Record ID
tcDomainCode	character	Domains.DomainCode	Domain
tiPosting_ID	integer	Posting.Posting_ID	Record ID
ttPostingDate	date	Posting.PostingDate	The accounting date on which the journal entry is posted. The posting date must be a valid calendar date and must be within the GL calendar year (PostingYear) and period (PostingPeriod).
tcPostingOriginReference	character	Posting.PostingOriginReference	GL Reference Number. Format is ZZYYMMDD999999 where ZZ = module (IC, SO, WO) YY = Year, MM = Month, DD = Day, 999999 = Running Journal Number. MfgPro equivalent: glt_ref
tcPostingOriginTransType	character	Posting.PostingOriginTransType	System generated code used to identify a transaction (IC for Inventory, WO for Work Orders, SO for Sales Orders, FA for Fixed Assets) MfgPro equivalent: glt_tr_type
ttPostingSystemDate	date	Posting.PostingSystemDate	The system date of the posting corresponding to "PostingDate".
	api annotation:		In Create mode, when Partial Update = yes - this field gets a default value which is the current date of the system.
DomainsCustom	character	calculated	custom fields
CompanyCustom	character	calculated	custom fields
PostingCustom	character	calculated	custom fields
ti_sequence	integer	calculated	primary index
tc_rowid	character	calculated	= rowid(Domains),rowid(Company),rowid(Posting)

Internal usage

unused

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 = "BDomain".
create ttContext.
assign ttContext.propertyName = "methodName"
       ttContext.propertyValue = "DomainByCompanyForPosting".
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/bdomain.domainbycompanyforposting.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.