4 Installing the Application Sample Files

The R12 PIM ConnectorApplication Server sample files are a collection of DSAs that are delivered with EDQP so that you can install them on your Oracle DataLens Server as an example of how you could process your data, using the R12 PIM sample data. These include a set of DSAs, Governance Studio Projects, and AutoBuild application samples. Each of these is described in this chapter.

Installing the R12 PIM Connector Application Server Sample Files

The R12 PIM Connector Application Server sample files are a collection of DSAs that are delivered with EDQP so that you can install them on your Oracle DataLens Server to see how you could process your data.

Install the R12 PIM Connector application server sample files:

On your Oracle DataLens Administration Server system, log in using the administrator user you established when installing the server in preparation to copy files.

Note:

This step does not refer to the Oracle DataLens Administration Server web page.

Copy the MW_HOME\edqp_template1\autodeploy directory that you extracted from the product package to the WebLogic dls_domain directory on your Oracle DataLens Administration Server. By default, these directories are:

On Linux and UNIX: MW_HOME/user_projects/domains/dls_domain/opdq/autodeploy

This automatically deploys (autodeploys) the DSA sample files to your Oracle DataLens Server. The Oracle DataLens Administration Server polls the autodeploy directory every 10 minutes and attempts to autodeploy the DSA sample files that are placed in the autodeploy parent folder.

Log out of the Oracle DataLens Administration Server system.

Wait 10 minutes to ensure that the server samples have been autodeployed.

Log into the Oracle DataLens Server Administration web page.

For more information about these web pages, see Oracle Enterprise Data Quality for Product Data Oracle DataLens Server Administration Guide.

Verify that the AUPIM_ DSAs and AUPIM_Capacitors.project data lens have been autodeployed.

Installing the R12 PIM Connector Application Client Sample Files

Install the R12 PIM Connector application client sample files:

On your Enterprise DQ for Product client system, copy the pdqcms_application_templates folder from the directory on the server where you unzipped the product package to your client Desktop. By default, these directories are:

The preconfigured Governance Studio projects are in the gov_studio_projects folder.

Start the Governance Studio and import each project file (*.ams) in the .../desktop/pdqcms_application_template/gov_studio_projects directory.

For more information about importing, see Oracle Enterprise Data Quality for Product Data Governance Studio Reference Guide. For more information about these projects, see "Preconfigured Governance Studio Projects".

Start the Knowledge Studio and check out the DLS_Import_Template data lens.

Note:

Before using the AutoBuild application, delivered in Services for Excel, the DLS_Import_Template data lens must be checked out from the Oracle DataLens Server. For information about checking data lenses in and out of the Enterprise DQ for Product, see Oracle Enterprise Data Quality for Product DataKnowledge Studio Reference Guide.

Enterprise DQ for Product DSA Sample Files Overview

There are four main categories of samples DSAs that illustrate the overall integration capabilities between the R12 PIM Connector and PIM.

Metadata Import

Semantic Model build from PIM metadata extract.

Alternate Catalog build from PIM metadata extract.

Creating and updating the semantic cache information that is used by the integration services to perform semantic matches.

Creating a new batch from a query of Production data.

Processing interface table batches thorough the Integration Services DSA and updating the results back in the interface tables.

Default Entries in DSAs

All DSAs shipped as part of the Enterprise DQ for Product R12 PIM Connector have default entries that allow for a quick configuration. The following default entries will need to be reviewed and configuration changes may be required. These changes are outlined in the Oracle Enterprise Data Quality for Product Data R12 PIM Connector User's Guide.

Default Database Connection

The default database connection name for all DSAs is, PIM_Connector. This database connection will be pointing to a fictitious server name with a fictitious user and password that will need to be configured as part of the initial server configuration.

Default Data Lens

The default data lens for all DSAs that process items in Enterprise DQ for Product is AUPIM_Capacitors.project. This data lens contains semantic models that work with the Capacitors Item Class category in the Vision Database installed with most R12 PIM Connector systems. A process of testing the system using this sample lens and then updating this data lens with actual customer specific data lenses is documented in Enterprise DQ for Product.

Creating and Updating Semantic Models from PIM Metadata Import

AUPIM_CREATE_SEMANTIC_MODEL

