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-09-17 12:00:00David O'BrienReviewed
Arkansas XML User Dictionary
Data Dictionary Details
2020-09-28 09:34:00Christopher FisherReviewed
California XML User Dictionary
Data Dictionary Details
2021-01-24 15:24:00Ben WormeliSubmitted
CoC XML User Dictionary
Data Dictionary Details
2020-01-27 12:40:00Jeff ReedReviewed
Colorado XML User Dictionary
Data Dictionary Details
2020-10-01 16:39:00John ArendSubmitted
Florida XML User Dictionary
Data Dictionary Details
11/12/2020 07:36:00Gary LevinReviewed
GeorgiaGeorgia Cancer Registry is not creating a user dictionary at this time2020-09-28 10:08:00Jan KresReviewed
Idaho (CDRI) XML User Dictionary
Data Dictionary Details
2020-11-24 06:45:00Regina EckReviewed
Iowa XML User Dictionary
Data Dictionary Details
2021-12-22 08:26:00Jason BrubakerSubmitted
IndianaIndiana is not creating a user dictionary.2020-09-25 24:28:00shebbar@isdh.in.govReviewed
KentuckyKentucky is not creating a user dictionary.2020-10-16 09:35:00Isaac HandsReviewed
Louisiana XML User Dictionary2020-10-19 11:21:00Brent MumphreyReviewed
Michigan XML User Dictionary
Data Dictionary Details
2021-01-21 06:11:00Stacey ColtrainSubmitted
MinnesotaMinnesota is not creating a user dictionary at this time.2020-11-12 17:09:00Mona HighsmithReviewed
Missouri XML User Dictionary
Data Dictionary Details
2020-09-24 10:45:00Nancy RoldReviewed
Montana XML User Dictionary
Data Dictionary Details
2020-11-30 13:47:00Debbie LemonsReviewed
NDSCR XML User Dictionary
Data Dictionary Details
2021-12-21 15:00:00Yung ZhengSubmitted
New Hampshire XML User Dictionary
Data Dictionary Details
2020-10-02 10:46:00Cathleen GeigerReviewed
New Mexico XML User Dictionary
Data Dictionary Details
2020-12-2311:52:00Barbara EvansSubmitted
New York XML User Dictionary
Data Dictionary Details
2020-10-19 11:32:00Stefan WindenReviewed
North Carolina XML User Dictionary
Data Dictionary Details
2020-10-15 14:25:00Brian KnoxReviewed
Ohio XML User Dictionary
Data Dictionary Details
10/01/2020 08:25:00Kaitlin KrugerReviewed
Oklahoma Oklahoma Cancer Registry is not creating a user dictionary at this time2020-12-16 10:00:00Christy DabbsReviewed
Ontario XML User Dictionary
Data Dictionary Details
2020-11-24 13:32:00Isabela OlaruReviewed
Pennsylvania XML User Dictionary
Data Dictionary Details
2020-12-23 1:21:00Christina McEachernReviewed
PRCCR XML User Dictionary
Data Dictionary Details
2020-10-28 15:48:00Janos BaksaSubmitted
Rhode Island XML User Dictionary
Data Dictionary Details
2021-01-25 13:00:00Lisa Marie GarciaSubmitted
South CarolinaSouth Carolina is not creating a user dictionary.2020-11-24 06:40:00Michael CasteraReviewed
Tennessee Tennessee is not creating a user dictionary at this time.2020-11-13 09:39:00Anne Llewellyn Reviewed
Utah XML User Dictionary
Data Dictionary Details
2020-09-02 9:31:00Valerie YoderReviewed
Vermont Data Dictionary Details2020-09-28 13:40:00Alison JohnsonReviewed
Virginia XML User Dictionary
2020-09-06 11:21:00Larry KirklandReviewed
WisconsinWisconsin Cancer Registry is not creating a user dictionary at this time2020-10-02 10:09:00Jenna StaehlerReviewed

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