Skip Headers
Oracle® Fusion Middleware Application Adapter for PeopleSoft User's Guide for Oracle WebLogic Server
11g Release 1 (11.1.1.4.0)

Part Number E17055-04
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

8 New Features

11g Release 1 (11.1.1.4.0) provides new features for the Oracle Application Adapter for PeopleSoft, which are described in this chapter. This chapter contains the following topics:

Exception Filter

This section describes how to configure exception filter functionality for the Oracle Application Adapter for PeopleSoft and includes a sample testing scenario.

The exception filter is supported only for outbound processes that use J2CA configurations. This feature is not supported for BSE configurations and inbound processes that use J2CA configurations.

The exception filter uses the com.ibi.afjca.oracle.AdapterExceptionFilter class to filter the generated exceptions. This class filters the exceptions and categorizes them into the following categories:

The following exceptions are represented in the fault policies file:

Prerequisites

This section lists the prerequisites for the exception filter.

  • Oracle PS3 SOA Suite must be installed.

  • Oracle JDeveloper for PS3 must be installed with the updated SOA composite editor.

  • Oracle Application Adapter for PeopleSoft for 11g Release 1 (11.1.1.4.0) must be installed.

Configuring the Exception Filter

Exception filter configuration consists of the following steps:

  1. Generate a WSDL file.

  2. Create a BPEL process with exception filter functionality.

  3. Create fault policies and fault binding files.

  4. Deploy and test the BPEL process with exception filter functionality.

Generating a WSDL File

To generate the WSDL file:

  1. Open Application Explorer and create a J2CA configuration.

    For more information, see "Creating a Configuration for J2CA".

  2. Create a target for the PeopleSoft adapter and then connect to the target.

    For more information, see "Establishing a Connection (Target) for PeopleSoft".

  3. Generate a WSDL for the appropriate object.

    For more information, see "Generating a WSDL (J2CA Configurations Only)".

Creating a BPEL process With Exception Filter Functionality

To create a BPEL process with exception filter functionality:

  1. Open JDeveloper and create a new SOA application.

    For more information, see "Creating a New SOA Application for the Outbound BPEL Process".

  2. Create a new SOA project (for example, PSoft_Exception_Filter).

  3. Create a third party adapter service component.

    For more information, see "Configuring a Third Party Adapter Service Component".

    Once the third party adapter service component is created, the WSDL file (with corresponding schemas and JCA file) is imported to the JDeveloper project.

    For more information, see "Defining a BPEL Outbound Process".

  4. Modify the imported JCA file.

    1. Right-click the imported JCA file and select Open from the menu, as shown in Figure 8-1.

      Figure 8-1 Application Navigator Tab

      Application Navigator tab
      Description of "Figure 8-1 Application Navigator Tab"

    2. In the <interaction-spec> element, add the ExceptionFilter property. For example:

      <interaction-spec className="com.ibi.afjca.cci.IWAFInteractionSpec"><property name="FunctionName" value="PROCESS"/><property name="ExceptionFilter" value="com.ibi.afjca.oracle.AdapterExceptionFilter"/></interaction-spec>
      
    3. Save the modified JCA file.

  5. Once the third party adapter service component is created and the JCA file is modified, continue with the remainder of the BPEL process creation.

    For more information, see "Defining a BPEL Outbound Process".

Creating Fault Policies and Fault Binding Files

To create fault policies and fault binding files:

  1. Right-click the created SOA project (for example, PSoft_Exception_Filter) and select New from the menu, as shown in Figure 8-2.

    Figure 8-2 Application Navigator Tab

    Application Navigator tab
    Description of "Figure 8-2 Application Navigator Tab"

    The New Gallery dialog is displayed, as shown in Figure 8-3.

    Figure 8-3 New Gallery Dialog

    New Gallery dialog
    Description of "Figure 8-3 New Gallery Dialog"

  2. Select File and click OK.

    The Create File dialog is displayed, as shown in Figure 8-4.

    Figure 8-4 Create File Dialog

    Create File dialog
    Description of "Figure 8-4 Create File Dialog"

  3. In the File Name field, type fault-bindings.xml and click OK.

  4. Add the appropriate fault binding functions in the fault-bindings.xml file.

    To view a sample fault-bindings.xml file, see "Sample Fault-Bindings.xml File".

    Note:

    The parameter in the <name> element is the name of the created BPEL process.
  5. Save the fault-bindings.xml file.

  6. Repeat steps 1 to 5 for the fault-policies.xml file, but ensure to add the appropriate fault policies functions.

    To view a sample fault-policies.xml file, see "Sample Fault-Policies.xml File".

    Note:

    The parameter ID in the <fault policy> element is obtained from the fault-bindings.xml file, which can be found in the <Component> element of the fault-bindings.xml file. This ID can have any name as long as it is identical in the fault-policies.xml and fault-bindings.xml files.

    Tip:

    The fault-bindings.xml and fault-policies.xml files can also be created externally and manually copied to the JDeveloper project.

