Demand Signal Repository

This chapter covers the following topics:

Demand Signal Repository (DSR) Implementation

The following install instructions apply to installing Demand Signal Repository as part of an E-Business Suite implementation or for upgrading DSR from an earlier release. 

Prerequisites

Make sure the following prerequisites are met before installing Demand Signal Repository:

Setting Up Oracle Data Integrator (ODI)

This section contains the activities required to set up ODI.

Copy the DSR ODI XML Files to a Temporary Folder

Copy the DSR ODI XML files from the APPL_TOP of your environment to a folder that will be used to import the ODI objects. This folder must be accessible from the ODI client you will use to perform the import.

DSR ODI XML files are located in the APPL_TOP folders:

Import the DSR Project Objects in the ODI Designer

Import all XML files with prefixes of FOLD_% from the ODI Studio.

Importing the Folders

  1. Select the Designer tab.

  2. From the Connect Manager button, select Import > Smart Import.

  3. In the file selection box, click the search button, navigate to the folder where the XML files from ddr/patch/115/odi/US/project/DDR were downloaded, and select the file to import in the list above.

    Leave the response file empty.

  4. Click Next.

  5. Accept all defaults on the Import Actions screen, and click Next.

  6. On the Summary screen, click Finish to import the object.

  7. Verify that the folders were imported correctly.

Import all XML files with the prefix of KM_% from the ODI Studio.

Importing the Knowledge Modules

  1. Select the Designer tab.

  2. From the Connect Manager button, select Import >Smart Import.

  3. In the file selection box, click the search button, navigate to the folder where the XML files from ddr/patch/115/odi/US/project/DDR were downloaded, and select the file to import in the list above.

    Leave the response file empty.

  4. Click Next.

  5. Accept all defaults on the Import Actions screen, and click Next.

  6. On the Summary screen, click Finish to import the object.

  7. Verify that the knowledge modules were imported correctly.

Import all XML files with the prefix of VAR_% from the ODI Studio.

Importing the Variables

  1. Select the Designer tab.

  2. From the Connect Manager button, select Import >Smart Import.

  3. In the file selection box, click the search button, navigate to the folder where the XML files from ddr/patch/115/odi/US/project/DDR were downloaded, and select the file to import in the list above.

    Leave the response file empty.

  4. Click Next.

  5. Accept all defaults on the Import Actions screen, and click Next.

  6. On the Summary screen, click Finish to import the object.

  7. Verify that the variables were imported correctly.

Importing the DSR Model in the Designer

Perform the following procedure from ODI Studio to import the DSR Model.

  1. Select the Designer tab.

  2. From the Connect Manager button, select Import >Smart Import.

  3. In the file selection box, click the search button, navigate to the folder where the XML files from ddr/patch/115/odi/US/project/model were downloaded, and select the MFOL_DDR.xml.

    Leave the response file empty.

  4. Click Next.

  5. Accept all defaults on the Import Actions screen, and click Next.

  6. On the Summary screen, click Finish to import the object.

  7. Verify that the model was imported correctly.

Importing the Topology Objects

Import the topology objects in the following order:

  1. LSC_DDR_RMS_XML_RETLDLPRD.xml

  2. LSC_DDR_TDLINX_FILE.xml

  3. LSC_DDR_ORACLE_DDR.xml

  4. LSC_DDR_ORACLE_APPS.xml

  5. CONN_DDR_RMS_XML_DATASERVER.xml

  6. CONN_DDR_TDLINX_FILE.xml

  7. CONN_DDR_ORACLE_DATASERVER.xml

  8. CONT_DDR_CONTEXT.xml

Perform the following procedure from ODI Studio to import the topology objects.

  1. Select the Topology tab.

  2. From the Connect Manager button, select Import >Smart Import.

  3. In the file selection box, click the search button, navigate to the folder where the XML files from ddr/patch/115/odi/US/master were downloaded, and select the file to import in the order above.

    Leave the response file empty.

  4. Click Next.

  5. Accept all defaults on the Import Actions screen, and click Next.

  6. On the Summary screen, click Finish to import the object.

  7. Verify that all the objects were imported correctly.

