Import Form

  • Article

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

Use this form to import application objects that were previously exported from a Microsoft Dynamics AX installation.

All objects in the file that you specify are selected for import by default.

To cancel the selection of some objects, open the tree by selecting the Show details check box. Expand the branches in the tree, and then clear the check box next to the object you want to exclude from the import. When you select a top node, all subnodes are also included.

The names of objects that already exist in the Application Object Tree (AOT) appear in bold in the import tree.

Note

Objects are always imported into the current model in the current application object layer.

The following tables provide descriptions for the controls in this form.

Buttons

Button

Description

Browse

Find the name and location of the export file. Click the button to open the Windows Browse dialog box, where the export file (.xpo) is located.

The file name list, displayed by clicking the arrow at the end of the file name field, contains the five most recently used export files. When you select the file, you can also select options for how to import the file.

Fields

Field

Description

Only application objects

Activate all options except the Create labels in the label file option.

Application objects and labels

Activate all options.

Only labels

Activate only the Create labels in the label file option.

Show details

Open an additional part of the form.

The Import from tab contains a list of all objects within the file that is imported. If objects are not selected in the tree on the Import from tab, labels that belong to these objects are not imported.

When the actual import starts, labels are imported first. If labels are found that conflict with existing labels, a separate form opens to display the conflict and the action to take.

The following three action options are available:

Action

Description

Skip

Do not import the label.

Overwrite

Overwrite the existing text with the imported text.

Create new

Creates a new label and substitute it in the AOT objects that are going to be imported.

When you click OK, the labels are imported, and a list of new labels that were created as a result of the third option above is generated. This list is passed on to the kernel, which subsequently replaces the IDs.

If an attempt is made to import tables that already exist, you will be prompted to specify whether the table should be overwritten in the AOT.

Delete sub-elements

Delete sub-elements in the AOT that are not present in the import file.

This check box is activated when you select Only application objects or Application objects and labels. This option only affects tables and classes. For other application object types, the check box is always implicitly selected and these object types will always be overwritten.

Example

The import file holds a class, MyClass, with the methods A, B, and C.

The AOT also holds a class, MyClass, but this class has methods A, B, C, and D.

When the Delete table and class members check box is selected, method D is deleted as part of the import. If not selected, the D method still exists after the import.

Create labels in the label file

This option is selected when you select the Application objects and labels option or Only labels option. Select the label file ID from the drop-down list. The default layer is SYS.

Enable data recovery for tables with changed IDs

Enable data recovery for tables with IDs that have been changed.