This procedure describes how to transform a MenuSuite object from the Classic client to a MenuSuite object that you can use in the RoleTailored client.

Before you begin this procedure, you must do the following:

To transform the MenuSuite object

  1. In the Classic client, on the Tools menu, click Object Designer.

  2. In Object Designer, click MenuSuite, and then select the MenuSuite object that you want to transform.

  3. To export the existing MenuSuite object from Object Designer to a text file, on the File menu, click Export.

  4. In the Export Objects window, select the location where you want to export the MenuSuite object. We recommend that you export the object to the same folder where the Microsoft.Dynamics.Nav.Tools.FormTransformation.exe file and the transformation input files reside.

  5. In the Save as type drop-down list, select Text Format (*.txt).

  6. Specify the name of the file, such as navigationpane.txt, and then click OK.

  7. In Object Designer, select Form, select form 177000, Transformation Forms, and then click Run.

  8. In the Transformation Forms window, click Functions, and then click MenuSuite Transformation.

  9. In the MenuSuites window, click Functions, and then click Import to import the navigationpane.txt file into the TIF Editor.

  10. In the Open File window, select the navigationpane.txt file that you created in step 6, and then click Open.

  11. Click Functions, and then click Show Menu to display all objects in the suite and their properties. After you review the objects in the suite, close the MenuNodes window.

    The following figure shows the MenuSuite objects in the TIF Editor.

  12. To transform the MenuSuite, in the MenuSuites window, click Functions and then click Make Suggestion. In the dialog box, click Yes to confirm.

    The following table describes the behavior when you create a suggestion from a MenuSuite object, such as 10 MBS. The source Classic MenuSuite object is never overwritten.

    RoleTailored client MenuSuite object exists Result Example

    No

    New RoleTailored client MenuSuite object created

    1010 MBS created

    Yes

    RoleTailored client MenuSuite object is overwritten with data from the TIF Editor and Microsoft Dynamics NAV Developers Toolkit

    1010 MBS overwritten with new data

  13. In the MenuSuites window, click Functions, and then click Validate to verify the result and find additional actions that you will need to take to modify the transformed MenuSuite object. The BadLink column specifies objects that are not in the database. The Comment column specifies menu items that you must delete manually, such as ignored forms or dataport objects. You will make the required modifications in Navigation Pane Designer after you export the transformed MenuSuite object.

  14. Click Functions, and then click Show Menu. In the Menu Nodes window, note that the following new properties have been added to the items in the MenuSuite:

    • IsDepartment

    • RunObjectType

    • DepartmentCategory

    • New RunObjectID

    If IsDepartment is cleared, then the menu item is a group heading only.

    If IsDepartment is selected, then the menu item or group is a link.

    Card pages are now replaced with list pages as the first access point when accessed from the navigation. This is specified in the Menu Nodes window by the New RunObjectID column, which references a list object, and the Department Category column, which specifies Lists.

  15. To export the new MenuSuite object from the TIF Editor to an object text file, in the MenuSuites window, click Functions, and then click Export.

  16. In the Save File window, select the location where you want to export the new MenuSuite object. We recommend that you export the object to same folder where the Microsoft.Dynamics.Nav.Tools.FormTransformation.exe file and the transformation input files reside.

  17. In the Save as type drop-down list, select Text Format (*.txt).

  18. Specify the name of the file, such as departments.txt, and then click Save.

  19. To import the new Departments MenuSuite object, in Object Designer, click MenuSuite, click the File menu, and then click Import.

  20. In the Import Objects window, browse to the location where you created the departments.txt file.

  21. In the Files of type drop-down list, select Text Format (*.txt).

  22. Select departments.txt, and then click Open.

  23. In Object Designer, select the new MenuSuite object, and then click Design. Make any modifications that were specified when you validated the MenuSuite object in step 13, such as deleting ignored forms or dataport objects.

  24. In Object Designer, select the new MenuSuite object, click the Tools menu, and then click Compile. Click Yes to confirm compilation.

  25. To view the transformed MenuSuite object, open the RoleTailored client and then select the Departments page. Verify whether you need to update the Departments page. For example, you may want to move items to other folders, delete folders, or change categories. For more information, see How to: Create and Modify a MenuSuite Object.

See Also