ax 2012 data export (gdpdu) definitions guidelines · pdf fileax 2012 data export (gdpdu)...
TRANSCRIPT
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 1 of 36
Contents
Introduction ..................................................................................................................................................... 2
Pre-Requisites ................................................................................................................................................ 3
Create Table export definition .............................................................................................................. 4
Tax codes ............................................................................................................................................................. 4
Data export for Tax codes ............................................................................................................................. 6
Create Table export definition ............................................................................................................ 10
Sales Tax Transactions ................................................................................................................................. 10
Create Table export definition ............................................................................................................ 12
Fixed assets ...................................................................................................................................................... 12
Create Table export definition ............................................................................................................ 14
Fixed assets transactions ............................................................................................................................. 14
Create Table export definition ............................................................................................................ 16
Customer master data .................................................................................................................................. 16
Create Table export definition ............................................................................................................ 18
Customer transactions .................................................................................................................................. 18
Create Table export definition ............................................................................................................ 20
Inventory item ................................................................................................................................................. 20
Create Table export definition ............................................................................................................ 22
Inventory item transactions ....................................................................................................................... 22
Create Table export definition ............................................................................................................ 24
Vendor master data ....................................................................................................................................... 24
Create Table export definition ............................................................................................................ 26
Vendor transactions ....................................................................................................................................... 26
Create Table export definition ............................................................................................................ 28
Employee details ............................................................................................................................................. 28
Create Table export definition ............................................................................................................ 31
Ledger accounts .............................................................................................................................................. 31
Create Table export definition ............................................................................................................ 34
Ledger Transactions ....................................................................................................................................... 34
Additional information ................................................................................................................................... 36
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 2 of 36
Introduction
Companies in Germany and Austria have the legal requirement to provide an export of financial
data in a machine readable form. This whitepaper contains a description to define a standard
export definition.
Data of all transactions and master data from a fiscal year needs to be provided to auditors within
a reasonable time frame. The data needs to be collected in a file format, to import this data in the
auditors test environment. This procedure is controlled by the tax authorities.
Required exported data set can be different depending on audit needs. A default set of exported
data would include following master data and transaction tables:
Fixed assets master data
Fixed assets transactions
Customer master data
Customer transactions
Item master data
Item transactions
Vendor master data
Vendor transactions
Main accounts
Ledger transactions
Tax codes
Tax Transactions
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 3 of 36
Pre-Requisites Following the next steps is needed for the option ‘Data export’ to appear in the menu of AX 2012
1. Click Organization administration > Setup > Organization > Legal entities
2. Select Company > Addresses > Edit
3. Validate country is Germany
4. Click Bank account detail tab
5. Enter an individual Bank account, is a basic requirement for tables to export for one legal
entity only
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 4 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Tax codes 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Click New
3. Enter a name for the definition group, such as GDPdU, or else, and enter a description
4. Save by using Ctrl+S
5. Click Data export tables
6. Enter the name and description of the Data export table that you are creating
7. Click Data export fields
8. Select from All tables ‘TaxTable’ from upper left grid
9. Click Button Next
10. Create new line using Ctrl+N
11. Enter a name in Data export field and Description (Tax code), select TaxTable in Table
column; choose TaxCode in Field > create new line using Ctrl+N
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 5 of 36
12. Enter a name in Data export field and Description (Tax code name), select TaxTable in Table
column; choose TaxName in Field > create new line using Ctrl+N
13. Enter a name in Data export field and Description (Percentage/amount), select TaxTable in
Table column; choose Method = showTaxValue
14. Click Button Finish
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 6 of 36
Create data export
Data export for Tax codes 1. Click General ledger > Periodic > Data export > Data export 2. The wizard for exporting GDPdU data appears 3. Click Button Next to continue
4. Enter Definition group; From date and To date
5. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 7 of 36
6. Enter Data version 1.0 and a comment
7. Data export version is 1.1
8. Load DTD file, it is located in C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin\
gdpdu-01-08-2002.dtd
9. Export path, is the path or your choice to be saved to
10. Fill in Name of data media
11. Enter Capacity of data media 1000
12. Expected XML file length is 500
13. Click Button Next
14. Click Button Finish
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 8 of 36
Result
2 Folders are created (test cee 1 and test cee 2)
INDEX.XML
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 9 of 36
TaxCodes.TXT
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 10 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Sales Tax Transactions 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘TaxTrans’ in upper left grid
7. Select ‘TaxTable’ in ‘Tables related to the selected tables’ in the lower left grid, move it to
the right grid by clicking on the button ‘>‘
8. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 11 of 36
9. Create new lines using Ctrl+N
10. Enter a names in Data export field and Description
11. Select tables, fields and methods as shown below
12. Click Button Finish
VATTransactions.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 12 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Fixed assets 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘AssetTable’ in upper left grid
7. Select ‘AssetGroup’ in ‘Tables related to the selected tables’ in the lower left grid, move it to
the right grid by clicking on the button ‘>‘
8. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 13 of 36
FixedAssetsMasterData.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 14 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Fixed assets transactions 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘AssetTrans’ in upper left grid
7. Select ‘AssetBookTable’ in ‘Tables related to the selected tables’ in the lower left grid, move
it to the right grid by clicking on the button ‘>‘
8. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 15 of 36
FixedAssetsTransactions.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 16 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Customer master data 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘CustTable’ in upper left grid
7. Select ‘CustGroup’ in ‘Tables related to the selected tables’ in the lower left grid, move it to
the right grid by clicking on the button ‘>‘
8. Select ‘DirPartyTable’ in ‘Tables related to the selected tables’ in the lower left grid, move it
to the right grid by clicking on the button ‘>‘
9. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 17 of 36
CustomerMasterData.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 18 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Customer transactions 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘CustTrans’ in upper left grid
7. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 19 of 36
CustomerTransactions.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 20 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Inventory item 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘InventTable’ in upper left grid
7. Select ‘EcoResProduct’ in ‘Tables related to the selected tables’ in the lower left grid, move it
to the right grid by clicking on the button ‘>‘
8. Select ‘EcoResProductTranslation’ in ‘Tables related to the selected tables’ in the lower left
grid, move it to the right grid by clicking on the button ‘>‘
9. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 21 of 36
InventoryItem.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 22 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Inventory item transactions 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘InventTrans’ in upper left grid
7. Select ‘InventTransOrigin’ in ‘Tables related to the selected tables’ in the lower left grid,
move it to the right grid by clicking on the button ‘>‘
8. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 23 of 36
ItemTransactions.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 24 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Vendor master data 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘VendTable’ in upper left grid
7. Select ‘VendGroup’ in ‘Tables related to the selected tables’ in the lower left grid, move it to
the right grid by clicking on the button ‘>‘
8. Select ‘DirPartyTable’ in ‘Tables related to the selected tables’ in the lower left grid, move it
to the right grid by clicking on the button ‘>‘
9. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 25 of 36
VendorMasterData.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 26 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Vendor transactions 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘VendTrans’ in upper left grid
7. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 27 of 36
VendorTransactions.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 28 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Employee details 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘HcmWorker’ in upper left grid
7. Select ‘DirPerson’ in ‘Tables related to the selected tables’ in the lower left grid, move it to
the right grid by clicking on the button ‘>‘
8. Select ‘DirNameName’ in ‘Tables related to the selected tables’ in the lower left grid, move it
to the right grid by clicking on the button ‘>‘
9. Select ‘HcmPersonPrivateDetails’ in ‘Tables related to the selected tables’ in the lower left
grid, move it to the right grid by clicking on the button ‘>‘
10. Select ‘HcmWorkerTitle’ in ‘Tables related to the selected tables’ in the lower left grid, move
it to the right grid by clicking on the button ‘>‘
11. Select ‘HcmTitle’ in ‘Tables related to the selected tables’ in the lower left grid, move it to the
right grid by clicking on the button ‘>‘
12. Select ‘LogisticsLocation’ in ‘Tables related to the selected tables’ in the lower left grid,
move it to the right grid by clicking on the button ‘>‘
13. Select ‘LogisticsPostalAddress’ in ‘Tables related to the selected tables’ in the lower left
grid, move it to the right grid by clicking on the button ‘>‘
14. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 29 of 36
Note: There are certain fields in HcmWorker and related tables, which cause that the
employee record is not exported when these fields are empty. Employee status
attribute was depreciated in AX 2012. It was replaced by start/end dates and these
fields can be used instead of employed/terminated status.
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 30 of 36
Employee.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 31 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Ledger accounts 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘LedgerChartOfAccounts’ in upper left grid
7. Select ‘MainAccount in ‘Tables related to the selected tables’ in the lower left grid, move it to
the right grid by clicking on the button ‘>‘
8. Select ‘Ledger in ‘Tables related to the selected tables’ in the lower left grid, move it to the
right grid by clicking on the button ‘>‘
9. Select ‘CompanyInfo in ‘Tables related to the selected tables’ in the lower left grid, move it
to the right grid by clicking on the button ‘>‘
10. Select ‘BankAccountTable in ‘Tables related to the selected tables’ in the lower left grid,
move it to the right grid by clicking on the button ‘>‘
11. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 32 of 36
Note: Due to the shared chart of accounts the data exported for ledger accounts will
appear for all companies. Entering CompanyInfo and BankAccountTable prevents this
and shows data for one company only.
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 33 of 36
LedgerAccounts.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 34 of 36
Create Table export definition Follow these steps to create Data export and launch Microsoft Dynamics AX 2012.
Ledger Transactions 1. Click General ledger > Periodic > Data export > Data export definition groups
2. Select definition group created before
3. Click Data export tables
4. Enter the name and description of the Data export table which you are creating
5. Click Data export fields
6. Select from All tables ‘GeneralJournalAccountEntry’ in upper left grid
7. Select ‘GeneralJournalEntry in ‘Tables related to the selected tables’ in the lower left grid,
move it to the right grid by clicking on the button ‘>‘
8. Select ‘LedgerEntryJournalizing in ‘Tables related to the selected tables’ in the lower left
grid, move it to the right grid by clicking on the button ‘>‘
9. Select ‘DimensionAttributesValueCombination in ‘Tables related to the selected tables’ in
the lower left grid, move it to the right grid by clicking on the button ‘>‘
10. Select ‘TransactionLog in ‘Tables related to the selected tables’ in the lower left grid, move it
to the right grid by clicking on the button ‘>‘
11. Click Button Next
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 35 of 36
LedgerTransactions.txt
AX 2012 Data export (GDPdU) definitions guidelines by Anke Hampel
Page 36 of 36
Additional information
There is a number of tools that can be used in order to understand AX 2012 data model.
Below you can find references to further information about them.
Reverse Engineering tool – the tool enables you to visualize data and classes in
Microsoft Dynamics AX by creating UML data models, UML object models, and ERX ER
data models.
Tool description: http://msdn.microsoft.com/en-us/library/aa499193.aspx
How to create ER diagram: http://msdn.microsoft.com/en-us/library/cc604309.aspx
Application Analysis Tool – the tool for Microsoft Dynamics AX 2012 designed to
enable developers to easily analyze trace files, database models, and X++ classes to
understand how the application has been constructed.
User guide: http://technet.microsoft.com/EN-US/library/hh378080.aspx
Data upgrade scripts – if you are familiar the data model of AX 4.0 or AX 2009 and
you configured exports in GDPdU tool in former versions, you can inspect upgrade
scripts (upgrade XPOs) to figure out changes in AX 2012 data model in comparison to
previous versions.
Upgrade Guide http://www.microsoft.com/en-us/download/details.aspx?id=14599
Data upgrade best practices: http://www.microsoft.com/en-us/download/details.aspx?id=28701