This DSA retrieves the semantic model metadata for a given ICC from the PIM system. AutoBuild uses this semantic model metadata to build a data lens that as a starting point for the cleansing and enrichment process. This DSA is typically run using the Enterprise DQ for Product Services for Excel to create the data needed by the AutoBuild application. This data includes attributes and sample descriptions.

Importing Alternate Catalog Metadata

AUPIM_EXTRACT_ALT_CATALOGS

This DSA is used by the AutoBuild application to import one or more alternate catalogs and create classification schemas inside a selected data lens. This DSA is typically run using the Services for Excel to create the data needed by the AutoBuild application. This data includes the metadata for the Alternate Catalog entered during the run including the id and parent information.

Creating and Updating the Semantic Cache

AUPIM_CREATE_SEMANTIC_CACHE

This DSA is run as a nightly job to update the Semantic Index from Oracle PIM Production data; this semantic index is used for matching and checking for duplicates.

Creating Production Batches

Oracle PIM System users will be able to process data from the interface tables where the source system is an external source system or where the source system is the PIM Data Hub. In order to process data from external source systems, the PIM users will continue to use the existing methods of loading data into the interface tables, usually the Excel import samples or a direct database load. The PIM users will also have a new feature to load data directly from PIM Production tables into the interface tables using a batch creation process that is included in this application.

AUPIM_PROCESS_EXTERNAL_DATA

This DSA is run to insert your external data into interface tables by the Oracle DataLens Server.

AUPIM_CREATE_PRODUCTION_BATCH

This DSA is run to create a new batch of data from the PIM Production tables. This batch will then be processed by the Oracle DataLens Server and updated back into interface tables.

Processing a Batch of Data Thorough the Cleansing and Matching Process

AUPIM_MAIN_PROCESS

This DSA is run as the main DSA from the DGS. This will take an Oracle PIM batch and clean/standardize/classify/extract attrs/etc from the description and load it into the DGS for further processing. The batches are populated with data from external systems or as pulls from the PIM Production data.

Secondary Data Service Applications for Reprocess and Apply

Secondary DSAs called by the main process as previously described that Reprocess or Apply the changes to the interface table.

DSA Name

Notes

AUPIM_REPROCESS

Reprocesses rows from the following outputs of the Main Process DSA:

Dups within Batch

Match on Mfg Part

Match Against PIM

Items for Enrichment

Exceptions

Based on specific process flags, this DSA will reroute the items back to the Governance Studio Main project, or will update the rows back in the interface tables with the correct match_status.

AUPIM_APPLY_RESULTS

Applies rows from the Ready for Load step and updates all pertinent fields in the interface tables.

AUPIM_EXTRACT_ALT_CATALOGS

Applies rows from the Alternate Catalog Review and updates all pertinent fields related to Alternate Catalogs

AUPIM_SET_BATCH_TO_ACTIVE

Updated the batch status from Pending to Active so that the PIM user can go into the Import Workbench UI and invoke the import process.

Preconfigured Governance Studio Projects

Enterprise DQ for Product R12 PIM Connector includes the following Governance Studio project. This project is used by users to create batch specific Governance Studio projects to process interface batch data. The process is documented in the Oracle Enterprise Data Quality for Product Data R12 PIM Connector User's Guide.

AUPIM_Cleansing_and_Matching

The main process that runs the main Data Service Applications that cleanse and match the items in the interface tables.

AUPIM_Create_Production_Batch

The process that automatically creates a new Import Workbench batch from a set of production items.

AUPIM_CREATE_SEMANTIC_CACHE

This administrative process can be run thorough the Governance Studio or can be scheduled to run as a nightly or weekly process. This should be run by System Administrators when not batches are being processed.

For information about how these project samples are used, see Oracle Enterprise Data Quality for Product Data R12 PIM Connector User's Guide.

Preconfigured Excel Spreadsheet Sample

The Enterprise DQ for Product R12 PIM Connector includes the following Excel workbook for use with the AutoBuild application. This preconfigured workbook contain VBA applications that are used to export PIM metadata and to create a set of semantic models with one or more associated alternate catalogs for use in cleansing and matching your specific product data.

CapacitorsExternalBatchTestInput.xlsx

Use this workbook to test your input data prior to executing a PIM external batch load.

For information about how the AutoBuild sample workbook is used to create a data lens and add an alternate catalog to the data lens, see Oracle Enterprise Data Quality for Product Data R12 PIM Connector User's Guide.