Skip Headers
Oracle® WebCenter Administrator's Guide for Application Adapters
11g Release 1 (11.1.1)

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

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

1 Introduction to Application Adapter Solutions

This chapter describes the application adapters for Oracle WebCenter. The adapters include the Imaging Solution, which provides imaging, capture, and workflow capabilities using Oracle WebCenter Content: Imaging, and the Managed Attachments Solution, which enables business users to attach, scan, and retrieve document attachments stored in an Oracle WebCenter Content Server (Content Server) repository.

This chapter covers the following topics:

1.1 About Application Extension Framework (AXF)

Oracle WebCenter Content business application integration solutions use the Application Extension Framework (AXF) infrastructure, a command-driven, web services integration, to integrate a business application such as Oracle E-Business Suite or Oracle PeopleSoft with a content management application such as Imaging or Content. AXF's open Java-based architecture enables integrators to configure and modify multiple Oracle WebCenter Content business application integrations solutions separate from the business applications themselves.

AXF is provided in two versions:

Note:

Both AXF for BPM and AXF for BPEL are included in Imaging installation. The BPEL version is automatically included with Imaging and the BPM version is available for selection.

An AXF solution is a micro-application whose components are created using either AXF infrastructure. Solutions are installed on top of a base configuration of core AXF and business application files standard to solutions that use AXF functionality.

Both Imaging solutions (the BPM imaging solution and the BPEL imaging solution) provide user interface components that form a task list that lists assigned human workflow tasks and a task detail area where users acquire, complete, and release human workflow tasks.

You can use either AXF structure with the Managed Attachments solution. (If using both solutions, it is recommended that you use the same AXF version.)

1.2 About the BPM Imaging Solution

This section covers the following topics:

1.2.1 Business User View of the BPM Imaging Solution

From a business user's perspective, the integration is virtually seamless. End-users use the BPM Imaging solution to:

  • Launch the BPM imaging solution from their business application (or via an email notifying them of an assigned task), and select and perform workflow tasks. For example, users processing tasks might select a custom button, link, or menu command integrated into their business application, initiating the following processes:

    • A SOAP request is generated and sent to AXF, passing the selected command along with additional parameters such as an AXF solution (SalesQuoteEntry), an AXF command (StartSalesQuoteEntry), and a user name.

    • AXF returns an OPEN_BROWSER command with the URL to launch, the AXF Solution Workspace.

    • The business application displays the BPM Views, Task List, and Task Details in the AXF Solution Workspace page in a new browser window.

  • The user selects a task from the task list, and its details display in the solution application area. The user reviews and keys entries in the business application and/or the task detail area while viewing images and related values.

  • The business user performs actions related to the workflow task, such as routing, canceling, updating, and completing tasks.

1.2.1.1 Imaging Scenario 1: Entering Sales Quotes

The HelloBPM solution installed with AXF provides an example imaging reference solution based on sales quote entry. It provides a non-production example for use in confirming installation and system operation and as the basis for portions of the documentation. It works as follows:

  1. A workflow process automatically generates user tasks.

    A sales quote is uploaded, data values are assigned, and a task for processing the quote is generated. Typically, tasks are pooled into views from which groups of users select. A user may have access to tasks in multiple views.

  2. From the business application, the user launches the imaging solution, by clicking a button or link or selecting a command called StartSalesQuoteEntry.

  3. The user selects a task from those listed for a selected assignee. Once a task is selected (acquired), it is no longer available to other users.

  4. In the solution application, users view the task's image, key entries based on the image, and perform related commands.

    Additional action commands are provided in top portion of the solution application. Users might route the task to another user or user group for approval, add comments for others to view, or route the task for account management.

  5. Users complete the task and begin another, if desired.

Note:

For details about imaging solution user tasks, see the Oracle WebCenter User's Guide for Application Adapters.

1.2.2 About the Business Tier Agility Administrator Role

This administrator configures the solution to match particular business needs by making changes to business rules in Solution Administration. For example, this administrator can add or change task actions, configure navigation to control pages, configure page components, change data and table display and editing, add validations and prompts, and add or change tabs. After saving, changes are immediately visible in the user interface (Section 5.2.3).

