Alternate forms

Alternate forms are forms from the core Dynamics dictionary that have been changed by a third-party developer, and are stored in a third-party dictionary. The new and changed resources for the alternate form are accessed through the third-party application's application assembly. To access alternate forms from you Visual Studio Tools for Microsoft Dynamics GP project, complete the following procedure:

1. Create an application assembly for the third-party dictionary.

   If the third-party dictionary doesn't already have an application assembly, create one using the process described in Dictionary Assembly Generator. For example, the following command creates the application assembly for the Sample Integrating Application, to which an alternate form (PM Vendor Maintenance) was added for this example:

   dag.exe 3333 "C:\Program Files\Microsoft Dynamics\GP\Dynamics.set" /M
   

2. Add the reference to the application assembly for your project.

   In Visual Studio, add the reference to the application assembly. The following illustration show the reference added for the application assembly that provides access to the alternate forms in the Sample Integrating App application.

   

3. Access the alternate forms.

   Alternate forms are accessed through the dictionary class for the assembly that contains them. For instance, the alternate forms in the Sample Integrating App application would be accessed through its dictionary class:

   SampleIntegratingApp

The following C# code sets the value of a new field on the Vendor Maintenance window of the alternate version of the Vendor Maintenance form, which is part of the Sample Integrating App dictionary. The new field is a local field named "Test".

SampleIntegratingApp.Forms.PmVendorMaintenance.PmVendorMaintenance.LocalTest.Value = "Alternate Field";