Oracle® Fusion Middleware

Using Oracle RightNow Cloud Adapter Configuration Wizard

Release 12.1.3

E63278-01

May 2015

Oracle Fusion Middleware Using Oracle RightNow Cloud Adapter Configuration Wizard, Release 12.1.3

E63278-01

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

Primary Author: Mark Kennedy

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, 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.

Contents

Preface

- Audience

- Documentation Accessibility

- Related Resources

- Conventions

1 Configuring Oracle RightNow Cloud Properties

- Configuring Basic Information Properties

- What You Can Do from the Basic Info Page

- What You See on the Basic Info Page

- Configuring Oracle Cloud Adapter Connection and CSF Key Properties

- What You Can Do from the Oracle Cloud Adapter Connection Page

- What You See on the Oracle Cloud Adapter Connection Page

- What You Can Do from the Oracle Cloud Adapter CSF Key Page

- What You See on the Oracle Cloud Adapter CSF Key Page

- Configuring Oracle RightNow Cloud Source Request Properties

- What You Can Do from the Oracle RightNow Cloud Source Request Page

- What You See on the Oracle RightNow Cloud Source Request Page

- Configuring Oracle RightNow Cloud Source Response Properties

- What You Can Do from the Oracle RightNow Cloud Source Response Page

- What You See on the Oracle RightNow Cloud Source Response Page

- Configuring Oracle RightNow Cloud Target Operation Properties

- What You Can Do from the Oracle RightNow Cloud Target Operations Page

- What You See on the Oracle RightNow Cloud Target Operations Page

- Reviewing Configuration Values on the Summary Page

- What You Can Do from the Summary Page

- What You See on the Summary Page

Preface

Topics:

Using Oracle RightNow Cloud Adapter Configuration Wizard describes the pages of the Adapter Configuration Wizard that you are guided through to configure the Oracle RightNow Cloud adapter.

- Audience

- Documentation Accessibility

- Related Resources

- Conventions

Audience

Using Oracle RightNow Cloud Adapter Configuration Wizard is intended for users who want to create, deploy, test, and monitor applications that use the Oracle RightNow Cloud adapter.

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.

Related Resources

For more information, see these Oracle resources:

- Developing SOA Applications with Oracle SOA Suite

- Administering Oracle SOA Suite and Oracle Business Process Management Suite

- Administering Oracle Service Bus

- Understanding Technology Adapters

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

1 Configuring Oracle RightNow Cloud Properties

The Oracle RightNow Cloud adapter enables you to create integrations with an Oracle RightNow Cloud application.

The following sections describe how to configure the Oracle RightNow Cloud adapter as a source and target in an integration.

Topics

- Configuring Basic Information Properties

- Configuring Oracle Cloud Adapter Connection and CSF Key Properties

- Configuring Oracle RightNow Cloud Source Request Properties

- Configuring Oracle RightNow Cloud Source Response Properties

- Configuring Oracle RightNow Cloud Target Operation Properties

- Reviewing Configuration Values on the Summary Page

Configuring Basic Information Properties

You can enter a name and description on the Basic Info page of each source and target in your integration.

Topics

- What You Can Do from the Basic Info Page

- What You See on the Basic Info Page

What You Can Do from the Basic Info Page

You can specify the following values on the source or target Basic Info page. The Basic Info page is the initial wizard page that is displayed whenever you drag a connector to the source or target area.

- Specify a meaningful name.

- Specify a description of the responsibilities.

What You See on the Basic Info Page

The following table describes the key information on the Basic Info page.

Element

Description

What do you want to call your connection?

Provide a meaningful name so that others can understand the connection. For example, if you are creating a source Oracle RightNow Cloud connection, you may want to name it RightNowInboundDirection). You can include English alphabetic characters, numbers, underscores, and dashes in the name. You cannot include the following:

- Blank spaces (for example, My RightNow Connection)

