Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

Part I Oracle Enterprise Repository Connectors

1 ClearCase Integration

• 1.1 ClearCase Web Interface
  • 1.1.1 Overview
  • 1.1.2 Prerequisites
  • 1.1.3 Creating and Configuring Repository and Assets
• 1.2 File Stores
  • 1.2.1 Overview
  • 1.2.2 Adding the File Stores Feature to Oracle Enterprise Repository
  • 1.2.3 Creating a File Store
  • 1.2.4 Configuring an Artifact Store For a File Store
  • 1.2.5 Adding a File to an Asset Using the File Store's Artifact Store
  • 1.2.6 Using File Stores
• 1.3 ClearQuest Integration
  • 1.3.1 Adding ClearQuest
  • 1.3.2 Configuring a ClearQuest Artifact Store
  • 1.3.3 Adding a File to an Asset Using the ClearQuest Artifact Store

2 Harvest-HTTP Repository Host Integration

• 2.1 Overview
• 2.2 Installation
• 2.3 Configure an Artifact Store
• 2.4 Add the Harvest Artifact Store to an Asset

3 Serena ChangeMan Integration

• 3.1 Adding Serena Changeman Plug-ins
• 3.2 Configuring a PVCS Artifact Store
• 3.3 Add a File to an Asset Using a PVCS Repository
• 3.4 Security Considerations

Part II Oracle Enterprise Repository Integration with Enterprise Manager

4 Enterprise Manager Integration Utility

• 4.1 Overview
  • 4.1.1 Prerequisites
  • 4.1.2 Obtaining the Enterprise Manager Integration Utility
  • 4.1.3 High Level Use Cases
• 4.2 Using the Enterprise Manager Integration Utility
  • 4.2.1 Running from Command Line
  • 4.2.2 Scheduling from Enterprise Manager
  • 4.2.3 Metric Publishing
    • 4.2.3.1 Oracle Service Bus
    • 4.2.3.2 BPEL PM
    • 4.2.3.3 Web Services
    • 4.2.3.4 Artifacts Creation
    • 4.2.3.5 Endpoint Creation
    • 4.2.3.6 Metrics to Update
• 4.3 Configuring the Enterprise Manager Integration Utility
  • 4.3.1 Setting the Repository and Enterprise Manager Connection Information for the Command-line Utility
    • 4.3.1.1 Encrypting the Configuration File Passwords
  • 4.3.2 Advanced Configuration
    • 4.3.2.1 Metric Mappings
    • 4.3.2.2 Target Finders
    • 4.3.2.3 Logging
• 4.4 Known Issues
  • 4.4.1 Using Incorrect Encrypted Password

Part III Oracle Enterprise Repository Integration with Development Environments

5 Integration with Development Environments

• 5.1 Overview
• 5.2 Best Practices
  • 5.2.1 Asset Production Process
    • 5.2.1.1 Policies
    • 5.2.1.2 Propose/Submit Assets
  • 5.2.2 Asset Consumption Process
    • 5.2.2.1 Prescription Reuse
    • 5.2.2.2 Developer-Driven Discovery
    • 5.2.2.3 Automated Usage Detection
• 5.3 High Level Use Cases
  • 5.3.1 Submit Files
  • 5.3.2 Harvest Files
  • 5.3.3 Search Oracle Enterprise Repository
  • 5.3.4 View Asset Details
  • 5.3.5 Download Artifacts
  • 5.3.6 Prescriptive Reuse
  • 5.3.7 Automatic Usage Detection

6 Configuring Oracle Enterprise Repository to Support Integration with Your IDE

• 6.1 Install the Harvester
• 6.2 Assign IDE Users to Oracle Enterprise Repository Projects
• 6.3 Establish Compliance Templates
• 6.4 Set up Automatic Usage Detection

7 Configuring Your IDE to Support Integration with Oracle Enterprise Repository

• 7.1 Configuring Oracle JDeveloper
  • 7.1.1 Integrating with Oracle JDeveloper 11g R2
  • 7.1.2 Integrating with Oracle JDeveloper 11g R1
  • 7.1.3 Integrating with Oracle JDeveloper 10g
• 7.2 Configuring Eclipse
  • 7.2.1 Enable Harvesting in Eclipse
    • 7.2.1.1 Setting up Eclipse Environment to use Harvester as an "External Program"
    • 7.2.1.2 Harvesting in Eclipse Environment using "External Program"
    • 7.2.1.3 Setting up Eclipse Environment to use Harvester via ANT
    • 7.2.1.4 Harvesting in Eclipse Environment using ANT
  • 7.2.2 Configure the Oracle Enterprise Repository Plug-ins
    • 7.2.2.1 Configuring the Oracle Enterprise Repository Plug-ins for Repository Access
    • 7.2.2.2 Prerequisites for Using the Oracle Enterprise Repository Plug-ins for Eclipse
  • 7.2.3 Configure the Oracle Enterprise Repository Preferences
  • 7.2.4 Enable Automatic Usage Detection