Business tier agility administrators must have access to WebCenter Content Solution Administration, which provides access to the Business Rule Editor. (These administrators must be assigned to the axfadmin group in Oracle WebLogic Server.) They must also have an understanding of Oracle Business Rules, the BPM processes, and their payload. For more information, see Chapter 5.

1.2.3 About AXF Commands Used by the BPM Imaging Solution

The reusable AXF commands allow you to implement the functionality described below. For information about these commands, including their parameters and example implementations, see Section A.3.

BPM AXF Command Description

Open Solution Workspace

Returns an instruction to the requester to open a browser with a URL to the AXF solution workspace. See Section A.3.1.

Update Task

Updates the BPM task referenced in the AXF conversation associated with the AXF request. Updates BPM task payload data given the arguments passed in the request and signals the AXF solution application. See Section A.3.2.

Document Search

Retrieves documents stored in the document repository system for display in the viewer. A URL is configured in AXF configuration which specifies the search URL with optional parameters that can be passed from the business application and appended to the search URL string. See Section A.3.3.


1.2.4 About BPM Imaging User Interface Components

This section covers the following topics:

1.2.4.1 About the Solution Workspace

The AXF for BPM infrastructure provides a configurable user interface through its solution workspace. This workspace comprises the entire window shown in Figure 1-1, and surfaces a list of BPM tasks, views, and other interface components to allow users to manage and complete assigned tasks.

  • The solution workspace provides the primary entry point into all solutions.

    Users typically access the workspace through their Line of Business integration (for example, through Oracle E-Business Suite or Oracle PeopleSoft), or through an email link sent from BPM.

  • The solution workspace displays the human tasks assigned to the user in an interface that contains the following panes shown in Figure 1-1:

    • Views, which displays BPM views for the user's work context.

    • Task List, which displays a list of assigned BPM tasks from which the user selects. For configuration information, see Section 5.5.

    • Solution Application, which displays the user interface representing a specific human task's details. For more information, see Section 1.2.4.2.

Figure 1-1 Solution Workspace

Description of Figure 1-1 follows
Description of "Figure 1-1 Solution Workspace"

1.2.4.2 About the Solution Application

The solution application uses a Dynamic Page Template common to all pages, that contains the elements described below and shown in Figure 1-2. The user interface and template functionality are driven by business rules contained in dictionaries.

  • Action control (or menu bar), which extends the full width of the solution application at its top. It contains actions that users can perform on the selected task. For example, actions links might enable users to approve, reject, route, or close the task.

    The actions that display in this area depend on configuration, such as whether a context is used that displays certain actions to some user roles and not others.

  • Dynamic tabs, which extend below the action control, and where business users perform the bulk of the tasks.

    The tabs that display in this area depend on configuration, such as whether a context is used and which page components are implemented.

Administrators edit the solution application using Oracle Business Rules, as described in Chapter 5. The solution's functional blocks define its functional units of work.

Figure 1-2 Solution Application

Description of Figure 1-2 follows
Description of "Figure 1-2 Solution Application"

1.3 About the BPEL Imaging Solution

A workflow Imaging solution is an integration between a business application and BPEL (Oracle BPEL Process Manager), using Imaging as the imaging source. Through an AXF configuration, business users can process associated images and perform document-centric workflow tasks from their business application user interface.

This section covers the following topics:

1.3.1 Business User View of the BPEL Imaging Solution

From a business user's perspective, the integration is virtually seamless. End-users use the Imaging solution to:

  • View attached images and metadata values. Use Imaging's tools for viewing, annotating, and redacting images, as permissions allow.

  • Key entries in the business application while viewing images and related values in the Imaging viewer.

  • Perform actions related to the workflow task, such as routing, canceling, updating, and completing tasks.

  • Scan or upload supporting documents for a selected business application record.

  • View supporting images for a business application record without leaving the business application.

1.3.1.1 Imaging Scenario 1: Processing Invoices

