SAP Disclosure Management 10€¦ · 14 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade...

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.

http://www.intre.nl/



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



1. GET THE LATEST NT14 SBR TAXONOMY

Go to https://www.sbr-nl.nl/software-geschikt-maken/

Scroll down and select the appropriate taxonomy:

https://www.sbr-nl.nl/software-geschikt-maken/



Download the SBR NT14- Taxonomie zip file.



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)

http://www.nltaxomonie.nl/2019

http://www.xbrl.org/2008

http://www.nltaxonomie.nl/2019/

http://www.xbrl.org/2008/



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.

https://www.7-zip.org/download.html



Note: If you still have issues with the 260 characters limitation, please refer to Appendix I to solve this

within Windows 10.



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/

http://www.nltaxonomie.nl/2019/

http://www.xbrl.org/2008/



Rename the zipped http.zip file into nt14.zip



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.



3.1 UPLOAD NEW TAXONOMY

3.2 SELECT TAXONOMY ENTRY POINTS After a successful upload, select and import the applicable Taxonomy Entry Points.



When errors occur

If any error occurs, please check the log file in the Administration tab



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.

http://www.intre.nl/



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:



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:



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:



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.



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



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.



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.



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.





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:



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.



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.



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



!! 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…



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.



Select Copy data from one or more tables or views. Click Next.

Select as Destination the table XBRL.Contexts. Click Next.



You can preview the Excel file if you want:

Make sure there are no errors. Click Next.



Select Run immediately. Click Next.

Click Finish to execute the import.



All should be fine now. Click Close.

Close the Microsoft SQL Server Management Studio.

Date post:	11-Apr-2020
Category:	Documents
Upload:	others
View:	12 times
Download:	0 times

SAP Disclosure Management 10€¦ · 14 SAP Disclosure Management 10.1 - SBR XBRL NT14 upgrade...

Documents