Pages

OracleEBSpro is purely for knowledge sharing and learning purpose, with the main focus on Oracle E-Business Suite Product and other related Oracle Technologies.

I'm NOT responsible for any damages in whatever form caused by the usage of the content of this blog.

I share my Oracle knowledge through this blog. All my posts in this blog are based on my experience, reading oracle websites, books, forums and other blogs. I invite people to read and suggest ways to improve this blog.


Thursday, March 12, 2015

Data Quality Management(DQM) in TCA

In this article I will touch base upon the data quality management feature of TCA. This article also contains a link to a DQM presentation that will compliment the Q & A in this article. A combination of this article and thepowerpoint presentation should help you understand the basics of DQM [ Data Quality Management ] in Oracle TCA. 
Is DQM a part of TCA?
Yes it is, the setup can be done using responsibility named "Trading Community Manager".

What are the setup steps for DQM?
Note:
 These steps will get clearer once you finish reading this article + PowerPoint Presentation
Here are the steps :-
1. Identify the Attributes that you wish to use for Search and Scoring.
2. Define custom attributes for those columns on which you would like to either search or score, but those columns are not in TCA tables.
3. Assign transformation to each column. Define custom transformation rules if need be, by using PL/SQL 
4. Decide which transformed values are used for Searching and which transformed values are to be used for [both] Searching and/or just Scoring
The attribute transformations that you wish to search upon, will have "Acquisition" checkbox set to Yes.
5. Define your match rules. You can define as many match rules
6. In Match rules, you specify how the users search criteria[values being used by users] are transformed prior to acquisition.
7. Define scoring/ranking rules
8. Run the staging process.


Give me some examples where DQM is used?

Lets say your organization has 50000 employees and a person named john smith gets recruited for a job. HRMS team must know whether this John Smith has had any kind of interaction with the organization in past. Ideally if John Smith has had any kind of interaction with the company in past, then there must exist an entry for this record in TCA. In this case, HR must ensure that HRMS record can be made to point to existing TCA record. By doing so a 360 degree view of the employee be maintained in your organization.


So DQM is about being able to identify a duplicate entry in your system.
Correct, and this I made possible by applying some transformations as you will see in the presentation.


Is DQM only applicable at party level in TCA?
No way, DQM can be made to work at party address level & contact level too.


Isn't finding duplicates as simple as matching the social security number or national insurance number?
Correct, but say if your payables department wants to pay expenses to a third party for their interview travel expenses, then payables team will not have access to SSN or "NI Number". In this case, they rely upon other attributes of the person to find duplicates.


Ah, it means DQM will not be used merely by HRMS department or the Receivables department?
Certainly not, in an efficient organization, any department that registers a party into oracle apps must have access to DQM functionality.


But what if Payables team wants to use DQM, but with different set of search and ranking criteria altogether?
This is a very common requirement. Hence in this case Oracle lets you define multiple "Match Rules" in DQM.


Fine, we can define different Match Rules, but how will we enforce Payables users to use say "Match Rule 1" and HRMS users to use say "Match Rule 2"?

You can differentiate such requirements by creating different DQM search responsibilities. For each such responsibility you will assign profile option "DQM Match Rule for Search" to respective value.
In case you do not wish to have different responsibilities, though recommended, you can set this profile option at user level too.


But DQM searches for duplication in TCA tables, however "NI Number" and SSN [Social Security] are stored in HRMS tables. How will DQM search data in other modules?
You can define custom attributes in DQM. Custom attribute is nothing but a pseudo column which uses pl/sql to return the value,in this case from per_people_f


Does DQM search data within TCA tables?
Well, after defining rules for DQM setup, you run a concurrent program named "DQM Staging Program". This process de-normalises TCA data into staging tables. Transformed values for columns are stored in staging table. This will be clear when you go through the PowerPoint presentation.


What are the staging tables?
There are a list staging tables where DQM Transformed data is stored. Each transformed value resides in a different column. The transformed values used for Acquisition are indexed by Oracle.
The list of tables are
HZ_STAGED_CONTACTS
HZ_STAGED_CONTACT_POINTS
HZ_STAGED_PARTIES
HZ_STAGED_PARTY_SITES



What is event "oracle.apps.ar.hz.DQM.realtimesync" which keeps on firing when employee records or the TCA records are modified?
As you know, the TCA data is transformed and de-normalized into staging tables. Any changes to the TCA data must update the DQM staging tables, so that changes can be searched upon in DQM. The subscription of this event reads the pending entries in staging interface table HZ_DQM_SYNC_INTERFACE and transfers them to DQM staging tables after having applied the transformations.

