Oracle® Application Integration Architecture

Release Notes

Release 12.2

E70995-01

January 2017

This document provides release notes for Oracle Application Integration Architecture release 12.2.

This document contains the following sections:

New Features

Release 12.2 includes changed functionality in the following areas:

Release 12.2 delivers the following pre-built integrations:

  • Communications Order to Cash with options for:

    • OSM

    • Oracle Communications Billing and Revenue Management (BRM)

    • Siebel CRM

  • Siebel CRM Integration Pack for Oracle Communications Billing and Revenue Management: Agent Assisted Billing Care

  • Product Master Data Management with options for:

    • BRM

    • Siebel CRM

    • Oracle Communications Pricing Design Center (PDC)

    • Oracle Communications Design Studio

For full details about features and functionality, see the implementation guides for each pre-built integration and Oracle AIA Installation Guide.

Simplified Installation and Packaging

Release 12.2 provides a simplified installation process for all pre-built integrations and simplified packaging for the Communications Order to Cash pre-built integration.

Simplified Installation

Release 12.2 provides all Oracle AIA software in one installation package.

In previous releases, the Oracle AIA installation was a two-step process: First you installed the Oracle AIA Foundation Pack and then you installed and configured the pre-built integrations.

In release 12.2, because all foundational components are bundled within Oracle Service Oriented Architecture (SOA) Suite and the pre-built integrations, you install and configure all Oracle AIA software in one step.

Simplified Packaging

Release 12.2 provides new packaging and deployment for the Communications Order to Cash pre-built integration options.

In previous releases, the pre-built integration options aligned with business processes, such as Order to Bill, Order to Activate, and Order to Cash.

In release 12.2, the pre-built integration options align with the integrated applications with the following options:

  • Communications Order to Cash for Siebel CRM

  • Communications Order to Cash for OSM

  • Communications Order to Cash for BRM

The Oracle AIA Installer and Configuration Wizard support these changes.

Compatibility with Oracle Fusion Middleware 12c

All pre-built integrations delivered with release 12.2 are built on Fusion Middleware 12c, which includes new Circuit Breaker functionality for increased resiliency.

See the Oracle AIA compatibility matrix available from the My Oracle Support for details about compatible version numbers:

http://support.oracle.com/epmos/faces/DocumentDisplay?id=2226851.1

You can also search for Oracle AIA and Oracle Communications integration packs on the Certifications tab of My Oracle Support.

Fixes in This Release

Table 1 lists fixed issues and provides a brief description of the resolution.

Table 1 Fixes in Release 12.2

SR Number Bug Number Description

3-9856841511

20074524

The undeploy scripts for the Agent Assisted Billing Care pre-built integration did not work due to incorrect commands in the AABCUndeployConditionalPolicy.xml script.

This issue has been fixed.

3-11361940541

21898705

For the Master Data Management pre-built integration option, the rate name in Oracle Communications Pricing Design Center (PDC) was always Pricing, regardless of what was entered in Oracle Product Hub.

This issue has been fixed and the Product Hub value is used.

3-11927560631

22591672

For the Agent Assisted Billing Care pre-built integration, Oracle Data Integrator web services were called synchronously, resulting in Oracle AIA processes hanging indefinitely and generating errors.

This issue has been fixed and the web services are called asynchronously.

3-11354709491

21840865

For the Order to Cash pre-built integration, hooks for customizing the input for BRM opcodes in the Oracle AIA XSLTs were limited.

This issue has been fixed and new hooks have been added to customize the input for the following opcodes:

  • PCM_OP_MODIFY_CUSTOMER

  • PCM_OP_SUBSCRIPTION_PURCHASE_DEAL

3-10995886281

21520797

For the Order to Cash pre-built integration, the UpdateSalesOrderOSMCFSCommsJMSConsumer mediator process did not honor the first in, first out sequence of order updates, resulting in incorrect order status in Siebel CRM.

This issue has been fixed and the mediator process now uses a best effort sequence.

3-10165201201

20649835

For the Agent Assisted Billing Care pre-built integration, dates were inconsistent for invoices synchronized between BRM and Siebel CRM due to an offset configured in Oracle AIA.

This issue has been fixed and the offset has been removed.


Known Problems

This section describes the known problems and fixes that apply to release 12.2.

Known Problems for Multiple Pre-Built Integrations

The known problems in this section apply to multiple pre-built integrations.

Configuration Wizard Fails on Windows

BugDB number: 25246380

This problem applies to all pre-built integrations.

When installing Oracle AIA on Windows, the Configuration Wizard fails when it attempts to run the SOA createStore utility.

There is no workaround for this problem.

Not All Agent Assisted Billing Care Services Undeployed

BugDB number: 23053792

This problem applies to the pre-built integration for Agent Assisted Billing Care when the pre-built integration for Order to Cash is also deployed.

When undeploying the pre-built integration for Agent Assisted Billing Care after you have undeployed the pre-built integration for Order t o Cash, some Siebel CRM services are not undeployed.

To resolve this problem, restart the Oracle WebLogic servers and the database before running the undeployAABC.sh script.

Undeployment Fails

BugDB number: 25371250This problem applies to all pre-built integrations.When undeploying the pre-built integrations, if you have never restarted the WebLogic servers and database after deploying the pre-built integrations, the undeployment scripts fail.To resolve this problem, restart the WebLogic servers and the database before running the undeployment scripts.

Oracle Web Services Manager Policy Manager in Admin State and Managed Server Slow to Start After Upgrade

This problem applies to pre-built integrations that use the BRM JCA Resource Adapter.

After upgrading to Oracle AIA 12.2, if you are using a BRM JCA Resource Adapter of version 7.5 with patch set 12 or earlier, the wsm-pm component is in the Admin state and the managed server is slow to start.

