Подключение .Net-библиотеки в Dynamics AX 2012

Казалось бы, минутное дело – добавить в Dynamics AX ссылку на стороннюю .Net-сборку. Но если предполагается, что библиотека будет использоваться на стороне сервера, просто добавить ссылку в AOT недостаточно. Работать она не будет.  Чтобы сэкономить ваше время, дальше в этой статье можно найти пошаговое решение этой задачи.

1. Проверьте что установленная на клиенте и сервере версия Microsoft.NET Framework не старше той версии, для которой сделана сборка. Сделать это можно разными способами. Например, с помощью редактора реестра найти ветку HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft\NET Framework Setup\NDP\. Вложенные в нее элементы соответствуют установленным версиям платформы.
2. Дальше необходимо скопировать вашу библиотеку туда, где Dynamics AX ее найдет. Для клиентского приложения это может быть папкаC:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin\

   Для сервера библиотека должна быть скопирована на компьютер, где установлен AOS. Например, в папку

   C:\Program Files\Microsoft Dynamics AX\60\Server\MicrosoftDynamicsAX\bin\

   Обратите внимание, что разрядность клиентского и серверного приложения отличаются!

3. Теперь нужно зарегистрировать сборку в глобальном кэше сборок (Global Assembly Cache или GAC). Регистрация нужна для работы библиотеки на стороне сервера, поэтому она должна выполняться в той операционной системе, где установлен AOS. Для регистрации сборки нужна будет утилита gacutil, которая идет в комплекте с Visual Studio. Если на серверной машине Visual Studio не установлен, можно скопировать файлы, необходимые для работы gacutil с другого компьютера, где VS установлена. Нужные вам файлы можно будет найти примерно по такому пути:C:\Program Files (x86)\Microsoft SDKs\Windows\v8.1A\bin\NETFX 4.5.1 Tools\x64\

   Для работы gacutil нужны файлы gacutil.exe, gacutil.exe.config и библиотека gacutlrc.dll, которая расположена во вложенной папке \1033

   Далее запустите командную строку от имени администратора. С помощью команды cd перейдите к расположению файлов утилиты gacutil. И для регистрации сборки выполните следующую команду:

   gacutil -i Полное_имя_сборки

   Если регистрация прошла успешно, утилита должна показать сообщение «Assembly successfully added to the cache».

4. При успешном добавлении сборки в GAC, она должна появиться в списке доступных сборок в диалоге добавления новой ссылки в AX:Выберете нужную библиотеку и добавьте ссылку на нее.
5. И наконец после добавления новой ссылки нужно перезапустить AOS.

Это все! Удачи и интересных проектов!