Sample Fault-Bindings.xml File

<?xml version="1.0" encoding="UTF-8" ?><faultPolicyBindings version="2.0.1" xmlns="http://schemas.oracle.com/bpel/faultpolicy" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><component faultPolicy="bpelFaultHandling"><name>BPELProcess1</name></component></faultPolicyBindings>

Sample Fault-Policies.xml File

<?xml version="1.0" encoding="UTF-8"?><faultPolicies xmlns="http://schemas.oracle.com/bpel/faultpolicy">   <faultPolicy version="2.0.1" id="bpelFaultHandling"                xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"                xmlns:xs="http://www.w3.org/2001/XMLSchema"                xmlns="http://schemas.oracle.com/bpel/faultpolicy"                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Conditions> <faultName xmlns:bpelx="http://schemas.oracle.com/bpel/extension" name="bpelx:remoteFault"> <condition> <action ref="ora-retry-3"/> </condition> </faultName>   <faultName xmlns:bpelx="http://schemas.oracle.com/bpel/extension" name="bpelx:bindingFault">  <condition>  <action ref="ora-retry-5"/>  </condition> </faultName>  </Conditions> <Actions>  <Action id="ora-retry-3">  <retry>  <retryCount>3</retryCount> <retryInterval>2</retryInterval>  <retryFailureAction ref="ora-terminate"/>  <exponentialBackoff/>  </retry>  </Action>   <Action id="ora-retry-5">  <retry>  <retryCount>5</retryCount> <retryInterval>2</retryInterval>  <retryFailureAction ref="ora-terminate"/>  <exponentialBackoff/>  </retry>  </Action>  <Action id="ora-terminate"> <abort/>  </Action> </Actions>  </faultPolicy> </faultPolicies>

Deploying and Testing the BPEL Process With Exception Filter Functionality

To deploy and test the BPEL process with exception filter functionality:

  1. Deploy the created BPEL process.

    For more information, see "Deploying the BPEL Outbound Process".

  2. Simulate a communication error by disconnecting the system (where the servers are running) from the network.

  3. Invoke the deployed BPEL process with a valid input.

    For more information, see "Invoking the Input XML Document in the Oracle Enterprise Manager Console".

  4. Select the process ID.

    You can observe the BPEL process being retried or aborted based on the configuration of the fault-policies.xml file.

Credential Mapping for Oracle SOA Suite (BPEL, Mediator, or BPM)

This section describes how to configure credential mapping functionality for the Oracle Application Adapter for PeopleSoft in a configuration that uses Oracle SOA Suite (BPEL, Mediator, or BPM). A sample testing scenario is also included. This section contains the following topics:

Credential mapping is supported only for outbound processes that use J2CA configurations. This feature is not supported for BSE configurations and inbound processes that use J2CA configurations.

Note:

The J2CA connector is common to all four application adapters (SAP R/3, PeopleSoft, Siebel, and J.D. Edwards OneWorld). If credential mapping is required, then ensure that only one application adapter is used in a particular instance. For example, in one adapter instance only the PeopleSoft application adapter can be used. Credential mapping cannot be configured at the individual adapter level. If you require the use of credential mapping for two adapters, then both adapters must be running in two independent adapter instances.

To pass user credentials to the iWay J2CA resource adapter, create a credential map from the Oracle WebLogic Server user credentials to the EIS user credentials (PeopleSoft adapter). Then associate a credential policy with a BPEL, Mediator, or BPM Web service and invoke the Web service using Oracle WebLogic Server user credentials. These credentials are mapped to the EIS user credentials and then passed to the iWay J2CA container, which uses them to connect with the EIS adapter (PeopleSoft).

Prerequisites

This section lists the prerequisites for credential mapping.

  • Oracle PS3 SOA Suite with an extended BPM domain must be installed.

  • Oracle JDeveloper for PS3 must be installed with the updated SOA/BPM composite editor.

  • Oracle Application Adapter for PeopleSoft for 11g Release 1 (11.1.1.4.0) must be installed.

Configuring Credential Mapping

