How to: Import a .NET Assembly Transform

Important

This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

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

This topic shows you how to import a .NET assembly in Microsoft Dynamics AX. After you import the assembly, you can use the transformation components that it contains in the Application Integration Framework (AIF) pipeline. The transformation components are classes within the assembly that implement the ITransform interface. These classes perform processing on requests that come into or go out of the AIF pipeline. For more information about creating a .NET assembly transform, see Walkthrough: Creating a .NET Assembly Transform.

Importing the .NET Assembly

In this section you import the .NET assembly transform so you can use it in the AIF pipeline.

Security noteSecurity Note

You must be logged into Windows Server as an administrator to add a new transform.

To import the .NET assembly

  1. Copy the assembly file (DLL) to the server bin directory. This directory varies depending on your installation, but it may be named something like C:\Program Files\Microsoft Dynamics AX\60\Server\MicrosoftDynamicsAX\Bin.

  2. Copy the assembly file (DLL) to the client bin directory. This directory varies depending on your installation, but it may be named something like C:\Program Files\Microsoft Dynamics AX\60\Client\Bin.

  3. Open Microsoft Dynamics AX and type CTRL+SHIFT+W to open a new development workspace.

  4. Select Tools > Application Integration Framework > Manage transforms.

  5. In the Manage transforms form, type CTRL+N to add a new transform.

  6. In the Name field, enter a unique name of up to 30 characters.

  7. In the Description field, enter a description of the transform of up to 1,000 characters.

  8. In the Type field, select .NET Assembly.

  9. Click Load, navigate to the assembly that you copied to the client bin directory, and then click Open.

  10. In the Class field, select the class in the assembly that contains the transform you want to import.

  11. Type CTRL+S to save the transform.

Warning

We do not recommend adding multiple instances of the same .NET assembly to the Manage transforms form by using a different name for each instance. When multiple instances of the .NET assembly are listed in the form, each instance refers to the same .dll file. Changes to the .dll file will affect all ports that reference the transform, regardless of the name of the transform in the Manage transforms form.

After you have imported the transform, you may add a new class to the assembly or change the code in an existing assembly class. For more information about how to import updated assemblies, see Importing Updated .NET Assembly Transforms.

See also

About the AIF Pipeline and Transforms

Walkthrough: Creating a .NET Assembly Transform

Importing Updated .NET Assembly Transforms