A BPEL Imaging Solution configured for invoice processing might work as follows:

  1. A workflow process automatically generates user tasks.

    An invoice is uploaded, metadata values are assigned, and a task for processing the invoice is generated. Typically, tasks are pooled into profiles from which groups of users select. A user may have access to tasks in multiple profiles.

  2. From the business application, the user launches the Imaging Solution, by clicking a button or link or selecting a command called Process Invoices.

  3. The user selects a task from those listed for a selected profile. Once a task is selected (acquired), it is no longer available to other users.

  4. In the Task Viewer, users view the task's invoice image, key entries in the business application based on the image, and perform related commands.

    Additional action commands are typically provided in a side panel. Users might route the task to another user or user group for approval, add comments for others to view, skip the task, or re-scan or delete the task's document.

  5. Users complete the task and begin another, if desired.

    Most often, changes users make in the business application are synchronized with Imaging, and vice versa.

Note:

For details about Imaging Solution user tasks, see the Oracle WebCenter User's Guide for Application Adapters.

1.3.1.2 Imaging Scenario 2: Capturing Supporting Employee Documents

An Imaging Solution configured for capturing supporting documents might work as follows:

  1. From the business application, a user retrieves a record such as an employee record.

  2. The user launches the document imaging solution, by clicking a link or button or selecting a command called Scan Employee Document.

  3. Oracle Distributed Document Capture launches and automatically initiates a scan (if a scanner is attached to the desktop) or enables the user to upload electronic images from desktop.

  4. The user enters index values (metadata) in Oracle Distributed Document Capture to store with the images.

  5. The user clicks Send, which transmits the captured document images and their metadata from Oracle Distributed Document Capture to Imaging.

1.3.1.3 Imaging Scenario 3: Viewing Supporting Employee Documents

An Imaging Solution configured for viewing supporting documents might work as follows:

  1. From the business application, a user retrieves a record such as an employee record.

  2. A user launches the document imaging solution, by clicking a button or link or selecting a command called View Employee Documents.

  3. From the list of documents associated with the employee record and their metadata values, the user selects a document.

  4. The document displays in the Imaging viewer, where the user can view its images, and with appropriate permissions, apply annotations or redactions.

1.3.2 About AXF Commands Used by the BPEL Imaging Solution

The reusable AXF commands allow you to implement the functionality described below. For information about these commands, including their parameters and example implementations, see Section B.3.

BPEL AXF Command Description

Open Task

Displays the AXF Task Viewer web page and claims a human workflow task. See Section B.3.1.

Autotask

Displays autotask mode, in which a new human workflow task is automatically claimed in the AXF Task Viewer without displaying the Task List. See Section B.3.2.

Release Task

Releases a human workflow task, and, if configured, executes additional actions. See Section B.3.3.

Complete Task

Completes a human workflow task, and, if configured, updates BPEL payload attribute values and executes additional actions. See Section B.3.4.

Redirect

Redirects the current AXF web page to any URL or AXF web page specified in the configuration. See Section B.3.5.

Terminate Conversation

Used by an external client to terminate a conversation with AXF. (This command does not include parameters.)

Update Task

Updates BPEL payload field values on a specified human task or values in the XML payload using XPATH. See Section B.3.6.

Update Task From Procedure

Calls a stored procedure using a specified data source and updates values in the BPEL payload using XPATH. See Section B.3.7.

Validate Task

Used to validate BPEL system attribute data or BPEL payload data using the Regular Expression language, and based on validation results, execute a subsequent command. See Section B.3.9.


Note:

You can also deploy custom commands and chained commands to execute through AXF. See Section 6.4.8 and Section 6.4.9.

1.3.3 About BPEL Imaging User Interface Components

The BPEL Imaging Solution provides the following user interface components. These are web interface components displayed to users and configured through the AXF tables. Once populated, you can modify the components using Imaging's Solution Editor, as described in Section B.2.1.

1.3.3.1 About the Task List

The Task List web page shown in Figure 1-3 displays a list of available tasks to users. It interacts with the AXF infrastructure and BPEL to display the list using views configured in the BPEL Worklist application.

Note:

Use the BPM Worklist application to create views and share them with other users or groups.