Configuring credential mapping consists of the following steps:

  1. Deploy the adapter.

    For more information, see Chapter 3, "Oracle WebLogic Server Deployment and Integration".

  2. Associate Oracle WebLogic Server credentials with EIS credentials.

    For more information, see "Associating Oracle WebLogic Server Credentials With EIS Credentials".

  3. Generate a WSDL file.

    For more information, see "Generating a WSDL File".

  4. Create an outbound process.

    For more information, see "Creating an Outbound Process".

  5. Attach a security policy to an outbound process.

    For more information, see "Attaching a Security Policy to an Outbound Process Using the Oracle Enterprise Manager Console".

Associating Oracle WebLogic Server Credentials With EIS Credentials

To associate Oracle WebLogic Server credentials with EIS credentials:

  1. Log in to the Oracle WebLogic Server Administration Console.

  2. In the Domain Structure section in the left pane, click Deployments, as shown in Figure 8-5.

    Figure 8-5 Domain Structure Section

    Domain Structure section
    Description of "Figure 8-5 Domain Structure Section"

    The Deployments page is displayed, as shown in Figure 8-6.

    Figure 8-6 Deployments Page

    Deployments page
    Description of "Figure 8-6 Deployments Page"

  3. Click the iwafjca resource adapter.

    The Settings for iwafjca page is displayed, as shown in Figure 8-7.

    Figure 8-7 Settings for iwafjca Page

    Settings for iwafjca page
    Description of "Figure 8-7 Settings for iwafjca Page"

  4. Click the Credential Mappings tab under the Security tab, and then click New.

    The Create a New Security Credential Mapping page is displayed, as shown in Figure 8-8.

    Figure 8-8 Create a New Security Credential Mapping Page

    Credential Mapping page
    Description of "Figure 8-8 Create a New Security Credential Mapping Page"

  5. Select the outbound connection pool.

    For example:

    eis/OracleJCAAdapter/DefaultConnection
    
  6. Click Next.

    The WebLogic Server User page is displayed, as shown in Figure 8-9.

    Figure 8-9 WebLogic Server User Page

    WebLogic Server User page
    Description of "Figure 8-9 WebLogic Server User Page"

  7. Select Configured User Name, enter a valid Oracle WebLogic Server user name, and then click Next.

    The EIS User Name and Password page is displayed, as shown in Figure 8-10.

    Figure 8-10 EIS User Name and Password Page

    EIS User Name and Password page
    Description of "Figure 8-10 EIS User Name and Password Page"

  8. Enter the user name and password for the EIS and click Finish.

    The credentials for an Oracle WebLogic Server user are now mapped with an EIS user (PeopleSoft). The mapping is invoked automatically before invoking the J2CA service.

Generating a WSDL File

To generate a WSDL file:

  1. Open Application Explorer and create a J2CA configuration.

    For more information, see "Creating a Configuration for J2CA".

  2. Create a target for the PeopleSoft adapter and then connect to the target.

    For more information, see "Establishing a Connection (Target) for PeopleSoft".

  3. Generate a WSDL for the appropriate object.

    For more information, see "Generating a WSDL (J2CA Configurations Only)".

Creating an Outbound Process

This section describes how to configure an outbound process. For demonstration purposes, specific references to the BPEL outbound process are made. However, the same steps apply to Mediator and BPM outbound processes.

For more information about creating a Mediator outbound process, see Chapter 5, "Integration With Mediator Service Components in the Oracle SOA Suite".

For more information about creating a BPM outbound process, see Chapter 6, "Integration With BPM Service Components in the Oracle SOA Suite".

To create a BPEL outbound process:

  1. Open JDeveloper and create a new SOA application.

    For more information, see "Creating a New SOA Application for the Outbound BPEL Process".

  2. Create a new SOA project (for example, Credential_Mappings).

  3. Deploy the BPEL outbound process.

    For more information, see "Deploying the BPEL Outbound Process".

Attaching a Security Policy to an Outbound Process Using the Oracle Enterprise Manager Console

To attach a security policy to an outbound process using the Oracle Enterprise Manager console:

  1. Log in to the Oracle Enterprise Manager console and navigate to the deployed composite.

  2. Click the Policies tab.

    From the Attach To/Detach From list, select the BPEL, Mediator, or BPM outbound process.

    BPEL or Mediator outbound processes have _client appended to the process name. BPM outbound processes use the Process.service naming convention.

    The Attached Policies page is displayed, as shown in Figure 8-12.

    Figure 8-12 Attached Policies Page

    Attached Policies page
  3. Select the Security category and click Search.

  4. Scroll through the list and select oracle/wss_http_token_service_policy.

  5. Click Attach and then OK.

    The selected policy is now displayed in the Policies tab.

  6. Click the Test tab and select WSS Username Token in the Security section of the Request tab. Enter a valid Oracle WebLogic Server user name and password, as shown in Figure 8-13

  7. Invoke the deployed BPEL outbound process with a valid input.

    For more information, see "Invoking the Input XML Document in the Oracle Enterprise Manager Console".

  8. Check the J2CA log files and locate the encrypted password, which shows that the user credentials have been passed to the EIS through Oracle WebLogic Server.

    For example:

    FINEST IWAFManagedConnectionFactory com.ibi.afjca.Util getPasswordCredential(78) InLoop: User-iwayqa:Password-ENCR(3109311731831131382333215315332323192322731773172)FINEST IWAFManagedConnectionFactory com.ibi.afjca.Util getPasswordCredential(90) Use the system PasswordCredential: User-iwayqa:Password-ENCR(3109311731831131382333215315332323192322731773172)
    

