Versions Compared

Key

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

...

...

...

This page is currently a WIP draft, and will be continuously updated with improvements.

This feature allows you to further filter (narrow down) the results of a particular search, by selecting a specific value or a set of values for a given attribute in WSO2 G-Reg Store. You can provide the filtering criteria for multiple attributes.

Table of Contents
maxLevel3

You can configure this in the RXT of the asset type. For an example, you can enable categorization by adding new fields to a new Categorization table of SOAP Services as explained below. 

  1.   Log in to the WSO2 G-Reg Management Console using the following URL and admin/admin credentials: https://<G-REG_HOST>:<G-REG_PORT>/carbon/
  2. Click Extensions, and then click Artifact Types in the Configure menu.
  3. Click the corresponding  View/Edit  link of the artifact type, in which you want to enable categorization a shown below.
    Image Removed
  4. Add the following configuration to add option fields to a new Categorization table of the SOAP service RXT using the provided Editor as shown below.  

    Code Block
    languagexml
    <table name="Categorization">
    <field type="options" categorization="true">
    <name label="Business">Business</name>
    <values>
    <value>Customer Care</value>
    <value>Corporate</value>
    <value>Gas Technology</value>
    <value>Energy Supply</value>
    <value>Information Technology</value>
    </values>
    </field>
    <field type="options" categorization="true">
    <name label="Availability">Availability</name>
    <values>
    <value>Tier 1</value>
    <value>Tier 2</value>
    <value>Tier 3</value>
    <value>Tier 4</value>
    </values>
    </field>
    <field type="options" categorization="true">
    <name label="Environment">Environment</name>
    <values>
    <value>Dev</value>
    <value>Test</value>
    <value>QA</value>
    <value>Disaster Recovery</value>
    <value>Production</value>
    </values>
    </field>
    <field type="options" categorization="true">
    <name label="Platform">Platform</name>
    <values>
    <value>J­EE</value>
    <value>ETL</value>
    <value>File Transfer</value>
    <value>EDI</value>
    <value>ESB</value>
    </values>
    </field>
    <field type="options" categorization="true">
    <name label="Service Type">Service Type</name>
    <values>
    <value>HTTP­SOAP</value>
    <value>HTTP­REST</value>
    <value>JMS­XML</value>
    <value>JMS­JSON</value>
    <value>JMS­BINARY</value>
    </values>
    </field>
    </table>
    Info

    You can enable categorization by adding  an option field to any of the existing tables in the RXT of a particular type (e.g. Overview).

  5. Click  Save, and then click Ok in the message which pops-up as shown below.

    Image Removed

  6. Restart the WSO2 G-Reg server.

Once you configure the RXT to enable categorizationOnce you configure the RXT to enable categorization and define categories as search refinements, you can select the categorization values for a particular asset in the WSO2 G-Reg Publisher when creating a SOAP Service an asset using the G-Reg Publisher or updating a SOAP Service an asset as shown below.

view added categories in WSO2 G-Reg PublisherImage Removed

You can use categorization to search for a SOAP Service in the G-Reg Store by its category as shown below.

categories in WSO2 G-Reg StoreImage Removed

search filters in WSO2 G-Reg StoreImage Removed

Other configuration options

You can use the following configuration options, when creating categories for asset types in WSO2 G-Reg.

To get the values to display under each categorization option from Apache Solr 

Change the value of the solarFacetsEnabled element under the asset.configure function to truein the < G-REG_HOME>/repository/deployment/server/jaggeryapps/store/extensions/assets/default/ asset.js file as follows, to retrieve the values from Solr facets.

Code Block
languagejs
categorization: {
solarFacetsEnabled: true,
}

To configure the number of categorization fields, to be expanded by default in the Store.

Change the value of the collapseInMenuCount element under the asset.configure function to truein the <G-REG_HOME>/repository/deployment/server/jaggeryapps/store/extensions/assets/default/ asset.js file as follows, to configure the number of categorization fields, to be expanded by default in the Store.

Code Block
languagejs
categorization: {
collapseInMenuCount: 3
}

 adding categories for an asset typeImage Added

Panel

After adding categories to an asset, to search for an asset using the added categories, see Searching for an asset using categories.