For configuration information, see Section B.2.2.

Figure 1-3 Task List Web Tool

This graphic is discussed in surrounding text.
Description of "Figure 1-3 Task List Web Tool"

The Task List web tool can also display a list of AXF actions, using AXF action commands.

1.3.3.2 About the Task Viewer

The Task Viewer web page shown in Figure 1-4 displays images and metadata values through interaction with the AXF infrastructure, BPEL, Imaging, and the business application. It also typically displays a side menu containing AXF action commands. It may also include a summary section with metadata values, a comments section, and a dynamic data table.

For configuration information, see Section B.2.3.

Figure 1-4 Task Viewer Web Tool

This graphic is discussed in surrounding text.
Description of "Figure 1-4 Task Viewer Web Tool"

1.3.3.3 About the Enumeration Picker

The Enumeration Picker web page shown in Figure 1-5 enables users to select from a list of enumerated values.

For configuration information, see Section B.2.4.

Figure 1-5 Enumeration Picker Web Tool

This graphic is discussed in surrounding text.
Description of "Figure 1-5 Enumeration Picker Web Tool"

1.3.3.4 About the Identity Picker

The Identity Picker web page shown in Figure 1-6 enables users to select one or more users or groups from an identity store configured for BPEL. After the user chooses an identity, AXF typically performs a related, configurable action. Most likely, it assigns or delegates a task to the selected user or group of users. For example, a business user who encounters a problem with a transaction might select an exception handler to send the transaction to, after entering a comment that describes the problem.

For configuration information, see Section B.2.5.

Figure 1-6 Identity Picker Web Tool

This graphic is discussed in surrounding text.
Description of "Figure 1-6 Identity Picker Web Tool"

1.3.3.5 About Comments

The Comments web page shown in Figure 1-8 enables users to enter comments related to the human task during the transaction's processing. Administrators can display comments on any AXF web page that shows data from a single task, such as the Task Viewer shown in Figure 1-4. Comments persist for the entire process, allowing users to view and add comments. BPEL workflow task saves comments using its native comments capabilities.

To view comments, users click the View Comments icon on the AXF web page, as shown below and in Figure 1-4. To add a comment, users click the Add Comment icon.

Figure 1-7 View Comments Icon (left), Add Comment Icon (right)

This graphic is discussed in surrounding text.

For configuration information, see Section B.2.3.3 and Section B.2.3.1.2.

Figure 1-8 Comments Web Tool

This graphic is discussed in surrounding text.
Description of "Figure 1-8 Comments Web Tool"

1.4 About the Managed Attachments Solution

With this solution, Content Server documents are listed as managed attachments to business application entities in a customizable window launched from a link, button, or menu, depending on business application configuration. For example, a business application user displays an Employee record, invokes the Managed Attachment functionality by clicking a button, and attaches a passport image and supporting identity documents.

Note:

In addition to applications built using Oracle E-Business Suite Forms, Oracle Applications Framework (OAF), and PeopleSoft, the Managed Attachments solution can be integrated with other business applications using the Enterprise Application Adapter Framework, as described in Section 7.4.

The Managed Attachments Solution, shown in Figure 1-9, enables business users to attach, scan, and retrieve attachments stored in a Content Server repository. An Oracle WebCenter Content Server repository enables users throughout an enterprise to view, collaborate on, and retire content, ensuring that content is secure, accurate, and up-to-date.

Figure 1-9 Managed Attachments Page

This graphic is discussed in surrounding text.
Description of "Figure 1-9 Managed Attachments Page"

This section covers the following topics:

1.4.1 Business User View of the Managed Attachments Solution

Business users can perform these tasks in the Managed Attachments solution, as an extension to their business application environment:

  • Check in new documents to Content Server and attach them to the selected business application entity

  • Scan and import documents using Oracle Distributed Document Capture, attaching them to the selected business application

  • Open documents in their native application, Web-viewable format, or AutoVue viewer (if configured)

  • Detach documents from the selected business application entity

  • Search Content Server and attach documents to the selected business application entity from the Content Server repository

  • Check out documents, locking them to changes by other users

  • Modify a document's metadata values

  • If configured, view a previous attached revision and update the attachment revision

  • View an attached document's information