- Special characters (for example,  #;83& or righ(t)now4)

- Multibyte characters

What does this connection do?

Enter an optional description of the connection’s responsibilities. For example: This connection receives an inbound request to synchronize account information with Oracle Sales Cloud.

Configuring Oracle Cloud Adapter Connection and CSF Key Properties

Enter the Oracle Cloud adapter configuration connectivity and Credential Store Framework (CSF) key values for your integration.

Topics

- What You Can Do from the Oracle Cloud Adapter Connection Page
What You See on the Oracle Cloud Adapter Connection Page

- What You Can Do from the Oracle Cloud Adapter CSF Key Page

- What You See on the Oracle Cloud Adapter CSF Key Page

What You Can Do from the Oracle Cloud Adapter Connection Page

You can specify the following connection values for the Oracle Cloud adapter.

- Specify the WSDL URL for some adapters. If you are configuring the Oracle Eloqua Cloud adapter, no WSDL is required.

- Specify the security policy.

- Create the authentication key. A key created for one direction (for example, outbound) is also available for selection in the other direction (for example, inbound).

What You See on the Oracle Cloud Adapter Connection Page

The following table describes the key information on the Oracle Cloud adapter Connection page.

Element

Description

WSDL URL

Note: This field is not displayed for the Oracle Eloqua Cloud adapter.

Specify the WSDL. The WSDL is used to build integrations specific to your instance. You can also select the WSDL from a file system or another source by choosing the browser icon next to the WSDL URL field. Click File System at the top of the dialog, then browse for the WSDL.

Security Policy

Select the security policy appropriate to your environment (for example, USERNAME_PASSWORD_TOKEN).

- The wizard shows all policies, including those that may not be applicable. To make a correct selection, you must have a knowledge of policies. For example, you cannot select a SAML-based policy because the identity is not propagated.

- The policies you apply to the cloud adapter are unique to the cloud adapter and do not impact other endpoints in the composite.

Authentication Key

Select the CSF authentication key.

- Add: Click to create a new authentication key. You must specify the key name, user name, and password. To successfully deploy and administer your application, you must specify these same values in Oracle Enterprise Manager Fusion Middleware Control.

- Edit: Click to edit an authentication key.

- Delete: Click to delete an authentication key.

Test

Click to validate the authentication key.

What You Can Do from the Oracle Cloud Adapter CSF Key Page

You can specify the following CSF key values for the Oracle Cloud adapter.

- CSF key name

- Company name for the Oracle Eloqua Cloud adapter only.

- User name and password

What You See on the Oracle Cloud Adapter CSF Key Page

The following table describes the key information on the Oracle Cloud adapter CSF Key page.

Element

Description

CSF Key Name

Specify the CSF key to enable runtime injection of credentials. The adapter uses the CSF to retrieve the username and password required for authentication with the application (for example, the Oracle Sales Cloud or Oracle HCM application). This key identifies your login credentials during design-time. To successfully deploy and administer your application, you must specify these same values in Oracle Enterprise Manager Fusion Middleware Control. For instructions, see the Oracle Cloud Adapters Postinstallation Configuration Guide.

Company Name

Note: This field is only displayed for the Oracle Eloqua Cloud adapter.

Specify the Oracle Eloqua company name.

User Name

Enter the user name for connecting to your application (for example, the Oracle Sales Cloud or Oracle HCM application). Your administrator provides you with user credentials.

Password

Enter the password for connecting to your application.

Re-enter Password

Re-enter the same password a second time.

Configuring Oracle RightNow Cloud Source Request Properties

Enter the Oracle RightNow Cloud source request values for your integration. The values you specify start the integration.

Topics

- What You Can Do from the Oracle RightNow Cloud Source Request Page

- What You See on the Oracle RightNow Cloud Source Request Page

What You Can Do from the Oracle RightNow Cloud Source Request Page

You can configure the following request value for Oracle RightNow Cloud.

- Select the business object that you want to receive from the Oracle RightNow Cloud application as a request document to start this integration.

What You See on the Oracle RightNow Cloud Source Request Page

The following table describes the key information on the Oracle RightNow Cloud source Request page.

Element

Description

Select Business Object

Select the business object that you want to receive from the Oracle RightNow Cloud application as a request document to start this integration.

Object Name Filter

Enter the initial letters to filter the display of business objects. You can also select a filter type:

- All: Displays all objects.

- Custom: Displays objects you created. These business objects are identified by special icons. The naming convention is a combination of the package name and object name joined by a “.”. For example, if there is a custom object package called CO and an object named PurchaseProduct, the wizard displays the custom object as CO.PurchaseProduct.

- Standard: Displays business objects delivered as part of the standard Oracle RightNow Cloud application.

Configuring Oracle RightNow Cloud Source Response Properties

Enter the Oracle RightNow Cloud source response values for your integration.

Topics

- What You Can Do from the Oracle RightNow Cloud Source Response Page

- What You See on the Oracle RightNow Cloud Source Response Page

What You Can Do from the Oracle RightNow Cloud Source Response Page

You can configure the operation and business object that comprise the response type for Oracle RightNow Cloud.

- No response is required (fire and forget): You deselect the Send checkbox on the Response page because a response is not required.

- Immediate (synchronous) response: A response business object is immediately returned as output. You select Immediate as the response type on the Response page and select the business object as part of the response to the client.

What You See on the Oracle RightNow Cloud Source Response Page

The following table describes the key information on the Oracle RightNow Cloud source Response page.

Select the type of response appropriate to your business requirements:

- No response is required (fire and forget) (See Table 1-1 for instructions)

- Immediate (synchronous) response is required (See Table 1-2 for instructions)

The following table describes the fields available if no response is required (fire and forget).

Table 1-1 Response Type — No Response is Required (Fire and Forget)

Element

Description

Send

Deselect if a response is not required. This option disables the selection of business objects because none are required.

Response Type

If you deselect the Send checkbox, this section is disabled.

Select Business Object

If you deselect the Send checkbox, this section is disabled.

The following table describes the fields available if an immediate (synchronous) response is required.

Table 1-2 Response Type — Immediate (Synchronous) Response is Required

Element

Description

Immediate Response

Select Immediate for the Oracle RightNow Cloud application to wait until a response is received from the integration. This is also known as the request and response message exchange pattern. This is the default selection.

Also Send faults

Select this checkbox if you want to send fault information to the Oracle RightNow Cloud application if any errors are encountered by the integration while processing the request. This is an optional checkbox only available with the Immediate response type.

Object Name Filter

Enter the initial letters to filter the display of business objects. You can also select a filter type:

- All: Displays all objects.

- Custom: Displays objects you created. These business objects are identified by special icons. The naming convention is a combination of the package name and object name joined by a “.”. For example, if there is a custom object package called CO and an object named PurchaseProduct, the wizard displays the custom object as CO.PurchaseProduct.

- Standard: Displays business objects delivered as part of the standard Oracle RightNow Cloud application.

Select Business Object

Select the business object for the integration to send as a response document to the Oracle RightNow Cloud application.

Configuring Oracle RightNow Cloud Target Operation Properties

Enter the Oracle RightNow Cloud target operation values for your integration.

Topics

- What You Can Do from the Oracle RightNow Cloud Target Operations Page

- What You See on the Oracle RightNow Cloud Target Operations Page

What You Can Do from the Oracle RightNow Cloud Target Operations Page

You can configure the following values for Oracle RightNow Cloud:

- Select to create a single operation or multiple operations in a batch.

- Select the operation (CRUD, Miscellaneous, or RightNow Object Query Language (ROQL)).

- Select the business objects.

- Enable aspects of server-side processing.

What You See on the Oracle RightNow Cloud Target Operations Page

The following table describes the key information on the Oracle RightNow Cloud target Operations page.

Element

Description

Select an Operation Mode

Select the operation mode in which to define business objects:

- Single Operation: Select to configure a single operation.

- Batch Operation: Select to configure multiple operations in a batch. This enables you to run multiple operations in a defined sequence.
Selecting this option refreshes the page to display options for the following:

- Add an operation to the list link: Click to create a list of batch operations and their business objects. The operations are performed in the order in which they appear in the list (from top to bottom).

- Edit icon: Click to edit an operations row in the table or change the order of batch operations.

- Delete icon: Click to delete a selected operation row in the table.

Select an Operation Type

Select the type of operation to perform on the business objects in an Oracle RightNow application:

- CRUD: Represents the create, read, update, delete, or destroy operations to perform on Oracle RightNow business objects. Each letter maps to a standard SQL statement, HTTP method, or DDS operation. Select the CRUD operation to perform on the business object: Create, Destroy, Get, or Update.

- MISC: Represents the set of specialized tasks operations (such as sending emails to users) to perform in the Oracle RightNow application.

- ROQL: (RightNow Object Query Language) enables you to define an ROQL-based query to send as a request to perform in the Oracle RightNow application. If you select this option, the page is refreshed to display a field for entering a query.

- Enter an ROQL query statement: Enter a valid ROQL query. For example:

SELECT contacts FROM organization WHERE name = 'RightNow'

The query can include custom fields and parameters.

- Parameter Bindings: Displays any parameter bindings included in the specified query. For example, orgId is a parameter in the following query:

SELECT Organization FROM Organization WHERE id = &orgId
Enter a query with a parameter and reselect QueryObjects from the dropdown list. This displays a text box in which to enter a test value for the parameter.

- Test My Query: Click to validate the query against the Oracle RightNow application. Query results are displayed. If errors occur, you receive results about how to correct the query.

Filter by object name

Enter the initial letters of an object name to display a range of objects. You can also select a filter type:

- All: Displays all objects.

- Custom: Displays objects you created. These business objects are identified by special icons. The naming convention is a combination of the package name and object name joined by a '.'. For example, if there is a custom object package called CO and an object named PurchaseProduct, the wizard displays the custom object as CO.PurchaseProduct.

- Standard: Displays business objects delivered as part of the Oracle RightNow application.

Select Business Objects

Select a single business object or multiple business objects from the Oracle RightNow application. The selected operation acts upon these business objects. The RightNow version 1.2 API is supported.

When you complete target operation configuration, the selected operation and business objects are defined in the integration-centric WSDL file.

Processing Options

Select to enable aspects of server-side processing. By default, no options are selected.

- Suppress External Events: Select to prevent the Oracle RightNow application from processing any external events raised after the completion of create, update, or delete operations.

- Suppress Rules: Select to prevent business rules from running after the completion of create, update, or delete operations. Business rules are tools for simplifying and automating common business tasks. See the RightNow documentation for more information.

- Suppress Response: Select to prevent the CRUD Create operation from returning a response ID. If this check box is disabled, the Create operation returns an ID of the created object.

- Commit After: Select to group multiple operations in a single transaction. At runtime, when a set of operations in a batch are defined as part of a single operation, the Commit After action is sent after the last operation in that transaction boundary. When an operation from the subset of the batch operation fails, it is handled by throwing a fault to the client. This option is only available with batch operations.

Reviewing Configuration Values on the Summary Page

You can review the specified source or target connector configuration values on the Summary page.

Topics

- What You Can Do from the Summary Page

- What You See on the Summary Page

What You Can Do from the Summary Page

You can review source or target configuration details from the Summary page. The Summary page is the final wizard page for each connection after you have completed your configuration.

- View the configuration details you defined for the source or target. For example, if you have defined an inbound Oracle RightNow Cloud source with a request business object and immediate response business object, specific details about this configuration are displayed on the Summary page.

- Click Done if you want to save your configuration details.

- Click a specific tab in the left panel to update your configuration definitions.

What You See on the Summary Page

The following table describes the key information on the Summary page.

Element

Description

Summary

Displays a summary of the source or target configuration values you defined on previous pages of the wizard. To return to a previous page to update any values, click the appropriate tab in the left panel.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2019, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

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.

Warranty Disclaimer

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.

Restricted Rights Notice

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.

Hazardous Applications Notice

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.

Trademark Notice

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.

Third-Party Content, Products, and Services Disclaimer

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.

Pre-General Availability Draft Documentation Notice

If this document is in public or private pre-General Availability status:

This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Pre-General Availability Draft Documentation Notice

If this document is in private pre-General Availability status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your pre-General Availability trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

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.