7 Configuring Your IDE to Support Integration with Oracle Enterprise Repository

This chapter describes how to get started with Harvester and its use in various high level use cases.

7.1 Configuring Oracle JDeveloper

This section contains the following topics:

7.1.1 Integrating with Oracle JDeveloper 11g R2

To create a connection between the Oracle Enterprise Repository and Oracle JDeveloper:

  1. Install Oracle JDeveloper on your local computer.

  2. Download the Oracle Oracle Enterprise Repository bundle from this location: http://ide.us.oracle.com/updates/extras/nondebug/soa-jdev-extension.zip.

  3. Open Oracle JDeveloper and click Help, Check for Updates. The Check for Updates dialog is displayed.

  4. Click Next. The Source page is displayed.

  5. Click Install from Local File.

  6. Click Browse to browse for the Oracle Enterprise Repository bundle file, and then click Next. The Summary page is displayed.

  7. Click Finish.

  8. Restart Oracle JDeveloper. The Oracle JDeveloper window is displayed.

  9. Click File, New. The New Gallery dialog is displayed.

  10. Select General, Connections, and then select Oracle Enterprise Repository Connection, as shown in Figure 7-1.

    Figure 7-1 New Gallery Dialog

    Description of Figure 7-1 follows
    Description of "Figure 7-1 New Gallery Dialog"

  11. Click OK. The Create Oracle Enterprise Repository Connection dialog is displayed, as shown in Figure 7-2.

    Figure 7-2 Create Oracle Enterprise Repository Connection Dialog

    Description of Figure 7-2 follows
    Description of "Figure 7-2 Create Oracle Enterprise Repository Connection Dialog"

  12. Enter the following information:

    • Repository URL: The URL from where a running instance of Oracle Enterprise Repository can be accessed.

    • User Name: The user name for the Oracle Enterprise Repository.

    • Password: The password for the Oracle Enterprise Repository.

  13. Click Test Connection. A success message is displayed in the Status pane.

  14. Click OK.

  15. In the Resource Palette, under IDE Connections, expand Oracle Enterprise Repository to see the application server connection that you created, as shown in Figure 7-3.

    Figure 7-3 Resource Palette

    Description of Figure 7-3 follows
    Description of "Figure 7-3 Resource Palette"

  16. Enter a search criteria to search for assets in the Search field. A list of all the assets is displayed, as shown in Figure 7-4.

    Figure 7-4 Search Results

    Description of Figure 7-4 follows
    Description of "Figure 7-4 Search Results"

Note:

You have to install SOA solution pack into Oracle Enterprise Repository to enable harvesting from JDeveloper. This is applicable for both JDeveloper 10g and 11g.

7.1.2 Integrating with Oracle JDeveloper 11g R1

To install the harvester Ant tasks in JDeveloper 11g or in SOA Suite 11g, perform the following steps:

  1. Double-click jdeveloper.exe in the jdev installation directory to open Oracle JDeveloper.

    Note:

    You should start and close the JDeveloper application at least once during this step.

  2. Unzip the harvester zip file into your JDeveloper installation. The contents of the zip file are extracted to the <jdeveloper_home>/harvester directory.

  3. Edit the tools11g.xml file to match your JDeveloper installation.

  4. Merge the contents of tools11g.xml into your JDeveloper's product preferences XML file located in the <jdeveloper_home>\system11.1.1.x.xx.xx.xx\o.jdeveloper\product-preferences.xml directory.

    If there is an existing entry "<hash n = "oracle.ideimpl.externaltools.ExternalToolList">, then replace with the contents in the tools11g.xml file. If not, add it right after the initial <ide:preferences> element.

7.1.3 Integrating with Oracle JDeveloper 10g

