Creating a Service Catalog for services in WebSphere Service Registry and Repository

This article takes you through the detailed steps to create a Service Catalog view for services in WebSphere Service Registry and Repository. This read-only view is optimized for business users to search for and discover existing services for reuse.

Share:

Dave Seager (seager@uk.ibm.com), Staff Software Engineer, IBM

Photo of David SeagerDavid J. Seager is a Software Developer on the WebSphere Service Registry and Repository Development team at the IBM Hursley Development Lab in the U.K. He has 15 years of experience in middleware development at IBM. David holds a Masters degree in Software Engineering and a Masters degree in Physics, both from Oxford University in the UK. His areas of expertise include AJAX, Java, JavaScript, WebSphere Application Server, and web UI design. You can contact David at seager@uk.ibm.com.


developerWorks Contributing author
        level

Martin Smithson (msmiths@uk.ibm.com), Senior IT Specialist, IBM

Photo of Martin SmithsonMartin Smithson is a Product Architect on the WebSphere Service Registry and Repository Development team at the IBM Software Lab in Hursley, UK. He has 17 years of experience in the IT industry in software development and technical consultancy. His areas of expertise include WebSphere Application Server and the architecture, design, and development of J2EE applications. He has published several developerWorks articles and co-authored the following IBM Redbooks: WebSphere Application Server V6.1 System Management and Configuration, WebSphere Application Server V6 System Management and Configuration Handbook, WebSphere Service Registry and Repository Handbook, and CCF Connectors and Database Connections Using WebSphere Advanced Edition. Martin also developed the IBM Client Application Tool for JMS. You can contact Martin at msmiths@uk.ibm.com


developerWorks Contributing author
        level

Gary Thornton (thorng@uk.ibm.com), User Experience Architect, IBM

Photo of Gary ThorntonGary Thornton is a is a User Experience Architect, specializing in UI design, information architecture, visual design, and usability. He is currently responsible for designing the user experience of various IBM software products, and he has over 25 years experience designing and developing user experiences for award-winning interactive applications. Previously, as a consultant in IBM Global Business Services, Gary worked on a variety of client engagements across all industry sectors, leading User Experience Design teams using the User Centered Design (UCD) methodology. You can contact Gary at thorng@uk.ibm.com.



10 October 2012

Introduction

A service registry is the central catalog for services within an organisation. It provides important governance and registration functions, enabling an organisation to keep track of what stage its services are in, who is using them, and policies and other metadata associated with them. IBM® WebSphere® Service Registry and Repository (hereafter called WSRR), IBM's service registry product, also gives visibility to services and provides a central place to search for them.

The WSRR Business Space user interface enables you configure controls and views into WSRR data to meet the requirements of your organization. This article shows you how to use the browser-based Business Space user interface to create a read-only Service Catalog view for WSRR, and how to further customize the Service Catalog view for your own needs.

Overview of Business Space

Business Space is made up of widgets, which perform specific tasks, and spaces, which are arrangements of widgets on several pages. WSRR provides both widgets and spaces, and both can be customized to meet your requirements. WSRR Widgets are divided into two categories: eight Service Registry widgets, which are described below, and five Service Registry Policy Analytics widgets, which are not covered in this article.

Service Registry Search widget
The Search widget lets you search for items in WSRR. By default, it performs a full-text index search against WSRR, matching your search argument against the metadata for the objects in WSRR and the content of documents that have been loaded into WSRR. You can configure the Search widget to restrict the types of objects that it searches, so that within a space, searches focus on those object types that users in the relevant role are interested in. The Search widget has a drop-down list of types, and you can choose which types appear in the list and the order in which they appear.
Service Registry Collection widget
The Collection widget shows the results of the most recent search from the Search widget, or the results of a predefined query selected from the Collection widget view menu. The results can be displayed in either a table with pages, or as icons (referred to as icon mode). You can configure the Collection widget to be locked, which means the user cannot modify the query that the widget executes when the page is displayed. You can also customize the formatting of the table by type or for multi-type search results.
Service Registry Detail widget
The Detail widget displays the details of a selected object in WSRR. For each WSRR object type, you can customize which details appear and how they are displayed. The Detail widget lets you perform operations on the displayed object, including executing a life cycle transition, editing the object metadata, or deleting the object. For each WSRR object type, you can configure which operations can be performed on the displayed object.
Service Registry Actions widget
Along with the Search widget, the Actions widget is a main starting point for actions within WSRR, providing a list of clickable actions that you can configure. Actions provided by the Actions widget include creating a business object, creating a policy, loading documents, opening a URL, or performing a custom query.
Service Registry Service Consumption Visualizer widget
New in WSRR V8, the Service Consumption visualizer widget shows services that are linked by service level agreements (SLAs). The widget shows business capability items (including business services, business applications, and business processes), and all the versions of these items that exist. The visualization shows how the providing versions are linked to consuming versions.
Service Registry Activity widget
Displays recent changes made to an object and who made them.
Service Registry Chart widget
Displays service reuse and a variety of other reports.
Service Registry Graphical Explorer widget
Shows registry content graphically.
Service Registry Navigator widget
Shows registry content graphically.

