Business Service Console Configuration Locate
The bsc.jar file is located in the REGISTRY_HOME/app/uddi directory. This JAR file also contains the configuration files for the entire Business Service Console. They are located in the conf subdirectory. The conf directory contains the following files:
web.xml Configuration file containing deployment information such as URLs and contexts; it also defines the location of JSP files, their pre-compiled versions and declared libraries for the JSP engine.
web_component.xml Contains the web framework's static settings, mainly definitions of components, tasks, and data types.
bsc.xml Contains Business Service Console-related settings, tabs, user profiles, URLs, and API endpoints used for communication with BEA AquaLogic Service Registry, and a flag whether to use SOAP communication with these endpoints or not.
In this section, we focus on the bsc.xml configuration file:
BEA AquaLogic Service Registry API Endpoint URL Locate
This configuration part contains the endpoint URLs used by the Business Service Console to communicate with BEA AquaLogic Service Registry:
<url>http://localhost:8080</url>
<secureUrl>https://localhost:8443</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]](../images/important.gif) | Important |
|---|---|
The useSoap element indicates whether to use SOAP to access BEA AquaLogic Service Registry, or to ignore the declared API endpoints and make the calls directly through Java. | |
Result Filtering Locate
Use this section to filter data that should not be displayed in the Business Service Console. 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 Console.
The following sample will hide the Operational business entity in the Business Service Console:
<filteredKeys>
<businessKey>uddi:systinet.com:uddinodebusinessKey</businessKey>
</filteredKeys>
Main Menu Tabs Locate
<tab caption="Home"
hint="Main screen for logging in, registering new accounts, or managing user profile"
tabId="home" taskId="/home"/>
<tab caption="Search"
hint="Find elements in the registry, by listing or searching"
tabId="search" taskId="/search"/>
<tab caption="Catalog"
hint="Access and Manage published resource information"
tabId="catalog" taskId="/publish"/>
<tab caption="Tools" hint="Shortcuts to tools and common tasks"
tabId="tools" taskId="/tools"/>
<tab caption="Report" hint="View and Define Reports" tabId="report"
taskId="/browse"/>
<tab caption="Configure" tabId="configure" taskId="/configure"/>Each tab element contains the definition of one main menu tab. These tabs are rendered in the top left area of the Business Service Console, under the product logo.
| Important |
|---|---|
Some navigation tabs should not be visible in all cases. Tab visibility depends on the profile selected for the current user. The BEA AquaLogic Service Registry administrator should define tab visibility using the Configuration main menu tab. | |
User Profiles Locate
<profile caption="Default Profile" defaultTab="home"
profileId="default">
<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 Console entity lists.
| Important |
|---|---|
Users are able to change their profiles using the My Profile link from the Home page. | |
Table 80. Profile Element Attributes
| Attribute | Description | Required |
|---|---|---|
| caption | Tab caption visible for users. | yes |
| profileId | Unique profile identification. | yes |
| defaultTab | TabId 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 |
| visibleTab | Id of navigation which will be visible for this user profile. | at least one |
| defaultView | Specifies 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 caption="Business" viewId="Business"/> <view caption="Common" viewId="Common"/> <view caption="Technical" viewId="Technical"/> <view caption="Operation" viewId="Operation"/> <!-- list of available view types --> <viewType caption="Providers" viewTypeId="providers"/> <viewType caption="Services" viewTypeId="services"/> <viewType caption="Endpoints" viewTypeId="endpoints"/> <viewType caption="Interfaces" viewTypeId="interfaces"/> <viewType caption="Bindings" viewTypeId="bindings"/>
The view element defines a list of available views. The viewType element defines a list of available entity list types.
| Important |
|---|---|
The viewId and viewType values are used to determine which component will be used for view presentation. The Business Service Console 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 | |
See Result Views
Browsable Taxonomies Locate
<browsableTaxonomy caption="Usage" tModelKey="uddi:systinet.com:taxonomy:usage"/> <browsableTaxonomy caption="Endpoint status" tModelKey="uddi:systinet.com:taxonomy:endpoint:status"/>
This section holds information about the list of browsable taxonomies. Each taxonomy is displayed as one node in the Business Service Console Report tab. This list is also used when displaying the Classification tab on entity detail pages.
Table 81. BrowsableTaxonomy Attributes
| Attribute | Description | Required |
|---|---|---|
| caption | Taxonomy display name used when rendering the navigation tree on the Report tab. | yes |
| tModelKey | The key of the taxonomical tModel in BEA AquaLogic 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.