.. include:: /includes.rst.txt

.. comments - headings

   # with overline, for parts
   * with overline, for chapters
   = for sections
   - for subsections
   ^ for subsubsections
   " for paragraphs


.. _working_with_crosswalks_target:


Working with Crosswalks
-----------------------

.. include:: ../licensing_and_enablement.rst

.. index:: pair: Crosswalks; Overview

Overview of Crosswalks
^^^^^^^^^^^^^^^^^^^^^^^^

The **Crosswalks** assetc collecion type 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 the *From* and *To* collection.

For each of the two collections connected by a crosswalk (From and To), you will be asked to select the class of assets to be mapped.
By default, mappings will use the *crosswalk:closeMatch* predicate.
A different mapping predicate can be specified on the **Manage** tab.

.. figure:: _images/edg_crosswalk.png
  :alt: TopBraid EDG Display Relationship Tree Example
  :align: center
  :class: edg-figure

  **TopBraid EDG Display Relationship Tree Example**


Mappings between two asset collections can be auto-generated by using the **Generate Mappings** button available in the Crosswalk Editor.
The automated mapping functionality is part of the **Problems and Suggestions** algorithms.
The **Manage** tab lets you set an option to automatically accept mappings that have 100% confidence.

TopBraid EDG uses fuzzy matching on asset labels to generate crosswalk mappings.
Alternative mapping algorithms can be added to TopBraid EDG.
Adding a new algorithm requires access to TopBraid EDG Java code and is currently supported only through TopQuadrant Professional Services.
If alternative auto-mapping algorithms are available in your installation of TopBraid EDG, users will be able to select them on the **Manage** tab.

.. seealso::

 * Specific crosswalk only information is contained within this page.

 * Please see the :ref:`asset_collections` for all the general features of asset collections such as import/export, editing, user permissions, reports and settings.

.. include:: ./crosswalks_home.rst
.. include:: ./create_new_crosswalk.rst
.. include:: ./the_crosswalk_editor.rst
.. include:: ./crosswalk_operations.rst
.. include:: ./including_crosswalks_into_participating_asset_collections.rst
.. include:: ./reporting_crosswalk_errors.rst
.. include:: ./creating_connections_using_edg_tagger.rst