Configuring the Physical Architecture in Topology Manager

This section provides procedures for configuring the Oracle dataserver and TDLINX.

Configuring the Oracle Dataserver

Perform the following procedure to configure Oracle dataserver.

  1. On the Physical Architecture tab under Oracle, open the “DDR_ORACLE_DATASERVER” object.

  2. On the JDBC subtab, change the JDBC URL to point to the DSR database.

  3. On the Definition subtab, change the password for the apps user.

  4. Save the changes.

  5. Click Test Connection and make sure the connection is successful.

    the picture is described in the document text

Configuring TDLINX

Perform the following procedure to configure TDLINX.

  1. On the Physical Architecture tab under File, expand the “DDR_TDLINX_FILE” object and open the DDR_TDLINX_FILE.<FILE DIRECTORY> object.

  2. On the Definition subtab, change the Directory (Schema) and Directory (Work Schema) to point to the location where the TDLINX file will reside on the server. Only provide the directory path; do not include the file name in the path.

  3. Save the changes.

    the picture is described in the document text

Configuring the Context and Logical Architecture in Topology Manager

Perform the following procedure to configure the context and logical architecture in Topology Manager.

On the Contexts tab, verify the following on the Schemas subtab for the “"DDR_CONTEXT":

the picture is described in the document text

Executing Scenarios

Perform the following procedure to execute scenarios.

  1. Right-click the scenario object and select Execute.

  2. Select “DDR_CONTEXT” for the context, you can leave the defaults for the other fields, and click ok.

  3. For any execution parameter you wish to change, uncheck the "Last Value" check box, and then enter a new value in the Value box. You must exit this text field for the value to save your change.

  4. Click OK.

  5. Monitor the execution on the Operator tab.

Setting Up Oracle Business Intelligence Enterprise Edition (OBIEE)

This section provides the following instructions:

Setting Up the Oracle Business Intelligence Enterprise Edition Server

Files ddrpd.zip and ddrwebcat.zip contain the following files for use with the Oracle Business Intelligence Suite Enterprise Edition 11.1.1.6:

  1. Copy these ZIP files (ddrrpd.zip, ddrwebcat.zip) from the obiee (APPL_TOP/ddr/patch/115/obiee) directory.

  2. Unzip ddrrpd.zip to display DSR_Reports.rpd.

  3. Open the DSR_Reports.rpd file in Oracle Business Administration Tool using Administrator1 as the password.

  4. In the physical layer, change the username/password for the database connection in DDR connection Pool.

  5. Add entry for the database in the correct TNSNAMES.ora file.

Setting Up the Oracle Business Intelligence Enterprise Edition Presentation Services

Perform the following procedure to set up the Oracle Business Intelligence Enterprise Edition Presentation Services.

  1. Change the directory to the catalog directory for the Oracle Business Intelligence Enterprise Edition Presentation server. Typically $OBIEE_HOME/instances/instance1/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1.

  2. Rename or delete the existing catalog directory.

  3. Unzip ddrwebcat.zip to get DSR_Reports catalog directory.

Configuring the Oracle Business Intelligence Enterprise Edition Infrastructure

Perform the following procedure to configure the Oracle Business Intelligence Enterprise Edition Infrastructure.

  1. Open the Enterprise Manager. The default URL is http://localhost:7001/em.

  2. Expand the Business Intelligence Node and select the application setup in the obiee installation. The default is coreapplication.

  3. Open the Deployment Tab and then select the Repository subtab.

  4. Click the Lock and Edit Configuration button.

  5. In the Upload BI Server Repository section, click the browse button.

  6. Select the DSR_Reports.rpd that you configured with the Administrator tool to connect to your database.

  7. Enter Administrator1 in both password fields.

  8. In the BI Presentation Catalog section, edit the path to include the DSR_Reports directory that was created by unzipping the ddrwebcat.zip.

    The path appears similar to the example below:

    $ORACLE_INSTANCE/bifoundation/OracleBIPresentationServicesComponent/$COMPONENT_NAME/catalog/DSR_Reports

  9. Click the Apply button.

  10. Click the Activate Changes button.

  11. Click the Restart Services to Activate Changes button. The Overview tab appears.

  12. On the Overview tab, click the Restart button to restart the services to complete the configuration.