To configure Oracle JDeveloper to support the integration with Oracle Enterprise Repository, perform the following steps:

  1. Navigate to the Oracle_HOME\repositoryXXX\core\tools\solutions directory and unzip the 11.1.1.2.0-OER-Harvester.zip file to the Oracle JDeveloper directory. For example, if the jdeveloper.exe file is located in C:\oracle\soa, ensure that the introspector directory is unzipped into that directory.

  2. Navigate to the <jdeveloper_home>\harvester directory and right-click the tools.xml file to open in a text editor.

  3. Copy all the elements between the <tools> and </tools> elements and paste the copied elements into the tools.xml file in the <jdeveloper_home>\jdev\system\oracle.jdeveloper.10.1.xxxxx directory.

  4. Save the tools.xml file in the <jdeveloper_home>\jdev\system\oracle.jdeveloper.10.1.xxxxx directory.

  5. Start Oracle JDeveloper. In JDeveloper window, select Tools, External Tools. The following two options are displayed:

    • Submit this File into OER

    • Submit this Project into OER

  6. Select Submit this File into OER and click Edit. The Edit External Tool dialog is displayed.

  7. Click the Properties tab, and configure the missing properties to point to your Oracle Enterprise Repository server.

  8. To point to an external HarvesterSettings.xml file, add a property called settings.file, and set the value to the URL of the settings file, for example, c:\temp\MyHarvesterSettings.xml.

  9. Repeat Steps 6 to 8 for the Submit this Project into OER option.

  10. In the Applications Navigator, select a file, and right-click and then select Submit this File into OER or Submit this Project into OER.

    Note:

    Oracle JDeveloper 10g does not support multi-select correctly for external tools. Even if you multi-select, only one file is harvested.

  11. In the Edit External Tool dialog, click the Process tab.

  12. Click Change to change the JDK version to 1.6, and then click OK.

Note:

Oracle Enterprise Repository browsing is not supported from Oracle JDeveloper 10g. To make 10g assets as consumable:

  • Harvest assets from JDeveloper 10g.

  • Reharvest from SOA runtime for just WSDLs.

Also, the assets that are harvested from JDeveloper 10g or 11g cannot be used for consumption.

7.2 Configuring Eclipse

The Harvester integrates the Oracle SOA Suite artifacts to Oracle Enterprise Repository to support the visibility, impact analysis, and reusability use cases. This section describes the various steps involved in configuring Eclipse to support integration with Oracle Enterprise Repository:

7.2.1 Enable Harvesting in Eclipse

This section describes how to harvest sample artifacts into Oracle Enterprise Repository using Eclipse:

7.2.1.1 Setting up Eclipse Environment to use Harvester as an "External Program"

  1. In Eclipse, click Run, External Tools. The External Tools dialog is displayed.

  2. Right-click Program, and then select New.

  3. Enter the following details in the External Tools dialog, as shown in Figure 7-5.

    • In the Name field, type Submit this project to Oracle Enterprise Repository.

    • In the Location field, type <Harvester Home>\harvest.bat. You can also browse the harvest.bat file using the Browse button.

    • In the Working Directory field, type <Harvester Home>. You can also browse the working directory using the Browse button.

    • In the Arguments field, type -dir ${project_loc}.

    Figure 7-5 External Tools Dialog

    Description of Figure 7-5 follows
    Description of "Figure 7-5 External Tools Dialog"

  4. Click the Common tab.

  5. In the Display in favorites menu pane, enable External Tools, as shown in Figure 7-6.

    Figure 7-6 External Tools Dialog - Common Tab

    Description of Figure 7-6 follows
    Description of "Figure 7-6 External Tools Dialog - Common Tab"

Note:

You must install Harvester in the same machine where you have installed eclipse.

7.2.1.2 Harvesting in Eclipse Environment using "External Program"

  1. In Eclipse, click New, Project, General, Project to create a new eclipse project.

  2. Browse for any WSDL file in the file system, copy it and paste into the just created project.

  3. Select the project and then click Submit this project to Oracle Enterprise Repository. This invokes the Harvester and submits all the artifacts in the project, as shown in Figure 7-7.

    Figure 7-7 Java EE - Eclipse Platform

    Description of Figure 7-7 follows
    Description of "Figure 7-7 Java EE - Eclipse Platform"

  4. Repeat the above steps to create another program called Submit this file to Oracle Enterprise Repository by using - dir ${resource_loc} instead of the ${project_loc} variable and to submit the individual files.

