dynamicsaxbi: Known Issue: Relative path errors when using version control

[Blog bot]

Источник: http://blogs.msdn.com/b/dynamicsaxbi...n-control.aspx
==============

Microsoft Dynamics AX 2012



OBSERVATIONS

• Relative path errors occurring in customer deployments when referencing shared assemblies
• Customers use a version control system like TFS to manage developer customizations
• Errors occur when developer customizations are ported into stabilization/production environment

OVERVIEW

Unlike classes, forms, & queries, compiled C# assemblies cannot be merged across layers. Instead, compiled assemblies are stored in layer specific locations. With the version of the assembly located in highest layer being the one which is ultimately deployed to the SSRS server.

Figure #1 – illustrates management of C# assemblies *without* customizations



In the above example, the C# assembly (“Report.DLL”) includes a direct reference to the shared assembly that resides in the SYS layer. The direct reference to the shared assembly can only be resolved during run-time execution if they both reside in the same layer during compilation of the project. When customizations are made to C# business logic assemblies the layer management code kicks in promoting the object into a higher layer. However, when a version control system like TFS is used to manage environment updates the relocation of the shared assembly into the higher layer will be ignored if where the shared assembly is NOT also included in the source control project. The result is an inability for the customized C# assembly to resolve the reference to the shared library (“Shared.DLL”).

Figure #2 – error caused by promotion of C# assembly into the USR layer due to customizations



RESOLUTION

Essentially, you’ll need to promote the shared library into the USR layer to support the direct references. This can be achieved by simply adding the shared assembly to the customer’s source control project. In the case of TFS, select the shared assembly located in AOT under Visual Studio Projects\C Share Projects, right+click the node, and select Add to Source Control. This will copy the shared assembly into the USR layer thus enabling the customized report assembly to resolve the direct reference during run-time execution.

Figure #3 – including shared assembly in source control elevates object into the USR layer



NOTES

• Existing report projects containing references to the shared assembly will NOT be affected by this change.
• You do NOT need to make any modifications to the shared assembly when adding it source control.

Источник: http://blogs.msdn.com/b/dynamicsaxbi...n-control.aspx