Licensing and Enablement

The availability of any asset collection is determined by what is (a) licensed and (b) configured under Server Administration. To install a license or to view the currently licensed features, see Setup > Product Registration. To configure which licensed collection types are currently enabled or disabled, see Setup - EDG Configuration Parameters.

For general licensing information and available asset collections and packages, see the TopQuadrant website.

Overview of Crosswalks

Crosswalks let you create connections between the assets in two different collections. This is especially useful for defining connections between two different standard vocabularies or between a standard one and a specialized local one. Applications can use saved crosswalk connection data to enhance the use of either vocabulary by taking advantage of the connected data and metadata for search, classification, and other operations.

When creating a new Crosswalk, you will be asked to identify From and To collection. 

For each of the two collections connected by a crosswalk (From and To), user will be asked to select the class (asset type) of assets to be mapped from the Entity Type drop-down list.

By default, mappings will use crosswalk:closeMatch predicate. However, a different mapping predicate can be selected on the Manage tab.

Mappings between two asset collections can be auto-generated. This functionality is available in the Crosswalk Editor by clicking on the Generate Mappings button. Mapping functionality is part of the Problems and Suggestions algorithms. Thus, mappings will be generated by running Problems and Suggests on the Reports tab or in the editor panel.

Crosswalk specific options on the Manage tab, let you plug in custom auto-mapping algorithms and set an option to automatically accept 100% matches.

Please see the Asset Collection Guide for all the general features of asset collections such as import/export, editing, user permissions, reports and settings. Specific crosswalk only information is contained within this page. 

Crosswalks Home

Selecting the Crosswalks link in the left-navigation pane of TopBraid EDG lists all of the Crosswalk collections currently available to the user and, it allows authorized users to create new ones.

Create New Crosswalk

The Crosswalks > Create New Crosswalk link opens a form with fields used to define the new Crosswalk. Note that you can also create a Crosswalk by using a Create link in the Governance Areas page or the plus button available in the application header bar.

The Create dialog box asks for the Crosswalk’s Label (name) and, optionally, a Description.

This creates a new Crosswalk with yourself as the manager.

For each of the new crosswalk’s two collections (vocabulary or asset), select the class of mapped terms from the Entity Type drop-down list. For example, a taxonomy typically will choose Concept because the terms in a taxonomy are each stored with an instance of Concept. For code lists, the class name often reflects the code list’s contents more directly, such as a “Market Identifier Code” class in a “Market Identifier Codes” code list.

References to Crosswalks

You will find references to crosswalks in the editor under the Available Crosswalks Panel. From here,  you can create a new crosswalk, or see crosswalks your collection is in and navigate to them.

From your collection, click the  dropdown located  on the right upper corner of the page and drag Available Crosswalks somewhere in the page.

The Crosswalk Editor

The crosswalk panel has two main columns, one for each asset collection in the mapping. If the asset-type on the left side has a primary key, then it will also have a column.

Like the Search Panel in other collections, users can filter-down the displayed assets by using (a) the Free Text search, property-specific constraints added from the Filters drop-down, or the filters available in each column.

For each left-side asset, there are zero or more mapped right-side assets. The mapping can be many-to-many, so viewers can swap the left/right collections via the Toggle direction button  found in the page header.

To manually add a new mapping from a right-side asset to a left-side one, use the mappings panel as seen below.

First highlight the row you wish to add a mapping in the table panel. This will cause the mapping panel to refresh for that particular row. You can then enter the matches along with comments for that row. Select each match from the dropdown and click the add match button. You will see all of the mappings entered below the add match button. If needed, you can delete a mapping from there.

To automatically generate potential matches, click the Generate Mappings button. This runs the crosswalks’ Problems ans Suggestion panel, which lists suggested asset mappings between the two collections.

Crosswalk Operations

Export page – Export Crosswalk as a Spreadsheet

In addition to the standard exporters, Crosswalks have an additional export option. This option creates a comma-separated spreadsheet containing one row for each mapping in this Crosswalk.

Reports page – Crosswalk mapping suggestions

For crosswalk collections, the report also lists potential mappings between assets in the two collections. Suggestions may have percentage-of-confidence estimates, by which users can filter them. Each suggestion also has an Apply link that will create the indicated mapping in the crosswalk as highlighted in the Generate Mappings image above.


Reporting Crosswalk Errors

Deletions or modifications to asset collections involved in a crosswalk can cause crosswalk relationship errors. Built-in EDG crosswalk constraints identify such occurrences for reporting and maintenance purposes. To use this feature, see the Reports > Problems and Suggestions report or the Problems and Suggestions Panel. The Problems and Suggestions report or panel also auto suggests new mappings.

Creating a Crosswalk with EDG Tagger 

If you have TopBraid EDG’s optional Tagger module, you may find it easier to create crosswalks between hierarchical asset collections (for example, two taxonomies) using Tagger instead of the Crosswalk module.

To do this, configure a new tag set setting one of the hierarchical asset collections as the Concept asset collection as you normally would and then set the other as the Content Graph. Here, after someone has set the IPTC taxonomy to be the Concept asset collection and the Geography one to be the Content Graph, they have tagged “Africa” in the Geography Vocabulary with “Africa” from the IPTC one:

See the Tagger User Guide for further details on configuring Content and Tag Property graphs and Concept asset collection into a tag set.