• 7.3 Configuring VS .NET
  • 7.3.1 Enable Harvesting in VS .NET
  • 7.3.2 Configure the Oracle Enterprise Repository Plug-ins
    • 7.3.2.1 Prerequisities
    • 7.3.2.2 Installation
  • 7.3.3 Configure the Connection to Oracle Enterprise Repository
  • 7.3.4 Assign an Oracle Enterprise Repository Project to a .NET Solution
  • 7.3.5 Enable Automatic Usage Detection
    • 7.3.5.1 Overview of SFID
    • 7.3.5.2 Configuring Automatic Usage Detection

8 Using the IDE to Interact with Oracle Enterprise Repository

• 8.1 Using Oracle JDeveloper
  • 8.1.1 Harvest Artifacts
  • 8.1.2 Search Oracle Enterprise Repository
  • 8.1.3 View Asset Details
  • 8.1.4 Download Artifacts
    • 8.1.4.1 Associating JDeveloper Application with Oracle Enterprise Repository
    • 8.1.4.2 Consuming WSDL/Service from Oracle Enterprise Repository
  • 8.1.5 Prescriptive Reuse
• 8.2 Using Eclipse
  • 8.2.1 Submit Files
  • 8.2.2 Harvest Artifacts
  • 8.2.3 Search Oracle Enterprise Repository
  • 8.2.4 View Asset Details
  • 8.2.5 Download Artifacts
  • 8.2.6 Prescriptive Reuse
  • 8.2.7 Automatic Usage Detection
• 8.3 Using VS .NET
  • 8.3.1 Submit Files
  • 8.3.2 Harvest Artifacts
  • 8.3.3 Search Oracle Enterprise Repository
  • 8.3.4 View Asset Details
    • 8.3.4.1 Accessing the Repository Assets Pane
    • 8.3.4.2 Accessing the Oracle Enterprise Repository Log
  • 8.3.5 Download Artifacts
  • 8.3.6 Automatic Usage Detection

Part IV Developing Custom Integrations

9 Repository Extensibility Framework

• 9.1 Introduction to REX
• 9.2 REX Architecture
  • 9.2.1 Subsystems Overview
  • 9.2.2 CRUD-Q Naming Convention
    • 9.2.2.1 Atomicity of Method Calls
    • 9.2.2.2 No Inter-call Transaction Support
  • 9.2.3 Fundamental WSDL Data Types
  • 9.2.4 Versioning Considerations for the Oracle Enterprise Repository REX
• 9.3 Basic Concepts
  • 9.3.1 Getting Started - Enabling the OpenAPI within the Oracle Enterprise Repository
  • 9.3.2 Getting Started - Consuming the WSDL

10 ArtifactStore API

• 10.1 Overview
• 10.2 Use Cases
  • 10.2.1 Use Case: Query for ArtifactStore
  • 10.2.2 Use Case: Create missing ArtifactStore

11 AcceptableValueLists API

• 11.1 Overview
• 11.2 Use Cases
  • 11.2.1 Use Case: Create and Edit an Acceptable Value List
  • 11.2.2 Use Case: Find an Acceptable Value List and use it in an asset

12 Asset API

• 12.1 Overview
  • 12.1.1 Definitions
  • 12.1.2 Sample Code
  • 12.1.3 Related Subsystems
• 12.2 Use Cases
  • 12.2.1 Use Case: Creating a new asset
  • 12.2.2 Use Case: Creating a new asset from XML
  • 12.2.3 Use Case: Modifying an asset
  • 12.2.4 Use Case: Assign users to an asset
  • 12.2.5 Use Case: Building an asset search
  • 12.2.6 Use Case: Upgrading asset status
  • 12.2.7 Use Case: Downgrading asset status
  • 12.2.8 Use Case: Apply and remove Compliance Templates from a project
  • 12.2.9 Use Case: Creating the new version of an asset and retiring the old version
  • 12.2.10 Use Case: "Housekeeping"
  • 12.2.11 Use Case: Finding assets and updating custom-data
  • 12.2.12 Use Case: Reading an Asset's Tabs
  • 12.2.13 Use Case: Retrieve An Asset's Tab Based on TabType
  • 12.2.14 Use Case: Approving and Unapproving a tab

13 AssetType API

