43 Oracle Real-Time Decisions

This chapter describes issues associated with Oracle Real-Time Decisions (Oracle RTD), including issues related to Decision Studio, integration, and security.

This chapter includes the following topics:

Depending on your Oracle Fusion Middleware implementation, some information in other chapters of this document might also be relevant, including:

43.1 Oracle RTD General Issues and Workarounds

This section describes general issues and workarounds related to Oracle RTD. It includes the following topics:

43.1.1 Transient Likelihood Problems

There are cases where non-mature predictive models will return an actual likelihood rather than NaN during the early life of a model. There are also some cases where mature predictive models will return NaN as opposed to actual likelihoods when the Randomize Likelihood option is enabled for a model. These situations are transient in nature and, in the latter case, do not outweigh the benefits of the Randomize Likelihood feature.

43.1.2 Use Development Deployment State Only

Deployment states will be deprecated in a future release. Until then, do not use any deployment state other than Development.

43.1.3 Error Deploying Inline Services from Command Line if Inline Service Uses Certain Functions

An Inline Service that uses one or more of the built-in functions Days Since Last Event, Days Since Last Event on Channel, Number of Recent Events, or Number of Recent Events on Channel cannot be deployed using the command-line deployer.

The workaround is as follows:

  1. Navigate to the unzipped RTDdeploytool folder, for example, C:\<myDir>\OracleBI\RTDdeploytool.

  2. Copy the includes folder from RTD_HOME\eclipse\plugins\com.sigmadynamics.studio_11.1.1.5.0 (for example, C:\OracleBI\RTD\eclipse\plugins\com.sigmadynamics.studio_11.1.1.5.0\includes) into the unzipped RTDdeploytool folder.

43.1.4 Ensuring Unique Batch Names Across a Cluster

It is a standard requirement for Inline Service names and batch names to be unique within a cluster.

After an Inline Service is copied within a cluster, batch names registered in the Inline Service can be changed manually to achieve uniqueness. This manual step is not required if the batch registration code in the Inline Service automatically generates the batch name from the new Inline Service name, as in the following generic examples:

batchAgent.registerBatch( 
       batchAgent.getInlineService().getName() + ".FeedBackBatchJob", 
               "com.<mycompany>.rtd.batch.FeedBackBatchJob", 
               FeedBackBatchJob.description, 
               FeedBackBatchJob.paramDescriptions, 
               FeedBackBatchJob.paramDefaults); 

or

batchAgent.registerBatch( 
       Application.getApp().getName() + ".FeedBackBatchJob", 
               "com.<mycompany>.rtd.batch.FeedBackBatchJob", 
               FeedBackBatchJob.description, 
               FeedBackBatchJob.paramDescriptions, 
               FeedBackBatchJob.paramDefaults);

Note that all programs that may call the batch need to be made aware of the new batch name.

43.1.5 Safari and Chrome Accessibility Items

  1. Special Safari Setting Must be Selected for Proper Keyboard Operation

    After Safari has been installed, ensure that the following property is selected:

    • Preferences > Advanced > Press Tab to highlight each item on a web page

    If this property is not selected, some Rule Editor tabbing operations in a rule editor built with Oracle Application Development Framework and the External Rules Deployment Helper rule editor will not function correctly.

  2. Unexpected Results for Alt + Down Arrow in Combo Boxes in Chrome and Safari browsers

    The expected actions for Alt + Down Arrow in combo boxes (as found in Internet Explorer 9 and Firefox 10.0.5) are:

    1. The combo box shows an expanded list of values.

    2. The combo box allows Up and Down Arrow movement through the options, and the selection of a value from the list.

    3. The screen does not update until the Enter key is depressed.

    The following results were found for Chrome for Alt + Down Arrow in a combo box:

    1. The combo box is not extended.

    2. Using Up and Down Arrows changes the combo box value in place.

    3. The screen updates with a combo box value change as the arrow keys are used.

    The following results were found for Safari 5.1.7 for Alt + Down Arrow in a combo box:

    1. The combo box is not extended.

    2. Using Up and Down Arrows changes the combo box value in place.

    3. The screen does not update until the value is selected and the Enter key is depressed.

  3. JAWS May Not Work in Safari on Windows

    For more information, refer to Freedom Scientific and Safari documentation.

  4. JAWS Refresh Keys in Safari and Chrome

    JAWS users should use <JAWS KEY> + escape and <JAWS KEY> + 3 to clear and input page object actions, especially with the Chrome and Safari browsers.

  5. Chrome and Safari do not natively support Windows high contrast

    Chrome needs an extension to support high contrast.

    Safari needs a style sheet to support high contrast.