Credential Mapping for Oracle Service Bus (OSB)

This section describes how to configure credential mapping functionality for the Oracle Application Adapter for PeopleSoft in a configuration that uses Oracle Service Bus (OSB). A sample testing scenario is also included. This section contains the following topics:

Credential mapping is supported only for outbound processes that use J2CA configurations. This feature is not supported for BSE configurations and inbound processes that use J2CA configurations.

Note:

The J2CA connector is common to all four application adapters (SAP R/3, PeopleSoft, Siebel, and J.D. Edwards OneWorld). If credential mapping is required, then ensure that only one application adapter is used in a particular instance. For example, in one adapter instance only the PeopleSoft application adapter can be used. Credential mapping cannot be configured at the individual adapter level. If you require the use of credential mapping for two adapters, then both adapters must be running in two independent adapter instances.

To pass user credentials to the iWay J2CA resource adapter, create a credential map from the Oracle WebLogic Server user credentials to the EIS user credentials (PeopleSoft adapter). Then associate a credential policy with a Web service and invoke the Web service using Oracle WebLogic Server user credentials. These credentials are mapped to the EIS user credentials and then passed to the iWay J2CA container, which uses them to connect with the EIS adapter (PeopleSoft).

Prerequisites

This section lists the prerequisites for credential mapping.

  • Oracle Service Bus (OSB) for PS3 must be installed.

  • Oracle Application Adapter for PeopleSoft for 11g Release 1 (11.1.1.4.0) must be installed.

Configuring Credential Mapping

Configuring credential mapping consists of the following steps:

  1. Deploy the adapter.

    For more information, see Chapter 3, "Oracle WebLogic Server Deployment and Integration".

  2. Associate Oracle WebLogic Server credentials with EIS credentials.

    For more information, see "Associating Oracle WebLogic Server Credentials With EIS Credentials".

  3. Generate a WSDL file.

    For more information, see "Generating a WSDL File".

  4. Create an Oracle Service Bus (OSB) outbound process.

    For more information, see "Creating an Oracle Service Bus (OSB) Outbound Process".

Associating Oracle WebLogic Server Credentials With EIS Credentials

To associate Oracle WebLogic Server credentials with EIS credentials:

  1. Log in to the Oracle WebLogic Server Administration Console.

  2. In the Domain Structure section in the left pane, click Deployments, as shown in Figure 8-14.

    Figure 8-14 Domain Structure Section

    Domain Structure section
    Description of "Figure 8-14 Domain Structure Section"

    The Deployments page is displayed, as shown in Figure 8-15.

    Figure 8-15 Deployments Page

    Deployments page
    Description of "Figure 8-15 Deployments Page"

  3. Click the iwafjca resource adapter.

    The Settings for iwafjca page is displayed, as shown in Figure 8-16.

    Figure 8-16 Settings for iwafjca Page

    Settings for iwafjca page
    Description of "Figure 8-16 Settings for iwafjca Page"

  4. Click the Credential Mappings tab under the Security tab, and then click New.

    The Create a New Security Credential Mapping page is displayed, as shown in Figure 8-17.

    Figure 8-17 Create a New Security Credential Mapping Page

    Credential Mapping page
    Description of "Figure 8-17 Create a New Security Credential Mapping Page"

  5. Select the outbound connection pool.

    For example:

    eis/OracleJCAAdapter/DefaultConnection
    
  6. Click Next.

    The WebLogic Server User page is displayed, as shown in Figure 8-18.

    Figure 8-18 WebLogic Server User Page

    WebLogic Server User page
    Description of "Figure 8-18 WebLogic Server User Page"

  7. Select Configured User Name, enter a valid Oracle WebLogic Server user name, and then click Next.

    The EIS User Name and Password page is displayed, as shown in Figure 8-19.

    Figure 8-19 EIS User Name and Password Page

    EIS User Name and Password page
    Description of "Figure 8-19 EIS User Name and Password Page"

  8. Enter the user name and password for the EIS and click Finish.

    The credentials for an Oracle WebLogic Server user are now mapped with an EIS user (PeopleSoft). The mapping is invoked automatically before invoking the J2CA service.

