-
Notifications
You must be signed in to change notification settings - Fork 7
1: NAACCR XML Utility Tool
Update (7/19/2023) - As announced earlier, the standalone tool has been retired and is not part of the distribution anymore.
Update (9/20/2022) - The main purpose of the NAACCR XML Utility Tool was flat-to-xml and xml-to-flat conversions. NAACCR 18 was the last NAACCR version to require those conversations. Because of that, NAACCR 23 will be the last NAACCR version supported by the tool; it will be retired sometimes in 2023. Every feature currently supported by the tool is also supported if File*Pro (see link under), making it a good replacement candidate.
While this GitHub project hosts a Java NAACCR XML library that is intended to be embedded into other software, it also provides a standalone GUI tool that provides a more user-friendly environment for processing NAACCR XML data files.
As of version 5.0, the tool does not require Java to be installed on your computer. Instead it uses its own embedded runtime environment. That is true only for Windows machines.
The tool can be used to perform the following operations:
- Translating a given fixed-column NAACCR file to the corresponding NAACCR XML file.
- Translating a given NAACCR XML file to the corresponding fixed-column NAACCR file.
- Validating a given NAACCR XML file.
- Viewing/exporting the standard NAACCR XML dictionaries.
- Creating or editing a user-defined NAACCR XML dictionary.
If you need to perform more complex operations on your NAACCR XML data files (like filtering and/or recoding the data), you should consider using File*Pro which is a free software provided by SEER.
To download the tool, follow the following steps:
- Check the releases page and locate the latest version that is available.
- Click the link naaccr-xml-utility-x.x.zip where x.x is the latest version available.
- Depending on how your browser is setup, you might be asked to select a location to save the file on your computer, or it might automatically download it in a "download" folder. Regardless, the file can be copied anywhere on your computer.
There is no installation procedure other than unzipping the file you just downloaded. It can be unzipped anywhere on your computer. The program wont't add or modify any other files or environment on your computer.
To run the tool on Windows, just double-click the NAACCR XML Utility.exe file.
As of version 5.0, the tool doesn't require a Java Runtime Environment on Windows; it comes with its own embedded environment. It is possible to use a different environment by running the application on the command line. Follow the following steps:
- Open a DOS prompts and navigate to the folder containing the
NAACCR XML Utility.exefile. - Type "java -jar lib\naaccr-xml-utility.jar" (without the quotes) followed by Enter.
When running the application on a MAC, a Java environment (JDK) is still required. Once that environment is available, you should be able to double-click the naaccr-xml-utility.jar file in the lib folder. You can also start the application on the command line with the following steps:
- Open a terminal and navigate to the folder containing the
NAACCR XML Utility.exefile. - Type "java -jar lib\naaccr-xml-utility.jar" (without the quotes) followed by Enter.
The tool itself contains a help page and the few feature it has are very self-explanatory.
The NAACCR XML Utility Tool was developed by Information Management Services, Inc. under the Surveillance, Epidemiology, and End Results program.