Creating new Spec Version

When creating a new data spec version, all existing files, types, and elements must be assigned to the new version as they do not automatically get assigned. This allows granular control for which of these components are being carried forward into the new spec.

Adding a Version

1. Log in to the nswers.org admin page
2. Click on Data Elements
3. Click on Versions
4. Complete the Add Version form
   • Name: (this is the new version number. i.e. 1.4.0)
   • Slug: (this is the code friendly version and should be the same as the name, but with dashes instead of periods. i.e. 1-4-0)
   • Description: (this is an internal only description of the version)
   • Visible: (toggles if the version is visible on the site)
   • Draft: (toggles if the version is in a draft state – this primarily effects the PDF output to include a DRAFT watermark)

Unchanged Files

1. Make sure each Element Specs is assigned to the new version
   • Click on Element Specs
   • Click on the title of each Spec to be included
   • Ensure the new version is checked in the Applicable Versions list.
   • Click on Update.
2. Make sure all elements are assigned to a new version
   • Click on All Data Elements.
   • Apply filters to view the list of elements to assign.
     • Typically this would be to select appropriate Specs in the Show all Specs dropdown, and the last version in the Show all Versions dropdown.
     • Click on Filter to apply the filter.
   • Select the checkbox at the top of the list in the header section – this will check off all visible elements. Uncheck any that will not be assigned, if applicable.
   • In the top bar, select Edit in the Bulk actions dropdown and click Apply
   • In the Versions field, start typing the name of the new version. After a moment, a selection list should appear to allow you to select the new version. NOTE: Only the new version needs to be added. The bulk edit process WILL NOT remove existing version assignments.
   • Click on Update.