Business Service Control Configuration  Locate

The bsc.jar file in directory REGISTRY_HOME/app/uddi contains the configuration files for the entire Business Service Control. They are located in the conf subdirectory, the contents of which were summarized in Directory Structure. In this section, we focus on the file bsc.xml.

Oracle Service Registry API Endpoint URL   Locate

This configuration part contains the endpoint URLs used by the Business Service Control to communicate with Oracle Service Registry:

<url>http://localhost:8888/registry</url>
<secureUrl>https://localhost:8443/registry</secureUrl>
<useSoap>false</useSoap>
<uddiEndpoints accountApiPath="/uddi/account" approverApiPath="/uddi/approver"
    categoryApiPath="/uddi/category" configuratorApiPath="/uddi/configurator"
    inquiryPath="/uddi/inquiryExt" inquiryUIApiPath="/uddi/inquiryUI"
    publishingPath="/uddi/publishingExt" requestorApiPath="/uddi/requestor"
    securityPath="/uddi/security" subscriptionPath="/uddi/subscriptionExt"
    taxonomyApiPath="/uddi/taxonomy" wsdlApiPath="/uddi/wsdl2uddi"
    xml2UddiApiPath="/uddi/xml2uddi" xsd2UddiApiPath="/uddi/xsd2uddi"
    xslt2UddiApiPath="/uddi/xslt2uddi"/>

The endpoint URL is composed of two parts:

  • The prefix, taken from the url element (or secureURL element for a secure endpoint)

  • The relative part, taken from the specified uddiEndpoints attribute (depending on the type of the endpoint).

If you want to use a different target registry, it is usually sufficient to change the prefix (the absolute part of the URL).

[Important]Important

The useSoap element indicates whether to use SOAP to access Oracle Service Registry, or to ignore the declared API endpoints and make the calls directly through the Java virtual machine.

Result Filtering  Locate

Use this section to filter data that should not be displayed in the Business Service Control. For example, to hide the Operational business entity, you can set up a filter in the businessUI element. Note that child elements of an element you filter will not be displayed in the Business Service Control.

The following sample will hide the Operational business entity in the Business Service Control:

<filteredKeys>
      <businessKey>uddi:systinet.com:uddinodebusinessKey</businessKey>
</filteredKeys>

Main Menu Tabs  Locate
<tab tabId="home" taskId="/home">
    <captionKey>bsc.tab_home</captionKey>
    <hintKey>bsc.tab_homeHint</hintKey>
</tab>
<tab tabId="search" taskId="/search">
    <captionKey>bsc.tab_search</captionKey>
    <hintKey>bsc.tab_searchHint</hintKey>
</tab>
<tab tabId="catalog" taskId="/publish">
    <captionKey>bsc.tab_catalog</captionKey>
    <hintKey>bsc.tab_catalogHint</hintKey>
</tab>
<tab tabId="tools" taskId="/tools">
    <captionKey>bsc.tab_tools</captionKey>
    <hintKey>bsc.tab_toolsHint</hintKey>
</tab>
<tab tabId="report" taskId="/browse">cat
    <captionKey>bsc.tab_reports</captionKey>
    <hintKey>bsc.tab_reportsHint</hintKey>
</tab>
<tab tabId="configure" taskId="/configure">
    <captionKey>bsc.tab_configure</captionKey>
    <hintKey>bsc.tab_configureHint</hintKey>
</tab>

Each tab element contains the definition of one main menu tab. These tabs are rendered in the top left area of the Business Service Control, under the product logo.

[Important]Important

Some navigation tabs should not be visible in all cases. Tab visibility depends on the profile selected for the current user. The Oracle Service Registry administrator should define tab visibility using the Configuration main menu tab.

Table 89.  Tab element attributes

AttributeDescriptionRequired
captionKeyResource bundle key to caption visible for users.yes
tabIdUnique tab identification.yes
taskIdURI of the task called when a user clicks on this tab.yes
hintKeyResource bundle key to descriptive text displayed as tab tooltip.no
User Profiles  Locate
<profile defaultTab="home" profileId="default" captionKey="bsc.profile_anonymousUserProfile">
    <visibleTab>search</visibleTab>
    <visibleTab>report</visibleTab>
    <visibleTab>home</visibleTab>
    <defaultView viewId="Common" viewType="providers"/>
    <defaultView viewId="Common" viewType="interfaces"/>
    <defaultView viewId="Common" viewType="endpoints"/>
    <defaultView viewId="Common" viewType="bindings"/>
    <defaultView viewId="Common" viewType="services"/>
