WSO2 Governance Registry Publisher/Store Search In Action

Gartner defines SOA Governance as “Ensuring and validating that assets and artifacts within the architecture are acting as expected and maintaining a certain level of quality.” In order to validating and maintain the assets we need to have quick and fast ways of finding what we required. WSO2 G-Reg allows that using simple and fast search capabilities.

Advanced search operators are query words or symbols that perform special actions in the search operation of WSO2 Governance Publisher/Store. These operators allow you to find what you are looking for quickly and accurately. Once you access the Governance Store, you can search for assets by entering advanced search operators in the provided field as shown below.

To download the latest version of G-Reg please visit Governance Registry official page.

Operator	Description	Example
name:	Specifies the asset name. You view assets which contain the word you enter in its name.	Example : name:uber Meaning : list all the assets which contains uber in their names Example : name:"Ordering Service.wadl" Meaning : list only the assets with "Ordering Service.wadl" name.
mediaType:	Specifies the asset type (mime type). You view assets which contain the word you enter in its type. Out of the box media types search keywords are: wsdl, wadl, policy, xsd, restservice, soap-service, etc...	Example : mediaType:wsdl Meaning : List all the asset that media type is application/wsdl+xml Example : MediaType:soap-service Meaning : List all the asset that media type is application/vnd.wso2-soap-service+xml.
version:	Specify the asset version. You view assets of which the version equals to what you enter.	Example : version:1.0.0
tags:	Specifies tags attached to the asset. You view assets which are tagged with the word you enter.	Example : tags:mac Meaning : List assets which includes mac
content:	Searches for assets with content as preferred. You view assets which contain the word you enter in its content. Other than that users can search sentences passing value within quotes.	Example : content:uber Meaning : List all the assets that contains ‘uber’ in the content Example : content:"Adding the WSDL file" Meaning : List all the assets that contains “Adding the WSDL file” in the content.
lcName:	Specifies the asset's lifecycle name. You view assets of which the lifecycle name equals to what you enter.	Example : lcName:ServiceLifeCycle
lcState:	Specifies the asset's lifecycle state. You view assets of which the lifecycle state equals to what you enter.	Example : lcState:Development
associationType:	Searches for assets which are associated with the given type.	Example : associationType:depends Meaning : list all the assets that have ‘depends’ association Example : associationType:security Meaning : list all the assets that have ‘security’ association
author:	Specifies the author of the asset. You view assets which are created by the given author.	Example : author:mark Meaning : List down all the assets created by or deployed by mark Example : author:admin Meaning : List down all the assets created by or deployed by admin
updater:	Specifies the one of the updaters of the asset. You view assets which are updated by the given author. Note:this will not show the last updater. If the user has updated the specific asset at least one that asset will also listed here.	Example : updater:mark Meaning : List down all the assets updated by or deployed by mark Example : updater:admin Meaning : List down all the assets updated by or deployed by admin
category:	Searches for assets which is in the given category. To find more about how to catogory works please visit this blog post.	Example : category:Engineering Example : category:Marketing

<PROPERTY_NAME>:<PROPERTY_VALUE>	Searches for assets which have the given property. You view assets which have the given property and value. How to add a property from here : https://docs.wso2.com/display/Governance510/Managing+Properties You can specify only one property in one search query.	note:uber prop1:val
<RXT_TABLE_NAME>_<RXT_FIELD_NAME>:<RXT_FIELD_VALUE>	Searches for assets by the given RXT field value. You view assets which have the value as specified of the given RXT field name.	security_authenticationType:none interface_transports:https

In Governance Registry 5.2.0 onward you can use concat search queries to filter out the search. Therefore you can only search using AND operation. Kindly find the below example queries which I have preformed after running the GReg getting started guide.

BuyMore (name:BuyMore)

Let’s travers to the rest services page and do the same query.

Let’s say user want to list all the rest services which is in the testing stage.

Either user can search name:buymore lcState:testing in rest service page or he or she can search name:buymore lcState:testing mediaType:rest in landing page search.

name:BuyMore version:2.0.0

"BuyMore" (name:"BuyMore")

content:"Adding the WSDL file" name:info

adding quotes to the search query makes the search strict search. For example in this case

lcState:Development

lcState:Development category:Marketing

interface_transports:https

<RXT_TABLE_NAME>_<RXT_FIELD_NAME>:<RXT_FIELD_VALUE>

updater:admin author:mark

note: I have manually created this asset to demonstrate

name:basic lcState:Testing version:1.0.0

lcState:Testing version:1.0.0 category:Engineering

version:1.0.0 category:Engineering name:"cd_store"

mediaType:policy

mediaType:policy name:sig

Thats it from here. If you have any questions please create a stackoverflow question and attached it as a comment below.