Note:

For details about Managed Attachments Solution user tasks, see the Oracle WebCenter User's Guide for Application Adapters.

1.4.1.1 Attachments Scenario 1: Capturing Identity Documents

A Managed Attachments solution configured for capturing employee identity documents such as passports might work as follows:

  1. From the business application, a user retrieves a record such as an employee record.

  2. The user launches the Managed Attachments solution, by selecting a command or clicking a link or button called Scan Employee Document.

  3. Oracle Distributed Document Capture launches and automatically initiates a scan (if a scanner is attached to the desktop) or enables the user to upload electronic images from desktop.

  4. The user selects attachment settings, clicks Scan Document, then enters index values (metadata) in Oracle Distributed Document Capture to store with the images.

  5. The user clicks Send, which transmits the captured document images and their metadata from Oracle Distributed Document Capture to Content Server.

  6. The user clicks the Refresh button to see the newly scanned or imported document listed as attached to the selected employee record.

1.4.1.2 Attachments Scenario 2: Viewing and Editing Identity Documents

A Managed Attachments solution configured for viewing employee identity documents might work as follows:

  1. From the business application, the user retrieves an employee record.

  2. The user launches the Managed Attachments solution, by selecting a command or clicking a link or button called View Employee Documents.

  3. The Managed Attachments page displays, listing attachments for the employee record.

  4. An attachment may show its revision number, and if it was checked out by the user or another user. If revision-specific mode has been configured and an older revision is attached, the user can either view the older attached revision or view the newer revision and make it the new attached version.

  5. The user selects an attached document's Edit icon. As the user makes updates to the document, it is checked out to the user and other users cannot edit it. When the user checks in the revised document, its revision number is incremented.

  6. The document displays in Content Server (or the AutoVue viewer), where the user can view its images, and with appropriate permissions, apply annotations or redactions.

1.4.2 About the AXF Command and Service Used By the Attachments Solution

The Managed Attachments solution uses an AXF solution namespace called UCM_Managed_Attachments to orchestrate user requests from the business application to display the Managed Attachments user interface for the Content Server repository.

  • When the business application user activates the Managed Attachments command from a business application entity, the adapter makes an AXF request. The solution supports a single AXF command namespace called UCM_Managed_Attachments, which invokes the AF_GRANT_ACCESS command.

  • The AF_GRANT_ACCESS command implements the AF_GRANT_ACCESS service. This Content Server service temporarily grants a user who has logged into the business application access to all Content Server documents associated with the selected business application entity and to which the user has security group access. This service also returns an AXF response containing a Managed Attachments URL to invoke the Content Server attachments framework search. This framework search lists all documents associated with the business application entity.

  • With the returned URL, the adapter opens the Managed Attachments browser window for the business application user, also displaying key values (AFLabel) for the business application entity with which the attachment list is associated, and optionally passing in metadata values from the business application to Content Server.

How Content Server Access is Granted to the Business Application User

The adapter uses a temporary authorization mechanism for managed attachments access. Communicating through a trusted RIDC mechanism, AXF invokes the AF_GRANT_ACCESS service with the application entity and user information needing authorization. The AF_GRANT_ACCESS service grants access to the user for the specified period, then ends the user session.

1.5 About Adapter Components

This section describes the main components of the application adapters in the following topics:

1.5.1 Business Application Plug-In