</profile>

Each profile element contains the definition of one user profile. The user profile defines the visibility of tabs, default navigation tab, and default views for various Business Service Control entity lists.

Users are able to change their profiles using the My Profile link from the Home page, unless an administrator has prohibited this via the Configure tab.

Table 90.  Profile Element Attributes

AttributeDescriptionRequired
captionTab caption visible for users.yes
profileIdUnique profile identification. yes
defaultTabTabId of the tab which will be displayed after user login. This attribute must contain the identification of one of the visible tabs defined for this profile.yes
visibleTabId of navigation which will be visible for this user profile. at least one
defaultViewSpecifies the viewId of the view used as default when the user enters a page with a result list. The attribute viewType defines the type of list and viewId defines view identification. one for each viewType
Entity List Views  Locate
<!-- list of available views -->
<view captionKey="bsc.view_business" viewId="Business"/>
<view captionKey="bsc.view_common" viewId="Common"/>
<view captionKey="bsc.view_technical" viewId="Technical"/>
<view captionKey="bsc.view_operation" viewId="Operation"/>

<!-- list of available view types -->
<viewType captionKey="bsc.viewType_providers" viewTypeId="providers"/>
<viewType captionKey="bsc.viewType_services" viewTypeId="services"/>
<viewType captionKey="bsc.viewType_endpoints" viewTypeId="endpoints"/>
<viewType captionKey="bsc.viewType_interfaces" viewTypeId="interfaces"/>
<viewType captionKey="bsc.viewType_bindings" viewTypeId="bindings"/>

The view element defines a list of available views. The viewType element defines a list of available entity list types.

[Important]Important

The viewId and viewType values are used to determine which component will be used for view presentation. The Business Service Control automatically checks the existence of all available view components, and only existing views will be presented to user. The View component name has the following format: [viewType][viewId]Results. For example, the component rendering the business view on a list of providers is named providersBusinessResults

Browsable Taxonomies  Locate

<browsableTaxonomy captionKey="bsc.browsableTaxonomy_usage" tModelKey="uddi:systinet.com:taxonomy:usage"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_endpoint" tModelKey="uddi:systinet.com:taxonomy:endpoint:status"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_status" tModelKey="uddi:systinet.com:taxonomy:interface:status"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_namespace" tModelKey="uddi:uddi.org:xml:namespace"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_localName" tModelKey="uddi:uddi.org:xml:localName"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_certification" tModelKey="uddi:systinet.com:taxonomy:service:certification"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_availability" tModelKey="uddi:systinet.com:taxonomy:endpoint:availability"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_wsiCompliance" tModelKey="uddi:65719168-72c6-3f29-8c20-62defb0961c0"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_milestone" tModelKey="uddi:systinet.com:versioning:milestone"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_releaseDate" tModelKey="uddi:systinet.com:versioning:releasedate"/>
<browsableTaxonomy captionKey="bsc.browsableTaxonomy_version" tModelKey="uddi:systinet.com:versioning:version"/>

This section holds information about the list of browsable taxonomies. Each taxonomy is displayed as one node in the Business Service Control Reports tab. This list is also used when displaying the Classifications tab on entity detail pages.

Table 91.  BrowsableTaxonomy Attributes

AttributeDescriptionRequired
captionTaxonomy display name used when rendering the navigation tree on the Report tab.yes
tModelKeyThe key of the taxonomical tModel in Oracle Service Registry. yes

Paging Limits  Locate

<pagingLimits component="resourcesXsltResults" pageSize="10" pageCount="20"/>
<pagingLimits component="resourcesWsdlResults" pageSize="10" pageCount="20"/>
<pagingLimits component="default" pageSize="10" pageCount="20"/>

In this section, the limits of rows displayed on one page and the number of pages displayed are defined. Each component should define its specific settings, or that default values are used when settings are not found.