Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The WSO2 Governance Registry (G-Reg) is an SOA-integrated registry-repository for storing and managing data or metadata related to services and other artifacts. It consists of two Web-based interfaces: the G-Reg Publisher and G-Reg Store. The Publisher is used to create and manage assets, while the Store is used to search for and subscribe to assets.

...

Introducing the sample

BuyMore is a fictitious supermarket chain with more than 200 retail branches. Given below is a snapshot of the existing services of BuyMore with their lifecycle states:

...

You now have sample services and other artifacts related to BuyMore along with two users (a developer called Smith and a DevOps engineer called Mark) deployed in the G-Reg. Next, let's log in to the G-Reg Store as Smith and subscribe to an asset. 

...

Searching for an asset

Smith is a developer at  at BuyMore.Smith  Smith comes to the G-Reg Store searching for the asset asset BuyMoreBillCalculateRESTAPI version 1.0.0 to calculate bill values of the products being purchased at BuyMore. Smith searches can search for the asset and subscribes to it in order to receive notifications regarding any changes that happen to the asset later. using the following alternative methods.

Search using search bar

  1. Log in to the G-Reg Store (https://localhost:9443/store/) as Smith. Smith's credentials are smith/smith@bm.
  2. Once logged in, search for the asset by typing "name:BuyMoreBillCalculateRESTAPI version:1.0.0" in the search field and and clicking the search icon: 
    Image Modified

Search using filters

Smith can follow the steps below to search for the BuyMoreBillCalculateRESTAPI version 1.0.0 asset using the pre-defined search filters.

 

Search using refinements

Smith can follow the steps below to search for the BuyMoreBillCalculateRESTAPI version 1.0.0 asset using the pre-defined search refinements.

Subscribing to an asset

Now Smith comes to the G-Reg Store and subscribes to the BuyMoreBillCalculateRESTAPI version 1.0.0 asset in order to receive notifications regarding any changes that happen to the asset later. 

  1. The service BuyMoreBillCalculateRESTAPI appears in the search results. Click it to open it.
  2. The asset open. Scroll down to see the following links:

    • Swagger UI: Opens a Swagger console where you can invoke the REST asset.
    • Download: Downloads the Swagger definition of the REST asset to a given location in your machine.
    • Copy URL: Gives you the option to copy the URL of the Swagger definition. 

    Smith has now discovered the REST asset that can be called from other applications to calculate bill values. Next, Smith subscribes to receive notifications for this asset. A notification is an alert that you get via email and/or the G-Reg Store regarding an asset's lifecycle and/or information change. 

  3. Click the ->OPTIONS button in the top right-hand corner of the screen to expand the notification settings.

    You can subscribe to receive notifications through emails or through the G-Reg Store.
    You can also opt to receive notifications when an asset is changed and/or when it goes through a lifecycle state change. 

  4. Enable the option to receive notifications related to lifecycle state changes via the G-Reg Store.

...

Reviewing the new version of the asset

In the previous step, Smith opened BuyMoreBillCalculateRESTAPI Version 2.0.0 in the G-Reg Store.

  1. Go to the User Reviews tab of the asset and add a rating (let's say 5). Also add a review comment (such as "This version of the asset is recommended as it implements the company's new loyalty scheme"), and then click Post Review
  2. Note that the review that Smith just added appears on the console, under the NEWEST category. You can filter reviews according to popularity and the date added.

...