Community docs

Business terms

The business glossary component of the metadata catalog on data.world brings your business terms into the heart of working with your data. And as different business units can have their own glossary terms, each organization you have also has the potential to have it's own Business Glossary.

The terms in the glossary are not only listed in the glossary for easy access by everyone in your organization, but they are also linked into the data itself and the projects using the data in a dynamic and fluid way. With the seamless integration you not only can access your glossary terms where you need them, but you can also easily keep them current and associate them with new data and projects as required.

There are two different ways to get your existing business terms into a glossary in your data.world catalog. If you already have an existing list of terms defined, we can upload them for you. If you don't have defined glossary terms yet, we can help you define them and then upload them for you. Once your business glossary has been created, you can manage it--editing, adding, and deleting terms--yourself from within data.world.

Your Business Glossary (or glossaries if you are in more than one organization) can be accessed either from the sidebar under Glossary:

Business_Glossary_from_sidebar.png

Or from your organization's home page from the business terms tile:

Org_home_page.png

When you open the glossary, you'll see that it has not only a list of terms, but also a variety of other metadata information custom-configured for your catalog:

Glossary_list.png

In this example, in the upper left of the screen are the collections that reference various terms (and how many they reference). Below collections are the types of terms, and the tags used for them. Each organization's glossary contains different, configurable metadata elements, the ones shown are just for example.

Although you can delete glossary terms it is often a better idea to differentiate between current, or approved terms and deprecated ones. The green icon to the right of the terms shown above is an example of a glossary that flags terms as approved. When a term is no longer used it can be marked as deprecated to show that it is no longer in use anymore.

Overview

When you select a business term from the list you are taken to the Overview tab on the listing for the term. The metadata collected for a business glossary term is as extensive as that of any other resource on data.world, and its overview page looks very much like the overview page for a dataset or project:

Glossary_Overview_top.png

As with the main organization Business Glossary list page, the metadata collected and displayed on the overview page is completely configurable with our metadata cataloger. In this example, on the top left are the icon for Business Glossary term, the name of the term, its status, and the identification of the type of resource it. The top portion of the main area contains the Description, the Summary, and the More Information sections. Scrolling down you'll find the relationship information for the term including what dashboards, tables, and columns reference it:

Gloassary_Overview_middle.png

The bottom section of the main window contains the Technical Details about the terms--the Knowledge Graph of its relationships which provide a visual representation of the relationships:

Glossary_Overview_bottom.png

Finally, on the top right is the About information containing (in our example):

  • The collection(s) the term is in

  • When it was created and last updated

  • The people in the organization who are responsible for it and links to their user profiles

  • Verification information

  • Tags

Glossary_Overview_About.png
Discussion

The discussion tab of a glossary term is where the information about the term, its status, usage, etc., can be presented and questioned. It provides a place to document and discuss the resource while keeping the discussion separate from the resource's other, permanent components. Discussion topics are grouped on the left and you can either replay to an existing one or create a new one:

Glossary_discussion.png
Settings

The final tab on a business glossary term page is the Settings tab. The Settings tab holds the permissions to the business term. From here it can be transferred to another organization or deleted:

Glossary_settings.png