43.1.6 Learning Service May Skip Processing of Some Learning Records if SDDB is on Oracle RAC Database

The Oracle RTD database sequence SDLEARNING_SEQ definition does not impose strict order. In a RAC environment, this could mean gaps in the values for the sequence, which leads to possible Learning Service failures in properly processing the learning records.

The workaround for this case is to impose the Order option on the sequence SDLEARNING_SEQ. Specifically, a database user with the ALTER ANY SEQUENCE system privilege should issue the following command against the SDDB schema:

  • ALTER SEQUENCE SDLEARNING_SEQ ORDER;

43.1.7 External Rule Editor Does Not Work in Mozilla Firefox Version 16

Impacted Release: 11.1.1.7

With Mozilla Firefox version 16 and later, the External Rule Editor does not work as documented. For example, selecting a left operand when creating a new rule causes a JavaScript error. The workaround for this issue is to use another supported browser.

43.2 Oracle RTD Installation Issues and Workarounds

There are no known issues at this time.

43.3 Oracle RTD Upgrade Issues and Workarounds

There are no known issues at this time.

43.4 Oracle RTD Configuration Issues and Workarounds

There are no known issues at this time.

43.5 Oracle RTD Security Issues and Workarounds

This section describes general issues and workarounds related to Oracle RTD and security. It includes the following topic:

43.5.1 Decision Center Logout Not Redirected Correctly for Oracle Access Manager (OAM) 11g Form-Based Authentication