This portion consists of a business application plug-in: Oracle E-Business Suite, Oracle PeopleSoft, both, or another business application.

  • Oracle E-Business Suite: Configuring the Oracle E-Business Suite plug-in consists of running PL/SQL scripts against the Oracle E-Business Suite database that populate tables and configure functionality. See Chapter 2. AXF-related Oracle E-Business Suite tables enable AXF components on Oracle E-Business Suite forms or pages.

    • For Forms configurations, you also upload files to the Oracle E-Business Suite system that integrate custom actions with pre-existing Oracle E-Business Suite Forms.

    • For OAF configurations (available for Managed Attachments only), you import files to the MDS repository and add a Managed Attachments button via OAF page personalization.

  • PeopleSoft: Configuring the Oracle PeopleSoft plug-in consists of importing the Oracle PeopleSoft project, configuring the Integration Broker to communicate with AXF, setting user roles, and enabling AXF functionality on Oracle PeopleSoft pages. See Chapter 3. AXF-related Oracle PeopleSoft tables enable AXF components on Oracle PeopleSoft pages.

  • Other business application: A generic component called the Enterprise Application Adapter Framework allows you to customize the Managed Attachments solution for use with a business application other than Oracle E-Business Suite or Oracle PeopleSoft. For more information, see Section 7.4.

1.5.2 AXF Infrastructure

The AXF integration infrastructure employs a service layer that handles requests from business application integration adapters. The infrastructure is included in Oracle WebCenter Content installation, and AXF tables are automatically created during installation.

The AXF infrastructure contains the following components:

1.5.2.1 Solution Mediator

The solution mediator receives AXF requests from the business application integration adapters. It implements a simple AXF request/response protocol to delegate abstract functional requests from the business application integration adapters to AXF command components that implement business functionality. The solution mediator is responsible for facilitating those services that are common across all AXF request/response, including invoking the Command Mediator to service the AXF request, managing the Conversation, and general error handling.

1.5.2.2 AXF Request /Response

The AXF request provides a functional request, defined by a solution namespace (representing a work thread, such as DocumentProcessing) and a command namespace (representing a service, such as StartProcessing). The AXF request may include optional arguments. The AXF response contains instructions to be performed by the requester as well as the Conversation ID (CID) used to synchronize activity between the business application and AXF solution application. The business application integration adapter stores the returned CID and includes it in subsequent requests within the same solution namespace.

1.5.2.3 Command Mediator

The command mediator maps logical functional requests to AXF commands based on the AXF request's solution namespace and command namespace.

1.5.2.4 AXF Commands

AXF commands implement business functionality. Commands may consume arguments provided by the request and return instructions to the requester through the AXF response.

  • The BPM Imaging solution uses several AXF commands, as described in Section 1.2.3.

  • The BPEL Imaging solution uses multiple AXF commands, as described in Section 1.3.2.

  • The Managed Attachments solution uses a single AXF command that implements Content Server services that temporarily display and provide access to documents associated with a business application entity. See Section 1.4.2.

1.5.2.5 Conversation

The conversation maintains the shared state between the business application and AXF solution applications. The conversation is referenced by both applications by the CID returned to the business application in the AXF response and provided as a parameter to the AXF solution application.

1.5.3 AXF User Interface Components

The adapter provides user interface components for the imaging solution, such as a task list and task detail (that includes subcomponents such as enumeration control, identity browser, metadata display, and comments).

  • For the BPM imaging solution, user interface components (solution workspace and solution application) are provided through the User Interface Library. Business agility tier administrators customize the solution's behavior by modifying BPM business rules. See Section 1.2.2 and Section 1.2.4.

  • For the BPEL imaging solution, user interface components (task list and task viewer) are configured through the AXF (WebCenter Imaging) database tables. Solution developers customize the solution using Imaging's Solution Editor or by modifying the AXF tables. See Section 1.3.3.

1.5.4 Content Server Components (Managed Attachments)

For the Managed Attachments solution, the adapter includes Content Server components bundled in ZIP files that you install and enable using Component Manager. They include the AppAdapter framework core files. See Section 7.3.

1.5.5 AXF Solution Accelerators

Oracle provides implementation accelerators for specific functions, such as automating invoice and receipt processing using workflows with associated approval rules, data entry forms, and reports.

Note:

To obtain a solution implementation accelerator, contact your systems integrator, Oracle Consulting, or Oracle Support.

1.6 About Adapter Security and Authentication

The adapters provide multiple security and authentication levels, which vary depending on the solution (BPM Imaging, BPEL Imaging, or Managed Attachments) and the business application, as identified in Table 1-1.

Table 1-1 Security Controls for the Adapter

