How to: Create the Cross-Reference System

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

The cross-reference system is a collection of tools you use to create and view information about the relationships between objects in the AOT. For example, you can use the cross-reference system to identify objects that get used by a specified form and the objects that use that form. To create and maintain cross-reference information, you first have to complete the following tasks:

  • Configure the cross-reference system.

  • Update the cross-reference data.

The following sections describe how to complete these tasks. For information about how to view cross-reference data, see Viewing the Cross-Reference System Information.

To configure and run a manual update

The following steps describe how to configure the cross-reference system and then start a manual update.

  1. In the development workspace, open the Tools menu, and then click Cross-reference > Periodic > Update. The Update cross-reference window appears.

  2. Use the Update cross-reference window to configure the type of cross-reference data that you want to view. The following table describes the fields and controls you use to configure the cross-reference system:


    Control type




    Opens the Inquiry window. You use this window to specify the date and time and the application model record types for the update.

    Delete all

    Check box

    Removes existing cross-reference information.


    Check box

    Updates specified cross-reference information. To specify the types to cross-reference, click the Select button.

    Update all

    Check box

    Updates all cross-reference information.

    Update data model

    Check box

    Updates cross-reference information that is used by the Reverse Engineering tool.

    Modified date and time

    Text box

    Shows the date range for the update. To change the date range, click the Select button.

    Record type

    Text box

    Shows the record types from the application model that you want to update. To change record types, click the Select button.

  3. Click OK to save your changes and start the update. Click Cancel to close the window without starting the update and remove any changes that you made.

To configure automatic updates

To help maintain cross-reference data, you can configure the compiler to update the cross-reference system. The automated update occurs when you compile an object in the AOT.


You can also manually update cross-reference data for a single object in the AOT. To complete the update, right-click the object, point to Add-Ins, point to Cross-reference, and then click Update. The cross-reference data for that object is updated.

To configure automatic updates, follow these steps:

  1. In the development workspace, open the Tools menu, and then click Options.

  2. In the Options window, click the Development link on the left side of the window.

  3. In the Set up option for the development workspace form, click the Compiler button.

  4. In the Compiler setup window, select Cross-reference. The cross-reference check box specifies whether the compiler updates cross-reference data during compilation.

    For information about the other fields in the Compiler setup window, see Compiler Setup Form.

  5. Click OK to save your changes and close the window.

See also

Cross-reference Tool

How to: Schedule Cross-references Without a Batch

Announcements: New book: "Inside Microsoft Dynamics AX 2012 R3" now available. Get your copy at the MS Press Store.