316 lines
15 KiB
HTML
316 lines
15 KiB
HTML
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
|
||
<head>
|
||
<meta http-equiv="X-UA-Compatible" content="IE=8;" />
|
||
<meta name="twitter:card" content="summary_large_image">
|
||
<meta name="twitter:site" content="@NLM_NIH">
|
||
<meta name="twitter:title" content="Versioning in PubMed. NLM Technical Bulletin. 2012 Jan–Feb">
|
||
<meta name="twitter:description" content=" The NLM Technical Bulletin is your source to stay informed about NLM products and services.">
|
||
<meta name="twitter:image" content="https://www.nlm.nih.gov/pubs/techbull/images/nlm_tech_bulletin_graphic_twitter.jpg">
|
||
<meta property="og:url" content="https://www.nlm.nih.gov/pubs/techbull/tb.html" />
|
||
<meta property="og:type" content="article" />
|
||
<meta property="og:title" content="Versioning in PubMed. NLM Technical Bulletin. 2012 Jan–Feb" />
|
||
<meta property="og:description" content="The NLM Technical Bulletin is your source to stay informed about NLM products and services." />
|
||
<meta property="og:image" content="https://www.nlm.nih.gov/pubs/techbull/images/nlm_tech_bulletin_graphic_facebook.jpg" />
|
||
<link type="text/css" href="/pubs/techbull/styles/reset.css" rel="stylesheet" />
|
||
|
||
<link type="text/css" href="/pubs/techbull/styles/technicalBulletin.css" rel="stylesheet" />
|
||
<!--Call jQuery-->
|
||
<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="/pubs/techbull/scripts/techbull.js" type="text/javascript" language="javascript"></script>
|
||
<!--[if lte IE 8]>
|
||
<script type="text/javascript" src="/scripts/PIE.js"></script>
|
||
<![endif]-->
|
||
<link type="text/css" href="/pubs/techbull/styles/print.css" rel="stylesheet" media="print"/>
|
||
<title>Versioning in PubMed. NLM Technical Bulletin. 2012 Jan–Feb</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="Versioning in PubMed" />
|
||
|
||
<meta name="DC.Subject.Keyword" content="versioning" />
|
||
<meta name="DC.Publisher" content="U.S. National Library of Medicine" />
|
||
<meta name="DC.Date.Issued" content="2012-02-15" />
|
||
<meta name="DC.Date.Modified" content="2013-11-01" />
|
||
<meta name="NLMDC.Date.LastReviewed" content="2013-11-01" />
|
||
<meta name="NLM.Contact.Email" content="nlmtechbull@mail.nlm.nih.gov" />
|
||
<meta name="DC.Type" content="Newsletters" />
|
||
<meta name="NLM.Permanence.Level" content="Permanent: Stable Content" />
|
||
<meta name="NLM.Permanence.Guarantor" content="U.S. National Library of Medicine" />
|
||
<meta name="DC.Rights" content="Public Domain" />
|
||
<meta name="DC.Language" content="eng" />
|
||
|
||
|
||
<meta name="DC.Subject.Keyword" content="PubMed" />
|
||
<meta name="DC.Subject.Keyword" content="PubMed Unique Identifier" />
|
||
<meta name="DC.Subject.Keyword" content="Abstract" />
|
||
<meta name="DC.Subject.Keyword" content="Date of Publication" />
|
||
<meta name="DC.Subject.Keyword" content="Versioning" />
|
||
<meta name="DC.Subject.Keyword" content="Abstract Display" />
|
||
<meta name="DC.Subject.Keyword" content="Author Name" />
|
||
<meta name="DC.Subject.Keyword" content="Entrez Date" />
|
||
<meta name="DC.Subject.Keyword" content="Search Box" />
|
||
<meta name="DC.Subject.Keyword" content="Author" />
|
||
<meta name="DC.Subject.Keyword" content="E-utilities" />
|
||
<meta name="DC.Subject.Keyword" content="Fact Sheet" />
|
||
<meta name="DC.Subject.Keyword" content="Journal Title Abbreviation" />
|
||
<meta name="DC.Subject.Keyword" content="National Center for Biotechnology Information" />
|
||
<meta name="DC.Subject.Keyword" content="Publisher" />
|
||
<meta name="DC.Subject.Keyword" content="Summary Display" />
|
||
<meta name="DC.Subject.Keyword" content="Unique Identifier" />
|
||
|
||
<!-- 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 -->
|
||
<div class="skipnavigation"><a title="Skip the navigation on this page" href="#skipnav" class="skipnavigation">Skip Navigation Bar</a></div>
|
||
|
||
<div>
|
||
|
||
<div class="header">
|
||
<img src="/pubs/techbull/images/tb_logo_113.jpg" alt="National Library of Medicine Technical Bulletin" title="National Library of Medicine Technical Bulletin" /><img src="/pubs/techbull/images/nlm_masthead_113.jpg" alt="National Library of Medicine Technical Bulletin" title="National Library of Medicine Technical Bulletin" usemap="#nlm_masthead_113" />
|
||
</div>
|
||
|
||
<div class="search_box">
|
||
<form method="get" action="//vsearch.nlm.nih.gov/vivisimo/cgi-bin/query-meta" target="_self" name="searchForm" class="searchForm">
|
||
<label class="displaynone" for="search">Search</label>
|
||
<input name="query" id="search" type="text" class="search-input inactive" size="50" onfocus="this.value=''" value="Search here for NLM Technical Bulletin articles" aria-label="Search NLM Technical Bulletin">
|
||
<input type="hidden" name="v:project" value="technical-bulletin">
|
||
</form>
|
||
</div>
|
||
|
||
</div>
|
||
|
||
<div id="nav">
|
||
<!--Open drop-->
|
||
<ul class="topnav">
|
||
<li class="currentissue"><a href="//www.nlm.nih.gov/pubs/techbull/current_issue.html">Current Issue</a> <img class="separator" src="/pubs/techbull/images/whitelinetransparentbackground.gif " alt=""/></li>
|
||
<li class="archive"><a href="//www.nlm.nih.gov/pubs/techbull/back_issues.html">Previous Issues</a> <img class="separator" src="/pubs/techbull/images/whitelinetransparentbackground.gif " alt=""/></li>
|
||
<li class="about"><a href="//www.nlm.nih.gov/pubs/techbull/about.html">About</a> <img class="separator" src="/pubs/techbull/images/whitelinetransparentbackground.gif " alt=""/></li>
|
||
<li class="staycurrent"><a href="//www.nlm.nih.gov/pubs/techbull/stay_current.html">Stay Current <img class="emaillogo" src="/pubs/techbull/images/email_20px.gif" alt="E-Mail Sign Up" style="margin-top: -4px;"/> <img class="rsslogo" src="/pubs/techbull/images/rss_20px.gif" alt="RSS Feed" style="margin-top: -4px;"/></a></li>
|
||
</ul>
|
||
<!--Close drop-->
|
||
</div>
|
||
<div class="body">
|
||
<a id="skipnav" name="skipnav"></a>
|
||
<div class="syndicate">
|
||
<p class="tableOfContents"><strong>Table of Contents: <a href="/pubs/techbull/jf12/jf12_issue_cover.html">2012 JANUARY–FEBRUARY No. 384</a></strong></p>
|
||
<p class="prevnext"><span class="buttons">
|
||
<span class="previous"><a href="jf12_pm_results_main_web.html">Previous</a></span> <span class="next"><a href="jf12_issue_cover.html">Next</a></span>
|
||
|
||
</span></p>
|
||
<hr class="hr1" />
|
||
<h1 class="articleH1">Versioning in PubMed</h1>
|
||
<p class="tbyearmonth">Torre S. Versioning in PubMed. NLM Tech Bull. 2012 Jan-Feb;(384):e6.</p>
|
||
<div class="articleactions">2012 February 15 <span class="status">[posted]</span>
|
||
|
||
|
||
|
||
</div>
|
||
<div class="articleParagraph">
|
||
|
||
<p>
|
||
PubMed now supports versioned citations. Revisions, scientific updates, and updates of reviews are examples of content that could be versioned. Versions are not intended for correcting specific errors in an article, for which published errata notices should continue to be used (see <a href="//www.nlm.nih.gov/pubs/factsheets/errata.html">Fact Sheet</a>). </p>
|
||
|
||
<h2>
|
||
How Will Versions Be Identified?
|
||
</h2>
|
||
|
||
<p>
|
||
The PMID of a versioned citation will remain constant while each version will have a unique version number assigned by PubMed. The combination of PMID and version number in the format PMID.version will be a unique identifier. All citations not versioned will be considered version 1.
|
||
</p>
|
||
|
||
<p>
|
||
There may be occasions when a specific version will be deleted. In these cases, the version number assigned to the deleted version will be skipped, and the next version of the citation will be assigned the following number. Version numbers will not be reused.
|
||
</p>
|
||
|
||
|
||
<h2>
|
||
Display of Versioned Citations in PubMed
|
||
</h2>
|
||
|
||
<p>Version information is noted on the Summary, Summary (text), Abstract, and Abstract (text), displays.
|
||
On the Summary display, the version number is located before the journal title abbreviation. The article’s original publication date is retained, and the version publication date is enclosed in square brackets (see <a href="#fig1">Figure 1</a>).
|
||
</p>
|
||
|
||
<a name="fig1"></a>
|
||
|
||
|
||
<div class="figure" style="width: 767px;"> <img src="graphics/pm_version_fig1.png" alt="Screen capture of citationcontext menu." title="Screen capture of citation context menu" width="765" height="109" /><br /> <strong>Figure 1: Summary display of a versioned citation</strong></div>
|
||
|
||
<p>
|
||
The Summary (text) display has a similar format (see <a href="#fig2">Figure 2</a>).
|
||
</p>
|
||
|
||
<a name="fig2"></a>
|
||
|
||
|
||
<div class="figure" style="width: 656px;"> <img src="graphics/pm_version_fig2.png" alt="Screen capture of citationcontext menu." title="Screen capture of Summary (text) display of a versioned citation" width="654" height="71" /><br /> <strong>Figure 2: Summary (text) display of a versioned citation.</strong></div>
|
||
|
||
|
||
<p>
|
||
The Abstract display also indicates the version number and version publication date. Users can easily access prior versions of the citation by clicking on the "Other versions" link. A menu will appear listing all versions with the corresponding publication date. The version currently being viewed is in grey text and is not a link. All other available versions are links that will take the user to the Abstract display for that version (see <a href="#fig3">Figure 3</a>).
|
||
</p>
|
||
|
||
<a name="fig3"></a>
|
||
|
||
|
||
<div class="figure" style="width: 804px;"> <img src="graphics/pm_version_fig3.png" alt="Screen capture of Using the Other versions menu." title="Screen capture of Using the Other versions menu" width="802" height="340" /><br /> <strong>Figure 3: Using the "Other versions" menu.</strong></div>
|
||
|
||
The Abstract (text) display shows the version number and version publication date (see <a href="#fig4">Figure 4</a>).
|
||
|
||
|
||
<a name="fig4"></a>
|
||
|
||
|
||
<div class="figure" style="width: 671px;"> <img src="graphics/pm_version_fig4.png" alt="Screen capture of Abstract (text) display of a versioned citation." title="Screen capture of Abstract (text) display of a versioned citation” menu" width="669" height="448" /><br /> <strong>Figure 4: Abstract (text) display of a versioned citation.</strong></div>
|
||
|
||
|
||
|
||
<h2>
|
||
Searching and Retrieving Using Versions
|
||
</h2>
|
||
|
||
<p>
|
||
Only the most recent version of a citation will be indexed and returned in a PubMed search for a versioned PMID (see <a href="#fig5">Figure 5</a>). The content, e.g., author names, abstract terms, from previous versions will not be included in the PubMed indices. For example, if an author name has been removed from the author list in the most recent version, a PubMed search for that author name will not retrieve the citation. Users can access previous versions from the Abstract display or use one of the methods described below.
|
||
</p>
|
||
|
||
|
||
<a name="fig5"></a>
|
||
|
||
|
||
<div class="figure" style="width: 804px;"> <img src="graphics/pm_version_fig5.png" alt="Screen capture of Searching PubMed for a versioned citation using a PMID." title="Screen capture of Searching PubMed for a versioned citation using a PMID” menu" width="802" height="395" /><br /> <strong>Figure 5: Searching PubMed for a versioned citation using a PMID.</strong></div>
|
||
|
||
|
||
|
||
|
||
<p>
|
||
Search for a specific version of a citation by entering a PMID.version (e.g., 20029611.1) in the PubMed search box (see <a href="#fig6">Figure 6</a>). To search for multiple versions of a citation at once, use a Boolean OR (e.g., 20029611.1 OR 20029611.2).
|
||
</p>
|
||
|
||
|
||
<a name="fig6"></a>
|
||
|
||
|
||
<div class="figure" style="width: 804px;"> <img src="graphics/pm_version_fig6.png" alt="Screen capture of Searching for a specific previous version of a citation." title="Screen capture of Searching for a specific previous version of a citation” menu" width="802" height="383" /><br /> <strong>Figure 6: Searching for a specific previous version of a citation.</strong></div>
|
||
|
||
<p>
|
||
Search for all versions of a citation by entering the PMID followed by .* (e.g., 20029611.*) in the PubMed search box (see <a href="#fig7">Figure 7</a>).
|
||
</p>
|
||
|
||
|
||
<a name="fig7"></a>
|
||
|
||
|
||
<div class="figure" style="width: 804px;"> <img src="graphics/pm_version_fig7.png" alt="Screen capture of Searching for all previous versions of a citation." title="Screen capture of Searching for all previous versions of a citation" width="802" height="320" /><br /> <strong>Figure 7: Searching for all previous versions of a citation.</strong></div>
|
||
|
||
|
||
Retrieve a specific version by explicitly adding the version number after the PMID in the URL, e.g., http://www.ncbi.nlm.nih.gov/pubmed/20029611.1. Only a single version can be retrieved at a time using this method.
|
||
|
||
<h2>
|
||
Publication Dates
|
||
</h2>
|
||
|
||
<p>
|
||
PubMed will set the DateCreated for the new version to the date the citation is added to PubMed. We will retain the Entrez Date, which defines the display order in PubMed, as the original date unless the publisher supplies a new PublicationDate. If the PublicationDate on the new version is different, we will modify the Entrez Date so the citation will display at the top of the search results.
|
||
</p>
|
||
|
||
<h2>
|
||
Versioning and E-utilities
|
||
</h2>
|
||
|
||
<p>
|
||
E-Search will only retrieve the latest version of a citation. E-Fetch can return a PMID.version.
|
||
</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
<p class="articleParagraph">
|
||
|
||
|
||
|
||
By
|
||
|
||
|
||
Sarah Torre<br />
|
||
National Center for Biotechnology Information<br />
|
||
|
||
|
||
|
||
|
||
</p>
|
||
</div>
|
||
<div class="footer">
|
||
<p class="footerLeft"><span class="footerissn"><strong>ISSN 2161-2986 (Online)</strong> Content not copyrighted; freely reproducible.</span><br/>
|
||
<a href="/">National Library of Medicine</a> 8600 Rockville Pike, Bethesda, MD 20894
|
||
<br/>
|
||
<a href="//www.nlm.nih.gov/socialmedia/index.html">Connect with NLM</a>,
|
||
<a href="//www.nlm.nih.gov/web_policies.html">Web Policies</a>,
|
||
<a href="//www.nlm.nih.gov/careers/jobopenings.html">Careers</a>,
|
||
<a href="//www.nlm.nih.gov/accessibility.html">Accessibility</a>,
|
||
<a href="//www.usa.gov/" id="anch_34">USA.gov</a>,
|
||
<a href="//www.hhs.gov/vulnerability-disclosure-policy/index.html">HHS Vulnerability Disclosure</a>
|
||
<br/>
|
||
|
||
<a href="//www.nih.gov/">NIH</a>,
|
||
<a href="https://www.hhs.gov/">HHS</a>,
|
||
<a href="//www.nih.gov/institutes-nih/nih-office-director/office-communications-public-liaison/freedom-information-act-office">FOIA</a>,
|
||
<a class="supportLink" href="//support.nlm.nih.gov?from=" target="_blank">NLM Support Center</a>
|
||
|
||
</p>
|
||
|
||
<p class="footerRight">
|
||
<strong>Last updated:</strong> 01 November 2013</p>
|
||
</div>
|
||
</div>
|
||
<map id="nlm_masthead_113" name="nlm_masthead_113">
|
||
<area shape="rect" alt="NLM Technical Bulletin" coords="1,15,396,45" href="//www.nlm.nih.gov/pubs/techbull/tb.html" title="NLM Technical Bulletin" />
|
||
<area shape="rect" alt="National Library of Medicine" coords="0,47,203,62" href="//www.nlm.nih.gov/" title="National Library of Medicine" />
|
||
<area shape="rect" coords="207,47,396,62" href="//www.nih.gov/" alt="National Institutes of Health" title="" />
|
||
</map>
|
||
<!--*****************************Content end*******************************-->
|
||
<script src="/scripts/support.js"></script>
|
||
<script src="/core/nlm-notifyExternal/1.0/nlm-notifyExternal.min.js"></script>
|
||
</body>
|
||
</html>
|
||
|