Management Reporter Integration Guide For Microsoft Dynamics® SL
Management Reporter Integration Guide For Microsoft Dynamics® SL
January 2014
Microsoft Dynamics is a line of integrated, adaptable business management solutions that enables you and your people to make business decisions with greater confidence. Microsoft Dynamics works like and with familiar Microsoft software, automating and streamlining financial, customer relationship and supply chain processes in a way that helps you drive business success. U.S. and Canada Toll Free 1-888-477-7989 Worldwide +1-701-281-6500
www.microsoft.com/dynamics Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted in examples herein are fictitious. No association with any real company, organization, product, domain name, e-mail address, logo, person, place, or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation. Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. 2014 Microsoft Corporation. All rights reserved. Microsoft, Active Directory, Management Reporter, Microsoft Dynamics, the Microsoft Dynamics logo, Windows, Windows Server, and SQL Server are trademarks of the Microsoft group of companies. All other trademarks are property of their respective owners.
Contents
Introduction ................................................................................................ 4 Upgrade Considerations .............................................................................. 4
New Ability to Limit the Data Integration Timeframe ................................................................. 4 System Database Method of Integration .................................................................................. 5 The Account Category and Account Type Attributes ................................................................... 5 Drill to Dynamics .................................................................................................................. 5 Use of Wildcard Characters in Filters ....................................................................................... 5 Filtering on Dimensions ......................................................................................................... 5 Exporting and Converting Report Definitions ............................................................................ 6 Prompting for Credentials ...................................................................................................... 6 The Microsoft Dynamics SL Legacy Data Provider ...................................................................... 6
Appendix ................................................................................................... 20
Available Attributes ..............................................................................................................20 Account Type ................................................................................................................... 20 Transaction Type .............................................................................................................. 20 Reporting When the Last Two Periods End on the Same Date ....................................................21 Integrating a Data Mart with a Second ERP Database ...............................................................22 Data Mart Displays Only Attributes Associated with Transactions ...............................................22 Supported Attributes ............................................................................................................22 Drill to Dynamics from the Web Report Viewer ........................................................................22
Introduction
Management Reporter 2012 for Microsoft Dynamics ERP uses a data mart adapter to integrate data between Microsoft Dynamics SL and Management Reporter. You can view and work with data from Microsoft Dynamics SL to create financial reports in Management Reporter 2012 without affecting the original data in the ERP database. Note: The Microsoft Dynamics SL data mart adapter replaces the Microsoft Dynamics SL legacy data provider with Management Reporter 2012 RU4 and later versions. The Microsoft Dynamics SL legacy data provider remains compatible with Management Reporter 2012 RU5 and later versions. Earlier versions of Management Reporter must be updated to Management Reporter 2012. This version of the Microsoft Dynamics SL data mart adapter is compatible with Microsoft Dynamics SL 2011 and later versions. The Microsoft Dynamics SL data mart adapter supports one system database per integration and lets you specify a starting fiscal year limit. This option improves report generation in Management Reporter 2012. The Microsoft Dynamics SL legacy data provider included with Management Reporter 2012 RU5 and later versions lets users run existing reports and also remove existing integrations. We recommend that you remove existing Microsoft Dynamics SL legacy data provider integrations and configure a Microsoft Dynamics SL data mart integration with Management Reporter 2012 RU5 and later versions.
Upgrade Considerations
When you upgrade to the Microsoft Dynamics SL data mart adapter, you may notice several differences. This section identifies these areas and explains the differences and reasoning behind them.
3. Change the year shown to the start fiscal year limit that you want to specify. For example, if you specify 2009, the Management Reporter reports will include data from fiscal year 2009 and later. 4. Run the SQL statement. To limit all Microsoft Dynamics SL databases, follow these steps: 1. Locate the MRServiceHost.settings.config file, and then edit the file in Notepad. The default location of the file is <Program Files>\Microsoft Dynamics ERP\Management Reporter\2.1\Server\Services. Note: You must install the Management Reporter Server component first. 2. Add a line that resembles the following. <add key="IntegrationFiscalYearStart" value="2009" /> 3. Change the year shown to the start fiscal year limit that you want to specify. For example, if you specify 2009, the Management Reporter reports will include data from fiscal year 2009 and later. 4. Save the changes to the MRServiceHost.settings.config file.
Drill to Dynamics
When drilling into Microsoft Dynamics SL the Microsoft Dynamics SL Account/Subaccount Detail Inquiry (01.303.00) screen is loaded based on the context of the report. With the provider the data passed to the screen used a period range specific to the report data. The adapter implementation uses the Management Reporter Data Mart Adapter, and that adapter passes data representing the range of fiscal periods from 01 to the reports base Fiscal Period. You may see different data loaded into the screen when you use Management Reporter 2012 RU5 and later versions and the data mart adapter.
Filtering on Dimensions
If any Microsoft Dynamics SL subaccounts are set up in Flexkey Definition (21.320.00) to allow for blank-filled segments, when you filter on that dimension in Management Reporter, you must use the word blank instead of spaces. For example, the subaccount used in a transaction is 00 -000- -00-000. If you want to use Management Reporter to filter on this third segment to locate this transaction, you can either type blank or select blank from the possible values list. The other possible values in
5 MANAGEMENT REPORTER INTEGRATION GUIDE FOR MICROSOFT DYNAMICS SL
this list contain the valid values for the segment specified in Flexkey Table Maintenance (21.330.00) and any values that were used in transactions.
1. Select Start the Configuration Console to continue, and then click Finish.
2. In the Task List pane, click the Update the Management Reporter database link, and then answer the prompts for credentials to run the update. For more information about credentials, see User Account Requirements on page 9. When the process is complete, the following confirmation message appears.
3. Click OK.
4. If your existing integration is a data mart integration, click the The integration to the data mart database datamartdatabasename' on server sqlservername needs to be updated link in the Task List pane. You receive the following message.
5. If your existing integration is a data mart integration or you want to switch from a legacy data provider integration to a data mart integration, you must remove the existing integrations. See the steps in the Remove an Integration topic on page 17. 6. Configure the data integration. See the steps in the Configure the Data Integration topic on page 10. Note: If you have multiple integrations for different companies from the same Microsoft Dynamics SL system database, each integration must be removed. All companies from the same Microsoft Dynamics SL system database will be integrated into one new data mart database when the integration is reconfigured.
System setup
Before you configure the Microsoft Dynamics SL data mart adapter, your system must meet the minimum requirements for Management Reporter 2012. For more information, see System requirements for Management Reporter. Additional prerequisites are listed here.
System Prerequisites
The following prerequisites must be met before the data mart adapter can be installed on your system: Management Reporter server components The Management Reporter application service or process service must be installed on the same computer(s) where the Microsoft Dynamics SL data mart adapter will be installed. To install these components, see the Management Reporter installation guide.
During the upgrade process, if SQL Server Change Tracking was currently not enabled, the Configuration Console resets the data mart for Microsoft Dynamics SL and performs the initial integration again. When you add a new company to an already integrated Microsoft Dynamics SL system database, you must reconfigure Change Tracking. In the Configuration Console for Management Reporter, highlight the integration, and then click the Reconfigure Change Tracking link.
Permissions required
Have an active user account in Microsoft Dynamics SL. Have Active Directory domain credentials (user ID and password) to log on to Microsoft Dynamics SL. Be a user assigned to the Administrator role. 9 MANAGEMENT REPORTER INTEGRATION GUIDE FOR MICROSOFT DYNAMICS SL
Management Reporter
You must set up user account permissions in Microsoft Dynamics SL before you configure Management Reporter services. When you configure the Management Reporter services, you must make sure that the account specified in the Log On properties for the service has sufficient access to the Microsoft Dynamics SL databases. For Windows Authenticated Microsoft Dynamics SL databases, set up a Microsoft Dynamics SL user who is associated with the Active Directory domain account that is used by the services. For SQL Authenticated databases use a domain account that has a SQL login already associated with it on the SQL Server that is hosting the Microsoft Dynamics SL databases. When you start Management Reporter 2012, you are prompted to log on to an existing company. Active Directory domain credentials are required. The provider and data mart adapter use these credentials to connect to Microsoft Dynamics SL databases. For more information, see How to create a domain account in Active Directory on MSDN (http://go.microsoft.com/fwlink/p/?LinkId=294717). After you have installed and fully configured Management Reporter, you can add users and change security permissions. For more information, see the Management Reporter Help documentation.
Note: The legacy data provider for Microsoft Dynamics SL will no longer be supported in future releases. We recommend that you use a data mart integration.
4. Click Next. 5. On the Prerequisite Validation page, review any failed prerequisites or warnings and resolve issues before you continue with the installation process. Click Revalidate to run the validation again. Note: If you do not use Microsoft Excel for reporting, you do not have to install the prerequisites associated with that feature. 6. On the Prerequisite Validation page, click Next. Note: This page closes automatically if there is nothing to review. 7. On the Settings page, specify the following settings: a. Dynamics SL System Database connection information section: i. In Database server, type the name of the Microsoft SQL server to which you want to connect. ii. If you use Windows Authentication, click to select the Use Windows authentication check box. If you use SQL Authentication, click to clear the Use Windows authentication check box, and then specify the User name and Password of the SQL server user. For more information, see User Account Requirements on page 9. iii. To use Secure Sockets Layer (SSL) for encryption, click to select the Encrypt connection check box. This encrypts the data that is transmitted between the instance of SQL server and Management Reporter 2012 services.
Note: You must configure SSL on the server and install certificates before you can use this option. For more information, see Encrypting connections to SQL server on MSDN (http://go.microsoft.com/fwlink/p/?LinkId=294718). iv. In Database, select the Microsoft Dynamics SL system database to which you want to integrate. b. Data Mart connection information section: c. Database server The server where the data mart database is located. User name and password of the account that is used to create the data mart database. Select Use Windows authentication to use your current credentials. Database The name of the data mart database to which you want connect.
Click Next. You may be prompted to provide credentials that have sufficient permissions to enable SQL Server Change Tracking, such as a user who has a role of db_owner or a system administrator.
9. When the legacy data provider or data mart adapter is successfully configured, click Close.
10. To integrate with another Microsoft Dynamics SL system database, repeat steps 1 through 9. To integrate with another ERP system, see the integration guide for that system. 11. After you configure all integrations, you must enable the integrations.
2. In the navigation pane of Management Reporter 2012 Configuration Console, expand Management Reporter Services, and then expand ERP Integrations. Select the integration from which you want to import companies.
3. In the display pane, click Enable Integration. 4. The integration of data begins. Information will change on the screen. The values next to the titles Last time everything was fully integrated and Last time an integration occurred will change. When the information displays a date and time, the initial integration is completed. This includes the import of the companies. Note: If either of these labels are not updated, verify that the application service and the process service are running.
5. When everything is fully integrated, click the Companies node, and then click Refresh Companies.
Note: The imported companies are listed in the navigation pane of Management Reporter 2012 Configuration Console, in the Companies node under Management Reporter Services. 6. Close Management Reporter 2012 Configuration Console.
After you successfully import companies, install the Management Reporter 2012 client components. For more information and installation procedures, see the Management Reporter installation guide.
Remove an Integration
To remove an existing integration, use the Management Reporter 2012 Configuration Console.
1. Open the Management Reporter 2012 Configuration Console. 2. Expand Management Reporter Services, and then expand ERP Integrations. 3. Click to select the integration that you want to remove. 4. On the right side, click Remove and then confirm that you want to remove the integration. 5. When the removal is complete, the integration is removed from the ERP Integrations list.
3. In the display pane, click Import. 4. Enter the user name and password of a user account in Microsoft Dynamics SL. For more information, see User Account Requirements on page 9. 5. Review the list of available companies. If a company has already been imported, Already imported will be selected. To not import a company, select Skip import. 6. Click Import companies. 7. If you import a company that has the same name and code as an existing company, a message is displayed that asks whether you want to overwrite the existing company information. To overwrite the company information, click Yes. Or, click No to cancel the import. To continue the company import, you must select Skip import for the existing company, and then click Import companies again. 8. When a message is displayed that indicates that the companies were successfully imported, click OK. 9. To view a list of imported companies, click Companies under the Management Reporter Services node in the navigation pane. The Integrated check box is selected for companies that were imported successfully through a data mart integration. The Integrated check box is cleared for companies that were imported through a legacy data provider integration.
4. If you use the legacy data provider, consider the following: If you use Windows authentication, click to select the Use Windows authentication check box, specify the Windows user name (defaults from the currently logged in Windows user, in the domain/username format) and the Windows user password. If you use SQL authentication, click to clear the Use Windows authentication check box, specify the Microsoft Dynamics SL user name and password. These credentials must match the credentials stored in the Microsoft Dynamics SL database.
5. Click Close.
Appendix
Available Attributes
The following attributes are available when you create reports from Management Reporter 2012.
Account Type
Acct_Cat - Account Category AcctType - Account Type Active - Account Active Status ClassID - Account Class ID ConsolAcct - Account Consolidation Account RatioGrp - Account Ratio Group UnitofMeas - Account Unit of Measure User1 - Account User 1 User2 - Account User 2 User3 - Account User 3 User4 - Account User 4 User5 - Account User 5 User6 - Account User 6 User7 - Account User 7 User8 - Account User 8
Transaction Type
20 MANAGEMENT REPORTER INTEGRATION GUIDE FOR MICROSOFT DYNAMICS SL
Balance Type - Transaction Balance Type BatNbr - Transaction Batch Number CpnyID - Transaction Company ID CrAmt - Transaction Credit Amount CuryCrAmt - Transaction Currency Credit Amount CuryDrAmt - Transaction Currency Debit Amount CuryEffDate - Transaction Currency Effective Date CuryId - Transaction Currency ID CuryMultDiv - Transaction Currency Operation CuryRate - Transaction Currency Rate CuryRateType - Transaction Currency Rate Type DrAmt - Transaction Debit Amount Employee ID - Transaction Employee ID JrnlType - Transaction Journal Type Labor_Class_Cd - Transaction Labor Class LineRef - Transaction Line Reference
Module - Transaction Module OrigAcct - Transaction Originating Account OrigBatNbr - Transaction Originating Batch Number OrigCpnyID - Transaction Originating Company ID OrigSub - Transaction Originating Sub Acct PC_Flag - Transaction PC Flag PC_ID - Transaction PC ID PC_Status - Transaction PC Status PerEnt - Transaction Period Entered ProjectID - Transaction Project ID Qty - Transaction Quantity RefNbr - Transaction Reference Number TaskID - Transaction Task ID GLTranDate - GL Transaction Date TranType - Transaction Type Units - Transaction Units TranUser1 - Transaction User 1 TranUser2 - Transaction User 2 TranUser3 - Transaction User 3 TranUser4 - Transaction User 4 TranUser5 - Transaction User 5 TranUser6 - Transaction User 6 TranUser7 - Transaction User 7 TranUser8 - Transaction User 8
Reporting When the Last Two Periods End on the Same Date
If the last two periods of your fiscal year end on the same date, the data for these two periods is combined and reported as the first of the two periods. For example, you have set up period 12 and period 13 so that both periods end on 12/31. All data for these two periods is reported as period 12 data and period 13 data is recorded as adjustments to period 12. If you want to separate the data for the two periods, you must use column restrictions when you create Column Definitions. A Column restriction of ADJ reports just the adjustments to that period. A Column restriction of XAD reports the data with the adjustments removed.
The following sections provide additional information about the Microsoft Dynamics SL data mart adapter.
Supported Attributes
You can select attribute filters to include additional account and transaction information on reports in Management Reporter. Select attributes to filter in row or column definitions and to display in the columns. See Management Reporter Help documentation for more information about filters in attributes.