Before you can use a dictionary with the runtime engine, you must use the Product Information utility to add product information to the dictionary. Product information is used when the launch file for the application is created. If dictionaries don’t have product information, the launch file created won’t contain the appropriate information about the main product dictionary and any additional dictionaries being accessed.
If you’re developing applications that integrate with Microsoft Dynamics GP, that is the main product.
To begin entering product information, open an editable dictionary (the dictionary you’re entering product information for), then choose Product Information from the Utilities menu to open the Product Information window.
Enter the name of the launch file in the Launch File field. The name is limited to eight characters plus a three-character extension. The name should have the .SET extension.
If you’re entering product information for the main product dictionary, this name is the default name the launch file will be given when it’s created. If you’re entering product information for an integrating dictionary, this should be the name of the launch file for the application you’re integrating with.
Enter the launch file ID in the Launch ID field. The launch file ID is an integer that uniquely identifies the launch file. If you’re entering product information for the main application dictionary, the launch file ID should be the same as the product ID for the dictionary. If you’re entering product information for an integrating dictionary, the launch file ID you use should be the same as the launch file ID for the application you’re integrating with.
In the Product Name field, enter the complete name of the product. This name can be displayed in your application while it is running. For example, if your product integrates with Microsoft Dynamics GP, the product name you enter here will appear in various parts of the application.
Enter the product ID of your application in the Product ID field. A product ID is an integer that uniquely identifies your product. You obtain a product ID by registering your product with Microsoft Business Solutions. Products should be registered so they each have a unique product ID. This minimizes the possibility of conflicts between different Dexterity applications. If you’re entering product information for the main application, the product ID must be the same as the launch file ID.
In the Forms Dictionary and Reports Dictionary fields, enter the names for the forms and reports dictionaries. These are the names the forms and reports dictionaries will be given when they’re created for the application. The names are limited to eight characters and should have the .DIC extension.
You must provide names for the forms and reports dictionaries, even if the Modifier and Report Writer won’t be used in your application. Otherwise, the launch file won’t work properly.
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 with 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 main 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. Refer to Updating an Application for more information about updating forms and reports dictionaries.
When you click OK, the information entered will be saved in the dictionary. When the dictionary is installed, the product information will be added to the launch file.