For more information on any of the widgets, see Widgets in the Business Space user interface in the WSRR information center.

Designing and creating a Service Catalog

For the exercise in this article, the design of the Service Catalog is based on a single page -- an Overview page showing various lists and details of a single item.

The Overview page contains the Search, Actions, Collection, and Detail widgets. The Actions widget will have an action to view all Business Services owned by a particular Organization. The Collection widget will have a view to show reusable Business Services, which are Business Services that have a Service Version with a Service Level Definition in the Subscribable state, which means that the service is ready to be reused by another service, application, or process. Finally the Detail widget shows information about an object, with all editing functions turned off. You will start from a blank configuration rather than modify an existing one, to demonstrate the range of configuration options available.

You will make the space read-only by removing the options to create, edit, or transition entities, using the UI options so that the UI will not give the user these options. However the user will be able to do the Create, Update and Delete actions in WSRR. For additional security, you can use WSRR fine-grained access control to restrict the user, as described in the developerWorks article Fine-grained access control in WebSphere Service Registry and Repository, Part 1: How it works with Application Server authentication and coarse-grained access control.

You can also prevent users from creating spaces, so that they cannot create spaces when viewing the Service Catalog. Finally you will share the Service Catalog space to a user group created for viewing services in the Service Catalog.

Creating a new space

  1. Navigate to https://yourhost:9443/BusinessSpace/, where you should see something like Figure 1 below. Log in as an administrator:
    Figure 1. Business Space login window.
    Business Space login window
  2. Create a new space: click Actions => Create Space.
  3. In the Space Name field, enter Service Catalog.
  4. In the Space icon section, select an icon.
  5. Ensure that Create a blank space is selected.
  6. Click Save.
  7. In the Create Page dialog, enter Overview into the Page name field. Ensure that Create an empty page is selected.
  8. Click OK. The space is created and the browser goes to the space.

Adding widgets and space configuration

  1. Click Edit Page at the top of the page. The Widget palette opens.
  2. Select Service Registry (9) from the filter pull-down menu to show the WSRR widgets.
  3. Drag a Service Registry Search widget into the left column.
  4. Drag a Service Registry Actions widget into the left column.
  5. Drag a Service Registry Collection widget into the left column.
  6. Drag a Service Registry Detail widget into the right column.
  7. Click Save at the top of the page:
    Figure 2. Initial overview page
    Initial overview page
  8. Next you create a space configuration, which is where the settings for the widgets are stored. In the Actions Widget title bar, click the small triangle to show the Widget menu.
  9. Click Edit settings to show the WSRR Business Space Configuration Settings dialog:.
    Figure 3. WSRR Business Space Configuration Settings dialog
    WSRR Business Space Configuration Settings dialog

When you change the display settings for a Service Registry widget, those changes are stored in the WSRR profile on the WSRR server that the Service Registry widgets are using. The WSRR configuration type of Business Space Configuration is used to store Service Registry widget configuration. Many Business Space Configurations can be stored in WSRR, but only one is used by all the Service Registry widgets in a space. The WSRR Business Space Configuration name specifies which Business Space Configuration in WSRR is used, and is set in the WSRR Business Space Configuration Settings dialog box. If no WSRR Business Space Configuration name is specified, the WSRR widgets use their own defaults.

