Altova StyleVision 2022 Enterprise Edition

Install a Taxonomy

Home Prev Top Next

To install a taxonomy:


1.Run XBRL Taxonomy Manager.

2.Select the check box next to the taxonomies or taxonomy versions you want to install, and click Apply.


Alternatively, if you have downloaded a file with the .altova_taxonomies extension from the Altova website, double-click the .altova_taxonomies file to run it. XBRL Taxonomy Manager opens when you run the .altova_taxonomies file.


Note the following:


Installing or uninstalling a taxonomy from XBRL Taxonomy Manager takes effect for all user accounts on the same computer.

Installing or uninstalling a taxonomy from XBRL Taxonomy Manager takes effect in all Altova XBRL-enabled applications installed on the same computer.

If the current taxonomy has dependencies on other taxonomies, the dependent taxonomies are also installed (or uninstalled, as applicable).


Command line interface

To install a taxonomy, run:


TaxonomyManager.exe install FILTER...


Where FILTER means one of the following:


1.A taxonomy identifier in the format <name>-<version>, for example: eba-2.10, us-gaap-2020.0. To view all the available taxonomy identifiers and versions, run the list command.

2.An .altova_taxonomies file downloaded from the Altova website.


Installing taxonomies on demand

Whenever StyleVision detects that certain XBRL taxonomies must be installed on your computer, you may be prompted to install taxonomies on demand.

If you choose to install the missing taxonomies, XBRL Taxonomy Manager performs the installation and updates its local cache directory to keep track of this information. You can always view all of the previously installed taxonomies by running the XBRL Taxonomy Manager from Tools | XBRL Taxonomy Manager.


If you select Ignore, StyleVision will resolve URIs from their public origin instead of local files, which will likely result in poor performance or even errors.


Applying patches

Occasionally, XBRL taxonomies may receive patches from their issuers. When the XBRL Taxonomy Manager detects that patches are available, the following happens:


If you use XBRL Taxonomy Manager through the Windows graphical user interface, the respective XBRL taxonomies are shown with the _ic_taxonomy_patch icon.

If you use the command line or a Linux/macOS system, any XBRL taxonomies that have patches are listed when you run the executable with the list -u command.

To apply a patch on Windows:

1.Click the Patch Selection button. The icon of each XBRL taxonomy that qualifies changes from _ic_taxonomy_patch to _ic_taxonomy_upgrade, and the dialog box informs you about the patches that are to be applied, for example:

Note:The Patch Selection button is enabled only when there are patches available for any of the currently installed XBRL taxonomies.


2.Click Apply.

To apply a patch at the command line interface:

1.Run the list -u command. This lists any taxonomies where patch upgrades are available.

2.Run the upgrade command to install the patches.


For more information, see the reference to the Command Line Interface.


© 2016-2022 Altova GmbH