Visual Studio® Tools for Microsoft Dynamics® GP 2013 Programmer’s Guide Copyright Copyright © 2012 Microsoft Corporation. All rights reserved. Limitation of liability This document is provided “as-is”. Information and views expressed in this document, including URL and other Internet Web site references, may change without notice. You bear the risk of using it. Some examples depicted herein are provided for illustration only and are fictitious. No real association or connection is intended or should be inferred. Intellectual property This document does not provide you with any legal rights to any intellectual property in any Microsoft product. You may copy and use this document for your internal, reference purposes. Trademarks Microsoft, Dexterity, Microsoft Dynamics, Visual Basic, Visual Studio, Windows, Windows Server, and Windows Vista are trademarks of the Microsoft group of companies. All other trademarks are property of their respective owners. Warranty disclaimer Microsoft Corporation disclaims any warranty regarding the sample code contained in this documentation, including the warranties of merchantability and fitness for a particular purpose. License agreement Use of this product is covered by a license agreement provided with the software product. If you have any questions, please call the Microsoft Dynamics GP Customer Assistance Department at 800-456-0025 (in the U.S. or Canada) or +1-701-281-6500. Publication date July 2012 Contents Introduction ................................................................................................................................................. 2 What’s in this manual...................................................................................................................................2 Prerequisites...................................................................................................................................................2 Symbols and conventions ............................................................................................................................3 Product support ............................................................................................................................................3 Part 1: Getting Started ................................................................................................................. 6 Chapter 1: SDK Installation ........................................................................................................ 7 Installation procedure ..................................................................................................................................7 Template registration....................................................................................................................................8 What was installed........................................................................................................................................9 Upgrading to a newer Visual Studio..........................................................................................................9 Chapter 2: Integration Basics..................................................................................................11 What Visual Studio Tools provides .......................................................................................................... 11 Architecture ................................................................................................................................................. 11 Creating a project ........................................................................................................................................12 Chapter 3: Upgrading an Integration .............................................................................. 15 Upgrading from Release 9 .........................................................................................................................15 Upgrading from Release 10 or later .........................................................................................................20 Part 2: Developing Integrations ................................................................................... 24 Chapter 4: WinForms...................................................................................................................... 25 Adding a Dynamics GP form to a project ...............................................................................................25 WinForm properties....................................................................................................................................26 Adding controls...........................................................................................................................................27 Chapter 5: Control Reference ................................................................................................ 29 Buttons..........................................................................................................................................................29 TextBoxes......................................................................................................................................................31 Labels............................................................................................................................................................32 ComboBoxes ................................................................................................................................................32 ListBoxes ......................................................................................................................................................32 Chapter 6: Dictionary Assembly Generator .............................................................. 33 Creating application assemblies ...............................................................................................................33 Output files ..................................................................................................................................................33 Using the Dictionary Assembly Generator .............................................................................................34 Optimizing the assembly generating process.........................................................................................36 Chapter 7: Accessing Dictionary Resources ............................................................ 37 Adding references.......................................................................................................................................37 Namespace...................................................................................................................................................38 Dictionary class ...........................................................................................................................................38 PROGRAMMER’S GUIDE i CONTENTS Accessing additional resources.................................................................................................................39 Variables for dictionary resources ............................................................................................................39 Chapter 8: Events .............................................................................................................................. 41 Registering events.......................................................................................................................................41 Responding to events .................................................................................................................................43 Unregistering events...................................................................................................................................44 Chapter 9: Working with Tables........................................................................................... 47 Tables in Microsoft Dynamics GP.............................................................................................................47 Table buffers.................................................................................................................................................48 Opening and closing tables .......................................................................................................................49 Keys...............................................................................................................................................................50 Retrieving a row..........................................................................................................................................50 Saving a row ................................................................................................................................................51 Updating a row ...........................................................................................................................................52 Removing a row ..........................................................................................................................................53 Table operation errors ................................................................................................................................54 Ranges...........................................................................................................................................................55