Skip to end of metadata
Go to start of metadata

Page Contents


Enterprise Data Governance (EDG)

The Enterprise Data Governance (EDG) application lets organizations tailor their governance solutions to suit their enterprise technology environments and management concerns. Leveraging standards-based semantic technologies, EDG enables users to manage many kinds of business and technical assets with the flexibility to customize, extend, or integrate the solutions as needed. EDG has different governance packages that together wide range of business and technical assets.

The EDG User Guide

The following pages cover the concepts and functions that users access via the web-based interface.

Users create and manage various Asset Collections , each of which has separate views for utilities (operations) and viewing/editing. The availability of each collection type depends on EDG licensing; see TopBraid products and data governance packages for details. EDG also supports user-teams' development and maintenance work through role-based workflows and features. Additionally, TopBraid Explorer and TopBraid Tagger and AutoClassifier are optional add-on modules.

The EDG User Interface (UI)

Many EDG views are oriented toward a particular type of asset collection (aka, vocabulary type), such as taxonomy, ontology, etc. Every view has a header that provides breadcrumb navigation, global lookup, and special application links. Often there is also a collapsible left-navigation menu that provides direct links to all of the asset collection types and to other top-level functions and views. The entire left-navigation menu can be toggled down to icons via the left-arrow at the top, and the main menu sections can be expanded/collapsed by selecting the +/- in the top right hand corner of the section.

EDG Home

The main home view shows top-level EDG searches and user-specific listings.

click image to enlarge

  1. Global Lookup: This searches across all EDG resources by label prefix (see below).
  2. Search the EDG: Application wide faceted searching across selected EDG resources (see below).
  3. Recently Viewed Collections : This widget is a personal view of the last 5 collections viewed by the user.
  4. My Tasks: This widget is a personal view of open tasks assigned to the user.
  5. My Governance Roles: This widget shows which Subject Areas a user is a member of and their Governance Role within that Subject Area.

Left Navigation Menu

The left navigation menu consists of three main sections: Dashboard, Asset Collections, and Governance Model.

  1. DASHBOARD: This section allows for access to Server Administration (if the user has Administrator privileges), it also provides two overviews of the current user's work items: dashboards and workflows. It also provides three search tools: for particular asset collections, reference codes, and tasks. See below for details.
  2. ASSET COLLECTIONS: These graphs contain the details of—and relationships among—various business and technical assets in the enterprise. The availability of each collection type depends on EDG licensing (see TopBraid products and data governance packages for details). For details of each collection type, see its documentation pages in either the page-tree (left) or the list above.
  3. GOVERNANCE MODEL: This holds the overall stucture of the organization, roles, and users for managing Governance. See Governance Model Overview for more information. The version number is also stored below this section

Additional UI Controls

 

1. "Hamburger menu" Home: The header's three-bar "hamburger" Home icon drops down a quick-navigation menu for direct access to any asset collection.

2. Toggle left-nav labels: The left/right arrow atop the left-navigation menu toggles the text labels off/on, trading them for screen real estate.

3. Special links: The right-header has links to the user's page, and help documentation.

EDG Top-Level Searches

Global Lookup

In the page header of non-editor screens, a Global Lookup text box searches for classes, properties, or instances across all asset collections in EDG. Any such resource whose label is prefixed by the search text will appear in a popup list. Label and Preferred label with a language tag in the current browser's language or with no language tag will be found. Selecting a listed resource opens its corresponding editor in a new browser tab, with the resource pre-selected.

Left-Nav Searches

There are three top-level search functions in the left-navigation menu's DASHBOARD section.

Find Asset Collection

To search the EDG application for a particular asset collection based on its metadata, use EDG Home > Find Asset Collection. This feature becomes more useful as the number of managed asset collections grows.

 click image to enlarge

