...
Code Block | ||
---|---|---|
| ||
<?xml version="1.0"?> <XBRLSettings xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <ThrowXBRLExceptionForUnitTesting>false</ThrowXBRLExceptionForUnitTesting> <MaxValidationExceptionLimit>1000<<MaxValidationExceptionLimit>10000000</MaxValidationExceptionLimit> <UseProxy>NoProxy</UseProxy> <ProxyPort>0</ProxyPort> <ProxyUseAuthentication>false</ProxyUseAuthentication> <XBRLFileCachePath>C:\Users\usernamerichard.boessen\AppData\Roaming\AMANAconsulting\XBRLCache</XBRLFileCachePath> <ForceOfflineMode>true</ForceOfflineMode> <FillOffllineCache>true</FillOffllineCache> <ReDownloadAndOverrideCachedFiles>false</ReDownloadAndOverrideCachedFiles> <TaxonomyPackageCacheType>None<<TaxonomyPackageCacheType>Extracted</TaxonomyPackageCacheType> <DisableAsyncTaxonomyLoading>false</DisableAsyncTaxonomyLoading> <DisableBinaryCache>false</DisableBinaryCache> <DisableBinaryCache>true</DisableBinaryCache> <PreferStreamedPackage>false</PreferStreamedPackage> <ValidateUTR>false</ValidateUTR> <CalculationLinkbaseValidationMode>Auto</CalculationLinkbaseValidationMode> <CalculationLinkbaseExclusions> <string>www.eba.europa.eu</string> <string>eiopa.europa.eu</string> <string>www.bundesbank.de</string> <string>www.bde.es</string> <string>www.srb.europa.eu</string> <string>www.fma-li.li</string> <string>www.bankingsupervision.europa.eu</string> <string>www.bankofengland.co.uk</string> </CalculationLinkbaseExclusions> <CalculationValidationSeverityErrorThreshold>0.01</CalculationValidationSeverityErrorThreshold> </XBRLSettings> |
There are few settings which might alter the behavior of the Engine:
- DisableAsyncTaxonomyLoading: Once enabled, the ThrowXBRLExceptionForUnitTesting: This setting should not be used in production enviroments, setting it to true causes the XBRL Engine to stop any validation by throwing an exception if an error is detected.
- DisableAsyncTaxonomyLoading: Once enabled, the files of a taxonomy are read asynchronously instead of one after another, which is usually slower. This option can be used if async loading causes issues. Default value is false.
- DisableBinaryCache: When set to false true, the faster fast binary cache is used. If a file is not found, the Engine will look for it in the cache folderdisabled. Default value is false.
- FillOffllineCache: Once set to true, enables the Engine to access remote location where a taxonomy is hosted and download it. The folder path where the taxonomy will be stored, is specified by the XBRLFileCachePath setting XBRLFileCachePath setting.
- ForceOfflineMode: Once enabled, forces the Engine to use the local cache where the taxonomies are located. If the taxonomies are not found, the engine will download them from the internet. The local cache path is specified by the XBRLFileCachePath setting.
- MaxValidationExceptionLimit: Specified Specified in numbers defining the Validation exception validation message limit. Once limit is reached, the Engine throws a so-called XbrlExceptionLimitReachedException exceptionan XbrlExceptionLimitReachedException. This setting should have a default value of at least 10000.
- ReDownloadAndOverrideCachedFiles: When enabled, the local cached files in the XBRLCache folder will always be replaced with new ones loaded from the internet. This setting should not be set to true in production envirments, default value is false.
- TaxonomyPackageCacheType: Select in which form the taxonomy packages will be stored. You can choose between None, Extracted and Zip.
- ThrowXBRLExceptionForUnitTesting: Once set to true, forces the Engine to throw a XbrlException if one occurs.
- UseProxy: Once set, forces the Engine to use a Proxy Server in order to access the remote location where the taxonomy is situated. If enabled, the following Properties must be specified:
- ProxyAddress: Must be a valid string.
- ProxyPort: Must be a valid integer.
- ProxyUser: Must be a valid string.
- ProxyPasswordEncrypted: Must be a valid string.
- ProxyUseAuthentication: Must be a valid bool.
- be a valid string.
- ProxyPasswordEncrypted: Must be a valid string.
- ProxyUseAuthentication: Must be a valid bool.
- XBRLFileCachePath: Specifies a path to local folder where the taxonomies are stored. This can be different for every client. Please don't forget to modify.
- Calculation Linkbase Validation settings:
- CalculationLinkbaseValidationMode: If set to Auto (default value), the calculation linkbase validation is performed on any XBRL document except those using one of the taxonomies listed in the CalculationLinkbaseExclusions. If the setting is set to Enabled, the validation is always performed, if set to Disabled, it is never performed.
- CalculationValidationSeverityErrorThreshold: This percent value (e.g. 0.01 = 1%) can be used to define a threshold which changes the severity of calculation linkbase inconsistencies to WARNING instead of error. If this setting is set to xsi:nil="true", the severity is not overwritten.
- CalculationLinkbaseValidationMode: If set to Auto (default value), the calculation linkbase validation is performed on any XBRL document except those using one of the taxonomies listed in the CalculationLinkbaseExclusions. If the setting is set to Enabled, the validation is always performed, if set to Disabled, it is never performed.
- ValidateUTR: If this setting is set to true (default), the Unity Type Registry is performed as part of the normal XbrlDocument validation.
- Taxonomy Packages settings:
- TaxonomyPackageCacheType: If the value is set to Extract, the Taxonomy Packages ZIP archives are extracted to the XBRLCache folder. However, this can cause issues for very long filenames. If the value is set to Zipped, the ZIP archived will be opened as streams, which can cause higher memory consumption. If the setting is set to None, no XBRL Taxonomy Packages are used at all while loading XBRL taxonomies.
- PreferStreamedPackage: tba
- TaxonomyPackageCacheType: If the value is set to Extract, the Taxonomy Packages ZIP archives are extracted to the XBRLCache folder. However, this can cause issues for very long filenames. If the value is set to Zipped, the ZIP archived will be opened as streams, which can cause higher memory consumption. If the setting is set to None, no XBRL Taxonomy Packages are used at all while loading XBRL taxonomies.
Code Block | ||
---|---|---|
| ||
<ValidateUTR>false</ValidateUTR> <CalculationLinkbaseValidationMode>Auto</CalculationLinkbaseValidationMode> <CalculationLinkbaseExclusions> <string>www.eba.europa.eu</string> <string>eiopa.europa.eu</string> <string>www.bundesbank.de</string> <string>www.bde.es</string> <string>www.srb.europa.eu</string> <string>www.fma-li.li</string> <string>www.bankingsupervision.europa.eu</string> <string>www.bankofengland.co.uk</string> </CalculationLinkbaseExclusions> <CalculationValidationSeverityErrorThreshold xsi:nil="true" /> </XBRLSettings> |
...
The settings can be stored as an XML file using it’s static Save method:
...