When Webgate 10g against Oracle Access Manager (OAM) 11g is configured as the SSO provider for Oracle RTD Decision Center access, logging out of, then back into Decision Center should ask users for their user name and password credentials on the re-login. To ensure that this occurs correctly, you must configure the following Oracle RTD Decision Center resources in OAM/Webgate as public (unprotected or anonymous access): 1. Decision Center logout URI /ui/do/logout 2. Decision Center images /ui/images/*

For information on how to perform the configuration, see the topic "Managing Policies to Protect Resources and Enable SSO" in Oracle Fusion Middleware Administrator's Guide for Oracle Access Manager at the location:

http://download.oracle.com/docs/cd/E14571_01/doc.1111/e15478/app_domn.htm#CHEIDJAF

43.6 Oracle RTD Administration Issues and Workarounds

There are no known issues at this time.

43.7 Oracle RTD Integration Issues and Workarounds

This section describes issues and workarounds related to Oracle RTD integration. It includes the following topic:

43.7.1 Java Smart Client Run Configuration Changes Required for Different Properties Files

When setting up the Java Smart Client example, depending on the properties file you are using, you must make some changes to the run configuration in Decision Studio before you run the example.

Note:

<RTD_HOME> refers to the directory where you installed the client-side files, for example, C:\RTD_Tools.

The changes you must make in the Arguments tab require you to enter an explicit, full path name. Make sure that you replace <RTD_HOME> with the exact name of your client-side files installation directory.

If you are using sdclient.properties for your properties file, perform the following change:

  • In the Arguments tab, add the following in the Program arguments box, replacing <RTD_HOME> with the exact name of your client-side files installation directory:

    • -u "<RTD_HOME>\client\Client Examples\Java Client Example\lib\sdclient.properties"

If you are using sdjrfclient.properties for your properties file, perform the following changes:

  • In the Arguments tab, add the following in the Program arguments box, replacing <RTD_HOME> with the exact name of your client-side files installation directory:

    • -u "<RTD_HOME>\client\Client Examples\Java Client Example\lib\sdjrfclient.properties"

If you are using clientHttpEndPoints.properties for your properties file, perform the following changes:

  • In the Arguments tab, add the following in the Program arguments box, replacing <RTD_HOME> with the exact name of your client-side files installation directory:

    • -u "<RTD_HOME>\client\Client Examples\Java Client Example\lib\clientHttpEndPoints.properties"

  • In the Classpath tab:

    • Remove the existing project

    • Add the following jar files: commons-code.jar, commons-httpclient.jar, commons-logging.jar, j2ee-client.jar, and rtd-ds-client.jar (if not already present).

    • Add the project with defaults

43.8 Oracle RTD Decision Studio Issues and Workarounds

This section describes issues and workarounds related to Oracle RTD Decision Studio. It includes the following topics:

43.8.1 Mapping Array Attributes in a Multi-Level Entity Hierarchy

A "parent-child" entity hierarchy is typically defined with the child entity as an attribute of the parent entity. When the child entity is an Array attribute, be careful to map the child Array attribute to its data source in the direct parent entity only. Assume, for example, a Customer with many Accounts, each of which has many Contracts. In Decision Studio, the Customer entity's Mapping tab may display the complete hierarchy as follows: - The Customer entity contains the Account entity as an Array attribute - The Account attribute contains the Contract entity as an Array attribute The Account entity's Mapping tab contains the Contract entity as an Array attribute.With this example, only map the Contract attribute in the Account entity's Mapping tab. Do not map the Contract attribute in the Customer entity's Mapping tab.

43.8.2 Issues When Trying to Enable Caching for Some Entities

There are known issues, which may result in compilation and runtime errors, with enabling entity caching where a number of design factors coincide:

  • You have a multi-level entity hierarchy, and a child entity is an array attribute of a parent entity

  • The data source for the child entity has no Input column defined

  • You want to enable caching on the child entity

If possible, simplify the structure of the child entity, specifically the attributes that are mapped to the sources. If this is not possible, contact Oracle Support with details of your particular design configuration.

43.8.3 Terminate Active Sessions in Cluster Works Only on Decision Server Receiving Deployment Request

Deploying an Inline Service to a cluster with the "Terminate active sessions" option selected will terminate sessions on only the Decision Server that receives the Inline Service deployment request.

43.9 Oracle RTD Decision Center Issues and Workarounds

There are no known issues at this time.

43.10 Oracle RTD Performance Monitoring Issues and Workarounds

There are no known issues at this time.

43.11 Oracle RTD Externalized Objects Management Issues and Workarounds

There are no known issues at this time.

43.12 Oracle RTD Localization Issues and Workarounds

There are no known issues at this time.

43.13 Oracle RTD Documentation Errata

This section describes errata in Oracle RTD documentation and help systems. It includes the following topic:

43.13.1 Oracle Fusion Middleware Administrator's Guide for Oracle Real-Time Decisions

There are no known documentation errata at this time in the Oracle Fusion Middleware Administrator's Guide for Oracle Real-Time Decisions.

43.13.2 Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions

This section describes documentation errata in the Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions. It includes the following topic:

43.13.2.1 External Rules Development Helper Mismatch between Code and Manual Description

The External Rules Development Helper, currently released with the DC_Demo Inline Service, does not function as described in Section 17.2.8, "Setting Up the External Interface and Embedded Rule Editor" and Section 17.3, "Example of End to End Development Using Dynamic Choices and External Rules."

43.13.2.2 Save Choice IDs in Inline Services Rather Than Choices

The Getting Started tutorial chapters within Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions store choices in session-tied entities. It is recommended that configurations only save IDs of choices instead of the full choice objects.

43.14 Oracle RTD Third-Party Software Information

This section provides third-party software information. It includes the following topic:

43.14.1 Displaytag Download Location

The third-party package Displaytag can be downloaded from http://displaytag.sourceforge.net.