Creating an alternate report involves changing table relationships for the report prior to making actual changes to the report layout. This is necessary if you use a third-party table with the Microsoft Dynamics GP report. Changing table relationships ensures that the alternate report retains all associated table relationships once you’ve transferred it to your application dictionary using Dexterity Utilities.
To create an alternate report, complete the following steps.
Open your development dictionary using Dexterity and display the report definition for the report you’re customizing.
Note the main table and the table’s first key. For the sample alternate report, this information is in the following table:
Main table |
RM_Customer_MSTR |
Key |
RM_Customer_MSTR_Key1 |
Use the Duplicate Utility in Dexterity to duplicate the main table for the report you selected in step 1. Be sure you rename the duplicate table differently from the original table. In the sample alternate report, the duplicate table is IG_Customer_MSTR.
Main table |
RM_Customer_MSTR |
Duplicate table |
IG_Customer_MSTR |
Open the Table Definition window for the table you duplicated in step 2 and change its display name so the name isn’t the same as the original table.
Duplicate table |
IG_Customer_MSTR |
Display name |
IG Customer Master |
Click Relationships to open the Table Relationship window, then click New. Using the Table Relationship Definition window, define a relationship between the duplicate table and the main table.
Once you’ve defined the relationship for the duplicate table and original table, define additional relationships between the duplicate table and any third-party tables you want to add to the relationship.
Since the sample alternate report displays contact history information, an additional relationship must exist between the duplicate (primary) table (IG_Customer_MSTR) and the secondary third-party table (IG_Contact_History_MSTR).
Primary table |
IG_Customer_MSTR |
Secondary table |
IG_Contact_History_MSTR |
Secondary table key |
IG_Contact_History_MSTR_Key1 |
Relationship type |
One Record |
Once you’ve finished creating relationships, close the Table Relationship Definition, Table Relationship, and Table Definition windows.
Open the Report Definition window for the report you want to customize and click Tables to display the Report Table Relationships window. Note all the report table relationships that exist for the main table. For the sample alternate report (RM Customer Report), the relationships look like the following:
After you’ve noted the report table relationships, close the Report Table Relationships window.
In the Report Definition window, switch the main table for the report from the original table to the duplicate table. A message will appear asking whether you want to change the main table. Click OK. For the sample alternate report, the duplicate table (IG_Customer_MSTR) replaces the original main table (RM_Customer_MSTR).
Click the Tables button and use the Report Table Relationships window to add the table relationships you noted in step 5. For the sample alternate report, relationships must exist for the following tables:
In addition, create new report table relationships for any third-party table(s) you related to the duplicate table in step 4. In the sample alternate report, a new report table relationship for the third-party table IG_Contact_History_MSTR exists for the RM Customer Report. When finished, the report table relationships for the sample RM Customer Report look like the following:
Once you’ve created the report table relationships, close the Report Table Relationships window.
In the Report Definition window, click Layout and make changes to the report layout by adding fields from the third-party table(s) you created report relationships for in step 7.
Once you’ve made all your changes, test the report in a test mode environment. To do this, simply print the report as you normally would. To test the report in a multidictionary environment, follow the instructions in the following section.
Use the following utilities in Dexterity Utilities to build your application dictionary and test alternate reports in a multidictionary environment:
|
Step |
Description |
|
1 |
Extract new third-party resources using the Extract utility. |
|
2 |
Transfer alternate reports using the Transfer Dictionary Module utility. |
|
3 |
Add product information using the Product Information utility. |
|
4 |
Update series resources for reports using the Series Resources utility. |
|
5 |
Create an installation file using the Auto-Chunk utility, and install it with an unmodified Microsoft Dynamics GP dictionary. |
Refer to Packaging Your Application, for information about using Dexterity Utilities to package and install an application in a multidictionary environment.