The left Filter pane of the search form lets you specify search criteria, with the Search Results showing in the right pane. EDG top-level asset collection form-searches work similarly to form searches in editors, but properties are not shown as columns in the results. Click the Reset button at the bottom of the search form to remove all search criteria entered on the form. Enter a value in the Search any Text property at the top to indicate that you want to search all the metadata properties for that particular text. This includes a checkbox to control whether the search is case-sensitive. Clicking the white triangle on the right of any property gives you greater control over how the value entered there is used in the search. The following options may appear on this menu, depending on the nature of the data stored in the property:

  • text contains Search for asset collections that have the entered string anywhere in the value for this property. It will match full or partial words containing the search string. This is the default behavior of each field on the search form.

  • text equals Search for asset collections that have this exact string in this property.

  • text matches regular expression Search using the regular expression entered here. Users will need to be familiar with the regular expression syntax. For example, while setting this field to "text contains" and entering "Virginia" would start a search that finds both "Virginia" and "West Virginia", a regular expression search for "^Virginia" would search only for values that begin with "Virginia", because ^ is used in regular expression syntax to indicate the beginning of an expression.

  • nested form When the field is a relationship, open up a nested form to describe the search criteria using the properties of the related entity.

  • any value Search for asset collections that have any value at all in this property.

  • min/max number of values Search for any asset collection whose number of values for this property fall in the range specified by the two numbers you enter. For example, entering the values 2 and 4 for the  subject area  property would search for asset collections that had more than 1 but less than 5 subject areas assigned to them.

  • no value Search for any asset collection that has no value set for this property.

The gear menu  below the search form gives you several options for what you can do with search results:

  • Export results to SPARQL CSV spreadsheet creates a comma-separated value version of the search results that includes the URI of the resource represented by each result row in the first column. See the W3C SPARQL 1.1 Query Results CSV and TSV Formats standard for more details (although there aren't many more details—it's a very simple format).

  • Export results to SPARQL JSON file creates a text page of results in SPARQL Query Results JSON format.

  • Export results to SPARQL TSV spreadsheet creates a tab-separated value version of the search results that includes the URI of the resource represented by each result row in the first column. URIs are delimited by angle brackets.

  • Export results to SPARQL XML file creates an XML version of the search results that conform to the W3C SPARQL Query Results XML Format.

  • Export results to simple TSV spreadsheet creates a tab-separated value version of the search results, showing the preferred label of each resource instead of URIs. This creates a more human-readable version of the data than the SPARQL TSV spreadsheet.

  • Show SPARQL query... displays a pop-up window with the query that is being generated on the server when the search form is executed. Advanced users with knowledge of the SPARQL query language can copy and paste the resulting query string into a SPARQL execution window (for example, using TopBraid Composer) or send the query to the EDG SPARQL Endpoint.

Exported search results will be displayed in your browser. Select Save As from your browser's File menu to save the results as a text file.

Spreadsheet programs such as Excel can easily read tab-separated value files, so saving search results in a tab-separated format is a simple way to create custom reports for people with no  access to this system.

Find Code (for Reference Datasets)

To search for a code across all reference datasets, the EDG Home > Find Code search provides a simple concept identifier lookup. In the Search for Code pane, enter the code of the desired concept and click Search. EDG searches across all managed datasets and shows the found concepts in the Search Results pane. Clicking on a result shows the concept's properties in the right pane, whose title changes from Selected Item to the label and (concept type).

 

Find Tasks

This lists the tasks defined for all asset collections in EDG.

Tasks do not appear until enabled by an administrator (see EDG Administration: EDG Configuration Parameters).

Filter the list by status and/or assignee. See also the (Utilities) > Task View documentation for any collection type.

  click image to enlarge

Search the EDG

This searches across all EDG resources that an administrator or manager has selected for inclusion in the index. This can be done from the Manage tab of the collection or upon creation of the collection. Governance area collections can also be included in search by selecting the checkbox in the Governance Areas page.

Submitting a search from the home page opens a page for the search results summary. Your search key words will be matched against text in any of the fields that have been configured for searching. You may have fields that contain text tagged with different languages, note that search will be performed across all values, irrespective of the language. In the search results page, you can:

  • refine or completely change the search terms and re-execute the search,
  • filter results via facets,
  • click on any of the result results to see more information about it,
  • make comments about any of the found resources and see comments made by other users,
  • access interactive visual views and diagrams for a found resource - what is available depends on a type of the item,
  • click on the title of the result to open the resource.


