dax-lessons: Generate XML Documentation Files for a project - DAX 2009

[Blog bot]

Источник: http://DAX-Lessons.spaces.live.com/B...FCD1!172.entry
==============


To generate XML documentation files for a project

1. 
   Open the Projects form by pressing CTRL+SHIFT+P.
2. 
   Right-click the project for which you want to create XML documentation files, point to Add-Ins, and then click Extract XML documentation.
3. 
   Select the Documentation check box if you want to create a documentation file for the project.The documentation file contains the documentation from the header templates in the source code
4. 
   Select the Reflection check box if you want to create a reflection file for the project.The reflection file contains reflection information about all the classes, tables, methods, data types, and base enumerations in the current layer
   In the File name fields, specify the destination of each file.

You can generate these XML files for a project or for the entire application. XML files for a project are generated by using a command in Microsoft Dynamics AX. XML files for the entire project are generated by using the command prompt. Generating XML files for the entire application can take a long time, depending on how much documentation has been written in the code

To generate XML documentation files for the entire application

Create a folder in which you will create the XML documentation files. This procedure will reference a folder that has the path, C:\XMLDoc.

Note: For security purposes, you may not be able to create XML documentation files directly on the root of a drive.

At the command prompt, execute the following command to create a documentation file for the entire application: Ax32.exe -startupcmd=xmldocumentation_C:\XMLDoc\documentation.xml

At the command prompt, execute the following command to create a reflection file for the entire application:
 Ax32.exe -startupcmd=xmlreflection_C:\XMLDoc\reflection.xml

Note :When you use these commands, Microsoft Dynamics AX will automatically start and create the XML files. Microsoft Dynamics AX will automatically close when it finishes.





Источник: http://DAX-Lessons.spaces.live.com/B...FCD1!172.entry