Adding product information

Before you can use your extracted application dictionary with Microsoft Dynamics GP in a multidictionary environment, you must add product information to your dictionary using the Product Information utility.

Once you add product information to your dictionary, you can update the launch file with the same product information, either by editing the launch file manually, or by updating the launch file using a chunk dictionary. This gives the Microsoft Dynamics GP runtime engine the information necessary to open your application in a multidictionary environment. The following illustration shows a launch file configured so Microsoft Dynamics GP and the sample integrating application run in a multidictionary environment.

Microsoft Dynamics GP
Sample Integrating App.
:C:Dynamics GP/Dynamics.dic
:C:Dynamics GP/Data/Forms.dic
:C:Dynamics GP/Data/Reports.dic
:C:Dynamics GP/Develop.dic
:C:Dynamics GP/Data/F3333.DIC
:C:Dynamics GP/Data/R3333.DIC

Use the following steps to add product information. Open your extracted dictionary as an editable dictionary, then choose Product Information from the Utilities menu to open the Product Information window.


  1. Select a launch file.

Enter the name of the Microsoft Dynamics GP launch file in the Launch File field. Usually, this name is “DYNAMICS.SET”. When installed with Microsoft Dynamics GP, the chunk file adds product information to this launch file.

  1. Enter a launch ID.

Accept the default launch ID of 0. This is the product ID for the main application. Microsoft Dynamics GP has a product ID of 0 and each is the main application in a multidictionary environment.

  1. Enter a product name.

Enter the name of your application in the Product Name field as you want it to appear when running with Microsoft Dynamics GP.

  1. Enter a product ID.

Enter the product ID for your application in the Product ID field. Each product must have a unique product ID assigned to avoid conflicts with other integrating applications. Contact Microsoft to obtain a product ID for your application.

  1. Enter the names of your forms and reports dictionaries.

Enter the name of the forms and reports dictionary for your application in the Forms Dictionary and Reports Dictionary fields. You can enter an eight-character name with a three-character extension. Use the .DIC extension. These are the dictionary names used when the runtime engine creates your application’s forms and reports dictionaries for the first time.

To avoid conflicts with forms and reports dictionaries from other integrating applications, include your product ID in the name. For example, the forms dictionary for the sample integrating application is F3333.DIC.

  1. Enter the compatibility ID and compatibility message.

The Compatibility ID is a string that uniquely identifies the version of your application. When you launch your application with the runtime engine, the compatibility ID in the application dictionary is compared to the compatibility IDs in the forms and reports dictionaries. If they match, items in the forms and reports dictionaries can be accessed.

The compatibility message is the message that is displayed when the compatibility IDs in the forms or reports dictionaries don’t match the compatibility ID in the application dictionary. You should provide information in this message describing how to update your forms and reports dictionaries to make them compatible with the current version of your application. For applications that integrate with Microsoft Dynamics GP, this typically means performing a form and report update operation with GP Utilities. Once you’ve finished entering product information, click OK.

Documentation Feedback