Note that what information is presented in the search summary and detail views, along with the properties and facets, is no longer configurable via an administrative UI in EDG version 6.0. By default, the results are configured to include more information, the summary and detail views will only contain labels of the found items and what asset collection they belong to. In order to customize this screens, please see the developer guide to create your own extension or contact a TopQuadrant representative for a custom extension. All properties of the collection will be indexed for search as well as applicable facets.

The results of search are sorted by score, then alphabetically. The score is calculated based on the number of matches to the term within the document. Lucene also offers query boosting per field.

For example searching:

*id^3 -will find anything that ends in "id" and assign it a weight of 3, boosting those results

Lucene integration and query language

Search the EDG uses Apache Lucene for indexing text. The index is (re)built on system startup and then in intervals set by a configuration setting. To rebuild the cache on demand, use the Cached Graphs administration page. In addition to simply using search keywords, users can combine them with Lucene operators to form richer search queries. By default wildcard search has been implemented before and after the search term. For example, searching for customer actually searches *customer*.

Example Lucene Operators

  • Wildcards (* ?): "?" performs a single character wildcard search and "*" performs a multiple character wildcard search. For example, te?t matches "test", "text", etc and Ken* matches all values that start with "Ken". *product* -will find anything with the word "product" in it. name -will find anything that ends in "name"

  • Fuzzy (~): Matches similar spellings of the word. For example john~, will match "john" and "jean". The similarity threshold is set to 0.5 by default. You can adjust it using any number between 0 and 1. For example, john~0.8.
  • Prohibit (-term or NOT term): excludes matches that contain the term after the "-" or "NOT" symbols. For example, Ken* -Kentucky matches all values that start with "Ken" but excludes anything that matches 'Kentucky'.
  • Modifiers (AND OR): using the AND operator will match items that contain both terms while the OR operator matches an item that contains either of the terms.
  • Range queries: using TO operator will match items with the range of values. For example, "Finland TO Germany" in curly brackets. If you want to limit this to a particular field (for example) only a label, use <property name>:{<search query>}. For example, skos_prefLabel:{Finland TO Germany}.

EDG administrators can disable the indexing via the Disable Lucene Indexing parameter. Disabling the index reverts to using SPARQL queries and will cause poor performance for large or numerous collections. The full range of Lucene syntax is only available when the index is active, otherwise only partial value matching is supported. Note, this will also disable the text index search used for tabular editors.

User's Work Items

The Home page shows user-specific listings for workflows with pending actions, open tasks, and recently viewed collections.

Basket

Each user can maintain a basket, which is a personal list of favorite ("bookmarked") asset collections or asset items. To add (or remove) a collection, select it and then select (or deselect) its star icon in the collection's header, for example:

To add an asset item, select it in the collection's editor and then select the "..." button (More Actions) > Add to Basket.

Selecting the left-nav DASHBOARD > Basket action shows the saved elements, allowing the user to either select or delete them.

My Workflows

This lists the workflows for which the current user has potential status-transition actions pending. (For an overview of workflows, see Governance Model > Workflows.) The workflows are listed in a table showing the following information for each:

  • Workflow: displays the type and name of the workflow.
  • Asset: displays the asset over which the workflow was started.
  • Asset Collection: name of the asset the workflow belongs to.
  • State: current state of the workflow.
  • Creator: shows who created this workflow.
  • Started: displays the date this workflow was created.
  • Priority: shows the priority assigned to the workflow, if defined.
  • Next Actions: denotes what actions can be taken on this workflow.

The following operations can be performed, some require a that a workflow is selected (users can select a workflow from the list by clicking on it):

  • Go to Workflow: navigates to the overview page of the selected workflow.
  • Go to Asset: navigates to the asset page the workflow is associated with.

  • No labels