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), 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.

  click to enlarge

EDG Home

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

  1. Global Lookup: This searches across all EDG resources by label prefix (see below).
  2. Search the EDG: This is an administratively-configured search that supports detailed 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.

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 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.

 

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).

 

Search the EDG

This searches across all EDG resources that an administrator has configured for inclusion in the EDG Administration: Search the EDG Configuration, or that a user, with at least Editor privileges, has included in the Manage tab of the asset collection.

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,
  • use "More" link to open a found resource in its editor application to see even more information about it and any other item in the same collection and, if authorized, make changes to it.

Note that what information is presented in the search summary and detail views is also administratively configured, including the available facets and the listed properties along with their presentation styles. By default, until they 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.

Some facets can be configured to serve as "suggestions" for semantic searches. This feature lets users find resources that are related to the resources that match their search keywords. For example, you may want to find out what country Abu Dhabi is the capital of. You can type " Abu Dhabi" and instead of searching for something that matches your search string, select from one of "suggested queries" to find resources that refer to (point to) Abu Dhabi using any of the relationships that were selected for suggestions. For example, suggested queries may be "what country is Abu Dhabi the capital of" (Saudi Arabia) or "what language is spoken in Abu Dhabi". You will only see suggestions that are applicable to the type of the items that match your search string.

If you want to know what type of resources, search fields and facets have been configured in your environment, click on the the help icon next to the Search the EDG filed on the home page. You will see a page listing the resources configured for the search scope (i.e., graphs, classes, properties, and facets).

 

 

In the configuration above, search key words will be matched against the content in the comment, label, altLabel and prefLabel properties. The scope of the configured search is only one asset collection - Geography Vocabulary and only resources of the selected type (belonging to classes above) will be included in the search. There will be a single facet - using "broader" relationship. There may also be a default "type" facet depending on whether administrator included it or not.

  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.

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".

  • 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}.

Information about Lucene integration and search configuration is available in EDG Administration: Search the EDG. EDG adminstrators 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.

Without wildcard Lucene will attempt exact matching. This is in contrast to the SPARQL based search which does partial matching by default. 

User's Work Items

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

Metrics Dashboard

This presents a high-level, user-oriented view of the status of the user's subject areas, collections, and workflows. The available subviews and their content is customizable, providing the capability of showing data quality indicators, workflow status, and metrics pertaining to collections and data governance. To customize please see Governance Model Overview > Metrics Dashboards.

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 shown using a table and include the following information about each workflow:

  • 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