SAP Disclosure Management 10.1 SBR XBRL NT14 upgrade guide
Author Oscar Schouten, Intre B.V.
Version 1.0
Date June 2019
Contact [email protected]
INdependent, TRustworthy and Excellent business consultancy
2 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
INTRODUCTION
This is an upgrade guide to use the latest SBR NT14 taxonomy with the SAP Disclosure Management
(DM) 10.1 solution for the generation of SBR taxonomy reports. This guide consists of downloading the
latest NT14 taxonomy, creating the zip file to be used in SAP DM, updating the XBRL settings in SAP DM
and updating the mapping of your data files.
Below diagram shows the context of the generation of XBRL reports using the SBR taxonomy. The areas
within the dotted line are covered in this setup guide.
Please refer to the SAP Disclosure Management 10.1, SBR XBRL setup guide on www.intre.nl under SAP
and OneStream EPM tab for a complete installation guide for using SAP DM 10.1 for SBR XBRL reporting.
Pre-requisites:
The generation of SBR XBRL reports with NT14 required SAP DM Stack 1400 for all components
(including the client and XBRL mapper) and upwards.
INdependent, TRustworthy and Excellent business consultancy
3 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
CONTENTS
Introduction .................................................................................................................................................. 2
1. Get the latest NT14 SBR Taxonomy ...................................................................................................... 4
2. Create NT14 Taxonomy upload file for SAP DM ................................................................................... 6
3. Add the new NT14 taxonomy to SAP DM 10.1 ................................................................................... 11
3.1 Upload new Taxonomy ..................................................................................................................... 12
3.2 Select Taxonomy Entry Points ........................................................................................................... 12
3.3 Create Reports .................................................................................................................................. 14
3.4 Import chapter structure in the Data Cache report .......................................................................... 16
3.5 Upload Excel Templates with mapping information......................................................................... 17
3.6 Specify Chapter Entry point .............................................................................................................. 19
3.7 Update XBRL output generation parameters ................................................................................... 19
3.8 Update XBRL Contexts ...................................................................................................................... 20
3.9 Update XBRL Units ............................................................................................................................ 21
3.10 Start mapping .................................................................................................................................. 21
Appendix I – How to Make Windows 10 Accept File Paths Over 260 Characters ...................................... 24
Appendix II – Import XBRL Contexts in SQL DB using Excel file .................................................................. 27
INdependent, TRustworthy and Excellent business consultancy
4 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
1. GET THE LATEST NT14 SBR TAXONOMY
Go to https://www.sbr-nl.nl/software-geschikt-maken/
Scroll down and select the appropriate taxonomy:
INdependent, TRustworthy and Excellent business consultancy
5 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
Download the SBR NT14- Taxonomie zip file.
INdependent, TRustworthy and Excellent business consultancy
6 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
2. CREATE NT14 TAXONOMY UPLOAD FILE FOR SAP DM
The zip file that needs to be uploaded to SAM DM must apply to a certain format. This format is shown
below:
Unfortunately, this is not the format of the taxonomy zip file that was downloaded from the SBR web
site. So, we have to create a new zip file that comply with the above structure. When using the former
NT13 zip file, we had to replace the nt14 folder from the downloaded NT14 taxonomy and added the
folder www.nltaxomonie.nl\2019 and added the file boolean-filter.xsd to the folder
www.xbrl.org\2008.
These two items can be found in:
1. http://www.nltaxonomie.nl/2019/ (download the complete xbrl folder)
2. http://www.xbrl.org/2008/ (download the file boolean-filter.xsd)
INdependent, TRustworthy and Excellent business consultancy
7 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
My advice is to use 7-zip for unzipping and zipping the taxonomy files. This is a free file archiver for
extremely high compression and does not have issues with maximum 260-character filenames.
Other archiver tools might give the following error when extracting NT1X files:
You can download 7-zip here: https://www.7-zip.org/download.html
Select the applicable platform.
Now unzip the NT14_20190517.zip file.
INdependent, TRustworthy and Excellent business consultancy
8 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
Note: If you still have issues with the 260 characters limitation, please refer to Appendix I to solve this
within Windows 10.
INdependent, TRustworthy and Excellent business consultancy
9 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
When the NT14 taxonomy zip file is extracted, the structure will look like:
In order to create the new nt14.zip file, I used the former nt13.zip file to get the content of the
www.xbrl.org folder and the other folders content in the www.nltaxonomie.nl folder. And add the
missing folder 2019 and file boolean-filter.xsd in the 2008 folder.
The structure should look like:
Now select the http folder and zip the whole structure:
Copied from NT14_20190517.zip Downloaded from http://www.nltaxonomie.nl/2019/
Downloaded from http://www.xbrl.org/2008/
INdependent, TRustworthy and Excellent business consultancy
10 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
Rename the zipped http.zip file into nt14.zip
INdependent, TRustworthy and Excellent business consultancy
11 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
3. ADD THE NEW NT14 TAXONOMY TO SAP DM 10.1
Within SAP DM create a new entry in your Share period for the SBR-Taxonomies.
Give the chapter the name NT14
Now upload the nt14.zip file.
INdependent, TRustworthy and Excellent business consultancy
12 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
3.1 UPLOAD NEW TAXONOMY
3.2 SELECT TAXONOMY ENTRY POINTS After a successful upload, select and import the applicable Taxonomy Entry Points.
INdependent, TRustworthy and Excellent business consultancy
13 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
When errors occur
If any error occurs, please check the log file in the Administration tab
INdependent, TRustworthy and Excellent business consultancy
14 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
3.3 CREATE REPORTS We have to create two reports, one XBRL SBR report and one Data Cache:
If you don’t know how to create such reports, please refer to the SAP Disclosure Management 10.1, SBR
XBRL setup guide on www.intre.nl under SAP and OneStream EPM tab.
INdependent, TRustworthy and Excellent business consultancy
15 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
The DataCacheSBR-MiddelGroot will contain the Excel templates that holds the XBRL mapping to the
NT14 taxonomy.
The NL-SBR-MiddelGroot is the XBRL reports that holds the Entry point and the XBRL configurations.
When both reports have been created, make sure you link the Data Cache report to the XBRL report:
INdependent, TRustworthy and Excellent business consultancy
16 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
3.4 IMPORT CHAPTER STRUCTURE IN THE DATA CACHE REPORT Now upload the chapter structure of the Data Cache. Select the DataCacheSBR-MiddelGroot report and
select the Import tab to import the XML file containing the chapter structure.
Your Data Cache chapter should now look like this:
INdependent, TRustworthy and Excellent business consultancy
17 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
3.5 UPLOAD EXCEL TEMPLATES WITH MAPPING INFORMATION Note: This process needs to run on the SAP DM Application server itself!
Note: before executing the batch upload file, make sure that the Workflow is started for this Data Cache!
Navigate to the folder that contains the Excel templates and search for the batch file that uploads the
Excel templates into SAP DM using the DMBatchTool.exe.
Edit the batch file so it applies the settings for your environment:
INdependent, TRustworthy and Excellent business consultancy
18 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
chcp 1252 # leave this parameter as it is
set user=admin # is the admin user for executing this script
set password=Intre01 # is the admin password for executing this script
set system=http://localhost:81 # is the SAP DM website address
set period=FY 2019 # is the Period
set report=DataCacheSBR-MiddelGroot # is the name of the Data Cache report
set pathBatch=C:\inetpub\wwwroot\SAP\SAP Disclosure Management\BatchTool # is the location of the DMBatchTool.exe on the server.
Save the batch file and execute this in a Command prompt box:
The information is now uploaded to DM.
The Excel templates are now uploaded and should be visible in the Data Cache chapters.
INdependent, TRustworthy and Excellent business consultancy
19 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
3.6 SPECIFY CHAPTER ENTRY POINT After importing the Taxonomy Entry Point, select the Chapter Entry Points. Go to your reporting period
and select the XBRL Report you just created. In our case NL-SBR-MiddelGroot.
Select the XBRL Taxonomy tab of the chapter 3 – XBRL Taxonomy. Select the Share period, the SBR-
Taxonomies report and the NT14 Taxonomy chapter.
3.7 UPDATE XBRL OUTPUT GENERATION PARAMETERS Now specify the output parameters for the XBRL generation:
- Dimension Container = Segement
- XBRL Instance Encoding = UTF8
- XBRL Document name = SAPDM_SBR_MiddelGroot.xbrl
INdependent, TRustworthy and Excellent business consultancy
20 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
Save the settings.
3.8 UPDATE XBRL CONTEXTS Now create of update the XBRL Contexts settings in the chapter 2- XBRL Contexts. Or refer to Appendix
II in order to import the XBRL Contexts directly in the Disclosure Management database using an Excel
file.
INdependent, TRustworthy and Excellent business consultancy
21 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
3.9 UPDATE XBRL UNITS Create the XBRL Units:
- EUR;
- pure;
- shares;
as shown below:
3.10 START MAPPING Go to your Data Cache report that contains the Excel templates with the mapping information.
Edit the Chapter and Excel should open with your input form. Now start the SAP DM XBRL Mapper in
the SAP Disclosure Management ribbon.
INdependent, TRustworthy and Excellent business consultancy
22 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
If you use an already mapped xls file, you might see this error message:
Don’t worry, you need to re-map the content. Make sure that all miss-mapped lines in the “Mapping
Overview” tab has been solved.
After successful mapping, you should be able to generate an XBRL instance document with SAP DM 10.1
using the NT14 SBR taxonomy.
INdependent, TRustworthy and Excellent business consultancy
23 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
INdependent, TRustworthy and Excellent business consultancy
24 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
APPENDIX I – HOW TO MAKE WINDOWS 10 ACCEPT FILE PATHS OVER
260 CHARACTERS
Before Windows 95, Windows only allowed file names that were eight characters long, with a three-
character file extension–commonly known as an 8.3 filename. Windows 95 abandoned that to allow
long file names, but still limited the maximum path length (which includes the full folder path and the
file name) to 260 characters. That limit has been in place ever since. If you’ve ever run into this limit,
most likely it was when you were trying to copy deep folder structures into other folders, such as when
copying the contents of a hard drive to a folder on another drive. The Windows 10 Anniversary Update
finally adds the option to abandon that maximum path length. There is one caveat. This new
setting won’t necessarily work with every application out there, but it will work with most. That’s why
the advice is to use 7-zip for extracting files.
To get started, open the Registry Editor by hitting Start and typing “regedit.” Press Enter to open
Registry Editor and give it permission to make changes to your PC.
In the Registry Editor, use the left sidebar to navigate to the following key:
INdependent, TRustworthy and Excellent business consultancy
25 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
On the right, find a value named LongPathsEnabled and double-click it. If you don’t see the value
listed, you’ll need to create it by right-clicking the FileSystem key, choosing New > DWORD (32-bit)
Value, and then naming the new value LongPathsEnabled.
INdependent, TRustworthy and Excellent business consultancy
26 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
In the value’s properties window, change the value from 0 to 1 in the “Value data” box and then click
OK.
You can now close Registry Editor and restart your computer (or sign out of your account and sign back
on). If you ever want to reverse the changes, just head back to the LongPathsEnabled value and set it
from 1 back to 0.
INdependent, TRustworthy and Excellent business consultancy
27 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
APPENDIX II – IMPORT XBRL CONTEXTS IN SQL DB USING EXCEL FILE
This appendix describes the process of importing the XBRL Contexts items in the SAP DM SQL database
directly using an Excel file.
Write down the Report ID of the XBRL report in SAP DM. In our case it is 6054
Open the Excel file XBRLContexts_NT14_MG.xlsx and update the Column (B) with the ReportId, so it
matches your own Report ID in SAP DM. In our situation this is 6054
INdependent, TRustworthy and Excellent business consultancy
28 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
!! Before you save the file there are two major things you need to update: !!
- In column C (SerializedXML) there is also a reference to your ReportID, so make sure you replace
this number with your own ReportID
- In column C (SerializedXML) there is also a reference to your EntityCODE, so make sure you
replace this number with your own Chamber of Commerce number
Now open Microsoft SQL Server Management Studio and select the Disclosure Management database
(in our case DisclosureManagementDB). Right mouse click and select Tasks → Import Data…
INdependent, TRustworthy and Excellent business consultancy
29 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
The Import data wizard opens. Click Next.
Select Microsoft Excel as the Data source and select Microsoft Excel 2007 as the Excel version. Now
select your Excel file. Tick the option “First row has column names”. Click Next.
Make sure you select your server name and the Disclosure Management database. Click Next.
INdependent, TRustworthy and Excellent business consultancy
30 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
Select Copy data from one or more tables or views. Click Next.
Select as Destination the table XBRL.Contexts. Click Next.
INdependent, TRustworthy and Excellent business consultancy
31 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
You can preview the Excel file if you want:
Make sure there are no errors. Click Next.
INdependent, TRustworthy and Excellent business consultancy
32 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
Select Run immediately. Click Next.
Click Finish to execute the import.
INdependent, TRustworthy and Excellent business consultancy
33 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade guide
All should be fine now. Click Close.
Close the Microsoft SQL Server Management Studio.