7.2.1.3 Setting up Eclipse Environment to use Harvester via ANT

  1. Copy the Harvester directory to any project in the Eclipse workspace.

  2. In the Eclipse workspace, click Window, Preferences. The Preferences dialog is displayed.

  3. Select Ant, Runtime. The Runtime page is displayed.

  4. Select Global Entries and then click Add Folder. The Browse for Folder dialog is displayed.

  5. Select the harvester and click OK.

  6. In the Eclipse workspace, click Window, Show View, Other, and then Ant. The Ant view is displayed.

  7. Right-click the ANT view window and select Add Build Files option. The Buildfile Selection dialog is displayed.

  8. Select harvester-ant.xml from the Harvester directory, as shown in Figure 7-8.

    Figure 7-8 Buildfile Selection Dialog

    Description of Figure 7-8 follows
    Description of "Figure 7-8 Buildfile Selection Dialog"

  9. In the ANT window, expand the harvester node and right-click introspect-file and select Run As, Ant Build, as shown in Figure 7-9. The External Tools dialog is displayed.

    Figure 7-9 The ANT Window

    Description of Figure 7-9 follows
    Description of "Figure 7-9 The ANT Window"

  10. Click Add External JARs and select all the jars under <Harvester Home> and <Harvester Home>\lib directories.

  11. Click the Add Property button and add the following properties as shown below:

    • file.path = ${resource_loc}

    • repository.url = http://localhost:7101/oer/

    • repository.username = admin

    • repository.password = admin

After the configuration of the Properties tab, the External Tools dialog is displayed, as shown in Figure 7-10.

Figure 7-10 External Tools Dialog - Properties Tab

Description of Figure 7-10 follows
Description of "Figure 7-10 External Tools Dialog - Properties Tab "

7.2.1.4 Harvesting in Eclipse Environment using ANT

  1. In Eclipse, click New, Project, General, Project to create a new eclipse project.

  2. Browse for any WSDL file in the file system, copy and paste it into the project that you just created.

  3. Select the project and then click Submit this file to Oracle Enterprise Repository using ANT. This invokes Harvester and submits all the artifacts in the project, as shown in Figure 7-11.

    Figure 7-11 The Console Window

    Description of Figure 7-11 follows
    Description of "Figure 7-11 The Console Window"

7.2.2 Configure the Oracle Enterprise Repository Plug-ins

This section describes the steps to configure the Oracle Enterprise Repository Plug-ins for repository access and the prerequisities to enable this configuration. This section contains the following topics:

7.2.2.1 Configuring the Oracle Enterprise Repository Plug-ins for Repository Access

For instructions on installing the Oracle Enterprise Repository plug-ins for repository access within the Eclipse-based Enterprise Repository Plug-in for Eclipse, see Oracle Fusion Middleware Installation Guide for Oracle Enterprise Repository.

Prerequisites for Using the Oracle Enterprise Repository Plug-in for Eclipse

For instructions about installing the Oracle Enterprise Repository plug-in for repository access, see http://download.oracle.com/otn_software/oer/eclipse.

Uninstalling the Oracle Enterprise Repository Plug-ins

The Oracle Enterprise Repository plug-in for Eclipse can be uninstalled the same as any other Eclipse plug-in through the Eclipse software update menu.

Installing Products After Installing Oracle Enterprise Repository

If Oracle Service Bus applications are installed after the Oracle Enterprise Repository plug-in is installed, then Eclipse must be launched using the -clean flag.

7.2.2.2 Prerequisites for Using the Oracle Enterprise Repository Plug-ins for Eclipse

You should complete the prerequisites described in this section before using the Oracle Enterprise Repository plug-ins for Eclipse:

7.2.2.2.1 Assign Users to an Oracle Enterprise Repository Project

