12 Configuring and Using Oracle Enterprise Repository as the Oracle AIA SOA Repository

This chapter discusses how to use Oracle Enterprise Repository (OER) as Oracle AIA SOA Repository, provide EBO and EBM documentation links in OER and access Oracle AIA content in OER.

This chapter includes the following sections:

12.1 Introduction to Using Oracle Enterprise Repository as the Oracle AIA SOA Repository

Oracle Application Integration Architecture (AIA) leverages Oracle Enterprise Repository as its SOA repository solution, providing a centrally managed user interface for discovering and learning about the SOA assets in your Oracle AIA ecosystem.

Specifically, all prebuilt AIA design-time interfaces, including Enterprise Business Service (EBS) WSDL files, Application Business Connector Service (ABCS) WSDL files, Enterprise Business Object (EBO) XSD files, Enterprise Business Message (EBM) XSD files, and their underlying artifacts, relationships, and metadata are delivered through Oracle Enterprise Repository.

Beyond this, you also can publish run-time, deployed composites into Oracle Enterprise Repository. As such, Oracle Enterprise Repository can provide visibility and coverage across the span of the SOA design-time and run-time lifecycles.

Solution Packs

Solution packs are an Oracle Enterprise Repository mechanism used to deliver content in bulk. The prebuilt AIA SOA portfolio is shipped as a solution pack. You can import the solution pack into your on-premise Oracle Enterprise Repository instances to view, access, and evaluate the AIA SOA portfolio.

The importing of an AIA solution pack to Oracle Enterprise Repository is a task that is independent of the installation of AIA. If you intend to use Oracle Enterprise Repository in your enterprise, you can import an AIA solution pack before or after your AIA installation. In fact, you can even import an AIA solution pack without purchasing or installing AIA.

The importing of an AIA solution pack does require that you perform the prerequisite steps documented in Section 5.1, "How to Set Up Oracle AIA Content Harvesting."

For more information about performing these imports, see "Importing Items into Oracle Enterprise Repository" in Oracle Fusion Middleware User's Guide for Oracle Enterprise Repository.

Note:

While the AIA solution pack import is in progress, ensure that no other activities occur on the target Oracle Enterprise Repository instance.

After AIA design-time artifacts and deployed composites have been published into Oracle Enterprise Repository, your enterprise can search for, browse, and view them in Oracle Enterprise Repository. By keeping Oracle Enterprise Repository synchronized with your AIA ecosystem, you ensure that it can serve as the system of record for your business services and their topologies.

Potential users of Oracle Enterprise Repository as a SOA repository are active across the span of the SOA development lifecycle and include functional and business analysts, architects, developers, system integrators, and system administrators.

For example, a business analyst working on requirements for building a particular business process can use Oracle Enterprise Repository to determine which business capabilities are available in a particular integration area and then determine which additional capabilities must be built. The capabilities are delivered in the form of application-independent services and objects.

Additionally, solution architects can use Oracle Enterprise Repository during their functional analysis (using Project Lifecycle Workbench) to evaluate the potential for service reuse.

For more information about viewing Oracle AIA artifacts and composites in Oracle Enterprise Repository, see Section 12.3, "How to Access Oracle AIA Content in Oracle Enterprise Repository."

For more information about Project Lifecycle Workbench, see Chapter 3, "Working with Project Lifecycle Workbench."

12.2 How to Provide EBO and EBM Documentation Links in Oracle Enterprise Repository

Objective

AIA delivers HTML documentation for each EBO and EBM, which you can link to from respective EBO and EBM entry detail pages in Oracle Enterprise Repository.

To do this, set up an Oracle Enterprise Repository artifact store to enable Oracle Enterprise Repository to provide links to AIA EBO and EBM HTML documentation provided on an AIA web server.

If you do not perform this setup, the AIA Reference Doc link appears on EBO and EBM detail pages in the Oracle Enterprise Repository, but does not lead anywhere.

Actor

System administrator

How to provide EBO and EBM HTML documentation links in Oracle Enterprise Repository

  1. Access the Oracle Enterprise Repository user interface (UI): http://<host>:<port>/oer. Click the Edit/Manage Assets link in the Assets menu to launch the Asset Editor.

  2. In the Asset Editor, navigate to Actions, Configure Artifact Stores.

    Click Edit to add a new AIA artifact store. The artifact store must be named AIA.

    You must manually add this artifact store when setting up the Oracle Enterprise Repository for the first time.

  3. In the Create a new Artifact Store dialog box, as shown in Figure 12-1, define the Hostname value for the AIA artifact store, which is the <host>:<port> value for the AIA web server installation. Define the Path value as /AIA/faces.

    The Hostname and Path values express the AIA location at which EBO and EBM HTML documentation can be accessed through the HTTP protocol.

    Figure 12-1 Edit Artifact Store Dialog Box

    This image is described in surrounding text
  4. Click OK.

12.3 How to Access Oracle AIA Content in Oracle Enterprise Repository

Objective

Access AIA content in the Oracle Enterprise Repository.

Prerequisites and Recommendations

Actors

  • Business analysts

  • Solution architects

  • Developers

  • Functional analysts

  • Integration architects

  • Release engineers

  • System administrators

  • System integrators

To access Oracle AIA design-time artifacts and deployed composites in Oracle Enterprise Repository:

  1. Access the Oracle Enterprise Repository to which your AIA design-time artifacts and deployed composites have been published.

    Use Oracle Enterprise Repository search and browse functionality to locate AIA content.

    For more information about using Oracle Enterprise Repository, see Oracle Fusion Middleware User's Guide for Oracle Enterprise Repository.

  2. To narrow your search to AIA asset types, select an AIA: <XYZ> value in the Type drop-down list box in the Search menu. For example, by selecting AIA: EBO, you can narrow your search to AIA EBOs only.

    When viewing EBOs and EBMs in Oracle Enterprise Repository, you can click the AIA Reference Doc link as shown in Figure 12-2 to access HTML documentation about the content.

    Figure 12-2 AIA Reference Doc Link

    This image is described in surrounding text

For more information about providing links to EBO and EBM HTML documentation from EBO and EBM detail pages in Oracle Enterprise Repository, see Section 12.2, "How to Provide EBO and EBM Documentation Links in Oracle Enterprise Repository."