To resolve this problem:

  1. Log in to the WebLogic Server Administration console.

  2. From the Domain Structure tree, select Deployments.

  3. From the table of deployments, select OracleBRMJCA14Adapter.

    You may need to page through the table to locate this deployment.

  4. In the Deployment Order field, enter 100.

  5. Click Save.

  6. Restart the managed server.

Known Problems for Communications Order to Cash

The known problems in this section apply only to the Communications Order to Cash pre-built integration.

AIASecurityConfigurationProperties.xml Does Not Exist

BugDB number: 22754867

After running the deployment script for the Communications Order to Cash pre-built integration option for BRM, the following error message appears in the deployment log file:

AIASecurityConfigurationProperties.xml does not exist in
Install_directory/comms_home/source/soainfra/apps/services/industry/Communications/BRM/ProviderABCS/CreateReceivedPaymentListBRMCommsProvABCSImpl/SOA

where Install_directory is the directory where you installed Oracle AIA.

This error appears because, although the AIASecurityConfigurationProperties.xml file is no longer delivered with Oracle AIA, the SOA deployment tool still checks for the file and adds the error message when it fails to find the file. Because the missing file does not interfere with deployment or functionality, you can ignore this error.

Missing Test Orchestration Process Connection Factories Preventing Order Processing

If you are deploying the Order to Cash for Siebel CRM and Order to Cash for BRM pre-built integration options and are using your own order management system (other than OSM), you must deploy the required connection factories for the test orchestration process or orders will fail.

Note:

If you have also deployed the Order to Cash for OSM pre-built integration option, this problem does not apply.

To resolve this problem:

  1. Create an XML file containing the following:

    <?xml version="1.0"?>
    <DeploymentPlan component="O2C" version="12.0">
    <Configurations>
    <ManagedServer wlserver="pips.O2C" action="shutdown" failonerror="true"/> 
    <JMSConnectionFactory connFacName="COMMS_ORDERORCHESTRATION_PRODUCER" connFacJNDI="jms/aia/COMMS_ORDERORCHESTRATION_PRODUCER" jmsModuleName="AIAJMSModule" jmsSubDeploymentName="AIASubDeployment"  action="create" wlserver="pips.O2C" isXA="true"/>
    <JmsAdapter jndi-name="eis/wljms/COMMS_ORDERORCHESTRATION_PRODUCER" connection-fac-Location="jms/aia/COMMS_ORDERORCHESTRATION_PRODUCER" isTopic="false" isTransacted="false" action="create" wlserver="pips.O2C"/>
    <JMSConnectionFactory connFacName="COMMS_ORDERORCHESTRATION_CONSUMER" connFacJNDI="jms/aia/COMMS_ORDERORCHESTRATION_CONSUMER" jmsModuleName="AIAJMSModule" jmsSubDeploymentName="AIASubDeployment"  action="create" wlserver="pips.O2C" isXA="true"/>
    <JmsAdapter jndi-name="eis/wljms/COMMS_ORDERORCHESTRATION_CONSUMER" connection-fac-Location="jms/aia/COMMS_ORDERORCHESTRATION_CONSUMER" isTopic="false" isTransacted="false" action="create" wlserver="pips.O2C"/>
    <ManagedServer wlserver="pips.O2C" action="start" failonerror="true"/> 
    </Configurations> 
    </DeploymentPlan>
    
  2. Save the file as DeployTOPConnFactories.xml.

  3. Create one of the following scripts, depending on your environment:

    • For UNIX, create a script named deploy.sh containing the following:

      source $COMMS_HOME/bin/commsenv.sh
      ant -f $SOA_HOME/aiafp/Install/AID/AIAInstallDriver.xml -DDeploymentPlan=New_DP_Path -DPropertiesFile=$DOMAIN_LOCATION/soa/aia/bin/AIAInstallProperties.xml
      
    • For Windows, create a script named deploy.bat containing the following:

      source %COMMS_HOME%\bin\commsenv.bat
      ant -f %SOA_HOME%\aiafp\Install\AID\AIAInstallDriver.xml -DDeploymentPlan=New_DP_Path -DPropertiesFile=%DOMAIN_LOCATION%\soa\aia\bin\AIAInstallProperties.xml
      

    where New_DP_Path is the path to the newly-created DeployTOPConnFactories.xml file.

  4. From the command line, run deploy.sh or deploy.bat.

    The required connection factories are created and deployed.

Known Problems for Product Master Data Management

The known problems in this section apply only to the Product Master Data Management pre-built integration.

Publication of Hierarchical Item Catalog Categories Fails

BugDB number: 25222766

When using Siebel version 8.1.1.16, publishing parent and child item catalog categories together from Oracle Product Hub to Siebel CRM fails.

To resolve this problem, publish the parent and child item catalog categories separately and manually create the hierarchy in Siebel CRM.

Note: This problem does not exist when using Siebel version 8.1.1.14.

Extra Child Component Created When Changing Product Name

BugDB number: 22390890

When changing the name, description, or long description of a product in Oracle Product Hub and resynchronizing the product to Siebel CRM, a new child component with the new name is created for the product in Siebel CRM and the original child component retains the original name.

To resolve this problem, delete the child component with the original name.

Product Lines with Multiple Products Overwriting Existing Products

BugDB number: 23031264

When synchronizing a product line with multiple products from Oracle Product Hub to Siebel CRM, the product synchronization succeeds, but each product associated with the product line overwrites the previous product. This results product lines with single products rather than the intended multiple products.

To avoid this problem, associate each product line with one product only. You can also associate a single product to multiple product lines.

This problem also applies to version 11.6.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.


Oracle Application Integration Architecture Release Notes, Release 12.2

E70995-01

Copyright © 2017, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.