Figure 54. Browse Menu Tab
On this page, you can use the drop down list to switch the taxonomy list to favorite taxonomies, enterprise taxonomies
, and a defined filter.
Note
The favorite taxonomies option appears in the drop down list only if your list of favorite taxonomies is not empty. To add a taxonomy to your favorites, follow the direction in
Section favorite Taxonomies . The list of
enterprise taxonomies is defined by an administrator. For more information, see Section 1.5, Taxonomy
Management in the Administrators guide.
Initially, the filter contains all taxonomies except system taxonomies. Icons next to the drop down list serve to showhide categorized entities, and show allsuppress empty categories.
Drill down through the taxonomy tree to see all taxonomy categories. Those with sub-categories can be expanded and collapsed.
When you browse internally checked taxonomies you can see their value set to see UDDI entities categorized by these key values. For unchecked or externally checked taxonomies, you can search UDDI entities by key values. We will show
you how to browse an unchecked taxonomy from the demo data
.
To browse the demo data using demo:location:floor taxonomy:
1. Switch the drop down list shown in
Figure 54 to the filter option.
2. Click on the demo:location:floor taxonomy. Expand the taxonomy by clicking on the plus sign in front of the
taxonomy name. The key name and key value field pair appears. 3.
Enter key value as 5
, then click Search button.
4. You will get a list of UDDI entities categorized by this taxonomy with matching key value IT in this case as shown
in Figure 55
.
Page 237
5.5.4. Browsing
Figure 55. Browse Demo
You can also add this search criterion to a query
.
Define Filter
You can reduce the number of taxonomies in the taxonomy list by defining a taxonomy filter. To switch from taxonomy browsing to filter definition, click on the filter link in the lower left corner. The page shown in
Figure 56 will appear.
Figure 56. Taxonomy Filter
Page 238
Define Filter
You can filter taxonomies by name using the wild card characters and
_ . You can specify taxonomy type, compatibility,
and a validation type. Once you define the filter criteria, click Apply filter. This will return you to the browse taxonomy page.
Define Query You can also combine search criteria in a query. To add a search criterion to a query, use the button Add to query shown
in Figure 55
. Then, you can expand another taxonomy and specify a new criterion. The page shown at Figure 57
presents the query displaying business entities located on the 5th floor demo:location:floor taxonomy having Headquarter
department as the superior department demo:hierarchy taxonomy.
Figure 57. Query
To remove a category from the query, right-click on the query and select remove from query from the context menu.
Note
The query definition is not persistent. Once you leave the Browse menu tab, the query will disappear. 5.5.5. Searching
Oracle Service Registry search function allows you to perform the following searches:
Find UDDI data structures
You can search for business entities, services, bindings, and tModels using names and categories in combination with find qualifiers including range queries.
• Find Business
• Find Services
• Find Binding
Page 239
5.5.5. Searching
• Find tModel
Direct Get
You can retrieve data from Oracle Service Registry when you know the key of the UDDI entity you want to retrieve.
Find Resources
You can search for resources: •
Find WSDL •
Find XML •
Find XSD •
Find XSLT In the Search section, we present a demonstration data set that is installed with Oracle Service Registry. This demonstration
set is designed to help familiarize you with the registry.
Note
Oracle Service Registry supports the use of wildcard characters. You can use both and
_ .
Use in place of any number of characters and spaces. For example, if you wish to find all business beginning
with A, type A
. Use the underscore wildcard _
in place of any single character. For example, to find Dan or Dane, type
Dan_ .
See Section Find Business by Categories
how to use range queries
functionality.
Find Business
In this section, we cover locating business entities using a number of different methods. You can locate business entities by:
• Name
• Categories
• Identifiers
• Discovery URL
• tModel
For each find method, you can specify qualifiers located on the Find Qualifiers tab of the Search panel.
Page 240
Find Business
Figure 58. Find Qualifiers
Find Business by Name
To find a business by name: 1.
Under the main Search tab, click the Businesses link.
2. Click the Add Name button in the Search panel.
3. Type in the business name, such as
IT
from the pre-installed demo data. Then click the Find tab at the bottom right
corner. To see all businesses, type the wildcard
and click Find.
4. The search result will appear on the Results panel. Click on the link with the business name, this opens the page
shown at Figure 59
.
Page 241
Find Business by Name
Figure 59. View Business Detail
Find Business by Categories
In this section we will show you how to search for business entities by categories. We will use demo data to demonstrate how to find all departments located on specific floors. Also, an example how to use
range queries will be shown.
To find a business by category: 1.
Under the main Search tab, click the Businesses link
2. Click the Categories tab, then click the Add category button. This returns a list of available taxonomies.
You can switch the Show drop down list from favorite taxonomies to see all taxonomies. To manage favorite taxonomies
see Section 5.5.3, User Profile
. 3.
Click on the desired taxonomy. The taxonomy is shown as a tree; its sub-branches include categories.
Select demo:location:floor from our demo data. 4.
Now you can enter Key name and Key value.
Page 242
Find Business by Categories
Type 1
in the box labeled Key value and then click the Add category icon.
Figure 60. Find Business by Category
5. Once a category is added as your search criteria, click Find.
You will get the department with that is located on the first floor. If you want search for all departments located on higher floors you must use
range queries functionality. We will continue with the previous search.
1. Click the tab Search to return to the Find business by categories page.
2. Click the Edit category icon. The page shown in
Figure 61 is returned.
Figure 61. Find Business by Range Category
3. From the Operator drop down list, select the operator, and click the Update icon.
4. Click Find. You will get all departments located higher than the first floor.
Find Business by Identifier
In this section we will show you how to find a business entity by identifier. We will use demo data to demonstrate how to find departments by their department number identifiers.
To find a business by identifier: 1.
Under the main Search tab, click the Businesses link
2. Click the Identifiers tab. Then click the Add identifier button. This returns a list of available taxonomies.
Page 243
Find Business by Identifier
3. Click on the desired taxonomy
The taxonomy is shown as a tree with its sub-branches including categories. Select demo:departmentID from the demo data.
4. Now you can enter Key name and Key value.
Type 002
in the box labeled Key value, and click Add identifier.
Figure 62. Find Business by Identifier
5. Once the Identifier is added as your search criteria, click Find.
Find Business by Discovery URL
To find a business entity by discovery URL: 1.
Under the main Search tab, click the Businesses link.
2. Select the Discovery URLs tab.
3. Type in the discovery URL and click Find.
Find Services
You can find services using a number of different methods including by: •
Name •
Category •
tModel Search principles for finding services are the similar to those used for finding business entities.
Find Binding
You can find bindings using a number of different methods including by: •
Parent service
Page 244
Find Binding
• Category
• tModel
The search principles for finding bindings are similar to those used for finding business entities.
Find tModel
You can find tModels using a number of different methods including by: •
Name •
Category •
Identifiers The search principles for finding tModels are similar to those used for finding business entities.
Direct Get You can also use Direct get from the Search menu tab to retrieve data from Oracle Service Registry when you know the
key of the UDDI structure you want to retrieve. Oracle Service Registry allows you to specify keys for both UDDI version 2 and UDDI version 3. Click the Find by v2 tab if you want to search using UDDI v2 keys.
Figure 63. Direct Get
Direct Get of XML Structures
You can also acquire the XML form of businesses, services, bindings, and tModels for use in automated processing by entering the key of the structure into a URI.
The form of the URI is:
Page 245
Direct Get of XML Structures
http:hostname:portcontextuddiwebdirectGetXml?structureKey=key
URI Examples
Note that UDDI v3 is assumed by default. •
http:localhost:8888registryuddiwebdirectGetXml?businessKey=uddi:systinet.com:uddinodebusinessKey •
http:localhost:8888registryuddiwebdirectGetXml?serviceKey=... •
http:localhost:8888registryuddiwebdirectGetXml?bindingKey=... •
http:localhost:8888registryuddiwebdirectGetXml?tModelKey=...
Example with Login
This URI includes username and password. •
https:localhost:8888registryuddiwebdirectGetXml?businessKey=uddi:systinet.com:uddinodebusinessKeyuserName=adminpassword=changeit
Example with UDDI Version Specification
Use this format when getting information associated with v1 and v2 structures.
• http:localhost:8888registryuddiwebdirectGetXml?businessKey=8f3033d0-c22f-11d5-b84b-
cc663ab09294version=2
Find WSDL
You can find all WSDL documents published in Oracle Service Registry. When you supply the WSDL location URI, you can review how artifacts of the WSDL document are published in Oracle Service Registry. The following criteria: a WSDL
document location, a tModel key, a business service key, and a binding template key can be used. To search for a WSDL document in Oracle Service Registry:
1. Select the Search menu tab and click the WSDL link. The page shown in
Figure 64 will appear.
2. Click the Find all published WSDLs button, or
Enter WSDL location URI , then click Examine this WSDL button.
Page 246
Find WSDL
Figure 64. Find WSDL
Find XML
You can search for an XML document in Oracle Service Registry according to location URI of the XML document. To search an XML document:
1. Select the Search menu tab and click the XML link. The page shown in
Figure 65 will appear.
2. Enter a location and click Find.
Page 247
Find XML
Figure 65. Find an XML Document
Find XSD
You can search for an XML Schema in Oracle Service Registry according to location URI of the XML document. To search an XML document:
1. Select the Search menu tab and click the XSD link. The page shown in
Figure 66 will appear.
2. You can search by the location of the XML Schema document, namespaces, and by xsd:elements and xsd:types
defined in the XML Schema document. Once you specify the search criteria, click Find.
Page 248
Find XSD
Figure 66. Find XSD
Find XSLT
To search an XSL transformation: 1.
Select the Publish menu tab and click the XML link. The page shown in Figure 67
will appear. 2.
You can enter the location of the XSLT. You can also search according to input and output XML schemas Search criteria for an XML schemas can be specified by tModel key or namespace. If you click on Select XML Schema
you can specify additional criteria for the XML Schema, then select an XML Schema from the XML Schema list.
3. Before you click Find, click the Update icon if you specified to be search according to an XML Schema.
Page 249
Find XSLT
Figure 67. Find XSLT
5.5.6. Publishing
Publishing in Oracle Service Registry has several components: •
Publish UDDI core structures: •
Section Publishing a Business •
Section Publishing a Service •
Section Publishing a Binding Template •
Section Publishing a tModel •
Section Publishing Assertions - Asserting relationships between business entities.
• Section Publishing Subscriptions
- Subscribing interest in receiving alerts regarding changes made to a registry. •
Section Publish Custody Transfer - Transferring ownership of selected UDDI structures.
• Publish Resources
• Section Publishing WSDL Documents
- Publishing Web Services Description Language documents WSDL to Oracle Service Registry.
• Section Publish XML
- Publishing XML Documents. •
Section Publish XSD - Publishing XML Schema Definition XSD Documents.
Page 250
5.5.6. Publishing
• Section Publish XSLT
- Publishing Extensible Stylesheet Language Transformation XSLT Documents.