If the current space does not have a WSRR Business Space Configuration name set, then when you first edit the display settings for any WSRR widget, the WSRR Business Space Configuration Settings dialog box will open.

  1. Click Create a new WSRR Business Space Configuration.
  2. Enter ServiceCatalog in the WSRR Business Space Configuration Name field.
  3. Uncheck Copy from existing configuration. A new blank configuration will be created, with the widgets using their defaults.
  4. Click Create to create the configuration in WSRR and set it to be selected in the WSRR Business Space Configuration pull-down menu.
  5. Click Save and Close. The Service Registry Actions -- Edit Settings dialog opens. Click Close.
  6. Click Save at the top of the page.

Configuring the Actions widget

Add the action described above to show Business Services owned by a particular organization, in this case the Commercial organization.

  1. On the Actions Widget title bar, click the small triangle to show the Widget menu.
  2. Click Edit Settings.
  3. In the Service Registry Actions -- Edit Settings dialog, uncheck the Visible check boxes against the two default actions.
  4. Click Create a New Action.
  5. In the Create a New Action dialog, enter Commercial Business Services into the Action Label field.
  6. Select Custom Query in the Action Type pull-down menu.
  7. Click Add Query.
  8. Select Custom Query in the Query Type pull-down menu.
  9. In the XPath field, enter:
    /WSRR/GenericObject[@primaryType='http://www.ibm.com/xmlns/prod/serviceregistry
    /profile/v6r3/GovernanceEnablementModel#BusinessService' and 
    ale63_owningOrganization(.)[@name='Commercial']]

    This query expresses the following conditions:

    • Find any instances of the Business Service, where it is related to an Organization by the ale63_owningOrganization relationship.
    • The Organization must have a name of Commercial.
  10. Click Add.
  11. Click OK.
  12. Click Save and Close.
  13. Click the small triangle to show the Widget menu.
  14. Click Choose Skin => No Border.
  15. Click Save at the top of the page. The action you created is shown below:
    Figure 4. Action to show Business Services owned by the Commercial Organization
    Action to show Business Services owned by the Commercial Organization

Configuring the Search widget

Next, change the searchable types to only Business Services:

  1. On the Search Widget title bar, click the small triangle to show the Widget menu.
  2. Click Edit Settings.
  3. In the Types table, click Deselect All.
  4. In the Types table, select the Business Service type:
    Figure 5. Completed Search widget configuration
    Completed Search widget configuration
  5. Click Save and Close.
  6. Click the small triangle to show the Widget menu.
  7. Click Choose Skin => No Border.
  8. Click Save at the top of the page.

Configuring the Collection widget

