nih-gov/www.nlm.nih.gov/vsac/support/authorguidelines/updatingvaluesets.html
2025-02-26 13:17:41 -05:00

974 lines
40 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="en">
<head>
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;500;700&display=swap" rel="stylesheet">
<link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.10/css/all.css" integrity="sha384-+d0P83n9kaQMCwj8F4RJB66tzIwOKmrdb46+porD/OvrJ+37WqIM7UoBtwHO6Nlg" crossorigin="anonymous">
<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/" title="The Dublin Core metadata Element Set" />
<script src="https://assets.nlm.nih.gov/uswds/js/uswds-init.min.js"></script>
<link rel="stylesheet" href="/home_assets/uswds/css/styles.css">
<title>Updating Value Sets</title>
<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/" title="The Dublin Core metadata Element Set" />
<meta name="DC.Title" content="Updating Value Sets" />
<meta name="DC.Subject.Keyword" content="vsac, value sets, updating, eCQM, clinical quality measures, code validation, expansion profile" />
<meta name="DC.Publisher" content="U.S. National Library of Medicine" />
<meta name="DC.Date.Issued" content="2014-10-01" />
<meta name="DC.Date.Modified" content="2022-12-07" />
<meta name="NLMDC.Date.LastReviewed" content="2022-04-19" />
<meta name="NLM.Contact.Email" content="nlmumlscustserv@mail.nlm.nih.gov" />
<meta name="DC.Type" content="Technical Documentation" />
<meta name="NLM.Permanence.Level" content="Permanence Not Guaranteed" />
<meta name="DC.Rights" content="Public Domain" />
<meta name="DC.Language" content="eng" />
<!-- Google Tag Manager --><script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push(
{'gtm.start': new Date().getTime(),event:'gtm.js'}
);var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','GTM-MT6MLL');</script>
<!-- End Google Tag Manager -->
</head>
<body>
<!-- Google Tag Manager -->
<noscript><iframe src="//www.googletagmanager.com/ns.html?id=GTM-MT6MLL" height="0" width="0" style="display:none;visibility:hidden" title="googletagmanager"></iframe></noscript>
<!-- End Google Tag Manager -->
<!-- TOP NAV -->
<a class="usa-skipnav" href="#main">Skip to main content</a>
<div class="usa-banner site-banner" aria-label="Official government website">
<div class="usa-accordion">
<header class="usa-banner__header">
<div class="usa-banner__inner">
<div class="grid-col-auto"> <img class="usa-banner__header-flag" src="https://assets.nlm.nih.gov/uswds/img/us_flag_small.png" alt="U.S. flag"/> </div>
<div class="grid-col-fill tablet:grid-col-auto">
<p class="usa-banner__header-text"> An official website of the United States government </p>
<p class="usa-banner__header-action" aria-hidden="true"> Heres how you know </p>
</div>
<button class="usa-accordion__button usa-banner__button" aria-expanded="false" aria-controls="gov-banner"> <span class="usa-banner__button-text">Heres how you know</span> </button>
</div>
</header>
<div class="usa-banner__content usa-accordion__content" id="gov-banner">
<div class="grid-row grid-gap-lg">
<div class="usa-banner__guidance tablet:grid-col-6"> <img class="usa-banner__icon usa-media-block__img" src="https://assets.nlm.nih.gov/uswds/img/icon-dot-gov.svg" role="img" alt="" aria-hidden="true"/>
<div class="usa-media-block__body">
<p> <strong> Official websites use .gov </strong> <br />
A <strong>.gov</strong> website belongs to an official government
organization in the United States. </p>
</div>
</div>
<div class="usa-banner__guidance tablet:grid-col-6"> <img class="usa-banner__icon usa-media-block__img" src="https://assets.nlm.nih.gov/uswds/img/icon-https.svg" role="img" alt="" aria-hidden="true"/>
<div class="usa-media-block__body">
<p> <strong> Secure .gov websites use HTTPS </strong> <br />
A <strong>lock</strong> ( <span class="icon-lock">
<svg xmlns="http://www.w3.org/2000/svg" width="52" height="64" viewBox="0 0 52 64" class="usa-banner__lock-image" role="img" aria-labelledby="banner-lock-title-default banner-lock-description-default" focusable="false">
<title id="banner-lock-title-default">Lock</title>
<desc id="banner-lock-description-default">A locked padlock</desc>
<path fill="#000000" fill-rule="evenodd" d="M26 0c10.493 0 19 8.507 19 19v9h3a4 4 0 0 1 4 4v28a4 4 0 0 1-4 4H4a4 4 0 0 1-4-4V32a4 4 0 0 1 4-4h3v-9C7 8.507 15.507 0 26 0zm0 8c-5.979 0-10.843 4.77-10.996 10.712L15 19v9h22v-9c0-6.075-4.925-11-11-11z"/>
</svg>
</span> ) or <strong>https://</strong> means youve safely connected to the .gov website. Share sensitive information only on official, secure websites. </p>
</div>
</div>
</div>
</div>
</div>
</div>
<!-- HEADER -->
<header id="siteheader" class="usa-header usa-header--basic">
<div class="usa-nav-container tablet:padding-x-4 mobile-lg:padding-x-2 padding-y-1">
<div class="grid-row padding-y-105">
<div class="grid-col-8 desktop:grid-col-4 tablet-lg:grid-col-4 tablet:grid-col-6"> <a href="https://www.nlm.nih.gov/"> <img src="https://assets.nlm.nih.gov/uswds/img/NLM_White.png" alt="NLM logo" class="logo margin-top-1"> </a> </div>
<div class="desktop:grid-col-4 desktop:grid-offset-4 tablet-lg:grid-col-6 tablet-lg:grid-offset-2 tablet:grid-col-6 grid-col-12">
<form class="usa-search desktop:margin-top-2 tablet:margin-top-2 mobile:margin-top-1" role="search" data-gtm-form-interact-id="0" method="get" action="//vsearch.nlm.nih.gov/vivisimo/cgi-bin/query-meta" target="_self" name="searchForm" id="searchForm2">
<input class="usa-input ui-autocomplete-input" aria-label="Search" type="search" name="query" data-gtm-form-interact-field-id="0" id="search2" autocomplete="off" placeholder="Search NLM" >
<input type="hidden" name="v:project" value="nlm-main-website">
<button class="usa-button border border-top border-bottom border-right border-white" role="button" aria-label="Search" type="submit"> <span class="usa-search__submit-text"> <i class="fas fa-search"></i> </span> </button>
</form>
</div>
</div>
</div>
</header>
<div class="bg-secondary insertCOOP">
<div class="usa-nav-container">
<div class="usa-navbar ">
<button class="usa-menu-btn">Menu</button>
</div>
<nav aria-label="Primary navigation" class="usa-nav">
<button class="usa-nav__close"><img src="https://assets.nlm.nih.gov/uswds/img/close.svg" alt="close"></button>
<ul class="usa-nav__primary usa-accordion insertNav">
<li class="usa-nav__primary-item desktop-lg:margin-x-5 desktop:margin-x-3 tablet:margin-x-0">
<button type="button" class="usa-accordion__button usa-nav__link usa-current" aria-expanded="false" aria-controls="basic-nav-section-one"> <span>Products and Services <i class="fas fa-caret-down margin-left-05"></i> </span> </button>
<ul id="basic-nav-section-one" class="usa-nav__submenu bg-secondary" hidden="">
<li class="usa-nav__submenu-item"> <a href="//eresources.nlm.nih.gov/nlm_eresources/"><span>All Products and Services</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="//clinicaltrials.gov/"><span>ClinicalTrials.gov</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="//collections.nlm.nih.gov/"><span>Digital Collections</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="//catalog.nlm.nih.gov"><span>LocatorPlus Catalog</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="//meshb.nlm.nih.gov/search"><span>Medical Subject Headings (MeSH)</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="//medlineplus.gov/"><span>MedlinePlus</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="//pubmed.ncbi.nlm.nih.gov/"><span>PubMed/MEDLINE</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="//uts.nlm.nih.gov/uts/"><span>Unified Medical Language System (UMLS)</span></a> </li>
</ul>
</li>
<li class="usa-nav__primary-item desktop-lg:margin-x-5 desktop:margin-x-3 tablet:margin-x-0">
<button type="button" class="usa-accordion__button usa-nav__link usa-current" aria-expanded="false" aria-controls="basic-nav-section-two"> <span> Resources for You <i class="fas fa-caret-down margin-left-05"></i></span> </button>
<ul id="basic-nav-section-two" class="usa-nav__submenu bg-secondary" hidden="">
<li class="usa-nav__submenu-item"> <a href="/portals/researchers.html"><span>For Researchers</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/portals/publishers.html "><span>For Publishers</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/portals/librarians.html"><span>For Librarians</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/training.html "><span>For Educators/Trainers </span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/portals/healthcare.html"><span>For Health care Professionals</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/portals/public.html "><span>For the Public</span></a> </li>
</ul>
</li>
<li class="usa-nav__primary-item desktop-lg:margin-x-5 desktop:margin-x-3 tablet:margin-x-0">
<button type="button" class="usa-accordion__button usa-nav__link usa-current" aria-expanded="false" aria-controls="basic-nav-section-three"> <span>Explore NLM <i class="fas fa-caret-down margin-left-05"></i> </span> </button>
<ul id="basic-nav-section-three" class="usa-nav__submenu bg-secondary" hidden="">
<li class="usa-nav__submenu-item"> <a href="/about/index.html"><span>About the Library</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/about/visitor.html"><span>Visit the Library</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/hmd/index.html"><span>History of Medicine</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/about/org.html"><span>NLM by Organization</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/news/newsandevents.html"><span>News, Events, and Updates</span></a> </li>
</ul>
</li>
<li class="usa-nav__primary-item desktop-lg:margin-x-5 desktop:margin-x-3 tablet:margin-x-0">
<button type="button" class="usa-accordion__button usa-nav__link usa-current" aria-expanded="false" aria-controls="basic-nav-section-four"> <span> Grants and Research <i class="fas fa-caret-down margin-left-05"></i> </span> </button>
<ul id="basic-nav-section-four" class="usa-nav__submenu bg-secondary" hidden="">
<li class="usa-nav__submenu-item"> <a href="/ep/index.html"><span>NLM Extramural Programs</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="/research/index.html"><span>NLM Intramural Research Program</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="https://www.ncbi.nlm.nih.gov/"><span>National Center for Biotechnology Information</span></a> </li>
<li class="usa-nav__submenu-item"> <a href="//lhncbc.nlm.nih.gov/"><span>Lister Hill National Center for Biomedical Communications</span></a> </li>
</ul>
</li>
</ul>
</nav>
</div>
</div>
<!-- End of TOP NAV -->
<!-- DIVISIONAL BANNER -->
<div class="bg-gray-70">
<div class="grid-container">
<div class="grid-row divisional">
<div class="grid-col text-white">
<div class="float-left">
<h4 class="margin-bottom-0"> VSAC Support Center</h4>
</div>
<div class="float-right margin-top-05">
<p>
<a class="text-white" href="/vsac/support/index.html">VSAC Support Center Home</a>
</p>
</div>
</div>
</div>
</div>
</div>
<!--END DIVISIONAL BANNER -->
<!-- Breadcrumbs -->
<div class="grid-container">
<nav class="usa-breadcrumb usa-breadcrumb--wrap padding-top-1" aria-label="Breadcrumbs">
<ol class="usa-breadcrumb__list">
<li class="usa-breadcrumb__list-item"> <a href="/index.html" class="usa-breadcrumb__link"><span>Home</span></a> </li>
<li class="usa-breadcrumb__list-item"> <a href="/vsac/support/index.html" class="usa-breadcrumb__link"><span>VSAC Support Center Home</span></a> </li>
</ol>
</nav>
</div>
<!-- End Breadcrumbs -->
<main class="padding-bottom-5" id="main">
<div class="grid-container">
<div class="grid-row">
<div class="col">
<div class="h1">Updating Value Sets</div>
</div>
</div>
<div class="grid-row grid-gap-1">
<!-- start row-->
<div class="tablet:grid-col-12">
<!-- start column-->
<h3>Code Validation, Expansion Profiles, Revisions, and Publication</h3>
<p>
The following tutorial supports any Authors and Stewards who need to
update their value sets as well as the measure developers and value set
developers for the annual updates of the electronic Clinical Quality
Measure (eCQM) value sets. This tutorial is useful for other purposes as
well, beyond the eCQM value set annual updates.
</p>
<div class="usa-accordion usa-accordion--bordered margin-bottom-3">
<!-- start accordion-->
<h4 class="usa-accordion__heading">
<button
type="button"
class="usa-accordion__button"
aria-expanded="false"
aria-controls="updatingvaluesets-section-1"
>
<!-- <h4 class="margin-bottom-0"> -->
I. My Value Sets and Search All Value Sets
<!-- </h4>-->
</button>
</h4>
<div
class="usa-accordion__content usa-prose"
id="updatingvaluesets-section-1"
>
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/updatingvaluesets_img1.jpg"
id="eCQM1"
alt="Image of the open VSAC Authoring tab, showing the My Value Sets and Search All Value Sets sections."
/><br /><br />
<p>
My Value Sets contains all value sets, regardless of status, assigned
to you as an Author and/or as a Steward.
</p>
<p>
Search All Value Sets contains all value sets, regardless of status.
Click [Search] to view all.
</p>
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/updatingvaluesets_img2.jpg"
id="eCQM2"
alt="Image of the open VSAC Authoring tab, showing the expanded Search All Value Sets section. The Search button is highlighted to show the user needs to click on the Search button to obtain the list of all value sets."
/><br /><br />
<p>
Use the filter boxes to refine your results, and click on any column
heading to sort your results.
</p>
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/updatingvaluesets_img3.jpg"
id="eCQM3"
alt="Image of the open VSAC Authoring tab, showing the expanded Search All Value Sets section. The Code System column filter text box contains 'LOINC' and the Author column filter text box contains 'VSAC."
/>
</div>
<!-- end accordion content-->
<h4 class="usa-accordion__heading">
<button
type="button"
class="usa-accordion__button"
aria-expanded="false"
aria-controls="updatingvaluesets-section-2"
>
<!-- <h4 class="margin-bottom-0"> -->
II. VSAC Authoring Permissions
<!-- </h4>-->
</button>
</h4>
<div
class="usa-accordion__content usa-prose"
id="updatingvaluesets-section-2"
>
<ul>
<li>
In addition to UMLS License credentials, you must also obtain VSAC
authoring/stewarding permissions by contacting the VSAC staff at
<a href="https://support.nlm.nih.gov/">Customer Support</a>.
</li>
<li>
A value set must be assigned to an Author and Steward group in order
for an Author or Steward to have access to the value set for the
purpose of editing, updating and publishing.
</li>
<li>
New value sets created by Authors in the VSAC are automatically
associated to the Author who created it.
</li>
<li>
If you authored draft value sets in the Measure Authoring Tool prior
to the MAT-VSAC import on 11/24/2013 then you must contact the VSAC
staff directly to associate your draft value sets to your Author and
Steward group.
</li>
</ul>
</div>
<!-- end accordion content-->
<h4 class="usa-accordion__heading">
<button
type="button"
class="usa-accordion__button"
aria-expanded="false"
aria-controls="updatingvaluesets-section-3"
>
<!-- <h4 class="margin-bottom-0">-->
III. What is an Expansion Profile?
<!-- </h4>-->
</button>
</h4>
<div
class="usa-accordion__content usa-prose"
id="updatingvaluesets-section-3"
>
<p>
<strong>Expansion</strong> refers to the calculation of a value set's
list of codes according to a defined rule or set of rules, such as
specific code system versions.
</p>
<p>
An <strong>expansion profile</strong> is a set of rules defined by a
particular program, such as the CMS Clinical Quality Measures Value
Sets Annual Update. For example, the eCQM Update 2020-05-07 expansion
profile applied a set of allowable code system versions, defined by
CMS, as well as a set of desired legacy codes, approved by CMS.
</p>
<p>
The Expansion Profile for the eCQM Update 2020-05-07 validated value
set code lists against the code system versions and legacy codes
defined by CMS and ONC.
</p>
</div>
<!-- end accordion content-->
<h4 class="usa-accordion__heading">
<button
type="button"
class="usa-accordion__button"
aria-expanded="false"
aria-controls="updatingvaluesets-section-4"
>
<!-- <h4 class="margin-bottom-0">-->
IV. Validate a Previously Published Value Set against an Expansion
Profile
<!-- </h4>-->
</button>
</h4>
<div
class="usa-accordion__content usa-prose"
id="updatingvaluesets-section-4"
>
<p>
Value sets that were previously published have likely undergone code
changes due to periodic updates by the code systems on which the value
sets were based. Some codes may now be invalid or inactive (retired by
the code system), and some code systems may have remapped existing
codes to new codes.
</p>
<p>
Authors need to review all value sets they wish to republish (for
example, for the eCQM Annual Updates).
</p>
<ol>
<li>
Find your value sets in Authoring -> My Value Sets, if they have
been assigned to an Author or Steward group to which you belong. If
you do not see a value set listed in My Value Sets, search for it in
Search All Value Set Definitions, click on its OID, then click
<strong>Contact Steward</strong> in the left sidebar to send a
request to the Steward to add you to the value set's Authoring group
using the
<a
href="https://www.nlm.nih.gov/vsac/support/authorguidelines/groupmanage.html"
>Group Management</a
>
function.
</li>
<li>Click on the value set OID to review your value set.</li>
<li>
In the left sidebar of the authoring window, click the
<strong>Validate</strong> link and then choose the appropriate
Expansion Profile calculation from the drop down. Check with your
program or sponsoring agency to determine which Expansion Profile
you should use. In the Code Validation pop-up box, click [Validate]
to view the expansion results.<br />
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/eCQM4.jpg"
id="eCQM4"
alt="eCQM4"
/><br /><br />
</li>
<li>
You can click the [View] button to see exactly which code system
versions and expansion rules are being applied to your value set
codes. Here, you see an example of the eCQM Update 2019-05-10
Expansion Profile being applied to this value set.<br />
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/eCQM5.jpg"
id="eCQM5"
alt="eCQM5"
/><br /><br />
</li>
<li>
Review the Validated Code List. Determine if any inactive/invalid
codes should remain in your updated value set expansion. You can
include inactive/invalid codes in your updated value set expansion
if the Expansion Rules in your Expansion Profile Details display
this rule: "Legacy/Retired Codes: VSAC applied the most recent code
system version that includes the code in an active status."
Sometimes there will be a code-system-supplied remapped code
available for you to use in place of an inactive/invalid code. There
will be very few cases of remapped codes.<br />
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/eCQM6.jpg"
id="eCQM6"
alt="eCQM6"
/><br />
</li>
</ol>
</div>
<!-- end accordion content-->
<h4 class="usa-accordion__heading">
<button
type="button"
class="usa-accordion__button"
aria-expanded="false"
aria-controls="updatingvaluesets-section-5"
>
<!-- <h4 class="margin-bottom-0"> -->
V. View Remap Info (for RxNorm, LOINC, and SNOMED CT value sets only)
<!-- </h4>-->
</button>
</h4>
<div
class="usa-accordion__content usa-prose"
id="updatingvaluesets-section-5"
>
<ol>
<li>
Use the column headings to sort your view of validation and
remapping information to facilitate reviewing the validation table.
</li>
<li>
If Remapping codes exist for any of your inactive/invalid codes, you
will see a [View Remap Info] button at the top right of the table.
When you click on this [View Remap Info], you will see a new window
providing a table with remapping information. You should review the
remapped codes and decide if they are appropriate for your value
set.
</li>
</ol>
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/eCQM7.png"
id="eCQM7"
alt="eCQM7"
/>
</div>
<!-- end accordion content-->
<h4 class="usa-accordion__heading">
<button
type="button"
class="usa-accordion__button"
aria-expanded="false"
aria-controls="updatingvaluesets-section-6"
>
<!-- <h4 class="margin-bottom-0">-->
VI. Invalid or Inactive?
<!-- </h4>-->
</button>
</h4>
<div
class="usa-accordion__content usa-prose"
id="updatingvaluesets-section-6"
>
<p>
The terms <strong>invalid</strong> and <strong>inactive</strong> are
confusingly similar because they both mean the code should be removed
from the value set, but for different reasons.
</p>
<p>
<strong>Invalid</strong>: The code never existed in the code system or
it could be a typo. You should remove invalid codes from your value
sets.
</p>
<p>
<strong>Inactive</strong>: The code system has decided to suppress
this code for reasons particular to the code system. You should remove
inactive codes from your value sets.
</p>
</div>
<!-- end accordion content-->
<h4 class="usa-accordion__heading">
<button
type="button"
class="usa-accordion__button"
aria-expanded="false"
aria-controls="updatingvaluesets-section-7"
>
<!-- <h4 class="margin-bottom-0"> -->
VII. Making Changes to Your Value Set
<!-- </h4>-->
</button>
</h4>
<div
class="usa-accordion__content usa-prose"
id="updatingvaluesets-section-7"
>
<ol>
<li>
<!--<strong>Before you modify your code list, it is important to first change the code system version to the appropriate code system version for your program release</strong>, as defined by your sponsoring agency or program. For example, the appropriate code system version for RxNorm is 2015-01 for the eCQM Annual Updates in 2015. -->You
will need to manually remove retired(inactive/invalid) codes from
your value set and add remapped codes, if appropriate, to your value
set.
</li>
<li>
<strong>Editing/Updating Your Value Set:</strong><br />
<p>
If your value set is in Draft status and was not previously
published, click the [Edit] button at the top of the tab.
</p>
<img
class="figure-img img-fluid img-thumbnail"
src="/vsac/support/authorguidelines/eCQM8.png"
id="eCQM8"
alt="eCQM8"
/><br /><br />
<p>
If your value set is in Published status, and was previously
published, click the [New Version] button at the top of the tab.
</p>
<br />
<img
class="figure-img img-fluid img-thumbnail"
src="/vsac/support/authorguidelines/eCQM9.png"
id="eCQM9"
alt="eCQM9"
/>
</li>
<li>
Check the check boxes beside codes you wish to remove from your
value set, and then click the trashcan icon at the top of the Value
Set Code List table.<br />
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/eCQM10.png"
id="eCQM10"
alt="eCQM10"
/>
</li>
<li>
To add individual codes to your value set, click the plus
<strong>(+)</strong> icon at the top of the Value Set Code List
table. This creates a new empty row at the top of the Value Set Code
List table. Paste in the code field the code you wish to add, for
example, a code that was mapped to an inactive or invalid code.<br />
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/eCQM11.png"
id="eCQM11"
alt="eCQM11"
/>
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/eCQM12.png"
id="eCQM12"
alt="eCQM12"
/>
</li>
</ol>
</div>
<!-- end accordion content-->
<h4 class="usa-accordion__heading">
<button
type="button"
class="usa-accordion__button"
aria-expanded="false"
aria-controls="updatingvaluesets-section-8"
>
<!-- <h4 class="margin-bottom-0"> -->
VIII. Importing Codes into Your Value Set
<!-- </h4>-->
</button>
</h4>
<div
class="usa-accordion__content usa-prose"
id="updatingvaluesets-section-8"
>
<p>
In many cases, you may have a long list of codes that you wish to add
to your value set and then <strong>Validate</strong>. You may have
this list of codes stored in a local spreadsheet or in a
non-spreadsheet formatted text file. You can copy the column of codes
from your spreadsheet or import the codes from the text file and add
them to your value set by using the <strong>Import</strong> link at
the top of the Value Set Code List table.
</p>
<ol>
<li>
In the VSAC Authoring Tool, in a value set you are modifying,
confirm you are in <strong>Edit</strong> mode by clicking the
<strong>[Edit]</strong> or <strong>[New Version]</strong> button at
the bottom of the Value Set Code List table. If you do not see the
<strong>[Edit]</strong> or <strong>[New Version]</strong> button,
you may not be the Value Set Author for this value set, or the value
set may need to be withdrawn from a more advanced state (Proposed,
Approved, Ready to Publish).
<strong
>Before importing your list of codes, you need to select a Code
System and Code System Version for your value set.</strong
>
The codes you are about to import will be validated against your
selected Code System and Code System Version.
</li>
<li>
Locate and click the <strong>Import</strong> link at the top of the
Value Set Code List table.<br />
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/importcodes.jpg"
id="ImportCodes"
alt="Import Codes into a Value Set"
/>
</li>
</ol>
<br />
<h4>Copy-Paste Codes into the Text Box</h4>
<ol>
<li>
If your codes are in an Excel spreadsheet, select and copy the
spreadsheet column that contains the codes (do not include the
column heading). In the Import Codes dialog pop-up box, select the
<strong>From Text Box</strong> option from the Import Methods list
to be able to simply copy and paste your codes, and then click the
<strong>[Import]</strong> button. You will need to select the
appropriate text separator: space, semicolon(;), or vertical bar(|).
</li>
<li>
If any of your codes are invalid, the import tool will not allow
them to be imported.<br />
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/copypastecodes.jpg"
id="CopyPasteCodes"
alt="Copy and Paste Codes into Text Box"
/>
</li>
</ol>
<h4>Import Codes from a File</h4>
<ol>
<li>
Alternatively, if you have codes in a non-spreadsheet formatted
file, such as a text (.txt) file, you can upload the file by
selecting the <strong>From File</strong> option from the Import
Methods list and then click on the
<strong>[Select File]</strong> button. Locate the file on your
computer and click the <strong>[OK]</strong> button. Be sure to
select the appropriate text separator: space, semicolon(;), or
vertical bar(|). The sample codes will be imported in the Codes text
box. Click the <strong>[Import]</strong> button once you are done.
</li>
<li>
You can import codes from an Excel spreadsheet using the From File
option, but you will first need to save the spreadsheet as a text
file. Once you have converted the spreadsheet to a text file you can
import the codes using the From File option as previously
mentioned.<br />
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/importfromfile.jpg"
id="ImportCodesFile"
alt="Import Codes from a File"
/>
</li>
</ol>
</div>
<!-- end accordion content-->
<h4 class="usa-accordion__heading">
<button
type="button"
class="usa-accordion__button"
aria-expanded="false"
aria-controls="updatingvaluesets-section-9"
>
<!-- <h4 class="margin-bottom-0"> -->
IX. Submitting, Approving, and Publishing Your Value Set
<!-- </h4>-->
</button>
</h4>
<div
class="usa-accordion__content usa-prose"
id="updatingvaluesets-section-9"
>
<p>
You must save your value set definition and submit it to your steward
for approval. The steward will review the value set definition and
decide to approve or reject your value set definition.
</p>
<ol type="1">
<li>
Save changes to your value set by clicking the
<strong>Save</strong> button.<br />
<img
src="/vsac/support/authorguidelines/UpdateVSsave.png"
alt="Save Value Set"
style="width: 950px"
/>
</li>
<li>
Submit your updated value set for the steward to approve by clicking
the <strong> Submit </strong> button.<br />
<img
src="/vsac/support/authorguidelines/UpdateVSsubmit.png"
alt="Submit Value Set"
style="width: 950px"
/>
</li>
<li>
The Steward will review the value set definition and decide to
approve or reject your value set definition.
</li>
<li>
To approve the value set definition and to enable public access of
the value set's expansion, the Steward should click the
<strong> Approve </strong>button.
<br />
<img
src="/vsac/support/authorguidelines/UpdateVSapprove.png"
alt="Approve Value Set"
style="width: 950px"
/><br />
You will see a message that confirms your approval to publish the
value set changes to the public repository. The updated value set
will be available to VSAC users from the Search Value Set tabs.
<br />
<img
class="figure-img img-fluid img-thumbnail"
src="//www.nlm.nih.gov/vsac/support/authorguidelines/approvesuccess.jpg"
id="ApproveSuccess"
alt="ApproveSuccess"
/>
<br />
To reject the changes, click the<strong> Reject </strong> button.
The value set returns to its draft state for the author to make
further changes. The author must make the necessary changes and
submit the updated value set for steward approval again. <br />
<img
src="/vsac/support/authorguidelines/UpdateVSreject.png"
alt="Reject Value Set"
style="width: 950px"
/>
</li>
</ol>
</div>
<!-- end accordion content-->
</div>
<!-- end accordion-->
</div>
<!-- end column-->
</div>
<!-- end row-->
<p class=”margin-top-5”><small>Last Reviewed: April 19, 2022</small></p>
</div>
</main>
<!-- FOOTER -->
<footer class="usa-footer__primary-section padding-top-5 padding-bottom-3 insertfooter">
<div class="grid-container">
<div class="grid-row">
<div class="desktop:grid-col-3 grid-col-6"> <a href="https://www.nlm.nih.gov/socialmedia/index.html">
<p class="text-white">Connect with NLM</p>
</a>
<ul class="social_media add-list-reset">
<li class="margin-right-05"><a href="https://www.facebook.com/nationallibraryofmedicine"><img class="bg-secondary" src="https://www.nlm.nih.gov/images/facebook.svg" alt="Facebook"></a></li>
<li class="margin-right-05"><a title="External link: please review our privacy policy." href="https://www.linkedin.com/company/national-library-of-medicine-nlm/"><img class="bg-secondary" src="//www.nlm.nih.gov/images/linkedin.svg" alt="LinkedIn"></a></li>
<li class="margin-right-05"><a title="External link: please review our privacy policy." href="https://twitter.com/NLM_NIH"><img src="//www.nlm.nih.gov/images/twitter.svg" class="img-fluid bg-secondary" alt="Twitter"></a></li>
<li class="margin-right-05"><a title="External link: please review our privacy policy." href="https://www.youtube.com/user/NLMNIH"><img src="//www.nlm.nih.gov/images/youtube.svg" class="bg-secondary" alt="You Tube"></a></li>
<li class="margin-right-05"><a title="External link: please review our privacy policy." href="https://public.govdelivery.com/accounts/USNLMOCPL/subscriber/new?preferences=true"><img src="//www.nlm.nih.gov/images/mail.svg" class=" bg-secondary" alt="Government Delivery"></a></li>
</ul>
</div>
<div class="desktop:grid-col-3 grid-col-6">
<p class="address_footer text-white"> National Library of Medicine <br>
<a href="https://www.google.com/maps/place/8600+Rockville+Pike,+Bethesda,+MD+20894/@38.9959508,-77.101021,17z/data=!3m1!4b1!4m5!3m4!1s0x89b7c95e25765ddb:0x19156f88b27635b8!8m2!3d38.9959508!4d-77.0988323" class="text-white"> 8600 Rockville Pike <br>
Bethesda, MD 20894 </a></p>
</div>
<div class="desktop:grid-col-3 grid-col-6">
<p><a href="/web_policies.html" class="text-white"> Web Policies </a><br>
<a href="https://www.nih.gov/institutes-nih/nih-office-director/office-communications-public-liaison/freedom-information-act-office" class="text-white"> FOIA </a><br>
<a href="https://www.hhs.gov/vulnerability-disclosure-policy/index.html" class="text-white">HHS Vulnerability Disclosure</a> </p>
</div>
<div class="desktop:grid-col-3 grid-col-6">
<p><a class="supportLink text-white" href="//support.nlm.nih.gov?from="> NLM Support Center </a> <br>
<a href="/accessibility.html" class="text-white"> Accessibility </a><br>
<a href="/careers/careers.html" class="text-white"> Careers </a></p>
</div>
</div>
<div class="grid-row">
<div class="grid-col-12">
<p class="text-center text-white"> <a class="text-white" href="//www.nlm.nih.gov/">NLM</a> | <a class="text-white" href="https://www.nih.gov/">NIH</a> | <a class="text-white" href="https://www.hhs.gov/">HHS</a> | <a class="text-white" href="https://www.usa.gov/">USA.gov</a></p>
</div>
</div>
</div>
</footer>
<script src="//assets.nlm.nih.gov/uswds/js/uswds.min.js"></script>
<script src="//assets.nlm.nih.gov/jquery/jquery-latest.min.js"></script>
<script src="//assets.nlm.nih.gov/jquery/jquery-migrate-latest.min.js"></script>
<script src="/scripts/nlm_autocomplete.js"></script>
<script src="/scripts/nlm_uswds.js"></script>
</body>
</html>