XML User Dictionary

XML User Dictionary

Deadline for State User-Dictionaries

In preparation for implementation of the XML standard for NAACCR v21, central registries with locally defined data items are expected to create and provide user dictionaries to vendors by October 1, 2020

A user dictionary is an XML file that defines key metadata about NAACCR data items as they relate to a NAACCR XML data exchange file, their valid XML parent elements, and processing rules. The user dictionaries should include all registry-specific data items for NAACCR v21, including current registry-specific items as well as any new items planned for implementation in NAACCR v21. This will help vendors prepare customized files and software applications and reduce the chance of delay for deployment of NAACCR v21 software. All central registries with registry-specific data items should do the following:

  1. Review existing registry-specific data items to determine if their reporting needs have changed, remove items that are no longer needed.
  2. Identify and define new registry-specific data items for NAACCR v21 as needed.
  3. Download and fill out the User Dictionary Sample Template with details of all registry-specific data items.
  4. Create an XML User Dictionary with all registry-specific data items, based on the information in the Excel template. According to the XML Data Exchange Standard, the filename for a user dictionary should match the last part of the dictionary URI and follow this pattern: [organization]-naaccr-dictionary[-xxx][-v#.#].xml where xxx is the corresponding NAACCR version, which is only required if the user dictionary depends on a specific NAACCR version. v#.#is your organization’s version of the dictionary(semantic versioning recommended)
  1. Upload the filled-out User Dictionary Sample Template and the XML User Dictionary to the XML Dictionary Submission Portal (MyNAACCR Login Required).

Help with Creating User Dictionaries

NAACCR has established this website as a User Dictionary Clearinghouse to show examples of user dictionaries from other central registries and provide the User Dictionary Sample Template that will help central registries gather information needed to define their own XML User Dictionary. Central registries with registry-specific data items are encouraged to fill out the Excel template and upload it to the XML Dictionary Submission Portal with a corresponding XML User Dictionary so that registry software vendors can get access to these required files and deploy their NAACCR v21 changes in a timely manner.

NOTE: These files will be shared publicly in order to provide it to the widest audience of software vendors and to assist registries in creating XML User Dictionaries as they transition to the XML standard for NAACCR v21. Only registered MyNAACCR account holders can post files, but once posted, they will be available publicly for download.

Once the User Dictionary Sample Template is filled out, it can be uploaded to the XML Dictionary Submission Portal by someone at a central registry with a MyNAACCR account that is responsible for managing registry-specific data items. Once uploaded, these files will be publicly available with the intent of allowing registry software vendors the registry-specific customizations, including codes and definitions, for registry-specific data items in their software. While codes and descriptions are optional and not defined in a user dictionary, central registry-assigned codes and descriptions must be shared with vendors in order to generate look up tables in software displays.

When assigning names to registry-specific data items, the maximum length for a NAACCR Name is 50 characters, and the maximum length for a NAACCR ID is 32 characters. The software tools available for creating user dictionaries will calculate a new NAACCR ID based on the NAACCR Name as long as the names contain 50 characters or less. Additional information can be found in the NAACCR Data Exchange Standard, available at https://www.naaccr.org/xml-data-exchange-standard/.

Please note that these spreadsheet templates do not take the place of a user dictionary. The templates provide a reference with information needed to successfully implement registry-specific data items with the end goal of bringing all of the information together in one place to create a user dictionary file. Once the spreadsheet is filled out, central registries with registry-specific data items must also create and maintain the actual user dictionary file.

We encourage all registries with custom local data items to complete the spreadsheet template and upload their documents.

Additional help can be received by posting to the NAACCR XML Forum, which is monitored by the NAACCR XML Data Exchange Workgroup

Important Links

User Dictionary Sample Template

XML Dictionary Submission Portal (MyNAACCR Login Required)

NAACCR XML Specification Document (NAACCR Volume I)

NAACCR XML Homepage

A status of Reviewed indicates the user dictionary has been reviewed by XML workgroup members. A status of Submitted has not been reviewed. Vendors should wait to implement a dictionary until it is Reviewed.

Organization NameUploaded FilesUpload Date/TimeUser AccountStatus
Alaska XML User Dictionary
Data Dictionary Details
2020-10-05 David O'BrienReviewed
Antr XML User Dictionary
Data Dictionary Details
2021-02-11 Garrett ZimpelmanReviewed
Arkansas XML User Dictionary
Data Dictionary Details
2020-09-28 Christopher FisherReviewed
California XML User Dictionary
Data Dictionary Details
2021-02-11 Ben WormeliReviewed
CoC XML User Dictionary
Data Dictionary Details
2021-02-11 Jeff ReedReviewed
Colorado XML User Dictionary
Data Dictionary Details
2020-10-01 John ArendReviewed
Connecticut XML User Dictionary
Data Dictionary Details
2021-05-03Cathryn PhillipsReviewed
Delaware Delaware Cancer Registry is not creating a user dictionary at this time2020-02-01 Elaine FloresReviewed
Florida XML User Dictionary
Data Dictionary Details
11/12/2020 Gary LevinReviewed
GeorgiaGeorgia Cancer Registry is not creating a user dictionary at this time2020-09-28 Jan KresReviewed
Idaho (CDRI) XML User Dictionary
Data Dictionary Details
2021-06-28 Randi RycroftReviewed
Iowa XML User Dictionary
Data Dictionary Details
2021-12-22 Jason BrubakerReviewed
IndianaIndiana is not creating a user dictionary.2020-09-25 shebbar@isdh.in.govReviewed
Kansas XML User Dictionary
Data Dictionary Details
2021-03-05 Evan ReitterReviewed
KentuckyKentucky is not creating a user dictionary.2020-10-16 Isaac HandsReviewed
Louisiana XML User Dictionary2020-02-11 Brent MumphreyReviewed
Maryland XML User Dictionary
XML User Dictionary
2020-01-29 Rebecca LIReviewed
Michigan XML User Dictionary
Data Dictionary Details
2021-01-21 Stacey ColtrainReviewed
MinnesotaMinnesota is not creating a user dictionary at this time.2020-11-12 Mona HighsmithReviewed
Missouri XML User Dictionary
Data Dictionary Details
2020-09-24 Nancy RoldReviewed
Montana XML User Dictionary
Data Dictionary Details
2020-11-30 Debbie LemonsReviewed
New Hampshire XML User Dictionary
Data Dictionary Details
2020-10-02 Cathleen GeigerReviewed
New Mexico XML User Dictionary
Data Dictionary Details
2021-05-03Barbara EvansReviewed
New York XML User Dictionary
Data Dictionary Details
2020-10-19 Stefan WindenReviewed
North Carolina XML User Dictionary
Data Dictionary Details
2021-05-10Brian KnoxReviewed
North Dakota XML User Dictionary
Data Dictionary Details
2021-06-28Yung ZengReviewed
Ohio XML User Dictionary
Data Dictionary Details
10/01/2020 Kaitlin KrugerReviewed
Oklahoma Oklahoma Cancer Registry is not creating a user dictionary at this time2020-12-16 Christy DabbsReviewed
Ontario XML User Dictionary
Data Dictionary Details
2020-11-24 Isabela OlaruReviewed
Pennsylvania XML User Dictionary
Data Dictionary Details
2020-12-23 Christina McEachernReviewed
PRCCR XML User Dictionary
Data Dictionary Details
2020-10-28 Janos BaksaSubmitted
Rhode Island XML User Dictionary
Data Dictionary Details
2021-01-25 Lisa Marie GarciaReviewed
South CarolinaSouth Carolina is not creating a user dictionary.2020-11-24 Michael CasteraReviewed
Tennessee Tennessee is not creating a user dictionary at this time.2020-11-13 Anne Llewellyn Reviewed
Utah XML User Dictionary
Data Dictionary Details
2020-09-02 Valerie YoderReviewed
Vermont Data Dictionary Details2020-09-28Alison JohnsonReviewed
Virginia XML User Dictionary
2020-09-06 Larry KirklandReviewed
West VirginiaWest Virginia Cancer Registry is not creating a user dictionary at this time2020-02-01 Myra FernattReviewed
WisconsinWisconsin Cancer Registry is not creating a user dictionary at this time2020-10-02 Jenna StaehlerReviewed

Copyright © 2018 NAACCR, Inc. All Rights Reserved | naaccr-swoosh-only See NAACCR Partners and Sponsors