Skip Navigation Bar

Create a Program Release


A program release is a group of value set expansions (code lists) that you publish under one program release label. The benefit of publishing your group of value sets as a program release is your end users can search for and obtain the entire set of value sets that belong to your program. A program release can be a new release or it can be an update to a previous program release in VSAC. You can update your program release on a regular or ad hoc basis.

Examples of program releases in VSAC:
  • Centers of Medicare and Medicaid (CMS) electronic Clinical Quality Measures (eCQM) value sets
  • CMS Hybrid Measures value sets
  • Consolidated Clinical Document Architecture (C-CDA) value sets
VSAC creates a program release in partnership with a value set author or steward, who then assumes the role of the program release manager. A program release may consist of one or more release items with which value sets are associated. For example, a program release may contain value sets specified by one or more quality measures. These quality measures are release items for a program release in VSAC. Each release item has a group of value sets associated with it. For a new program release that is not an update to a previous release, the program release manager can inform VSAC of value sets association to release items by submitting one of the following:
  • Spreadsheet of value sets for a release, grouped by release item associations to value sets
  • HQMF files for each measure, if applicable, produced by a measure authoring tool
If your value sets were published previously in VSAC, you may need to make changes to the value sets to reflect current changes in code systems. For example, the CMS eCQM value sets that were released in May 2017 were later updated by CMS to reflect code system updates, and were published with these changes in a subsequent program release.
  1. Contact NLM to provide your program release name, program description, and supply a URL that links to the authoritative source of your program.
    We will link to your program through this URL so users can find more information about your program that uses these value sets. If you need to update any of your previously published value sets, complete your updates prior to your program release publication date.
  2. Decide which value sets to include in your program release.
  3. Analyze your program release value sets and decide if any of the value sets need to be updated.
  4. Submit a spreadsheet of value sets for your program release, grouped by program release item associations. You may choose your own authored value sets as well as any other published value sets in VSAC.
    If you use the CMS Measure Authoring Tool (MAT), or any other HQMF-prodicing measure authoring tool, you may submit HQMF files.
  5. Define and submit your expansion profile to NLM: which code system versions you want to bind to your value sets for your program release.
  6. Supply your quality assurance rules, if you want VSAC to include automatic data quality checks for your value sets.
  7. Inform NLM which of your colleagues need access to My Program Releases – your dashboard that tracks information about your program release while you are preparing it in VSAC
  8. Contact NLM if anyone needs to be added or removed from your author, steward, or program release manager groups.
  • Contact NLM to provide your program release name, program description, and supply a URL that links to the authoritative source of your program.
    We will link to your program through this URL so users can find more information about your program that uses these value sets. If you need to update any of your previously published value sets, complete your updates prior to your program release publication date.
  • Make your desired edits to your existing value sets and assign them to your program release name in VSAC. If you do not need to make any changes to some of your chosen release value sets, VSAC will use your previously published value set definition version for any value sets you do not manually assign to your program release name in VSAC.
  • Select the Authoring tab, and then open the My Value Sets sections: Find value sets you need to update for your program release.
  • Click on hyperlinked value set OID to enter editing screen for that value set in the Authoring Tool.
  • Definition tab: Choose the value set definition version, and make a “New Version” of that definition version of your value set.
  • Author must submit value set to steward for approval, and steward must approve this value set before your release publication date.
To illustrate the process, we use two CMS eCQM program releases as examples. These example releases are based on two previous program releases.
  1. Contact NLM to provide your program release name, program description, and supply a URL that links to the authoritative source of your program.
    We will link to your program through this URL so users can find more information about your program that uses these value sets. If you need to update any of your previously published value sets, complete your updates prior to your program release publication date.
  2. Make your desired edits to your existing value sets and assign them to your program release name in VSAC. If you do not need to make any changes to some of your chosen release value sets, VSAC will use your previously published value set definition version for any value sets you do not manually assign to your program release name in VSAC.
  3. Select the Authoring tab, and then select, My Value Sets: Find the value sets that you need to update for your program release.
  4. Click on hyperlinked value set OID to enter editing screen for that value set in the Authoring Tool.
  5. In that value set’s editing screen, go to the Expansion/Publication tab .
  6. Expansion/Publication tab - Expansion History table, see which of your releases published this value set OID previously and observe the value set definition version your previous program release used.
  7. Determine the value set definition version that you need to update (if necessary) for the base program release for which you are creating a new program release.
  8. Definition tab: Choose the value set definition version you determined from the previous step, and make a “New Version” of that definition version of your value set.
  9. Make your desired changes to your new draft version of your previously published value set definition, and click Save . (You may also click submit and approve if desired at this point.)
  10. In the left side bar, select release, and then assign release .
  11. In Assign Release dialog pop up: select +Add for your draft definition version, and click, Save .
  12. In Add Release dialog pop up: select and save your appropriate release name.
  13. Author must submit value set to steward for approval, and steward must approve this value set before your release publication date.
  14. To view the release assignments that you just made, select the View Assignment History link under Release , and view the designations under the Description column.
  1. You only need to make these release assignments for value sets that you need to update.
    VSAC will expand and include the most recently published value set definition version of any value set you do not manually assign to a release.
  2. You only need to make new definition versions of extensional value sets if you want to add codes or remove codes. You only need to make new definition versions of grouping value sets if you are adding or removing any member value sets. VSAC will expand and publish your previously published value set definition version for your program release, unless you decide to assign a different published value set definition version to your program release.
  3. For grouping value sets, review the member extensional value sets for any updates that you need to make. If you update (new definition version) any member value set within a grouping value set you must assign the new value set definition version of the member value set to your program release.
  4. You cannot assign two different value set definition versions of the same value set to the same program release.
  5. You can reuse the same value set definition version for multiple program releases.
  1. What if I assigned my value set definition version to the wrong program release?
    You can make changes yourself in the Authoring, Release, Assign Release menu up until your final VSAC deadline for your program release.
  2. What if I created a new value set definition version by mistake?
    You can delete any new draft you created in error in Authoring, Definition, Delete .
The members of your release manager group use this feature to track progress on value set definition version assignments to your program release before VSAC publishes your release. Your release manager group members may also use this feature after the program release publication for reference purposes.
Select the Authoring tab, and then My Program Releases.
  • Members of your release manager group have access to My Program Releases. Contact NLM if you need to add people to your release manager group.
  • Represents real-time record keeping for your value set definition version assignments to your program release.
  • View value sets for all release items in a program release or select a specific release item to view its value sets.
  • Export a spreadsheet of program release value set results as of a certain date.
  • Default display is all value sets, grouped by release items, for a selected program release.
  • Select individual release items if desired, and apply filter.
  • Click OID hyperlink to navigate to value set’s authoring screen.
  • Click Grouping hyperlink in Type column to view member value sets and their program release definition version assignment status.
  • User Assigned column: “Yes” indicates the author/steward manually assigned this value set definition version to this upcoming program release.
  • Definition Selection Rule column:
  • Steward: The author/steward assigned this definition version to this release.
  • Previous: This definition version has not been revised by the author/steward since its previous base release. VSAC will include this definition version in this release unless the author/steward assigns a different definition version of this value set to this release.

Consolidated Release Results: Presents the value sets in the release and the metadata for the value sets. For grouping value sets, the member value sets are listed.

Itemized Release Results: Presents the values sets per the release. Select the tabs at the bottom of the spreadsheet to see the summary of the releases or access specific information about the release.