Go to main content
1/32
Contents
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
What's New in This Guide
New and Changed Features for 12
c
Release 1 (12.1.3)
Other Significant Changes in this Document for 12
c
Release 1 (12.1.3)
Part I Administering the Infrastructure
1
Basic Configuration
1.1
Overview
1.2
Departments
1.2.1
Creating a New Department
1.2.2
Editing Department Information
1.2.3
Deleting a Department
1.3
Roles
1.3.1
User Role Descriptions
1.3.2
Creating a New Role
1.3.3
Editing a Role
1.3.4
Deleting a Role
1.4
Access Settings
1.4.1
Granting Permissions to a Role
1.4.2
Editing Permissions
1.4.3
Verifying User Permissions
1.4.4
Security Considerations
1.4.4.1
Access Setting and the Asset Editor
1.4.4.2
Permissions
1.5
Users
1.5.1
Creating a New User
1.5.2
Viewing User Information
1.5.3
User Search
1.5.4
Cloning a User
1.5.5
Editing User Information
1.5.6
Deleting a User
1.6
Projects
1.6.1
Viewing Project Details
1.6.2
Creating a Project
1.6.3
Editing a Project
1.6.4
Reassigning Users/Usage
1.6.5
Locating a Project
1.6.6
Closing a Project
1.6.7
Adding a Relationship to a Project
1.6.8
Deleting a Project
1.7
Sessions
1.7.1
Viewing Sessions
1.7.2
Deleting a Single Session
1.7.3
Deleting Multiple Sessions
1.8
Types
1.9
Accessing Oracle Enterprise Repository Diagnostics Page
1.10
Install Java Web Start
1.10.1
Download and Install Java Web Start
1.10.2
Troubleshooting Java Web Start
1.10.3
Configure Java Web Start on Linux
2
System Settings Overview
2.1
Access System Settings
2.2
Search for System Settings
2.3
Enable System Settings Properties
2.4
Move Settings to Database
2.5
System Settings in Oracle Enterprise Repository
2.5.1
Functional Settings
2.5.1.1
General User Interface
2.5.1.2
Search
2.5.1.3
Print Asset Detail via PDF
2.5.1.4
Projects and Navigator
2.5.1.5
Assets in Progress
2.5.1.6
Policy Management
2.5.1.7
Notifications
2.5.1.8
Access Control
2.5.1.9
Software File Identification (SFID)
2.5.1.10
Use - Download
2.5.1.11
Custom Links
2.5.1.12
Reports
2.5.1.13
Miscellaneous
2.5.2
Server Settings
2.5.2.1
General
2.5.2.2
Server Resources
2.5.2.3
Email
2.5.2.4
Upload Area
2.5.2.5
Audit
2.5.2.6
Caching
2.5.3
Enterprise Authentication Settings
2.5.3.1
General
2.5.3.2
Authentication Token
2.5.3.3
Password Settings
2.5.3.4
Plugin Login Settings
2.5.3.5
LDAP and Active Directory Settings
2.5.3.6
Single Sign-On (SSO) Settings
2.5.3.7
Container Login Settings
2.5.4
Open API Settings
2.5.4.1
Open API
2.5.5
External Integration Settings
2.5.5.1
UDDI
2.5.5.2
File Stores
2.5.5.3
Rational ClearCase
2.5.5.4
Eventing
2.5.6
Import / Export and Introspection Settings
2.5.6.1
Import / Export
2.5.6.2
WSDL and XSD
2.6
Known Issues
3
Customizing Oracle Enterprise Repository
3.1
Overview
3.1.1
Accessing the Oracle Enterprise Repository Home Page
3.1.2
Customizing the Oracle Enterprise Repository Home Page
3.2
Rebranding Oracle Enterprise Repository
3.2.1
Start with CSS
3.2.2
Customizing Skins
3.2.2.1
Choosing a Skin
3.2.2.2
Creating a Skin
3.2.2.3
Images
3.2.2.4
Activating Your Custom Skin
3.2.2.5
Installing a Oracle-supplied Custom Skin in Oracle Enterprise Repository
3.2.2.6
Using the Directory Structure
3.3
Role/Department-based Homepage Display
3.3.1
Installation
3.4
Install Oracle Enterprise Repository Solution Packs
4
Configuring E-Mail Notifications and Distribution Lists
4.1
Overview
4.1.1
Using E-Mail Notifications and E-Mail Distribution Lists
4.2
Setting Up E-Mail Notification
4.3
Managing E-mail Distribution Lists
4.3.1
Creating a Distribution List
4.3.2
Updating a Distribution List
4.3.3
When List Members Are Copied on E-mails
4.4
Working with E-Mail Templates
4.4.1
Viewing E-Mail Templates
4.4.2
Editing E-Mail Templates
5
Import Export Tool
5.1
Overview
5.2
Using the Import/Export Tool
5.2.1
Overview
5.2.2
The parameter.properties File
5.2.2.1
Supported Parameters in the parameter.properties File
5.2.2.2
Sample parameter.properties File
5.2.3
The Default Import Behavior
5.3
Starting the Import/Export Tool
5.3.1
Launching from Oracle Enterprise Repository
5.3.2
Launching from Outside of Oracle Enterprise Repository
5.3.3
Initial Startup
5.4
Export Items from Oracle Enterprise Repository
5.5
Importing Items into Oracle Enterprise Repository
6
Configuring Reporting with BI Publisher
6.1
Deploy Oracle Enterprise Repository Pre-configured BI Publisher Content
6.1.1
Configure BI Publisher with Oracle Enterprise Repository
6.2
Understanding the Security Model
6.2.1
The Administrator User
6.2.2
The OER User and OER_REPORTS Role
6.2.3
Set Local Time Zone for Report Footer
6.3
Configuring the Oracle Enterprise Repository JDBC Data Source
6.4
Configuring the BI Publisher Server - Cache Expiration
6.5
Configuring the Oracle Enterprise Repository System Settings to Enable Reporting
6.6
Working with Reports
6.6.1
Understanding Report Types
6.6.2
Adding Custom Reports
6.6.2.1
Overview
6.6.2.2
Configuration Steps
6.6.3
Running a Report
Part II Administering the Asset Lifecycle
7
Using the Type Manager
7.1
Overview
7.2
Launching the Type Manager
7.2.1
Type Manager Views
7.2.1.1
The Editor
7.2.1.2
The Viewer
7.3
Creating a New Type
7.4
Configuring Tabs to Support Registration Workflow
7.4.1
Adding Tabs
7.4.2
Change the Position of a Tab
7.4.3
Editing Tabs
7.4.4
Deleting Tabs
7.5
Tab Elements
7.5.1
Working with Elements
7.6
Adding Images for Type Manager Icons
7.6.1
Icon Image Requirements
7.6.2
View/Select Available Type Icons
7.7
Unique ID
7.7.1
Adding the Unique ID Element to a Type
7.7.2
Information Necessary for Custom Reporting
7.8
Common Metadata Viewers
7.8.1
XPath Common Metadata Viewer
7.8.2
XSLT Common Metadata Viewer
7.9
Viewing and Editing Type XML Schemas
7.9.1
Configuring XML Schemas
7.9.2
Using the Export Schema Feature
7.9.3
Using the Type XML Editor
8
Configuring and Using Automated Harvesting
8.1
Getting Started with Harvester
8.1.1
Prerequisites
8.1.2
Harvester Functionality
8.1.3
Artifacts/Products Version Matrix
8.2
Configuring the Harvester
8.2.1
Obtaining the Harvester
8.2.2
Configuring the Harvester for the Command Line
8.2.2.1
Setting Repository Connection Information for the Command Line
8.2.2.2
Selecting the Artifacts to Harvest for the Command Line
8.2.3
Invoking the Harvester Using the Repository.Submit Ant Task
8.2.3.1
Specifying Parameters for the repository.submit Ant Task
8.2.3.2
Specifying Parameters as Nested Elements
8.2.3.3
Running the Harvester from Ant
8.2.3.4
Using the Third-Party Tasks
8.2.4
Invoking Harvester from WLST
8.2.5
Runtime Harvesting Details
8.2.5.1
Harvesting from Oracle SOA Suite Server
8.2.5.2
Harvesting Web Services from WebLogic Server
8.2.5.3
Harvesting Web Services from Oracle Service Bus
8.2.5.4
Harvesting Deployed Services
8.2.6
Performing Optional Harvester Configuration
8.2.6.1
Oracle Metadata Service URLs
8.2.6.2
Classpath URLs
8.2.7
Configuring Logging for the Harvester
8.2.8
Transaction Handling in Harvester
8.2.9
Advanced Configuration
8.3
Harvesting of Artifacts
8.3.1
Harvesting Artifacts
8.3.1.1
BPEL
8.3.1.2
WSDL
8.3.1.3
WADL
8.3.1.4
XSD
8.3.1.5
XSL
8.3.1.6
Harvesting Oracle SOA Suite
8.3.1.7
JCA Adapters
8.3.1.8
Applications via Oracle BSE (WSDL/SOAP)
8.3.1.9
Proxy Service or Business Service
8.3.1.10
Oracle Service Bus (OSB) Project
8.3.1.11
BPMN
8.3.2
Detecting Duplicate Artifacts
8.3.3
Downloading Harvested Artifacts
8.3.4
Searching Harvested Assets
8.3.4.1
Using Consumption Method
8.3.4.2
Using Metadata
8.3.5
Previewing of the Created Assets in Harvester
8.3.6
Best Practices
8.3.6.1
Recommended Privileges for Harvesting
8.3.6.2
Do Not Override the Namespace Parameter
8.3.6.3
Namespaces in WSDL Files
8.3.6.4
Harvesting Completed Work
8.3.6.5
Harvesting and Maintenance Releases of XSD
8.3.6.6
Harvesting Metadata throughout the Asset Lifecycle
8.3.6.7
Downloading WSDL Artifacts
8.3.6.8
Harvesting Retired Endpoints
8.3.6.9
Harvesting SOA Projects
8.3.6.10
Harvesting a File in the Harvester Folder
8.3.6.11
Running Harvester and Exchange Utility on the Same Computer
8.3.6.12
Harvesting Composite Service WSDL
8.3.6.13
Understanding Versioning of Assets
8.3.7
Known Issues
8.3.7.1
Asset Types Must be Present in the System
8.3.7.2
Two Versions of an Asset Type
8.3.7.3
Do Not Delete the Harvester-Specific Metadata Entries in a in a Harvested Asset
8.3.7.4
Supported Remote Server Types
8.3.7.5
Using Incorrect Encrypted Password
8.3.7.6
View in Repository Option
9
Using the Asset Editor
9.1
Overview
9.2
Launching the Asset Editor
9.3
Configuring System Options
9.3.1
Configure Acceptable Value Lists
9.3.2
Configure Artifact Stores
9.3.3
Selecting a New Artifact Store
9.3.4
Configure Categorizations
9.3.5
Configure Relationships
9.3.5.1
Configure System-Supplied Relationships
9.3.6
Configure Rejection Reasons
9.3.7
Configure Vendors
9.4
Advanced Asset Submission
9.5
Asset/Compliance Template/Policy Migration
9.5.1
Migrating an Asset/Compliance Template/Policy
9.6
Understanding the Asset Registration Process
9.6.1
Accepting a Submitted Asset
9.6.2
Registering an Asset
9.6.2.1
Approving an Asset's Tabs
9.6.2.2
Completing the Registration Process
9.6.3
Adding a Note to an Asset
9.7
Understanding Asset Status
9.7.1
Assigning or Changing an Asset's Status
9.8
Deleting an Asset
Part III Securing Oracle Enterprise Repository
10
Configuring Oracle Enterprise Repository to use External Authentication Tooling
10.1
Overview
10.1.1
LDAP/Active Directory
10.1.2
Enable LDAP Integration System Properties
10.1.3
Modify LDAP/Active Directory Properties
10.1.4
Security Considerations
10.1.4.1
Use Case Sample Scenarios
10.1.5
LDAP Property Examples
10.2
Single Sign-On
10.2.1
Overview
10.2.2
Configure Oracle Enterprise Repository For Use With Single Sign-On Authentication
10.2.2.1
Enable Single Sign-On Integration System Properties
10.2.2.2
Using the Oracle Enterprise Repository SSO Integration with Basic Authentication
10.2.2.3
Modify Application Property Files Manually
10.2.3
Advanced Options
10.2.3.1
Creating/Assigning Default Roles for New Users
10.2.3.2
Create New Users/Allow Unapproved Users
10.2.3.3
Enable Unapproved/New User Login
10.2.3.4
New User Notification
10.2.3.5
Syncing Departments
10.2.3.6
Syncing Roles
10.2.3.7
Enable Debug Logging
10.3
Container Managed Setup
10.3.1
Overview
10.3.2
Configure Oracle Enterprise Repository for Container Managed Authentication
10.3.3
Modify the Web Application's Web.xml File to Allow for Container Authentication
11
Configuring Advanced Role-based Access Control
11.1
Overview
11.2
Security Considerations
11.2.1
Access Settings and the Asset Editor
11.2.2
Enabling Custom Access Settings
11.3
Basic Concepts
11.3.1
Roles
11.3.2
Access Settings
11.4
Access Definitions
11.5
Process Overview
11.6
Granting and Denying Permissions
11.6.1
Grant/Deny Access to Specific Assets
11.6.1.1
Prerequisites
11.6.1.2
Create the Asset CAS
11.6.2
Grant/Deny Access to Specific Download Files Within an Asset
11.6.2.1
Prerequisites
11.6.2.2
Create the File CAS
11.7
Configuring Access Settings for Existing Roles
11.7.1
User Roles and Default Privileges
11.7.2
Access Options
11.7.2.1
Option I: Grant or deny access to specific assets using CAS
11.7.2.2
Option II: Grant or deny access to specific files and assets using CAS
11.8
Role-based Access Control Use Cases
11.8.1
Use Case 1: Expose Web Services to Customers and Trading Partners
11.8.1.1
Benefit
11.8.1.2
Overview
11.8.1.3
Solution
11.8.2
Use Case 2: Manage Intellectual Property in an Outsourced Environment
11.8.2.1
Benefits
11.8.2.2
Overview
11.8.2.3
Solution
11.8.3
Use Case 3: Establish a Federated Repository
11.8.3.1
Benefit
11.8.3.2
Overview
11.8.3.3
Solution
11.8.4
Use Case 4: Manage the Asset Lifecycle
11.8.4.1
Benefit
11.8.4.2
Overview
11.8.4.3
Configuring the Use Case Solutions
11.8.4.4
Asset Lifecycle Management Solution Validation Tests
11.8.5
Use Case 5: Limit Access to Source Code Files to Asset Production Teams
11.8.5.1
Benefit
11.8.5.2
Overview
11.8.5.3
Solution
11.8.6
Use Case 6: Grant Browse-only Repository Access to Specific Groups
11.8.6.1
Benefit
11.8.6.2
Overview
11.8.6.3
Solution
11.8.6.4
Validation Test
12
Password Encryption
12.1
Generating Encrypted Passwords
12.1.1
Encrypted Passwords Used in Oracle Enterprise Repository Deployment
12.1.2
Other Passwords
12.2
Encrypting the Configuration File Passwords
12.2.1
Harvester Configuration File
12.2.2
Exchange Utility Configuration File
12.2.3
Workflow Configuration File
12.2.4
Export to API Catalog Configuration File
Part IV Advanced Lifecycle Administration
13
Configuring Oracle Enterprise Repository Express Workflows
13.1
Introduction to Oracle Enterprise Repository Express Workflow
13.2
Configuring Express Workflows
13.2.1
Step 1: Install the OER Express Workflows SOA Composite Application
13.2.2
Step 2: Configure OER Event Manager to deliver events to the deployed SCA
13.2.2.1
Configuring Web Service Endpoints
13.2.2.2
Enabling the Event Manager
13.2.3
Step 3: Define and Configure your Express Workflows
13.3
Running the Sample Workflow
13.4
Modifying the Sample Workflow
13.4.1
Modifying the Express Workflows Configuration File
13.4.1.1
Producing Projects
13.4.1.2
Approval Flows
13.4.1.3
Event-to-Action Mappings
14
Configuring Prescriptive Reuse
14.1
Overview
14.2
Creating a Compliance Template Type
14.3
Creating a Compliance Template
14.4
Apply a Compliance Template to a Project
14.5
Using Assets Associated with Compliance Templates (Prescribed Assets)
14.6
Running a Project Compliance Report
15
Integration with Code Compliance Inspector
15.1
Overview
15.1.1
Overview of Steps for Generating CCI Reports and Publishing them to OER
15.2
Checking Compliance and Synchronizing Report Data in OER
15.2.1
Configuring an OER Artifact Store for CCI Reports
15.2.2
Configuring the cci-oerSynch.properties File
15.2.3
Running the Check Compliance Command
15.2.4
Harvesting the SOA or AIA Projects into OER
15.2.5
Running the CCI-OER Synch Command
15.2.6
Copying the Files
15.3
Configuring Reports for Access from the OER Reports Menu
15.3.1
Reviewing the Reports
16
Configuring Policy Management
16.1
Overview
16.2
Activating the Policy Management Feature
16.3
Creating a Policy Type
16.4
Adding the Policy Assertion Element to the Policy Type
16.5
Creating a Policy
16.6
Adding the Applied Asset Policies Element to a Type
16.7
Applying a Policy to an Asset
16.8
Viewing Policy Status
16.9
Validating Policy Assertions
16.10
Running the Oracle Enterprise Repository Policy Reports
17
Enterprise Manager Integration Utility
17.1
Overview
17.1.1
Prerequisites
17.1.2
Obtaining the Enterprise Manager Integration Utility
17.1.3
High Level Use Cases
17.2
Using the Enterprise Manager Integration Utility
17.2.1
Running from Command Line
17.2.2
Scheduling from Enterprise Manager
17.2.3
Metric Publishing
17.2.3.1
Oracle Service Bus
17.2.3.2
BPEL PM
17.2.3.3
WebLogic Web Services
17.2.3.4
Oracle SOA Suite 11
g
17.2.3.5
Artifacts Creation
17.2.3.6
Endpoint Creation
17.2.3.7
Metrics to Update
17.3
Configuring the Enterprise Manager Integration Utility
17.3.1
Setting the Repository and Enterprise Manager Connection Information for the Command-line Utility
17.3.2
Advanced Configuration
17.3.2.1
Metric Mappings
17.3.2.2
Target Finders
17.3.2.3
Logging
17.4
Encrypting the Configuration File Passwords
17.5
Known Issue
17.5.1
Using Incorrect Encrypted Password
18
Configuring Metrics
18.1
Overview
18.1.1
Metrics Elements
18.1.2
Adding a Reusable Metrics Tab
18.2
Validate the Elements on the Asset Type
18.3
Running Queries Against the Database
18.3.1
dbqueries
19
Configuring Assets in Progress
19.1
Overview
19.2
Viewing Assets in Progress
19.3
Enabling Assets in Progress
19.3.1
Set Default Asset Status
19.4
Disabling Assets in Progress
19.5
Enabling Viewing of Assets in Progress Through Oracle JDeveloper
20
Configuring Contract Management
20.1
Overview
20.1.1
Prerequisites
20.2
Import the Contract Management Solution Pack
20.3
Instructions for Service Providers
20.3.1
Create the Contract
20.3.2
Edit the Contract
20.3.3
Create Relationships
20.3.3.1
Terms of Use
20.4
Instructions for Service Consumers
21
Configuring Oracle Enterprise Repository to Exchange Metadata with the Oracle Service Registry
21.1
Getting Started With the Oracle Registry Repository Exchange Utility
21.1.1
What is the Oracle Registry Repository Exchange Utility?
21.1.1.1
Valid Metadata Entities
21.1.1.2
Prerequisites
21.1.2
Example Use Cases
21.2
Configuring the Oracle Registry Repository Exchange Utility
21.2.1
Installing and Configuring the Oracle Registry Repository Exchange Utility
21.2.1.1
Install the Oracle Registry Repository Exchange Utility
21.2.1.2
Configure Using the Asset Type Name
21.2.2
Installing Oracle Service Registry
21.2.3
Configuring the Oracle Registry Repository Exchange Utility Configuration File
21.2.3.1
Setting the Repository Connection Information
21.2.3.2
Setting the Registry Connection Information
21.2.3.3
Setting the Repository Query
21.2.3.4
Setting the Destination Registries
21.2.3.5
Setting the Registry Query
21.2.3.6
Setting the Source Registry
21.2.4
Configuring Oracle Enterprise Repository Categorizations in the UDDI Mappings File
21.2.5
Configuring the tModelKey UDDI Setting
21.2.6
Understanding the Oracle Registry Repository Exchange Utility's Property File
21.2.7
XU Support
21.2.7.1
XU Support for Manually-Created Services
21.2.7.2
XU Support for Non-WSDL Services Harvested from Oracle Service Bus
21.2.7.3
Configuring XU to Publish Non-Harvested or Custom Asset Types and Relationships
21.3
Using the Oracle Enterprise Repository Exchange Utility
21.3.1
Running the Oracle Registry Repository Exchange Utility
21.3.1.1
Invoking the Oracle Registry Repository Exchange Utility Using Workflows
21.3.2
How the Exchanged Metadata Is Synchronized
21.3.2.1
Synchronizing the Metadata Published from Oracle Enterprise Repository to Oracle Service Registry
21.3.2.2
Synchronizing the Metadata from Oracle Service Registry to Oracle Enterprise Repository
21.3.3
Searching for Oracle Service Registry Exchanged Metadata in Oracle Enterprise Repository
21.3.4
Checking the Oracle Registry Repository Exchange Utility Log File
21.3.5
Known Issues
21.3.5.1
Resynchronizing Oracle Service Registry Services
21.3.5.2
Publishing Services to Oracle Service Registry
21.3.5.3
Running an Incorrect Version of Java
Part V Appendixes
A
Other Configurations
A.1
Creating and Configuring an Upload Submission Directory
A.1.1
Asset Upload System Settings
A.1.2
Creating and Configuring an Artifact Store
A.1.3
Selecting a New Artifact Store
A.2
Creating an Asset Audit Log
A.3
Oracle Enterprise Repository Default Artifact Store Integration
A.4
Maintaining XSLT Templates for use with the Export-to-PDF Feature
A.4.1
Maintaining XSL:FO Templates for use with Oracle Enterprise Repository
A.5
Support for UTF-8/Unicode Characters
A.6
Data Rules
A.6.1
Flags on Asset Type Elements
A.6.2
Grandfathered Data
A.6.3
Element Storage
A.6.4
Elements Required to Exist on Asset Types
A.6.5
Elements Tied to Functionality
A.6.6
Description of the Asset Type Catalog
A.7
Harvester Properties
Index
Scripting on this page enhances content navigation, but does not change the content in any way.