The valxbrltaxonomy | dts command validates one or more XBRL taxonomies (schemas) according to the XBRL 2.1, Dimensions 1.0 and Formula 1.0 specifications.
raptorxmlxbrl valxbrltaxonomy | dts [options] InputFile |
•The InputFile argument is the XBRL taxonomy to validate.
•To validate multiple documents, either: (i) list the files to be validated on the CLI, with each file separated from the next by a space; or (ii) list the files to be validated in a text file (.txt file), with one filename per line, and supply this text file as the InputFile argument together with the --listfile option set to true (see the Options list below).
Examples
Examples of the valxbrltaxonomy command:
•raptorxmlxbrl valxbrltaxonomy c:\Test.xsd
•raptorxmlxbrl dts --listfile c:\FileList.txt
RaptorXMLXBRL (and RaptorXMLXBRLServer for administration commands) on Windows raptorxmlxbrl (and raptorxmlxbrlserver for administration commands) on Windows and Unix (Linux, Mac) * Note that lowercase (raptorxmlxbrl and raptorxmlxbrlserver) works on all platforms (Windows, Linux, and Mac), while upper-lower (RaptorXMLXBRL) works only on Windows and Mac. * Use forward slashes on Linux and Mac, backslashes on Windows. |
On Windows systems: When spaces or special characters occur in strings (for example in file or folder names, or company, person or product names), use quotes: for example, "My File". Note, however, that a backslash followed by a double-quotation mark (for example, "C:\My directory\") might not be read correctly. This is because the backslash character is also used to indicate the start of an escape sequence, and the escape sequence \" stands for the double-quotation mark character. If you want to escape this sequence of characters, use a preceding backslash, like this: \\". To summarize: If you need to write a file path that contains spaces or an end backslash, write it like this: "C:\My Directory\\". |
Options
Options are listed in short form (if available) and long form. You can use one or two dashes for both short and long forms. An option may or may not take a value. If it takes a value, it is written like this: --option=value. Values can be specified without quotes except in two cases: (i) when the value string contains spaces, or (ii) when explicitly stated in the description of the option that quotes are required. If an option takes a Boolean value and no value is specified, then the option's default value is TRUE. Use the --h, --help option to display information about the command.
--ct-restrict-mode = 1.0|1.1|default Specifies how to check complex type restrictions. A value of 1.0 checks complex type restrictions as defined in the XSD 1.0 specification—even in XSD 1.1 validation mode. A value of 1.1 checks complex type restrictions as defined in the XSD 1.1 specification—even in XSD 1.0 validation mode. A value of default checks complex type restrictions as defined in the XSD specification of the current validation mode (1.0 or 1.1). The default value is default. |
--assertion-severity = true|false Enables the Assertion Severity 1.0 and 2.0 extensions. Default is true. Note: Boolean option values are set to true if the option is specified without a value. |
--dimensions = true|false Enables XBRL Dimension 1.0 extensions. Default is true. Note: Boolean option values are set to true if the option is specified without a value. |
--evaluate-referenced-parameters-only = true|false If false, forces evaluation of all parameters even if they are not referenced by any formulas/assertions/tables. Default is: true. |
--inconsistencies-limit = N | unlimited Specifies the XBRL inconsistencies limit, with values being in the range 1-65535 or unlimited. Processing continues if the limit is reached, but further inconsistencies are not reported. The default value is 100. |
--formula = true|false Enables the XBRL Formula 1.0 extension. Default is true. Note: Boolean option values are set to true if the option is specified without a value. |
--formula-parameters = JSON-ARRAY Specifies parameters for XBRL formula evaluation as array of JSON maps directly on the CLI. See the section Formula Parameters for details. |
--formula-parameters-file = FILE Specifies a FILE containing the parameters for XBRL formula evaluation. The file can be either an XML file or JSON file. See the section, Formula Parameters. |
--generic-links = true|false Enables the XBRL Generic Links 1.0 extension. Default value is true. Note: Boolean option values are set to true if the option is specified without a value. |
--generic-preferred-label = true|false Enables the XBRL Generic Preferred Label 1.0 extension. Default value is true. Note: Boolean option values are set to true if the option is specified without a value. |
--inconsistencies-limit = N | unlimited Specifies the XBRL inconsistencies limit, with values being in the range 1-65535 or unlimited. Processing continues if the limit is reached, but further inconsistencies are not reported. The default value is 100. |
--listfile = true|false If true, treats the command's InputFile argument as a text file containing one filename per line. Default value is false. (An alternative is to list the files on the CLI with a space as separator. Note, however, that CLIs have a maximum-character limitation.) Note that the --listfile option applies only to arguments, and not to options. Note: Boolean option values are set to true if the option is specified without a value. |
--preload-formula-schemas = true|false Preloads schemas of the XBRL Formula 1.0 specification. Default is false. Note: Boolean option values are set to true if the option is specified without a value. |
--preload-xbrl-schemas = true|false Preloads schemas of the XBRL 2.1 specification. Default is true. Note: Boolean option values are set to true if the option is specified without a value. |
--recurse = true|false Used to select files within sub-directories, including in ZIP archives. If true, the command's InputFile argument will select the specified file also in subdirectories. For example: "test.zip|zip\test.xml" will select files named test.xml at all folder levels of the zip folder. References to ZIP files must be given in quotes. The wildcard characters * and ? may be used. So, *.xml will select all .xml files in the (zip) folder. The option's default value is false. Note: Boolean option values are set to true if the option is specified without a value. |
--report-import-namespace-mismatch-as-warning = true|false Downgrades namespace or target-namespace mismatch errors when importing schemas with xs:import from errors to warnings. The default value is false. Note: Boolean option values are set to true if the option is specified without a value. |
--schema-imports = load-by-schemalocation | load-preferring-schemalocation | load-by-namespace | load-combining-both | license-namespace-only Specifies the behaviour of xs:import elements, each of which has an optional namespace attribute and an optional schemaLocation attribute: <import namespace="someNS" schemaLocation="someURL">. The option specifies whether to load a schema document or just license a namespace, and, if a schema document is to be loaded, which information should be used to find it. Default: load-preferring-schemalocation. The behavior is as follows: •load-by-schemalocation: The value of the schemaLocation attribute is used to locate the schema, taking account of catalog mappings. If the namespace attribute is present, the namespace is imported (licensed). •load-preferring-schemalocation: If the schemaLocation attribute is present, it is used, taking account of catalog mappings. If no schemaLocation attribute is present, then the value of the namespace attribute is used via a catalog mapping. This is the default value. •load-by-namespace: The value of the namespace attribute is used to locate the schema via a catalog mapping. •load-combining-both: If either the namespace or schemaLocation attribute has a catalog mapping, then the mapping is used. If both have catalog mappings, then the value of the --schema-mapping option (XBRL option and XML/XSD option) decides which mapping is used. If no catalog mapping is present, the schemaLocation attribute is used. •license-namespace-only: The namespace is imported. No schema document is imported. |
--schema-mapping = prefer-schemalocation | prefer-namespace If schema location and namespace are both used to find a schema document, specifies which of them should be preferred during catalog lookup. (If either the --schemalocation-hints or the --schema-imports option has a value of load-combining-both, and if the namespace and URL parts involved both have catalog mappings, then the value of this option specifies which of the two mappings to use (namespace mapping or URL mapping; the prefer-schemalocation value refers to the URL mapping).) Default is prefer-schemalocation. |
--schemalocation-hints = load-by-schemalocation | load-by-namespace | load-combining-both | ignore Specifies the behavior of the xsi:schemaLocation and xsi:noNamespaceSchemaLocation attributes: Whether to load a schema document, and, if yes, which information should be used to find it. Default: load-by-schemalocation. •The load-by-schemalocation value uses the URL of the schema location in the xsi:schemaLocation and xsi:noNamespaceSchemaLocation attributes in XML or XBRL instance documents. This is the default value. •The load-by-namespace value takes the namespace part of xsi:schemaLocation and an empty string in the case of xsi:noNamespaceSchemaLocation and locates the schema via a catalog mapping. •If load-combining-both is used and if either the namespace part or the URL part has a catalog mapping, then the catalog mapping is used. If both have catalog mappings, then the value of the --schema-mapping option (XBRL option and XML/XSD option) decides which mapping is used. If neither the namespace nor URL has a catalog mapping, the URL is used. •If the option's value is ignore, then the xsi:schemaLocation and xsi:noNamespaceSchemaLocation attributes are both ignored. |
--script = FILE Executes the Python script in the submitted file after validation has been completed. Add the option multiple times to specify more than one script. |
--api, --script-api-version = 1; 2; 2.1 to 2.4; 2.4.1; 2.5 to 2.8; 2.8.1 to 2.8.6 Specifies the Python API version to be used for the script. The default value is the latest version, currently 2.8.6. Instead of integer values such as 1 and 2, you can also use the corresponding values 1.0 and 2.0. Similarly, you can use the three-digit 2.5.0 for the two-digit 2.5. Also see the topic Python API Versions. |
--script-output = FILE Writes the script's standard output to the file named in FILE. |
--script-param = KEY:VALUE Additional user-specified parameters that can be accessed during the execution of Python scripts. Add the option multiple times to specify more than one script parameter. |
--single-dts = true|false If set to true, all submitted files (the XBRL taxonomy schemas and linkbases) will be treated as a single XBRL discoverable taxonomy set. The default is false. Note: Boolean option values are set to true if the option is specified without a value. |
--taxonomy-package = FILE Specifies the absolute path to an additional taxonomy package as described in the Taxonomy Package 1.0 and Taxonomy Packages 1.0 working drafts. The value of FILE gives the location of the taxonomy package. Add the option multiple times to specify more than one taxonomy package. |
--taxonomy-packages-config-file = FILE Specifies the path to the TaxonomyPackagesConfig.json file, which is used to load XBRL taxonomy packages. The file's convenience is that it serves as a catalog of taxonomy packages. The structure of the JSON file is as in the example listing below. The value of the uri key gives the location of the package. The active key (of a set of packages) switches on usage of those packages. {"taxonomies": {"EIOPA Solvency II XBRL Taxonomy 2.1.0": {"packages":[ {"uri":"C:\\test\\XBRL\\EIOPA_SolvencyII_XBRL_Taxonomy_2.1.0.zip"}, {"uri":"C:\\test\\XBRL\\AdditionalTestPkg.zip"} ],"active":true },"Test Taxonomy": {"packages":[{"uri":"C:\\test\\XBRL\\test.zip"}],"active":true } } } |
--treat-custom-role-errors-as-warnings = true|false Reports non-critical XBRL errors related to custom role/arcrole types (for example, missing roleRefs) as warnings. Default value is false. Note: Boolean option values are set to true if the option is specified without a value. |
--treat-inconsistencies-as-errors = true|false Causes XBRL validation to fail if the file contains any inconsistency as defined by the XBRL 2.1 specification. Default value is false. Note: Boolean option values are set to true if the option is specified without a value. |
--treat-invalid-use-of-standard-role-as-warning = true|false Specifies whether the invalid use of standard roles should be reported only as a warning. Default value is false. Note: Boolean option values are set to true if the option is specified without a value. |
--xinclude = true|false Enables XML Inclusions (XInclude) support. Default value is false. When false, XInclude's include elements are ignored. Note: Boolean option values are set to true if the option is specified without a value. |
|
--aspect-node-order = lexical|instance Specifies the layout order of an open aspectNode. The default is lexical. |
--concept-label-linkrole = VALUE Specifies the preferred extended link role to use when rendering concept labels. |
--concept-label-role = VALUE Specifies the preferred label role to use when rendering concept labels. Default is: http://www.xbrl.org/2003/role/label. |
--evaluate-referenced-parameters-only = true|false If false, forces evaluation of all parameters even if they are not referenced by any formulas/assertions/tables. Default is: true. |
--generic-label-linkrole = VALUE Specifies the preferred extended link role to use when rendering generic labels. |
--generic-label-role = VALUE Specifies the preferred label role to use when rendering generic labels. Default is: http://www.xbrl.org/2003/role/label. |
--label-lang = VALUE Specifies the preferred language to use when rendering labels. Default is: en. |
--preload-table-schemas = true|false Preloads schemas of the XBRL Table 1.0 specification. Default is false. Note: Boolean option values are set to true if the option is specified without a value. |
--t | --process-table = VALUE Limits formula execution to the given table only. Add the option multiple times to specify more than one table. Short form is --t. The VALUE is either the value of the @id attribute, or a URI with an XPointer fragment that identifies the resource. The special values ##none and ##all can also be used. |
--table = true|false Enables the XBRL Table 1.0 extension. Default value is true. If true, automatically specifies --formula=true and --dimensions=true. Note: Boolean option values are set to true if the option is specified without a value. |
--table-execution = true|false Enables evaluation of XBRL tables. Default is false. Will be set to true if --table-output is specified. If true, automatically specifies --table=true. Note: Boolean option values are set to true if the option is specified without a value. |
--table-linkbase-namespace = ##detect | http://xbrl.org/PWD/2013-05-17/table | http://xbrl.org/PWD/2013-08-28/table | http://xbrl.org/CR/2013-11-13/table | http://xbrl.org/PR/2013-12-18/table | http://xbrl.org/2014/table Enables loading of table linkbases written with a previous draft specification. Table linkbase validation, resolution, and layout is, however, always performed according to the Table Linkbase 1.0 Recommendation of 18 March 2014. Use ##detect to enable auto-detection. |
--table-output = FILE Writes the table output to the specified FILE. If set, automatically specifies --table-execution=true. |
--table-output-format = xml|html Specifies the format of the table output. Default is xml. |
|
--catalog = FILE Specifies the absolute path to a root catalog file that is not the installed root catalog file. The default value is the absolute path to the installed root catalog file (<installation-folder>\Altova\RaptorXMLXBRLServer2024\etc\RootCatalog.xml). See the section, XML Catalogs, for information about working with catalogs. |
--user-catalog = FILE Specifies the absolute path to an XML catalog to be used in addition to the root catalog. See the section, XML Catalogs, for information about working with catalogs. |
--enable-globalresources = true|false Enables global resources. Default value is false. Note: Boolean option values are set to true if the option is specified without a value. |
|
--error-format = text|shortxml|longxml Specifies the format of the error output. Default value is text. The other options generate XML formats, with longxml generating more detail. |
--error-limit = N | unlimited Specifies the error limit with a value range of 1 to 9999 or unlimited. The default value is 100. Processing stops when the error limit is reached. Useful for limiting processor use during validation/transformation. |
--info-limit = N | unlimited Specifies the information message limit in the range 1-65535 or unlimited. Processing continues if the specified info limit is reached, but further messages are not reported. The default value is 100. |
--help Displays help text for the command. For example, valany --h. (Alternatively the help command can be used with an argument. For example: help valany.) |
--listfile = true|false If true, treats the command's InputFile argument as a text file containing one filename per line. Default value is false. (An alternative is to list the files on the CLI with a space as separator. Note, however, that CLIs have a maximum-character limitation.) Note that the --listfile option applies only to arguments, and not to options. Note: Boolean option values are set to true if the option is specified without a value. |
--log-output = FILE Writes the log output to the specified file URL. Ensure that the CLI has write permission to the output location. |
--network-timeout = VALUE Specifies the timeout in milliseconds for remote I/O operations. Default is: 40000. |
--recurse = true|false Used to select files within sub-directories, including in ZIP archives. If true, the command's InputFile argument will select the specified file also in subdirectories. For example: "test.zip|zip\test.xml" will select files named test.xml at all folder levels of the zip folder. References to ZIP files must be given in quotes. The wildcard characters * and ? may be used. So, *.xml will select all .xml files in the (zip) folder. The option's default value is false. Note: Boolean option values are set to true if the option is specified without a value. |
--verbose = true|false A value of true enables output of additional information during validation. Default value is false. Note: Boolean option values are set to true if the option is specified without a value. |
--verbose-output = FILE Writes verbose output to FILE. |
--version Displays the version of RaptorXML+XBRL Server. If used with a command, place --version before the command. |
--warning-limit = N | unlimited Specifies the warning limit in the range 1-65535 or unlimited. Processing continues if this limit is reached, but further warnings are not reported. The default value is 100. |
|