Authentication/
Security Level
Business Applications Supported Solutions Description Configuration Information

Web Service Authentication (WSS/SOAP)

Oracle E-Business Suite and Oracle PeopleSoft

BPM Imaging, BPEL Imaging, and Managed Attachments

Occurs when web service calls are made to AXF. The solutions support user authentication against the AXF solution mediator web services using a user name token security installed on the application server on which AXF resides.

  • In Oracle E-Business Suite, set user name token authentication using an AXF_SOAP_POLICY key in the properties table (AXF_PROPERTIES or OAF_AXF_PROPERTIES).

  • In Oracle PeopleSoft, configure the Integration Broker node that communicates to AXF with user name token authentication.

For the BPM imaging solution, the solution workspace is secured via WebLogic Server security. You can avoid requiring multiple sign-ons between the business application and the solution application by enabling single sign-on (SSO).

For Oracle E-Business Suite, see Section 2.4.1.

For Oracle PeopleSoft, see Section 3.2.2.1.

SSL

Oracle E-Business Suite and Oracle PeopleSoft

BPM Imaging, BPEL Imaging, and Managed Attachments

For Oracle E-Business Suite, configure SSL settings through the AXF_CONFIGS and AXF_PROPERTIES tables (Forms) or OAF_AXF_CONFIGS and OAF_AXF_PROPERTIES tables (OAF).

For Oracle PeopleSoft, configure SSL settings via Integration Broker.

For both Oracle E-Business Suite and Oracle PeopleSoft, configure web server-based digital certificates on the business application and Oracle WebCenter Content side.

For Oracle E-Business Suite, see Section 2.4.2.

For Oracle PeopleSoft, see Section 3.2.1.

AXF to Content Server

Oracle E-Business Suite and Oracle PeopleSoft

Managed Attachments

Enable trusted communication between the host on which AXF is running and the Content Server.

See Section 7.7.4.

Document Security

Oracle E-Business Suite and Oracle PeopleSoft

Managed Attachments

Users specify private or shared access to a document upon attachment (check-in to Content Server).

  • Users can access private documents only through the Managed Attachments page.

  • Any Content Server user with the document's security group access can access shared documents.

See Section 7.7.3.


1.7 Adapter System Requirements

The adapter is composed of optional solutions installed over a base configuration of AXF, Imaging, and Content Server files standard to adapters that use AXF functionality. General requirements for the adapter are listed in this section, and supported configuration and certification information is available at:

http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

Notes:

When beginning configuration, be sure to check MyOracleSupport for the latest patches to apply.

General requirements include:

1.7.1 Oracle E-Business Suite

  • A fully functioning Oracle E-Business Suite system. The Oracle E-Business Suite application adapter supports both Oracle E-Business Suite Forms (Imaging and Managed Attachments) and OAF web pages (Managed Attachments only). See the certification matrix for supported releases. Also see the Oracle E-Business Suite requirements in Section 7.1.

  • For Forms applications, Oracle E-Business Suite Forms Builder is required for .PLL compilation. Specific releases are listed in the matrix.

  • To avoid duplicate logins, Oracle Single Sign-On or Oracle Access Manager is required. For more information, see the Oracle Fusion Middleware Application Security Guide.

    Note:

    If using Oracle Single Sign-On, an Oracle Identity Management (OIM) / Oracle Internet Directory (OID) Server is required.

1.7.2 Oracle PeopleSoft Enterprise

  • A fully functioning Oracle PeopleSoft system, including PeopleTools. See the certification matrix for supported releases.

  • To avoid duplicate logins, Oracle Single Sign-On or Oracle Access Manager is required. For more information, see the Oracle Fusion Middleware Application Security Guide.

    Note:

    If using Oracle Single Sign-On, an Oracle Identity Management (OIM) / Oracle Internet Directory (OID) Server is required.

1.7.3 SOA 11g (Imaging Solutions Only)

For either imaging solution, SOA 11g is required, along with available patch sets. A BPEL server instance is also required. BPEL is part of SOA 11g.

Note:

SOA 11g is not needed if configuring the Managed Attachments Solution only.