The next task is to give the Collection widget a view to show Reusable Business Services, which are Business Services that have a Service Version with a Service Level Definition in the Subscribable state, which means that the service is ready to be reused by another service, application, or process. Adding a view to the Collection widget shows an alternative way of adding useful searches to the space:

  1. On the Collection Widget title bar, click the small triangle to show the Widget menu.
  2. Click Edit Settings.
  3. In the Service Registry Collection Display Settings dialog, click View Menu in the navigation pane.
  4. Uncheck the check boxes in the Visible column for the three entries in the View Menu Display Settings pane: My Recent Items, All My Items, and All Recent Items.
  5. Click Add Menu Item.
  6. In the Menu Item Settings dialog, enter Reusable Business Services in the Display Label field.
  7. Enter Business Services ready for reuse into the Description field.
  8. Click Add Query.
  9. Select Custom Query in the Query Type pull-down menu.
  10. In the XPath: field, enter:
    /WSRR/GenericObject[@primaryType='http://www.ibm.com/xmlns/prod/serviceregistry
    /profile/v6r3/GovernanceEnablementModel#BusinessService' and 
    gep63_capabilityVersions(.)/gep63_provides(.)[classifiedByAllOf(.,'http://www.ibm.com
    /xmlns/prod/serviceregistry/lifecycle/v6r3/LifecycleDefinition#SLDSubscribable')]]
  11. Click Add.
  12. In the Menu Item Settings dialog, click OK.
  13. In the Service Registry Collection Display Settings dialog, click Instance Settings in the navigation pane.
  14. In the Instance Settings pane, select Reusable Business Services in the Default View pull-down menu.
  15. Click Save and Close.
  16. Click Save at the top of the page.

Configuring the Detail widget

The Detail widget shows information about an object, with all editing functions turned off. First you will turn off all editing functions for the Business Capability type, and then configure how the Business Capability type is displayed.

Turning off editing for the Business Capability type

Turning off editing is done in two stages. First you turn off deletion and life cycle transitions and editing of properties, and then you turn off editing of classifications and relationships.

  1. On the Detail Widget title bar, click the small triangle on the right to show the Widget menu.
  2. Click Edit Settingsto open the Service Registry Detail Display Settings dialog.
  3. In the types navigator panel, expand Asset.
  4. Click Business Capability to open the Detail Display Settings for the Business Capability panel in the content area.
  5. Uncheck Enable life cycle transitions in Actions menu. This will prevent the user from attempting to transition the object.
  6. Uncheck Enable Delete in Actions menu. This prevents the user from attempting to delete the object.
  7. Uncheck Enable View in Graphical Explorer in the Actions menu. You are not using the Graphical Explorer in this space.
  8. Ensure that Enable View Consumers and Providers in the Actions menu is unchecked. You are not initially using the Consumption Visualizer in this space.
  9. In the Properties section, uncheck Properties are editable. This prevents the user from attempting to edit the properties of the object.
    Figure 6. Completed Properties tab
    Completed Properties tab
  10. Click the Classifications tab to show the classifications settings.
  11. In the Classifications section, uncheck Classifications are editable. This prevents the user from attempting to edit the classifications of the object.
  12. In the Classifications section, uncheck Display classifications. This prevents all the classifications from showing.
  13. Click the Relationships tab to show the relationships settings.
  14. In the Relationships section, uncheck Relationships are editable. This prevents the user from attempting to edit the relationships of the object.
  15. In the Relationships section, uncheck Policy tables are editable. This prevents the user from attempting to edit the policy attachments of the object.

Configuring the Business Capability display

Next you configure how the relationship targets are displayed for the Business Capability type.

  1. In the Relationships section, in the Relationships table, uncheck the check box in the Visible column for the relationship named Service Interface Versions.
  2. In the Relationships section, in the Relationships table, uncheck the check box in the Visible column for the relationship named Artifacts.
  3. In the Relationships table, in the Charter row, select Attached Document in the pull-down menu in Column 2.
  4. In the Charter row, select (None) in the pull-down menu in Column 3.
    Figure 7. Completed Relationships table for Business Capability
    Completed Relationships table for Business Capability
  5. Next you configure how Properties are displayed for the Business Capability type. Click the Properties tab to show the Properties section.
  6. In the Properties section, in the Properties table, uncheck the check box in the Visible column for the Asset Owners property.
  7. Uncheck the check boxes in the Visible column for the properties named Community Name, GUID, Asset Type, Remote State, Full Description, Asset Web Link, Namespace, and Version:
    Figure 8. Completed Properties table for Business Capability
    Completed Properties table for Business Capability
  8. Click Save Changes to save the current configuration in WSRR.

Configuring the subtypes of Business Capability to inherit settings

Next, make the subtypes of Business Capability use the view detail settings of Business Capability, so that you don't have to configure these subtypes explicitly.

  1. In the Types Navigator panel, expand Business Capability.
  2. Click Business Application.
  3. Check Inherit settings from Business Capability. This makes the Business Application use the Detail Display settings of the Business Capability.
  4. Repeat the above procedure for the remaining subtypes of Business Capability: Business Process and Business Service.
  5. Click Save and Close to save the current configuration in WSRR and close the Edit dialog.

Configuring the Capability Version type

Next you will customize the Capability Version type. Again you will make it read-only and hide some of the technical properties and relationships.

  1. On the Detail Widget title bar, click the small triangle to show the Widget menu.
  2. Click Edit Settings. This opens the Service Registry Detail Display Settings dialog.
  3. In the Types Navigator panel on the left, expand Asset.
  4. Click Capability Version. This shows the Detail Display Settings for Capability Version panel in the content area.
  5. Follow steps 5 to 15 in the section Turning off editing for the Business Capability type, for the Capability Version type.
  6. Click the Relationships tab. Uncheck the check box in the Visible column for the relationships named: Service Level Agreements, Provided SCA Modules, Interface Specifications, Provided Web Services, Provided REST Services, Artifacts.
  7. Click the Properties tab. Uncheck the check box in the Visible column for the properties Consumer Identifier, Asset Owners, Community Name, GUID, Asset Type, Remote State, Full Description, Asset Web Link and Namespace.
  8. Click the up arrow next to Version to move the Version property underneath the Description property. You can also drag and drop the Version row.
  9. Click the down arrow next to Version Termination Date to move it below Version Availability Date. You can also drag and drop the Version Termination Date row.
    Figure 9. Completed Properties table for Capability Version
    Completed Properties table for Capability Version
  10. Follow the steps in the section Configuring the subtypes of Business Capability to inherit settings to make the following types inherit their settings from Capability Version: Application Version, Process Version, and Service Version.
  11. Click Save and Close.

Configuring the Service Level Definition (SLD) and Extended Service Level Definition (ESLD) display

Next you will customize the SLD and ESLD types. Again you will make them read-only and hide some of the more technical properties and relationships.

  1. On the Detail Widget title bar, click the small triangle on the right to show the Widget menu.
  2. Click Edit Settings to open the Service Registry Detail Display Settings dialog.
  3. In the Types navigator panel, click Service Level Definition. This shows the Detail Display Settings for the Service Level Definition panel on the right.
  4. Follow steps 5 to 15 in the section Turning off editing for the Business Capability type, for the SLD type. There is no checkbox for View Consumers and Providers.
  5. Click the Relationships tab. Uncheck the check box in the Visible column for the relationships named Bound SCA Exports, Anonymous SLA, Bound Web Service Ports, Bound REST Services, Service Interface, Available Operations, and Available Endpoints.
  6. Click the Properties tab. Uncheck the check box in the Visible column for the properties Namespace, Version, and Additional Properties.
  7. In the Types navigator panel, expand Service Level Definition and click Extended Service Level Definition. This shows the Detail Display Settings for the Extended Service Level Definition panel in the Content area.
  8. In the Detail Display Settings for the Extended Service Level Definition panel on the right, click Copy settings from Service Level Definition. The panel displays the message The copy was successful. The second message warns that this type has more properties that the parent, and the settings for these types have not been changed.
  9. Click the Properties tab. Move the following properties to just below Description: Average Response Time and Availability.
  10. Click Save and Close.

Configuring the Other Document and Organization display

Next you will customize the Other Document and Organization types. Again you will make them read-only and hide some of the more technical properties and relationships.

  1. On the Detail Widget title bar, click the small triangle on the right to show the Widget menu.
  2. Click Edit Settings to open the Service Registry Detail Display Settings dialog.
  3. In the Types navigator panel, expand Document and click Other Document. This shows the Detail Display Settings for the Other Document panel in the Content area.
  4. Follow steps 5 to 15 in the section Turning off editing for the Business Capability type, for the Other Document type. There is no checkbox for View Consumers and Providers and no checkbox for Policy tables are Editable.
  5. Click the Properties tab. Uncheck the check boxes in the Visible column for the properties Encoding, Location, Size in Bytes, Governance State, Namespace, Version, and Additional Properties.
  6. Click the Relationships tab. Uncheck Display Relationships.
  7. In the Types navigator panel, click Organization. This shows the Detail Display Settings for the Organization panel in the Content area.
  8. Follow steps 5 to 15 in the section Turning off editing for the Business Capability type, for the Organization type. There is no checkbox for View Consumers and Providers.
  9. Click the Properties tab. Uncheck the check box in the Visible column for the properties Governance State, Namespace, and Version.
  10. Click Save and Close.
  11. Click Save at the top of the page.
  12. Click Finish Editing at the top of the page.

    The completed space is shown in Figure 10 below. The Overview page has the Actions, Collection, Search, and Detail widgets. The Actions widget has an action to view all business services owned by a particular organization. The Collection widget has a view to show reusable business services. The Detail widget shows information about an object, with all editing functions turned off.

    Figure 10. Completed Service Catalog space
    Completed Service Catalog space

Sharing the Service Catalog space with the user

Now that the Service Catalog space is complete, you share the space to give a special user created for purely viewing services access to the Service Catalog space. Assume that you have a user called guest who is a member of a group called guest. To share the space:

  1. Click Manage Spaces at the top of the page.
  2. In the Space Manager dialog, click Actions to the side of the Service Catalog space.
  3. In the drop-down menu, click Share
  4. In the Share Service Catalog dialog, click the down arrow next to the search box and select Group Search.
  5. Enter guest into the Search for Group box.
  6. Click the Search icon. The Search Results panel shows the search results.
  7. In the Search Results panel, select Guest.
  8. Click Add to View. This enables users in the Guest group to view the space, but not alter its contents.
  9. Click Save.
  10. In the Space Manager dialog, click Done.

When a member of the guest group logs into Business Space, they can use the Service Catalog space using the Go to Spaces link, but they cannot edit the Service Catalog space.

Preventing users from creating spaces

You have prevented the guest user of the Service Catalog space from creating, updating, or deleting WSRR content. However, a Business Space user can create spaces, and you may want to prevent them from doing so, so that they can use only the space shared to them. For information on locking down Business Space so that only users who log in using a superuser ID can create spaces, see Preventing users from creating business spaces. in the IBM Business Process Manager information center.

Extensions to the Service Catalog space

Many clients will find the Service Catalog space you created ideal for their needs. There are a few ways to extend the Service Catalog space to demonstrate more advanced functionality.

To extend the Service Catalog space, you will add a new search to the Actions widget that uses the current time to find Services that have been updated in the last five days. You will add the new Service Consumption Visualizer widget onto a separate page, and enable the space to switch to the page when the user clicks View Consumers and Providers in the Detail widget.

Adding a new action to the Actions widget to show services changed in the last five days

  1. Click Edit Page at the top of the page. The Widget palette opens.
  2. On the Actions Widget, click the small up arrow where the border was to show the border. The up arrow appears when the cursor is hovering over the widget:.
    Figure 11. Show border arrow for a hidden border widget
    Show border arrow for a hidden border widget
  3. On the Actions Widget title bar, click the small triangle on the right to show the Widget menu.
  4. Click Edit Settings.
  5. Click Create a New Action.
  6. In the Create a New Action dialog, enter Services changed in the last five days into the Action Label field.
  7. Select Custom Query in the Action Type pull-down menu.
  8. Click Add Query.
  9. Select Custom Query in the Query Type pull-down menu.
  10. In the XPath field, enter:
    /WSRR/GenericObject[classifiedByAnyOf(., "http://www.ibm.com/xmlns/prod
    /serviceregistry/profile/v6r3/GovernanceEnablementModel#BusinessService") 
    and @lastModified>${currentTime - 432000000}]

    This query expresses the following conditions:

    • Find any instances of the Business Service type.
    • Find any instances where the last modified date (in milliseconds) is greater than a specific time. This specific time is the current time (in milliseconds) minus five days (in milliseconds).

    Here you use the advanced substitution capabilities of the Actions widget. The Actions widget can insert the current time and perform additions or subtractions upon it before using the calculated value in the XPath search. The XPath engine in WSRR can compare values using less than, equals, or greater than.

  11. Click Add.
  12. Click OK.
  13. Click Save and Close.
  14. Click Save at the top of the page.

Adding the Consumers and Providers page

You will add the new Service Consumption Visualizer widget onto a separate page called Consumers and Providers, and use the Page Navigator widget to switch the space to the Consumers and Providers page when the menu option View Consumers and Providers is clicked in the Detail widget.

Configuring the Business Capability display to enable the Consumers and Providers menu item.

First, you enable the menu item that lets the space show the Consumers and Providers for the Business Capability:

  1. On the Detail Widget title bar, click the small triangle on the right to show the Widget menu.
  2. Click Edit Settings to opens the Service Registry Detail Display Settings dialog.
  3. In the Types Navigator panel, expand Asset.
  4. Click Business Capability to show the Detail Display Settings for Business Capability panel in the Content area.
  5. In the Detail Display Settings for Business Capability panel, check Enable View Consumers and Providers in Actions menu.

Configuring the Capability Version to enable the Consumers and Providers menu item

Next you enable the Consumers and Providers menu item for the Capability Version type.

  1. In th types navigator panel, click Capability Version to show the Detail Display Settings for Business Capability panel in the Content area.
  2. In the Detail Display Settings for Business Capability panel, check Enable View Consumers and Providers in Actions menu.
  3. Click Save and Close.
  4. Click Save at the top of the page.

Adding the Consumers and Providers page

The Consumers and Providers page contains the Detail widget and the Service Consumption Visualizer widget.

  1. Click + next to the Overview page tab.
  2. In the Create Page dialog, enter Consumers and Providers in the Page Name field.
  3. Select Create an Empty Page.
  4. Click OK. The page switches to the new Consumers and Providers page.

Adding the Consumers and Providers page widgets

  1. Click Edit Page.
  2. Select Service Registry (9) from the Filter pull-down menu to show just the WSRR widgets.
  3. Drag a Service Registry Detail widget into the left column.
  4. Drag a Service Consumption Visualizer widget into the right column.
  5. Click Save at the top of the page:
    Figure 12. Initial Consumers and Providers page
    Initial Consumers and Providers page

    Because the Detail widget has already been configured on the Overview page, the Detail widget on the Consumers and Providers page will use the same settings.

Adding a Page Switch widget

To switch from the Overview page to the Consumers and Providers page when the View Consumers and Providers action is selected in the Detail view, you use the Page Navigator widget. Now that you have added the Consumers and Providers pages, you can add the Page Navigator:

  1. Click the Overview tab.
  2. Click Edit Page.
  3. In the Widget palette, select All Widgets from the pull-down Filter list.
  4. Click the + next to the Page Navigator widget to add it to the page.
  5. On the Page Navigator Widget title bar, click the small triangle to show the Widget menu.
  6. Select Edit Settings
  7. Select Switch Page in the Action pull-down menu.
  8. Select Service Catalog in the Space pull-down menu.
  9. Select Consumers and Providers in the Page pull-down menu.
  10. Select View in consumer provider graph in the Target Event pull-down menu.
    Figure 13. Completed Page Navigator settings
    Completed Page Navigator settings
  11. Click OK.
  12. On the Page Navigator Widget title bar, click the small triangle to show the Widget menu.
  13. Click Hide to hide the Page Navigator widget because it does not display useful information. To see the widget again, click the Open Hidden Widgets icon next to the Save button at the top corner of the page:
    Figure 14. Open hidden widgets icon
    Open hidden widgets icon
  14. Click Save at the top of the page.

Service Registry widgets support auto-wiring, which means that the widgets will automatically wire themselves together with compatible events, so they will send messages between themselves and react to events on the page. However, you must explicitly wire the Page Navigator Widget to the widgets on the page. You will wire the Service Registry Detail Widget to the Page Navigator, so that when the View Consumers and Providers action is selected in the Detail view, it will cause the page to switch.

  1. Click the Open Hidden Widgets icon in the top right corner of the page. The Page Navigator Widget opens.
  2. On the Page Navigator Widget title bar, click the small triangle on the right to show the Widget menu.
  3. Click Edit Wiring to open the Wiring dialog.
  4. Select Page Navigator in the Widget pull-down menu.
  5. Click Add Incoming Wire.
  6. Select Service Registry Detail in the menu that opens to add the Service Registry Detail widget to the wiring diagram and create a wire from it to the Page Navigator widget.
  7. On the outgoing wire from the Service Registry Detail widget, click the small arrow and select View Consumer Provider Graph from the menu:
    Figure 15. Selecting target of View Consumer Provider Graph event
    Selecting target of View Consumer Provider Graph event
  8. Click OK.
  9. Click Save at the top of the page.
  10. Click Finish Editing to hide the Widget palette.
  11. In the Detail widget when viewing an item, clicking Action => View Consumers and Providers will now switch to the Consumers and Providers page, and the Detail and Service Consumption Visualizer widgets will show the item, as shown in Figure 16:
    Figure 16. Item being shown on Consumers and Providers page
    Item being shown on Consumers and Providers page

Conclusion

In this article you learned how to create a read-only Service Catalog view for WSRR, optimized for Business users to search and discover existing services for reuse. You then learned how to extend the Service Catalog to add advanced features.

Download instructions

The download file ServiceCatalog_WSRR.zip contains:

  • The WSRR configuration (ServiceCatalog_WSRR.xml) for the Service Catalog and the Business Space template file (ServiceCatalog_Template.zip) for it.
  • The WSRR configuration (ServiceCatalog_Extended_WSRR.xml) for the extended Service Catalog and the Business Space template file (ServiceCatalog_Extended_Template.zip) for it.

For instructions to load the Business Space template, see

For instructions to load the WSRR configuration, see


Download

DescriptionNameSize
Code sampleServiceCatalog_WSRR.zip159 KB

Resources

Comments

developerWorks: Sign in

Required fields are indicated with an asterisk (*).


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name



The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


All information submitted is secure.

Dig deeper into WebSphere on developerWorks


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=WebSphere
ArticleID=840216
ArticleTitle=Creating a Service Catalog for services in WebSphere Service Registry and Repository
publish-date=10102012