NOTE: Although the event name is realtimesync, Oracle has disabled the realtime option for this event subscription. Hence synchronization with DQM staging tables happens in deferred mode only.


Here is the link to DQM presentation
Link for DQM and TCA presentation 

References:
http://oracle.anilpassi.com/dqm-tca.html

Thursday, March 5, 2015

BI Publisher Bursting: Data Definition sample XML file

<?xml version="1.0"?>
<dataTemplate name="XXCOMPSOL" description="Concurrent Program Name" version="1.0" defaultPackage="XXCOMP_CUSTOMER_TOOL_PKG" >
    <!--
    Modification Log
    =================================================================================================================================================
    Version  Date          Modified By             Ticket    Comments
    =======  ============  ======================  =======   ========================================================================================
    1.0      24-DEC-2013   First Last Name             Initial Development
    =================================================================================================================================================
    -->
    <properties>
        <property name="xml_tag_case" value="upper"/>
        <property name="db_fetch_size"/>
        <property name="scalable_mode"/>
        <property name="include_rowsettag"/>
        <property name="debug_mode"/>
    </properties>
 
    <parameters>
        <parameter name="P_ORDER_HEADER_ID"       dataType="number"    />
        <parameter name="P_SEND_EMAIL"            dataType="character" />
        <parameter name="P_EMAIL_BCC_01"          dataType="character" />
        <parameter name="P_CTL_TBL_RETAIN_DAYS"   dataType="number"    />
    </parameters>
 
    <dataTrigger name="beforeReport" source="XXCOMP_CUSTOMER_TOOL_PKG.BEFORE_REPORT"/>
    <dataTrigger name="afterReport"  source="XXCOMP_CUSTOMER_TOOL_PKG.AFTER_REPORT"/>
 
    <dataQuery>
        <sqlStatement name="Q_MAIN">
            <![CDATA[ select *
           from XXCOMP_CUSTOMER_TOOL_STG
  where CREATED_BY_REQ_ID = :LP_REQUEST_ID
]]>
        </sqlStatement>
    </dataQuery>
 
    <dataStructure>
        <group name="Q_MAIN_HDR" source="Q_MAIN" groupFilter="XXCOMP_CUSTOMER_TOOL_PKG.FLAG_AS_NOTIFIED(:HEADER_ID)">
            <element name="HEADER_ID"          value="HEADER_ID"          />
            <element name="SHIP_TO_CONT_EMAIL" value="SHIP_TO_CONT_EMAIL" />
            <element name="EMAIL_TO"           value="EMAIL_TO"           />
            <element name="EMAIL_SUBJ"         value="EMAIL_SUBJ"         />
            <element name="EMAIL_BCC"          value="EMAIL_BCC"          />
            <element name="IMG_URL_PORT"       value="IMG_URL_PORT"       />
<element name="EMAIL_BODY_1"         value="EMAIL_BODY_1"        />
<element name="EMAIL_BODY_2"         value="EMAIL_BODY_2"        />
<element name="EMAIL_BODY_3"         value="EMAIL_BODY_3"        />
<element name="EMAIL_BODY_4"         value="EMAIL_BODY_4"        />
            <group name="Q_MAIN" source="Q_MAIN">
                <element name="SOLD_TO_CUST"          value="SOLD_TO_CUST"          />
                <element name="END_CUST"              value="END_CUST"              />
                <element name="CUST_PO_NUMBER"        value="CUST_PO_NUMBER"        />
                <element name="ORDER_NUMBER"          value="ORDER_NUMBER"          />
                <element name="ORDERED_DATE"          value="ORDERED_DATE"          />
                <element name="SEGMENT1"              value="SEGMENT1"              />
                <element name="DESCRIPTION"           value="DESCRIPTION"           />
                <element name="ORDERED_QUANTITY"      value="ORDERED_QUANTITY"      />
                <element name="SOLUTION_NAME"         value="SOLUTION_NAME"         />
<element name="SOLUTION_TYPE"         value="SOLUTION_TYPE"         />
                <element name="CONTRACT_DURATION"     value="CONTRACT_DURATION"     />
                <element name="CONTRACT_DURATION_WORDS"     value="CONTRACT_DURATION_WORDS"     />
                <element name="CONTRACT_DURATION_UOM" value="CONTRACT_DURATION_UOM" />
<element name="SERVICE_START_DATE" value="SERVICE_START_DATE" />
<element name="SERVICE_END_DATE" value="SERVICE_END_DATE" />
            </group>
        </group>
    </dataStructure>
 
</dataTemplate>