Setting Up Oracle Business Intelligence Enterprise Translations

Perform this setup only if you are planning to use translated OBIEE UI. This process uses the "transx" utility that is part of the Oracle DB install.

  1. Configure Transx using the instructions provided in the links below:

    The OBIEE translated files are shipped under APPL_TOP/ddr/patch/115/obiee directory and are named as ddr_obiee_<language id>.zip. For example, ddr_obiee_fr.zip.

  2. Unzip the language ZIP file to be used to a local drive (for example c:\ drive). The DLF files are extracted into the C:\ddr\OracleBI\Repository directory.

  3. Import the files into the DB by executing the following transx command:

    transx "hostname:port:sid" username password filename

    For example, to load the Spanish translation version you use the following:

    c:\transx rws60147rems:1524:mz1dv220 apps apps ddr_es.dlf
  4. Verify that the seed data is uploaded correctly in DDR_TRANSLATED_MESSAGE by using the following query:

    SELECT Count(*)
    FROM DDR_TRANSLATED_MESSAGE
    GROUP BY lang_id='<language id>'
  5. Copy the file sharedcaptions.xml from ddr\OracleBIData\l_<language id>\ into $OBIEE_HOME\instances/obieedb/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1/msgdb/l_<language id>\captions. If the directory "l_<language id> is not there, first create subdirectory l_<language id>\captions under $OBIEE_HOME\instances/obieedb/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1/msgdb directory.

  6. Restart the BI servers to verify the translation.

  7. To use the translated UI, select an appropriate language and then enter user id/password when you log in to Presentation Service.

Setting Up the Exception Management Dashboard Feature

Perform the set up described in this section only if you plan to use the exception management dashboard feature. Setup steps assume the use of bundled WebLogic server.

  1. Get the following EAR file:

    APPL_TOP/ddr/patch/115/ear/DDRExceptionHandler.ear

  2. Log in to Admin Console.

  3. After logging in, navigate to Services > Data Sources.

    the picture is described in the document text

  4. Click Lock & Edit and New > Generic Data Source.

    the picture is described in the document text

  5. Enter the following information:

    • Name: DDRDS

    • JNDI Name: jdbc/DDRDS

    Enter the other connection details.

  6. Select the targets for this connection.

    the picture is described in the document text

  7. Click Finish to create the connection, and then click the Activate Changes button.

  8. Navigate to Deployments > Install.

    the picture is described in the document text

  9. Next, either pick up the EAR file from the server file location, or if you have saved the EAR file in your local, click "Upload your file" and choose the EAR file.

  10. Assign the Targeting style of "Install as an Application" and choose the target server to deploy. A default name appears.

  11. Click Finish.

  12. Click Activate Changes.

  13. Expand the deployed app and click the Web Service Name.

  14. In this settings page, click the expand icon next to the Web Service Name.

  15. Right-click on the WSDL link and copy it. This is required in the next step.

    the picture is described in the document text

Configuring a Web Service in OBIEE

This section contains information on the followings procedures:

Adding an Action