• 13.1 Overview
• 13.2 Use Cases
  • 13.2.1 Use Case: Create and edit a new Type
  • 13.2.2 Use Case: Create a Compliance Template Type
  • 13.2.3 Use Case: Find Types
  • 13.2.4 Use Case: Read tab types
  • 13.2.5 Use Case: Retrieve all Asset Type tabs

14 Categorization Types and Categorizations API

• 14.1 Overview
• 14.2 Use Cases
  • 14.2.1 Use Case: Create a Categorization Type
  • 14.2.2 Use Case: Manipulate Categorization Types
  • 14.2.3 Use Case: Manipulate Categorizations

15 CMF Entry Type API

• 15.1 Overview
• 15.2 Use Cases
  • 15.2.1 Use Case: Manipulating CMF Entry Types

16 Custom Access Settings API

• 16.1 Overview
• 16.2 Use Cases
  • 16.2.1 Use Case: Retrieve a List of Custom Access Setting Types
  • 16.2.2 Use Case: Get Default Custom Access Setting Names

17 Department API

• 17.1 Overview
• 17.2 Use Cases
  • 17.2.1 Use Case: Manipulate Departments

18 Extraction API

• 18.1 Overview
• 18.2 Use Cases
  • 18.2.1 Use Case: Extract an Asset
  • 18.2.2 Use Case: Read an Extraction
  • 18.2.3 Use Case: Update an Extraction

19 Localization of REX Clients

• 19.1 Overview
• 19.2 Use Cases
  • 19.2.1 Use Case: Creating localized messages from REX Exceptions
  • 19.2.2 Use Case: Creating localized messages from REX Audit Messages

20 Notification API

• 20.1 Overview
• 20.2 Use Cases
  • 20.2.1 Use Case: Read Notification Substitution List
  • 20.2.2 Use Case: Create a Notification

21 Policy API

• 21.1 Overview
• 21.2 Use Cases
  • 21.2.1 Use Case: Create a Policy
  • 21.2.2 Use Case: Get All Policies
  • 21.2.3 Use Case: Get/Set Policy Assertions
  • 21.2.4 Use Case: Get Policies That Have Been Applied To An Asset
  • 21.2.5 Use Case: Set Which Policies Are Applied To An Asset
  • 21.2.6 Use Case: Evaluate Asset Compliance

22 Projects API

• 22.1 Overview
• 22.2 Use Cases
  • 22.2.1 Use Case: Create a New Project
  • 22.2.2 Use Case: Read a Project
  • 22.2.3 Use Case: Validate a Project
  • 22.2.4 Use Case: Update a Project
  • 22.2.5 Use Case: Update a Project's Produced Assets
  • 22.2.6 Use Case: Remove Produced Assets from a Project
  • 22.2.7 Use Case: Update a Project's Asset Usage
  • 22.2.8 Use Case: Closing a Project with Hidden Assets
  • 22.2.9 Use Case: Add Users and Related Projects to a Project
  • 22.2.10 Use Case: Remove Related Projects and Users from a Project
  • 22.2.11 Use Case: Update a Project's Extractions - Reassign Extractions to a Different User on the Same or a Different Project
  • 22.2.12 Use Case: Update a Project's User - Reassign User and His/Her Extractions to Another Project
  • 22.2.13 Use Case: Update a Project's User - Reassign User Only (Not the User's Extractions) to Another Project
  • 22.2.14 Use Case: Read the Value-Provided for a Project and Asset
  • 22.2.15 Use Case: Update the Value Provided for a Project and Asset - Use Predicted Value
  • 22.2.16 Use Case: Update the Value Provided for a Project and Asset - Use Consumer Value
  • 22.2.17 Use Case: Update the Value-Provided for a Project and Asset - Use Project Lead Value

23 Relationship Types API

• 23.1 Overview
• 23.2 Use Cases
  • 23.2.1 Use Case: Create a new relationship type
  • 23.2.2 Use Case: Modify related assets
  • 23.2.3 Use Case: Query related assets

24 Role API

• 24.1 Overview
• 24.2 Use Cases
  • 24.2.1 Use Case: Manipulate Roles

25 Subscriptions API

• 25.1 Overview
• 25.2 Use Cases
  • 25.2.1 Use Case: Create Subscription to Assets
  • 25.2.2 Use Case: Delete Subscription to Assets
  • 25.2.3 Use Case: Read Subscriptions for Assets
  • 25.2.4 Use Case: Read Users Subscribed to an Asset

26 System Settings API

• 26.1 Overview
• 26.2 Use Cases
  • 26.2.1 Use Case: Query for System Settings

27 User API

• 27.1 Overview
• 27.2 Use Cases
  • 27.2.1 Use Case: Manipulating Users

28 Vendor API

• 28.1 Overview
• 28.2 Use Cases
  • 28.2.1 Use Case: Manipulating Vendors

Index