Creating a MAX Technical Report to Document Configuration Information

Updated Aug 3, 2018

Reported In

Software

  • Measurement and Automation Explorer (MAX)
  • LabVIEW

Issue Details

How can I generate a document with a list of all installed NI software versions on my computer or remote system?

Solution

Create Report Using NI Measurement & Automation Explorer (MAX)

  1. Launch the MAX Report Wizard by selecting File»Create Report:
  2. Choose My System to create a report for the development computer or choose a remotely connected systems to create a report specific for a remote system:
  3. ​ There are three types of HTML reports that you can generate:
    • Simple Report: A simple report which consists of just the MAX configuration tree item names and icons.
    • Custom Report: A custom report in which you can select the items you want to document and receive a more detailed report for those items.
    • Technical Support Report: Choose this option if you are working with NI technical support on an issue, and you need to send in your MAX Report to provide more detailed information about your setup, including an installation log of National Instruments software. 

  4. ​(Optional) Click Next and configure the custom options for the custom report or add any additional files you would like to include in the Technical support report.
  5. Click Next to enter a location and file name for your report.
  6. Click Generate.
 

Programatically using LabVIEW

  1. ​Launch LabVIEW.
  2. Go to Help >> Find Examples...
  3. Search Max Report.
  4. Click on example Generate Max Report .vi
  5. Select the Report Type that you wish to generate.
  6. In the File Path box, put a file name with the extension corresponds to the Report Type. e.g. .zip for Technical Support type.
  7. Run the VI.

Additional Information

The MAX Technical Report generation process can also be invoked directly from the command line without opening MAX. You can do this by passing special arguments to the MAX executable.
  1. Open your command prompt and navigate to the folder that contains NIMax.exe. This location will depend on where you installed your National Instruments software. The default location is <Program Files>\National Instruments\MAX\. To change the current file path, use the cd command and then enter the directory you want to move to. An example of this is shown below:
 
  1. Once you have navigated to this location, enter your desired parameters to the MAX report generation command (nimax /REPORT) to generate your report. The format is as follows:
nimax /REPORT:fileName="absolute path to a new htm/html file";reportType="custom|simple";silent="true|false"
 
Parameters include:
  • filename (required) is the filename for the generated report. It must be an absolute path to an htm or html file. When running in silent mode, any existing file will automatically be overwritten. When running in non-silent mode, user will be prompted whether to overwrite the existing file.
  • reportType (optional) is simple (no details) or custom (full details). The default value is custom(full detail).
  • silent (optional) is true or false. If true, no message boxes are displayed to report errors and completion status. true is the default value.
Note: Quotes are necessary around each of the parameter values. Parameters are not case-sensitive and should be separated by semicolons, with no spaces in between. Remote System reports are not currently supported if you run the report from the command line. If you want to create a report for a Remote System, you must use the MAX Technical Report Wizard.

Examples that demonstrate the use of the command line report generation:
  • nimax /REPORT:fileName="C:\reports\my_file.html"
  • nimax /REPORT:fileName="C:\reports\my_file.html";reportType="custom";silent="true"
  • nimax /REPORT:fileName="C:\reports\my_file.htm";reportType="simple";silent="false"

WAS THIS ARTICLE HELPFUL?

Not Helpful