Perform the following to add an action.

  1. Select the New button and click Action.

    the picture is described in the document text

  2. Select Invoke a Web Service.

    the picture is described in the document text

    The Web Service Operation dialog appears

    the picture is described in the document text

  3. Paste WSDL link copied from the last step of "Setting Up the Exception Management Dashboard Feature", select the HandleExceptions, and click OK.

    The parameter configuration screen appears.

    the picture is described in the document text

  4. Enter the following Prompt values:

    • Arg0 = Report

    • Arg1 = Exception Type

    • Arg2 = Exception Source Code

    • Arg3 = Date Offset

    • Arg4 = User

      Select Session Variable and Enter USER. Select Hidden and Fixed options.

    • Arg5 = Debug On

      Select Hidden and Fixed options.

    • Arg6 = Debug File Location

      Select Hidden and Fixed options.

    • Arg7 = Debug Log Level

      Select Hidden and Fixed options.

  5. Click Save Action, and select the location and Name for the action

Adding a New Agent

Perform the following procedure to add a new agent.

  1. Select the New button and click Agent.

    the picture is described in the document text

  2. Navigate to the Delivery Content tab and select the Analysis (Report) that the Agent will run.

    the picture is described in the document text

  3. On the Actions tab, in the Agent Condition True or No Condition Exists box, select the Add existing action button, and select the action you just added to configure it for this agent.

    the picture is described in the document text

  4. Enter the following values:

    • Report - Select XML from drop down and select Delivery Content.

    • Exception Type - Select the Exception type that you are running with this agent.

    • Exception Source Code - Select the Exception source code that you are running with this agent.

    • Date Offset - Select or enter number of days to go back and delete previous Exceptions.

      the picture is described in the document text

  5. Click OK and save the agent.

Setting Up Web Services

Demand Signal Repository provides a set of Web services that can be optionally deployed. Implementers can use these Web services to automate their processes or perform integration with third party systems.

The following procedure assume you are using the bundled WebLogic server.

  1. Get the following EAR file:

    APPL_TOP/ddr/patch/115/ear/ddrwsfal.ear

  2. Log in to Admin Console.

  3. After logging in, navigate to Services > Data Sources.

  4. Click Lock & Edit, and select New > Generic Data Source.

  5. Enter the following:

    • Name: DDRDS

    • JNDI Name: jdbc/DDRDS

    Enter other connection details.

  6. Select the targets for this connection.

  7. Click Finish to create the connection, and then click the Activate Changes button.

  8. Navigate to Deployments > Install.

  9. Next, either pick up the EAR file from the server file location, or if you have saved the EAR file in your local, click "Upload your file" and choose the EAR file.

  10. Select "Install as an Application" as the targeting style, and choose the target server to deploy. A default name appears.

  11. Click Finish.

  12. Click the Activate Changes button.

Setting Up Demand Signal Repository - Demantra Integration

If you want to use Oracle Demantra Release 7.2 with DSR, apply the script msddemcrwf3.sql to create the series, integration profiles and workflows required for the integration.

The SQL file is not executed during patch application. It must be applied manually.

The SQL file location is: $MSD_TOP/patch/115/sql/msddemcrwf3.sql.

Case 1: DSR (APS) and Demantra are on the same database instance.

  1. Make sure that the profile 'MSD_DEM: Schema' is set to the correct Demantra Schema name.

  2. Make sure the Demantra installation is not in use for any activity.

  3. Apply the SQL File msddemcrwf3.sql in the APPS schema.

  4. Restart the Demantra Application Web Server.

  5. Create a synonym named 'BIIO_DSR_SALES_DATA' in the APPS schema of the instance where DSR is installed.

    This synonym should point to the table 'BIIO_DSR_SALES_DATA' in the Demantra Schema. For example, if the Demantra schema name is 'DMTRA_TEMPLATE', then create the synonym by running the following command in the APPS schema:

    CREATE OR REPLACE SYNONYM BIIO_DSR_SALES_DATA FOR DMTRA_TEMPLATE.BIIO_DSR_SALES_DATA

