|NI TestStand 2014 Help|
|NI TestStand 2014 SP1 Help|
|TestStand 2016 Help|
|TestStand 2016 SP1 Help|
|TestStand 2017 Help|
Use the XML Packaging Utility to copy local XML and HTML report files you select, including related style sheets, image files, and referenced files, to a destination directory you specify so you can view the XML report on a computer that does not have TestStand installed. You can launch the utility in the following ways:
When you use the XML Packaging Utility to distribute XML, HTML, and supported versions of ATML reports that include hyperlinks, the utility also distributes the target file of the link if the XmlPack.ini file includes the file extension. You must run the utility at least once for TestStand to create the XmlPack.ini file, which is located in the <TestStand Application Data>\Cfg directory. Edit the COMMON_EXTENSIONS key of the XmlPack.ini file to include a comma-separated string of file extensions for files you want to distribute using the utility. For example, if you want to distribute .docx and .xlsx files, use "docx, xlsx" as the COMMON_EXTENSIONS key. TestStand distributes .tdms files by default.
|Note The utility packages only local files and not remote files that are referenced by the report files.|
After the utility completes the packing, the selected and referenced files reside in the specified destination directory. The utility substitutes all file references to use the files copied to the destination directory. For distribution, you can compact, deliver, and extract the destination directory to view the copied files at the distribution location.
To package XML files, first click Add in the XML Packaging Utility dialog box and select one or more XML files to package. The files appear in the XML Files list. Use the Destination Folder control to specify the directory in which the utility copies the files to in the Destination Folder control. Click Pack to package the XML and other referenced files.
The XML Packaging Utility dialog box contains the following options:
When packaging the files, the utility displays the following icons to the left of the XML Files list and the Referenced Files list:
If no icon displays, the utility copied the file but did not process it.
|Note The XML Packaging Utility does not package the TsGraphControl2.ocx ActiveX control, located in the <National Instruments>\Shared\TestStand directory.|
You can execute the utility from the command line using the following syntax:
XMLPack [[-v] file-list [ file-list* ] dest-folder]
The following table describes the elements of this command-line syntax.
|-v||Represents verbose mode, which displays messages.|
|file-list||A valid directory or path and filename that can contain wildcard characters, such as * and ?.|
|dest-folder||A valid directory or path, which might not exist. If it does not exist, TestStand creates it.|
Square brackets contain optional command-line arguments. If you do not specify an argument, the dialog-based XML Packaging Utility launches.
When run from the command line, the utility returns an error code of 0 if successful and non-zero if an error occurred.