New Features
firesys-Version 22.3.1
Tag PDF documents with TextBlocks from tagged Word documents
For many issuers a report creation process begins with a Word document. While the report itself is being created in Word, the final document is, for layout reasons, sometimes a PDF. While tagging text blocks in Word and maintaining those tags through different versions is very reliable, doing so in PDF is technically more challenging.
If your working document is a Word document but your final document to be tagged and published is a PDF, from firesys version 22.3.1 onwards we can offer a reliable way to restore all tagged text blocks from a Word document to the PDF. This even works with nested tags. When the time has come to tag the PDF, open it in toolsxbrl, set the default settings and then choose the "Import Word document text blocks" option from the "Tools" section:
Choose your tagged Word document and toolsxbrl will apply all text block tags to the PDF. Make sure you apply the Word document to a PDF document based on the same version of the content. Once toolsxbrl is done applying the tags you can see them as usual in both the Preview and the Text Tagging tab.
Copy Textblock Tags through the Mapping Clipboard
The Mapping Clipboard is a powerful tool to work with your report and also transfer tags from one version of a tagged document to another. So far it only supported tags in tables, from firesys version 22.3.1 onwards it also supports text block tags.
Settings and LEI-Search
The settings dialog has been improved and provides a more clear interface and further information to most of the settings. It is now also possible to change the role name for the Names And Mandatory Items role in the settings. The LEI-Search dialog has also been improved and shows more results from the official GLEIF database.
Mini Disclosure Checklist
From 2022 onwards the ESEF requirements mandates text block tagging, all mandatory tags from the role 000000 in the ESEF taxonomy have to be tagged if the content is present in the document and the tag is material to the issuer. All the mandatory tags have references to the respective sections in the standard:
toolsxbrl now allows the issuer to select the references which are material to the report, and then the validation will show a warning for all the tags that are actually referenced by that selection. To enable this feature, just go to the document settings and select the three dots for the "References to Check" property in the Options.
Now the Mini Disclosure Checklist appears and the references to be checked can be selected and saved.
From now on, when the user validates the document, all tags that are not yet tagged and referenced by the selection will show up as a warning.
Information about Reportwide Calculations
We have improved toolsxbrl to make it clearer how and where reportwide calculations affect the report:
In the example above the tagged cell for "Other operating income" does not have a calculation itself, since it is part of another calculation in the "Income Statement". In the table "Other operating income" however, this tag is actually the total of the values in that table. Since the calculation for the "Other operating income" table is also valid for the tag at this position in the report, it is now also being shown here besides a possible calculation for this "Cell". The summands being shown are the summands that are valid in the context of this given cell, meaning if you have added a calculation for certain dimensions, it would show the values for tags existing in the dimension selection for the selected cells. This will make it more transparent why a calculation in another part of the report might lead to a calculation warning in the currently selected table. All calculation that have not been created for the selected cell can only be edited in the original cell.
Improvements for table tags
toolsxbrl now has a new smart AI-powered feature that will help you selecting tables in PDF documents. While you had to manually select tables in prior versions, you can now click the "Automatically select table area" button in the upper left corner of the preview pane:
Then toolsxbrl will use the AI to select the tables available on the page. If there are multiple tables, it will highlight all of them:
You can then simply select the table you want to tag, manually adjust the area if necessary and tag the table as usual:
-->
You can change the table area even when you already have a table tag and cell tags applied to it. Just right click the border, click „Edit“ and then adjust the area. All tags that are within the newly selected area will be kept:
Improvements to textblock-tagging
We have vastly improved the algorithm for textblock-restoration to make tagging documents, that are still a work in progress, more reliable. toolsxbrl is now able to restore most textblock-tags, even in the following situations:
- A text block moves from version 1 to version 2 to another page.
- A text block that was on one page in version 1 wraps to two pages in version 2.
- Words are inserted or deleted within a text block.
- Paragraphs are inserted or deleted within a text block.
To furthermore support this process it is now also possible to edit the area of a textblock-tag, without having to retag it:
When you have to use the same tag in multiple areas of your report, the XBRL concept of continuations are the way to go. We have also simplified the way to tag those. Whenever you use a textblock-tag that you have already tagged to a different area, you will be asked if this is supposed to be a continuation of the already existing tag. If you select yes, the continuation will automatically be set in the correct order.
You can now also jump between all continuations of a textblock-tag, by rightclicking one instance and using the "jump to" functionality:
Big Textblock tagging for the full notes from page to page (PDF)
Create or use a new layer. Tag the first page with the Tag for example: “Disclosure of notes and other explanatory information”. Go to the last page of your notes section and repeat the step. You will get this screen. Answer it with yes:
Rightclick on the tagged text and chose this part of the menu:
Answer the next window with yes:
After this all pages will be tagged.
If you work with a word document: To insert the whole notes section (“Disclosure of notes and other explanatory information [text block]”) into your word document, you need to select all the text you wish of your document and insert the Content Control and the Technical Name as it would for any tag, but please note that the selection of the text must be made under a headline, for example the first one in the document.
Further improvements
- PDF: toolsxbrl now shows the "true" page numbers of a document (according to information in the PDF) in the chapter selection
- PDF: In accordance with the new ESEF reporting manual section 2.2.6 whitespaces of PDF documents will be preserved to ensure readability of the content in the XBRL layer.
- Calculation Linkbase 1.1: While not yet mandatory for ESEF, the new implementation of the calculation linkbase in version 1.1 can be chosen in the settings.
==
Double/Multiple Tagging for PDF documents
In some reports some content has to be tagged more than once. This can be two tags for the same table cell, two tags for the same text or a text block around a table that is already tagged. With the firesys-Version 21.3.1 we are adding tagging layers to PDF documents. Each layer can then be tagged independently. When creating a result document, all the tags will be merged according to the iXBRL specifications.
To get started, first load your document as usual and then add a new layer via the axis manager:
While one additional layer is enough for most reports, it is possible to add more than that. After clicking on apply you can select the new layer in the Z-Axis dropdown, with "[..]" being your default layer:
Once you switch the layer, you will see that all current tags have been hidden in the other layer and you can tag on a blank page.
- If you want to tag the same table cell twice, just tag the table again and then the desired cell (you don't have to tag the whole table again in Layer 2)
- If you want to create an additional textblock tag around the table, just select the table and tag the textblock
- If you want to tag the same text twice, just select and tag it in both layers
When you now create a result document and select the double tagged cell in the preview, the viewer will show two tags and the tags are properly nested in the document:
Continuations
In reporting text that belongs to a single XBRL textblock or text tag might be in several places in the document. XBRL has a mechanism called continuation for this case that essentially tells the XBRL processors to merge all the content that has been tagged with this tag and is part of the continuation for the output. From firesys-Version 21.3.1 the places to continue a tag can not explicitly be selected:
Abstract hierarchy customizer
In addition to the Dimension Hierarchy Customizer (Document_Tagging#Customizing_the_dimensional_hierarchy) firesys-Version 21.3.1 adds a similar feature for Abstract Hierarchies. If the hierarchy of a statement in your report does not resemble the one in the ESEF taxonomy, you can now rearrange the positions and levels, add additional abstracts from the taxonomy and remove abstracts that are part of the default:
Just select the hierarchy customizer for your table, select the role from which you want to copy the initial hierarchy and then drag and drop abstracts to this hierarchy. Once your are done, you drag and drop the abstract for a specific tag from this dialog onto the relevant tags, just as you did before from the taxonomy:
Rearranging the row order
It is important to bear in mind, that the structure of statements in your company specific XBRL taxonomy extension will differ from what you have in the report. One such case is for example the following Statement of Changes in Equity. In the example report we can find two separate tables, one for each year. In the resulting taxonomy we will only have one combined table, with the period being selectable. In the below example we can further see that the table for 2017 has two rows more than the one for 2018. Where exactly these two rows are supposed to be placed in a combined table is up to the Filer and/or Auditor. Per default they will just be added at the end, as shown below.
With the new custom row ordering feature, this can easily be changed by you, just click on the highlighted button and rearrange the rows to your requirements, the result in the extension taxonomy will change accordingly:
Custom date formats
There are countless ways to represent a date, it is challenging to support all formats automatically in toolsxbrl. If a date is not recognized by default, from firesys-Version 21.3.1 a custom format description can be created for the table in question.
Click on the table properties after selecting the table in question. The following window opens with a new setting ("Custom date formats"). Click in the right empty cell. A button appears. This opens the editor for user-defined date formats.
Add a new format using the + Button, this opens the editor for user-defined date formats. It is possible to add multiple formats for a table if necessary. All formats have to be described by regular expressions. A good introduction can be found here: https://github.com/ziishaned/learn-regex/blob/master/translations/README-de.md.
New Settings
Three further new features can be enabled or disabled from the toolsxbrl Settings:
Readonly Properties
If this is set to read only, changing tagging properties for cells that have been set to the Final status can no longer be changed. To change these cells revert to status to In Edit or Review Pending.
Document View Type
It is now possible to define the view type for converted Word documents. The available options are FullScreen, Manuscript and Pages. Just try them out to see what fits your report best.
Auto Save
toolsxbrl has now an Auto Save feature to prevent accidental loss of work. If your PC crashes and you have not saved your work, you will get a prompt on the next load of the document if you want to restore the latest auto save backup rather then the original mapping file. This option deactivates this mechanism if it is not desired.
Two new features have been added to the Document Settings:
Roll Forward
toolsxbrl usually detects changes in table headers during a roll forward and adjusts the mapping periods accordingly. For tables that don't have the date explicitly in the header, for example Statement of Changes in Equity, this option moves the mapping periods forward according to the date set in the document settings. Just select "Yes" and click on OK for a roll forward. This option will always be "No" by default and also after a roll forward.
Table Order
Usually the table order in the extension taxonomy should resemble the order of tables in the actual report. In some jurisdictions or auditors' opinions it has to exactly resemble the order in the original taxonomy. To achieve this just enable this option.
Calculation Validation
Failed calculations in XBRL are often just rounding errors, and thus ignored by most filers and regulators. Sometimes the actual delta between the calculated value and the tagged value is so too big to be a rounding error, so it would make more sense to be an error than a warning. This behavior can now be changed in the XBRL Processor settings:
You can enable or disable this functionality and also set the threshold for when a calculation warning should become an error.
Detach Controls
With the firesys-Version 21.3.1 you can now make full usage of multiple displays while tagging. Simply use the Detach Controls feature and independently move the windows around your desktops:
See also
The Toolsxbrl Functions
First Steps
Interface and toolsxbrl Settings
Document Tagging
Validation
Generate an XBRL Document
IXBRL Taxonomies, Reports, and Common Errors