Case 2: Demantra is on separate database instance.

  1. Create the package MSD_DEM_DEMANTRA_UTILITIES in the Demantra schema by applying the following files:

    • $MSD_TOP/patch/115/sql/msddemdus.pls - Package Specification

    • $MSD_TOP/patch/115/sql/msddemdub.pls - Package Body

  2. Make sure the Demantra installation is not in use for any activity.

  3. Apply the SQL File msddemcrwf3.sql in the Demantra schema.

  4. Restart the Demantra Application Web Server.

  5. Create a synonym named 'BIIO_DSR_SALES_DATA' in the APPS schema of the instance where DSR is installed. This synonym should point to the table 'BIIO_DSR_SALES_DATA' in the Demantra Schema.

Setting up Demand Signal Repository - Retail Merchandise System (RMS) Integration

Follow instructions in this section only if you are planning to implement Demand Signal Repository integration with Retail Merchandising System (RMS).

Copy the DSR RMS Integration XML Files to a Temporary Folder

This topic provides information about copying ODI files and the class and DTD files.

Copying ODI Files

Copy the DSR RMS Integration ODI XML files from the APPL_TOP of your environment to a folder that will be used to import the ODI objects. This folder must be accessible from the ODI client you plan to use to perform the import.

DSR RMS Integration ODI XML files are in the following APPL_TOP folders:

Copying Class and DTD Files

Copy the ddrrms.zip file from the APPL_TOP of your environment to a temporary folder and unzip. Location of this zip is ddr/patch/115/odi/US/project/DDR_RMS

The following files are extracted:

Using ODI Objects in the RMS Integration

The following ODI objects are used in the RMS integration:

Configuring the User Parameters in DSR Lookups

Configure the following parameters in the DSR Lookup table DDR_R_LKUP_MST.

DDR_R_LKUP_MST Table

The parameters specified below in the LKUP_CD column need to be configured and set up by the user. Sample values appear in the table below.

MFG_ORG_CD LKUP_TYP_CD LKUP_CD LKUP_NAME LKUP_DESC
-1 SYS_PARAM RETL_DSR_SRC_DIR ODI_HOME/retldsr/source The directory where the RMS EDIDLPRD File should be kept for upload to DSR.
-1 SYS_PARAM RETL_DSR_SRC_FILENAME EDIDLPRD.dat The RMS EDIDLPRD File name that needs to be loaded into Oracle DSR.
-1 SYS_PARAM RETL_DSR_SUCCESS_DIR ODI_HOME/retldsr/sucess The directory where the RMS EDIDLPRD file should be moved after the successful upload.
-1 SYS_PARAM RETL_DSR_FAILED_DIR ODI_HOME/retldsr/failed The directory where the RMS EDIDLPRD File should be moved after the upload fails.
-1 SYS_PARAM RETL_DSR_TO_ADDR nimit.mankodi@oracle.com The admin e-mail address where the error or success notification should be sent.
-1 SYS_PARAM RETL_DSR_FM_ADDR retl-dsr@integrator.com The Integrator admin e-mail from which the error or success notification should be sent.
-1 SYS_PARAM RETL_DSR_MAIL_SERVER Mail.oracle.com Mail Server that will send the ODI email notifications.
-1 SYS_PARAM RETL_DSR_CLASS_DIR ODI_HOME/retldsr/source The directory where the DLPRDFileToXMLConverter.class File is located.

Creating the Directories Defined in the DDR_R_LKUP_MST Table

Create the directories that were defined to be the source, success, and failure directories.

Copying the Class and DTD Files

Perform the following procedure to copy the class and DTD files to the appropriate folders.

  1. Copy the class file DLPRDFileToXMLConverter.class from the folder where the ZIP file was originally downloaded to the directory specified in the DDR_R_LKUP_MST table.

  2. Copy the DTD file RETLDLPRD.dtd from the folder where the ZIP file was downloaded to the source directory specified in the DDR_R_LKUP_MST table.

Importing the DSR - RMS Project Objects in the ODI Designer

This section provides procedures for importing DSR - RMS project objects using ODI Designer.

Import the DSR - RMS Project Objects in the ODI Designer

Import all XML files with prefixes of FOLD_% from the ODI Studio.