Generating a WSDL File

To generate a WSDL file:

  1. Set the class path for Application Explorer to integrate with Oracle Service Bus (OSB).

    For more information, see "Setting the Class Path for Application Explorer to Integrate With Oracle Service Bus".

  2. Open Application Explorer and create a J2CA configuration.

    For more information, see "Creating a Configuration for J2CA".

  3. Create a target for the PeopleSoft adapter and then connect to the target.

    For more information, see "Establishing a Connection (Target) for PeopleSoft".

  4. Publish a WSDL to OSB for the appropriate object.

    For more information, see "Publishing a WSDL From Application Explorer to Oracle Service Bus".

Creating an Oracle Service Bus (OSB) Outbound Process

To create an Oracle Service Bus (OSB) outbound process with credential mapping functionality:

  1. Start Oracle Service Bus and create project folders.

    For more information, see "Starting Oracle Service Bus and Creating Project Folders".

  2. Configure a File type Business Service.

    For more information, see "Configuring a File Type Business Service".

  3. Configure a Business Service.

    For more information, see "Configuring a WSDL-based Business Service".

  4. Configure a Proxy Service.

    For more information, see "Configuring a Proxy Service".

  5. Configure a Pipeline.

    For more information, see "Configuring a Pipeline".

  6. Configure a Service account by selecting the created folder in the left pane.

    In the right pane, select Service Account from the Create Resource list, as shown in Figure 8-20.

    Figure 8-20 Select Service Account Option

    Service Account option
    Description of "Figure 8-20 Select Service Account Option"

    The Create a New Service Account page is displayed, as shown in Figure 8-21.

    Figure 8-21 General Configuration Page

    General Configuration page
    Description of "Figure 8-21 General Configuration Page"

  7. Provide a name for the resource and select Static as the resource type.

  8. Click Next.

    The Static User Configuration page is displayed, as shown in Figure 8-22.

    Figure 8-22 Static User Configuration Page

    Static User Configuration page
    Description of "Figure 8-22 Static User Configuration Page"

  9. Provide a valid user name and password for Oracle WebLogic Server, and then click Last.

    The Summary page is displayed, as shown in Figure 8-23.

  10. Review the information and click Save.

  11. In the left pane, select the Business Service that was created while publishing the WSDL, as shown in Figure 8-24.

    Figure 8-24 Select the Business Service

    Select the Business Service
    Description of "Figure 8-24 Select the Business Service"

    For more information, see "Configuring a WSDL-based Business Service".

  12. Click Edit to edit the process, as shown in Figure 8-25.

    The General Configuration page is displayed.

  13. Click Next.

    The Transport Configuration page is displayed, as shown in Figure 8-26.

    Figure 8-26 Transport Configuration Page

    Transport Configuration page
    Description of "Figure 8-26 Transport Configuration Page"

  14. Click Next.

    The JCA Transport Configuration page is displayed, as shown in Figure 8-27.

    Figure 8-27 JCA Transport Configuration Page

    JCA Transport Configuration page
    Description of "Figure 8-27 JCA Transport Configuration Page"

  15. Browse the JNDI service account that was created and click Last.

    The Summary page is displayed, as shown in Figure 8-28.

  16. Review the information and click Save.

  17. Check if the success message is displayed and click Activate in the Change Center, as shown in Figure 8-29.

    Figure 8-29 Success Message

    Description of Figure 8-29 follows
    Description of "Figure 8-29 Success Message"

    The Activate Session page is displayed, as shown in Figure 8-30.

    Figure 8-30 Activate Session Page

    Activate Session page
    Description of "Figure 8-30 Activate Session Page"

  18. Click Submit.

  19. Copy and paste a valid input XML file in the input folder you configured and check to see that the output is received in the configured output location.

  20. Check the J2CA log files and locate the encrypted password, which shows that the user credentials have been passed to the EIS through Oracle WebLogic Server.

    For example:

    FINEST IWAFManagedConnectionFactory com.ibi.afjca.Util getPasswordCredential(78) InLoop: User-iwayqa:Password-ENCR(3189321331831132502333215312132323192322731773156)Tue FINEST IWAFManagedConnectionFactory com.ibi.afjca.Util getPasswordCredential(90) Use the system PasswordCredential: User-iwayqa:Password-ENCR(3189321331831132502333215312132323192322731773156)