Altova MapForce 2022 Enterprise Edition

Adding XBRL Files as Mapping Components

Home Prev Top Next

Before you can map data to or from an XBRL document, the XBRL document must be added to the mapping area as a mapping component. There are two ways of adding XBRL documents as mapping components:


As a flat XML document

As a hierarchically structured XBRL document


The first option inserts the XBRL file as a flat XML file without any business logic concepts or specific XBRL hierarchical structure. Such a component is useful only for very simple mappings where no dimension handling or automatic XBRL context generation is required.


The second option inserts the XBRL taxonomy and displays its contents in a hierarchical fashion suitable for XBRL. In this scenario, MapForce resolves the Discoverable Taxonomy Set (DTS) references and builds automatically the derived XBRL structure. This means that the XBRL mapping component will include XBRL-specific items (which may be actual nodes in the XBRL file or "abstract" nodes derived from the DTS). For example, the following hierarchical structure is derived from the xlink:from and xlink:to presentation arcs in the presentation linkbase. (The term "linkbase" here has the meaning as found in the XLink specification (see Specifically, it represents a collection of links (or a link database). XLink linkbases are extended, among other uses, to XBRL, and provide additional information about concepts defined in a taxonomy.)


This example is only a basic illustration of how MapForce resolves the taxonomy in order to display data in a conceptual manner better suited for mapping operations than plain XML. In addition to the presentation linkbase, MapForce can also render structures derived from other linkbases, including the table linkbase (see Working with XBRL Tables).


For information about items that can appear on an XBRL component, including their conventional graphical representation, see About XBRL Component Items.

To open XBRL documents as flat XML:

On the Insert menu, click XML/Schema File.

Select the XBRL instance file, and then click Open. Note that the instance file must reference a schema; otherwise, MapForce will prompt you to generate it.

To open XBRL documents with automatic context handling:

1.On the Insert menu, click Insert XBRL Document.

2.Select the taxonomy file (*.xsd) or an XBRL instance file (*.xbrl or *.xml). If you select a taxonomy, a further dialog will prompt you to select a valid instance file.

3.Click Browse... if you intend to use this XBRL component as a source instance and select the XBRL instance file.


When you open an XBRL taxonomy, a dialog box opens prompting you to select the structure views to shown on the XBRL component. If you are not sure what structure view to select, leave the default option as is. By default, MapForce selects automatically one of the options by analyzing data from the loaded Discoverable Taxonomy Set. You can change the structure views later if necessary (see also Selecting Structure Views).

© 2016-2022 Altova GmbH