Importing the Folders

  1. Select the Designer tab.

  2. From the Connect Manager button, select Import > Smart Import.

  3. In the file selection box, click the search button and navigate to the folder where the XML files from ddr/patch/115/odi/US/project/DDR_RMS were downloaded and select the file to import in the list above.

    Leave the response file empty.

  4. Click Next.

  5. Accept all defaults on the Import Actions screen and click Next.

  6. On the Summary screen, click Finish to import the object.

  7. Verify that the folders were imported correctly.

Import all XML files with the prefix of KM_%. from the ODI Studio

Importing the Knowledge Modules

  1. Select the Designer tab.

  2. From the Connect Manager button select Import >Smart Import.

  3. In the file selection box, click the search button and navigate to the folder where the XML files from ddr/patch/115/odi/US/project/DDR_RMS were downloaded and select the file to import in the list above.

    Leave the response file empty.

  4. Click Next.

  5. Accept all defaults on the Import Actions screen and click Next.

  6. On the Summary screen, click Finish to import the object.

  7. Verify that the knowledge modules were imported correctly.

Import all XML files with the prefix of VAR_% from the ODI Studio.

Importing the Variables

  1. Select the Designer tab.

  2. From the Connect Manager button select Import >Smart Import.

  3. In the file selection box, click the search button and navigate to the folder where the XML files from ddr/patch/115/odi/US/project/DDR_RMS were downloaded and select the file to import in the list above.

    Leave the response file empty.

  4. Click Next.

  5. Accept all defaults on the Import Actions screen and click Next.

  6. On the Summary screen, click Finish to import the object.

  7. Verify that the Variables were imported correctly.

Importing the Topology Objects

Import the topology objects in the following order:

  1. LSC_DDR_RMS_XML_RETLDLPRD.xml

  2. CONN_DDR_RMS_XML_DATASERVER.xml

Perform the following procedures from the ODI Studio.

  1. Select the Topology tab.

  2. From the Connect Manager button select Import >Smart Import.

  3. In the file selection box, click the search button and navigate to the folder where the XML files from ddr/patch/115/odi/US/master were downloaded and select the file to import in the order above.

    Leave the response file empty.

  4. Click Next.

  5. Accept all defaults on the Import Actions screen, and click Next.

  6. On the Summary screen, click Finish to import the object.

  7. Verify that all the objects were imported correctly.

Configuring the Physical Architecture in Topology Manager

Use the following procedure to configure the RMS XML Dataserver.

Configuring the RMS XML Datasever

  1. On the Physical Architecture tab under XML, open the “DDR_RMS_XML_DATASERVER” object.

  2. On the JDBC subtab, change the JDBC URL to point to the file RETLDLPRD.dtd in the source directory created.

  3. Save your changes.

  4. Click Test Connection and make sure the connection is successful.

    Example: jdbc:snps:xml?d=\\server\rms\source\RETLDLPRD.dtd&s=RETLDLPRD

    the picture is described in the document text

Configuring the Context and Logical Architecture in Topology Manager

Use the following procedure to configure the context and logical architecture for a DSR-RMS integration in the Topology Manager.

On the Contexts tab, verify the Schemas tab for the "DDR_CONTEXT".

Logical Schema "DDR_RMS_XML_RETLDLPRD" = "DDR_RMS_XML_DATASERVER.RETLDLPRD" Physical Schema

the picture is described in the document text

Copying the EDIDLPRD.dat File

Copy the EDIDLPRD.dat file to the location as specified in RETL_DSR_SRC_DIR lookup.

the picture is described in the document text

Executing the Scenario

Perform the following procedure to execute the scenario for a DSR-RMS integration.

  1. Right-click the LOAD_RETL_ITEMS_TO_DSR_PKG object from the Operator on the Scenario tab and select Execute.

  2. Uncheck the "Last Value" check box and then enter a value for RTL_ORG_CD in the Value box. You must exit this text field for the value to be saved.

  3. Click OK.

  4. Select the Sessions List tab to check the status of the execution.