In order to download assets from the repository, users must be assigned to at least one Oracle Enterprise Repository project. An Oracle Enterprise Repository project administrator can assign users to projects using the Oracle Enterprise Repository Projects page.

Obtain the Eclipse integration path from the Oracle Enterprise Repository administrator. (For example, http://appserver.example.com/oer-web/eclipse).

7.2.2.2.2 Enabling the Assets-in-Progress Properties

Two system settings must be enabled in order to activate Assets-in-Progress when using the Oracle Enterprise Repository Plug-in for Eclipse.

This procedure is performed on the Oracle Enterprise Repository Admin screen.

  1. Click System Settings.

  2. Click General Settings in the System Settings section.

  3. Enter the cmee.asset.in-progress property in the Enable New System Setting box and click Enable to reveal this hidden property.

  4. Ensure the Asset in Progress property is set to True.

  5. Click Save.

  6. Enter the cmee.asset.in-progress.visible property in the Enable New System Setting box and click Enable to reveal this hidden property.

  7. Ensure the Asset in Progress property is set to True.

  8. Click Save.

The Registration Status list will now appear in the Search section on the Oracle Enterprise Repository Assets screen. For more information about Assets-in-Progress, see Oracle Fusion Middleware Configuration Guide for Oracle Enterprise Repository.

7.2.2.2.3 SiteMinder

If Oracle Enterprise Repository is or will be configured to be secured by Siteminder, the policy server must be configured to ignore (or unprotect) the following URL:

http://appserver.example.com/oer-web/eclipse/
7.2.2.2.4 Java JDK

The Java Cryptography Extension (JCE) is required. It is provided in JDK v1.4, and is available as an optional package in JDK 1.2.x through 1.5.x. Note that Oracle Enterprise Repository plug-ins for use with Eclipse 3.x require JDK v 1.5.x or later.

7.2.2.2.5 XML Parsing

Since Editor and Viewer metadata is represented as CDATA-escaped XML, some XML parsers may exceed their entity expansion limit when communicating with Oracle Enterprise Repository. For example, if you have defined a large number of Asset Types in Oracle Enterprise Repository, then you may need to increase the Entity Expansion Limit of your XML parser.

On some popular parsers, the default entity expansion limit is set to 64,000. This limit can be increased on JAXP-compliant processors by passing a command-line parameter called entityExpansionLimit. The entityExpansionLimit can be increased by passing a VM argument on the Eclipse command-line (modify the Eclipse desktop shortcut). For example, set the target of the shortcut to the following:

c:\eclipse\eclipse.exe -debug -consolelog -vmargs -DentityExpansionLimit=1048576

7.2.3 Configure the Oracle Enterprise Repository Preferences

This section describes the steps to configure the Oracle Enterprise Repository connection.

When you invoke an action on a repository, such as querying or publishing assets, before repository connectivity has been established, then the Connect to Enterprise Repository wizard will either be automatically displayed (in the case of querying the repository), or will be launched by an explicit user gesture.

Note:

If credential information had been specified in a previous session, the wizard will display this persisted information when it is launched.

  1. In the Credentials area, as shown in Figure 7-12, enter the server location and login credentials, as follows:

    • Repository URL: the URL of the repository server. The URL must include the host, port, and Oracle Enterprise Repository server name, for example, http://localhost:7001/oer.

    • User Name: user name to gain access to the repository.

    • Password: password to gain access to the repository.

    Figure 7-12 Establish Enterprise Repository Connection

    Description of Figure 7-12 follows
    Description of "Figure 7-12 Establish Enterprise Repository Connection"

  2. Click the Establish Connection button to ensure enterprise repository connectivity.

    If a connection cannot be established, an appropriate error message will be displayed.

  3. In Figure 7-13, once connectivity is established, you can either:

    • Click Finish to exit.

    • Click Next to select your workspace preferences (skip to Step 4).

    Figure 7-13 Specify Workspace Preferences

    Description of Figure 7-13 follows
    Description of "Figure 7-13 Specify Workspace Preferences "

  4. Once connectivity is established, you can specify your workspace preferences:

    • Select a Repository project in Oracle Enterprise Repository that the submitted model will be associated with. Asset usage is tracked in the repository and attributed to repository projects, which typically represent software development programs, business initiatives, etc.

    • Enable usage detection: If you selected an Oracle Enterprise Repository project as the workspace default, usage detection will be enabled for the default Oracle Enterprise Repository project. For more information about workspace preferences, see Oracle Fusion Middleware Configuration Guide for Oracle Enterprise Repository.

  5. Click Finish to exit.

7.2.4 Enable Automatic Usage Detection

Oracle Enterprise Repository can automatically detect asset reuse within the development environment. This allows development teams to ensure that they get asset reuse credit, regardless of whether the assets have been downloaded through Oracle Enterprise Repository or pulled from another source, such as the developer's desktop. Automated Usage Detection relies on a fingerprinting process, called Software File Identification (SFID), which tags selected files within an asset with a unique ID. This SFID is then used to detect when and where an asset is used, even if the asset was acquired through means other than the Oracle Enterprise Repository Use - Download process. An instance of usage is recorded by Oracle Enterprise Repository when tagged files within the asset are brought into the developer's IDE, and a new build or build clean occurs.

For more information, see Oracle Fusion Middleware Configuration Guide for Oracle Enterprise Repository.

Note:

Automated Usage Detection requires the installation of the Oracle Enterprise Repository Plug-in for Eclipse, and is currently compatible only with Eclipse and Eclipse-based IDEs.

  1. On the Window menu, click Preferences.

  2. Select Oracle Enterprise Repository.

  3. Select Workspace Automatic Usage Detection. The Workspace Automatic Usage Detection screen is displayed, as shown in Figure 7-14.

    Figure 7-14 Preferences - Workspace Automatic Usage Detection

    Description of Figure 7-14 follows
    Description of "Figure 7-14 Preferences - Workspace Automatic Usage Detection "

  4. Click the Detect usage in workspace projects option, and then activate the desired usage detection features, as appropriate:

    • Enable usage detection in new workspace projects by default - monitors new projects

    • Detect usage of files on classpath - monitors files on classpath.

    • Detect usage of Java Runtime JARs - monitors Java Runtime JARs

    • Cache calculated SFIDs (recommended) - caches calculated SFIDs (enhances performance)

    • Detect usage of files matching pattern - monitors files matching specified patterns

  5. Enter the appropriate information in the File Pattern text boxes:

    • Include File Pattern - Includes indicated file pattern

    • Exclude File Pattern - Excludes the indicated file pattern

  6. Specify which project directories will be targets for automatic usage detection by using the individual check boxes or by using the Select All and/or Unselect All buttons.

  7. Click OK when finished.

7.3 Configuring VS .NET

Oracle Enterprise Repository integration with Visual Studio .NET provides users with the ability to easily search for and use assets from the repository without leaving the VS .NET IDE environment. Assets and any associated artifacts are downloaded directly to your VS .NET solution. Repository Access within the VS .NET solution also provides a view into Oracle Enterprise Repository that enables you to download artifacts and assets from the repository, query the repository, and view the contents of the repository.

This section contains the following topics:

7.3.1 Enable Harvesting in VS .NET

  1. In Microsoft Visual Studio, click Tools, External Tools. The External Tools dialog is displayed.

  2. Click Add. A entry is added to the Menu Contents pane.

  3. Enter the following details in the External Tools dialog, as shown in Figure 7-15:

    • In the Title field, type OER - Harvest.

    • In the Comman field, click the Browse button at the end of the field and select the harvest.bat file in the harvester directory.

    • In the Arguments field, type the -dir parameter. Click the right-arrow at the end of this field and select ItemPath from the menu.

    • In the Initial Directory field, type the location of the harvester directory.

    • Select the Use Output Window option. This option enables you to monitor progress.

      Figure 7-15 External Tools Dialog

      Description of Figure 7-15 follows
      Description of "Figure 7-15 External Tools Dialog"

  4. Click OK.

  5. Select the WSDL file in the Microsoft Visual Studio and click Tools, OER - Harvest. The Output window is displayed with the Shutdown and Clean up messages indicating that the introspection is complete.

  6. Open the Oracle Enterprise Repository home page with your username/password credentials.

  7. In Assets pane, enter the name of the WSDL as the search criteria in the Enter Search String field, and then click Search. The search results are displayed in the right pane.

  8. Select the service in the search results section, the details of the service are displayed in the bottom pane.

  9. Click the Navigator button to view the relationships.

  10. In the Oracle Enterprise Repository main page, click Admin, and then System Settings. The System Settings page is displayed.

  11. Enter Show in the Search field, and set the Show System-Supplied Relationships option to True.

  12. Click Save at the bottom of the page.

  13. In the Oracle Enterprise Repository main page, click Assets and repeat the same search that you performed in step 7. The automatic relationships that were not imported earlier are now imported.

7.3.2 Configure the Oracle Enterprise Repository Plug-ins

Oracle Enterprise Repository can automatically detect asset reuse within the development environment. This allows development teams to ensure that they get asset reuse credit, regardless of whether the assets have been downloaded through Oracle Enterprise Repository. For more information, see Section 7.3.5, "Enable Automatic Usage Detection".

7.3.2.1 Prerequisities

To configure the Oracle Enterprise Repository plug-ins, you need the following prerequisites:

  • Microsoft Visual Studio 2008.

  • Microsoft Visual J# 2005 runtime. (If J# is not installed on your machine, the installer will prompt you download the correct version from Microsoft.)

  • The VS .NET Always show solution option should be selected (Tools -> Options -> Projects and Solutions -> General).

  • Users must be assigned to at least one Oracle Enterprise Repository project. A Project Administrator can assign users to projects using the Oracle Enterprise Repository Projects page.

  • If your Oracle Enterprise Repository is or will be secured by Siteminder, you will need to configure the policy server to ignore (or unprotect) the following URL to allow the OpenAPI integration to function properly:

    • http://appserver.example.com/OER/services/

7.3.2.2 Installation

To install VS .NET plug-in, perform the following steps:

  1. Download the VS .NET plug-in Zip file from your Oracle Enterprise Repository instance at the following URL:

    http://appserver.example.com/oer-web/integration/dotnet/OER103-VisualStudioAddin.zip

  2. Unzip the OER103-VisualStudioAddin.zip file.

  3. Locate and run the setup.exe program.

  4. Follow the prompts, as shown in Figure 7-16, to select installation parameters.

    Figure 7-16 Oracle Enterprise Repository Adapter Add-in for Visual Studio

    Description of Figure 7-16 follows
    Description of "Figure 7-16 Oracle Enterprise Repository Adapter Add-in for Visual Studio"

  5. Click Finish to complete the installation.

  6. Follow the instructions in Section 7.3.3, "Configure the Connection to Oracle Enterprise Repository" to configure and establish a connection to an Oracle Enterprise Repository instance from VS. NET.

7.3.3 Configure the Connection to Oracle Enterprise Repository

Follow these steps to configure and establish a connection to an Oracle Enterprise Repository instance from VS. NET.

  1. Launch Visual Studio .NET.

  2. Open the Tools menu and click Options.

  3. On the list of options, click the OER Add-in for Visual Studio .NET option, as shown in Figure 7-17, and provide the required login information.

    Figure 7-17 The Options Dialog

    Description of Figure 7-17 follows
    Description of "Figure 7-17 The Options Dialog"

    • OER URL: The URL of the Oracle Enterprise Repository instance, for example, http://appserver.example.com/OER.

    • Note:

      Do not include index.jsp used in the default home page as part of the URL.

    • User Name: The user name to connect as.

    • User Password: The password to connect with. Passwords are case-sensitive.

    • Establish Connection: Click to verify a valid connection.

    • Automatically register downloaded Asset files: If selected, downloaded asset files are registered with the Windows Registry, as appropriate. This may be overridden on an case-by-case basis for each asset download.

  4. Click the Establish Connection button to connect to the Oracle Enterprise Repository instance you specified.

  5. Optionally, click the Advanced button to enable additional Oracle Enterprise Repository options:

    • Usage detection for VS .NET Solution Projects

    • Automated usage detection of referenced DLLs, WSDLs, and allow local caching of SFIDs (if SFID is enabled at your installation)

    • File name patterns to include and exclude

  6. Click OK when finished.

7.3.4 Assign an Oracle Enterprise Repository Project to a .NET Solution

In order to track the usage of downloaded assets, an Oracle Enterprise Repository project must be assigned to a .NET solution.

Note:

Before using this feature, you must be assigned to at least one Oracle Enterprise Repository Project by a Project Administrator.

  1. Open the .NET Solution Explorer.

  2. Right-click a solution in the file tree and select the Oracle Enterprise Repository Add-in for Visual Studio .NET option from the context menu.

  3. Click Assign OER Project from the submenu, as shown in Figure 7-18.

    Figure 7-18 The Solution Explorer Window

    Description of Figure 7-18 follows
    Description of "Figure 7-18 The Solution Explorer Window"

  4. In the Project Selection window, use the Select the Oracle Enterprise Repository Project list to view the Oracle Enterprise Repository projects that you are assigned to, as shown in Figure 7-19.

    Figure 7-19 Oracle Enterprise Repository Project Selection Dialog

    Description of Figure 7-19 follows
    Description of "Figure 7-19 Oracle Enterprise Repository Project Selection Dialog"

    Note:

    If the list is empty, you have not been assigned to any projects and the procedure must be canceled.

  5. Select an Oracle Enterprise Repository project from the list.

  6. Click Finish to save your changes.

7.3.5 Enable Automatic Usage Detection

Follow these steps to enable advanced configuration options, such as enabling automatic usage detection of DLLs, WSDLs, local caching of SFIDs, and file pattern detection.

7.3.5.1 Overview of SFID

If SFID is enabled at your installation, Oracle Enterprise Repository can automatically detect asset reuse within the development environment. This allows development teams to ensure that they get asset reuse credit, regardless of whether the assets have been downloaded through Oracle Enterprise Repository. Automated Usage Detection relies on a fingerprinting process, called Software File Identification (SFID), which tags selected files within an asset with a unique ID. This SFID is then used to detect when and where an asset is used, even if the asset was acquired through means other than the Oracle Enterprise Repository Use - Download process. An instance of usage is recorded by Oracle Enterprise Repository when tagged files within the asset are brought into the developer's IDE, and a new build or build clean occurs.

7.3.5.2 Configuring Automatic Usage Detection

  1. Launch Visual Studio .NET.

  2. Open the Tools menu and click Options.

  3. In the list of options, click Oracle Enterprise Repository Add-in for Visual Studio .NET to reopen the Login window.

  4. Click the Advanced Options button to open the Advanced Settings window. Use the Detect Usage tab to enable usage detection for VS .NET Solution Projects, as shown in Figure 7-20.

    Figure 7-20 The Advanced Settings Dialog - Detect Usage Tab

    Description of Figure 7-20 follows
    Description of "Figure 7-20 The Advanced Settings Dialog - Detect Usage Tab"

  5. Click the Automated Usage Detection tab to enable usage detection of referenced DLLs, WSDLs, and allow local caching of SFIDs, as shown in Figure 7-21.

    Figure 7-21 The Advanced Settings Dialog - Automated Usage Detection Tab

    Description of Figure 7-21 follows
    Description of "Figure 7-21 The Advanced Settings Dialog - Automated Usage Detection Tab"

  6. Click the File Pattern Detection tab to specify include and exclude file name patterns, as shown in Figure 7-22.

    Figure 7-22 The Advanced Settings Dialog - File Pattern Detection Tab

    Description of Figure 7-22 follows
    Description of "Figure 7-22 The Advanced Settings Dialog - File Pattern Detection Tab"

  7. Click Done to save your settings.