Business services can be accessed
from outside
the application via XAI inbound service, or
from within
the application via scripting, Java, or info zones. Below is an example to what you can do with a business service wrapping an info zone.
Generally, a business service is specific to a page service program which references a maintenance object, that means one business service = one service program = one maintenance object.
There have been quite a few threads in
the forum around this topic where
the business service is misconstrued to perform services only on a single object, for e.g. only for CILCSVAP - SA Page Maintenance, CILCPRMP - Premise Page Maintenance, CILCACCP - Account Page Maintenance, etc.
So what do you do when you want to retrieve some "non-persistent"
field or information associated with some object/entity? Consider few business requirements:
· Retrieve all
the field activities associated to an account.
· Retrieve
the last bill date for an account.
· Retrieve next bill date for an account.
It can be as simple as described below, for this post, we'll use
the first scenario - Retrieve all
the field activities associated to an account. To achieve this we'll have to do
the following:
Step 1: Define an info zone
(A basic Zone of type F1-DE-SINGLE - Info Data Explorer - Single SQL has been used; you can use F1-DE - Info Data Explorer - Multiple SQLs for more complex scenarios)
Parameter Description
Value To Enter
User Filter 1
F1
Initial Display Columns
C1 C2 C3
SQL Condition
F1
SQL Statement
SELECT
FA_ID, FA_STATUS_FLG, CRE_DTTM
FROM
CI_FA
WHERE
SP_ID IN
(SELECT SP_ID
FROM CI_SA_SP
WHERE
SA_ID IN
(SELECT SA_ID
FROM CI_SA
WHERE
ACCT_ID = :F1))
Column 1
source=SQLCOL sqlcol=FA_ID
Column 2
source=SQLCOL sqlcol=FA_STATUS_FLG
Column 3
type=TIME source=SQLCOL sqlcol=CRE_DTTM order=DESC
Note: Zone code specified was 'CM_ACCTFA'
Step 2: Define a business service
Create a business service linked to 'Service Name' FWLZDEXP - Data Explorer.
Schema will look like this:
<schema>
<zoneCd mapField="ZONE_CD" default="CM_ACCTFA"/>
<accountId mapField="F1_VALUE"/>
<rowCount mapField="ROW_CNT"/>
<result type="group">
<selectList type="list" mapList="DE">
<faId mapField="COL_VALUE">
<row mapList="DE_VAL">
<SEQNO is="1"/>
</row>
</faId>
<status mapField="COL_VALUE">
<row mapList="DE_VAL">
<SEQNO is="2"/>
</row>
</status>
<createdDateTime mapField="COL_VALUE">
<row mapList="DE_VAL">
<SEQNO is="3"/>
</row>
</createdDateTime>
</selectList>
</result>
</schema>
What's next? As mentioned above, you can invoke this business service
from an outside application via XAI inbound service or call this business service
from within a script.
Step 3: Create a XAI inbound service for above created business service
Step 4: Test
the inbound service
Go to XAI Submission and test
the newly created service
<RXS_AccountFA>
<accountId>5922116763</accountId>
</RXS_AccountFA>