Note:

Specific version mapping between Oracle WebCenter Content (formerly Oracle Enterprise Content Management) and SOA Suite is required. Refer to the following certification information at:

http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

1.7.4 Oracle BPM Suite (BPM Imaging Solution Only)

If configuring AXF for BPM, Oracle Business Process Management (Oracle BPM) is required. Oracle BPM is part of BPM Suite. Oracle BPM Suite is layered on the Oracle SOA Suite.

1.7.5 Additional Managed Attachments Requirements

The Managed Attachments Solution has additional requirements, listed in Section 7.1.

The Managed Attachments solution is supported on WebSphere Application Server when Content Server is running on WebSphere Application Server and Application Extension Framework (Imaging Server) is running on Oracle WebLogic Server.

1.8 Adapter Configuration Roadmap

This section lists the major configuration steps for the adapter, after installation.

  1. If configuring the adapter for Oracle E-Business Suite, configure the Oracle E-Business Suite plug-in.

    Tasks Refer To

    Configure the Oracle E-Business Suite database by running PL/SQL scripts.

    Section 2.1

    Configure one or both Oracle E-Business Suite plug-ins:

    • For Forms configuration, compile Oracle E-Business Suite Forms by modifying PLL files.

    • For OAF configuration, add the Managed Attachments button to OAF pages via personalization.

    Secure Oracle E-Business Suite to AXF communications via SOAP security and SSL.

    Section 2.4

    Configure Oracle E-Business Suite logging.

    Section 2.5


  2. If configuring the adapter for Oracle PeopleSoft, configure the PeopleSoft plug-in.

    Tasks Refer To

    Import the Oracle PeopleSoft integration project.

    Section 3.1

    Configure Integration Broker to communicate with AXF securely and configure AXF access for Oracle PeopleSoft users.

    Section 3.2

    Place AXF components on Oracle PeopleSoft pages.

    Section 3.3

    Configure Oracle PeopleSoft logging.

    Section 3.4


  3. Configure AXF settings.

    Tasks Refer To

    Configure AXF logging.

    Section 4.1 or Section 4.2


  4. If configuring the BPM Imaging solution, complete these steps.

    Tasks Refer To

    Run the HelloBPM solution or apply a solution accelerator. Use the solution to verify BPM imaging functionality.

    Section 5.2.1

    Use Solution Administration links to configure the solution application. Manage business rules and contexts, and use the command driver to test and verify configurations such as task actions, dynamic tabs, contexts, and control pages.

    Section 5.2

    Use the HelloBPM solution and its use cases to learn business rule modification.

    Section 5.3 and Section 5.4

    Configure BPM views. (The HelloBPM solution provides BPM views configured for a single administrator user.)

    Section 5.5

    System administrators modify the configuration in Enterprise Manager, as needed.

    Section 5.6


  5. If configuring the BPEL Imaging solution, complete these steps.

    Tasks Refer To

    Configure the BPEL connection.

    Section 6.1

    Configure the AXF tables or apply a solution implementation accelerator.

    After initial configuration, use Imaging's Solution Editor to edit user interface components such as the Task List and Task Viewer.

    Section 6.2

    Section B.2.1

    Test functionality using the AXF driver page.

    Section 6.3

    Customize Imaging functionality as needed.

    Section 6.4


  6. If configuring the Managed Attachments solution, complete these steps.

    Tasks Refer To

    Ensure your configuration meets additional Managed Attachments system requirements.

    Section 7.1

    Run Managed Attachments installation scripts.

    Section 7.2

    Configure Content Server components.

    Section 7.3

    If configuring Managed Attachments for a business application other than Oracle E-Business Suite or Oracle PeopleSoft, configure the Enterprise Application Adapter Framework.

    Section 7.4

    Configure Managed Attachments variables.

    Section 7.5

    Customize Managed Attachments functionality as needed.

    Section 7.6

    Configure authentication and security.

    Section 7.7

    Configure document viewing with AutoVue (optional).

    Section 7.8

    Configure document scanning/importing with Oracle Distributed Document Capture (optional).

    Section 7.9