Work with glossary

On this page

  1. Create category
  2. Create term
  3. Manage glossary
  4. Update stream configuration
  5. Results & next steps

Glossary can help you in documenting groups of golden records that meet specific criteria, simplifying the process of cleaning and streaming these groups of records.

In this article, you will learn how to work with the glossary in CluedIn. Glossary consists of terms that are grouped into categories. Each term contains a list of golden records that correspond to your conditions.

Working with the glossary in CluedIn includes creating categories and creating terms within those categories. You can have multiple terms under one category.

Before you start: Make sure you have completed all steps in the Ingest data guide and Stream data guide.

Create category

Category refers to a logical grouping of terms. For example, you can have a category named Customer, which would contain customer records organized by regions. Each region is a separate term within the category. In other words, a category acts as a folder for terms.

To create a category

  1. On the navigation pane, go to Management > Glossary.

  2. Depending on whether or not you have created categories before, do one of the following:

    • If you haven’t created any categories before, then in the middle of the page, select Create Category.

    • If you already created some categories, then, in the upper-left corner of the page, select Create > Create Category.

  3. Enter the category name. Then, in the lower-right corner, select Create.

    create-category-1.png

    You created the category. Now, you can create a term in the category.

Create term

Term refers to the list of golden records that meet specific conditions. For example, within the Customer category, you can have a term named North America encompassing customer records where the BusinessRegion vocabulary key is set to North America.

To create a term

  1. Select Create Term.

  2. On the Create Term pane, do the following:

    1. Enter the term name.

    2. In the Category section, leave the Choose an existing Category checkbox selected.

    3. Select the category that you created before.

    4. In the Filters section, define which golden records should be included in the term.

      create-term-1.png

    5. In the lower-right corner, select Create.

      You created the term.

  3. (Optional) Specify additional details about the term:

    1. Select Edit.

    2. In the Certification Level dropdown list, select the quality level of the records.

    3. Enter the Short Description and Long Description of the term.

      create-term-3.png

  4. In the upper-right corner of the term details page, select Save.

  5. Go to the Matches tab to view the records that meet the condition that you set up.

    By default, all records are displayed in the following columns: Name, Business Domain, and Description. To add more columns to the table, see step 3 of Find data.

  6. Activate the term by turning on the toggle next to the term status.

    create-term-4.png

    You created the term and defined the records that are included in this term.

Now, you can clean the glossary term and stream it to a Microsoft SQL Server database. As an example, update the configuration of the stream that you created in the Stream data guide.

Manage glossary

You can do the following actions with the terms in the glossary:

  • Endorse the term when you are confident that the records are of good quality, signaling to other users that the term is reliable for their use. To do that, in the upper-right corner of the term page, select Endorse.

    manage-glossary-1.png

  • Rate the term, enabling other users to view that it is reliable for their use.

    manage-glossary-2.png

Update stream configuration

Streaming the glossary terms to the database is more convenient than streaming specific records based on filters. You only need to specify the name of the glossary term, rather than setting filters for properties or vocabulary values.

To update the stream

  1. On the navigation pane, go to Consume > Streams.

  2. Open the needed stream.

  3. On the Configuration pane, in the Filters section, delete the existing filter.

  4. Select Add First Filter, and then specify the glossary term that you created:

    1. In the Select Property Type dropdown list, select Glossary.

    2. In the All Glossary dropdown list, select the glossary term that you created.

    3. In the Choose Operation dropdown list, select Is True.

      update-stream-configuration-1.png

  5. In the upper-right corner select Save. Then, confirm that you want to save your changes.

    The stream is updated with the new filter. As a result, the database table now contains the records from the glossary term.

    If you update the glossary term, the records will be automatically updated in the database.

Results & next steps

After completing all steps outlined in this guide, you learned how to create a glossary term to document a group of golden records and how to send those golden records from the glossary term to a Microsoft SQL Server database. If you make any changes to the glossary term in CluedIn, the associated records will be automatically updated in the database.

Next, learn how to add edges to build relations between golden records in the Add relations between records.