148 lines
111 KiB
Text
148 lines
111 KiB
Text
<!DOCTYPE html>
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" class="no-js no-jr">
|
|
<head>
|
|
<!-- For pinger, set start time and add meta elements. -->
|
|
<script type="text/javascript">var ncbi_startTime = new Date();</script>
|
|
|
|
<!-- Logger begin -->
|
|
<meta name="ncbi_db" content="books">
|
|
<meta name="ncbi_pdid" content="book-part">
|
|
<meta name="ncbi_acc" content="NBK3802">
|
|
<meta name="ncbi_domain" content="helplinkout">
|
|
<meta name="ncbi_report" content="reader">
|
|
<meta name="ncbi_type" content="fulltext">
|
|
<meta name="ncbi_objectid" content="">
|
|
<meta name="ncbi_pcid" content="/NBK3802/?report=reader">
|
|
<meta name="ncbi_pagename" content="Information for Other Resource Providers - LinkOut Help - NCBI Bookshelf">
|
|
<meta name="ncbi_bookparttype" content="chapter">
|
|
<meta name="ncbi_app" content="bookshelf">
|
|
<!-- Logger end -->
|
|
|
|
<!--component id="Page" label="meta"/-->
|
|
<script type="text/javascript" src="/corehtml/pmc/jatsreader/ptpmc_3.22/js/jr.boots.min.js"> </script><title>Information for Other Resource Providers - LinkOut Help - NCBI Bookshelf</title>
|
|
<meta charset="utf-8">
|
|
<meta name="apple-mobile-web-app-capable" content="no">
|
|
<meta name="viewport" content="initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no">
|
|
<meta name="jr-col-layout" content="auto">
|
|
<meta name="jr-prev-unit" content="/books/n/helplinkout/ft/?report=reader">
|
|
<meta name="jr-next-unit" content="/books/n/helplinkout/related/?report=reader">
|
|
<meta name="bk-toc-url" content="/books/n/helplinkout/?report=toc">
|
|
<meta name="robots" content="INDEX,FOLLOW,NOARCHIVE">
|
|
<meta name="citation_inbook_title" content="LinkOut Help [Internet]">
|
|
<meta name="citation_title" content="Information for Other Resource Providers">
|
|
<meta name="citation_publisher" content="National Center for Biotechnology Information (US)">
|
|
<meta name="citation_date" content="2023/06/30">
|
|
<meta name="citation_fulltext_html_url" content="https://www.ncbi.nlm.nih.gov/books/NBK3802/">
|
|
<link rel="schema.DC" href="http://purl.org/DC/elements/1.0/">
|
|
<meta name="DC.Title" content="Information for Other Resource Providers">
|
|
<meta name="DC.Type" content="Text">
|
|
<meta name="DC.Publisher" content="National Center for Biotechnology Information (US)">
|
|
<meta name="DC.Date" content="2023/06/30">
|
|
<meta name="DC.Identifier" content="https://www.ncbi.nlm.nih.gov/books/NBK3802/">
|
|
<meta name="description" content="LinkOut is a feature of NCBI databases where third parties provide information to link specific NCBI database records to relevant Web-accessible online resources, such as full-text publications, molecular biology databases (i.e., organism-specific, taxonomy, structure, etc.), catalogs of research materials (clones, cell cultures, primers, etc.), funding sources, medical resources, research groups, and others. This document explains how providers of resources other than online full text can participate in LinkOut by supplying NCBI with the necessary information for creating links from NCBI database records to the providers' resources.">
|
|
<meta name="og:title" content="Information for Other Resource Providers">
|
|
<meta name="og:type" content="book">
|
|
<meta name="og:description" content="LinkOut is a feature of NCBI databases where third parties provide information to link specific NCBI database records to relevant Web-accessible online resources, such as full-text publications, molecular biology databases (i.e., organism-specific, taxonomy, structure, etc.), catalogs of research materials (clones, cell cultures, primers, etc.), funding sources, medical resources, research groups, and others. This document explains how providers of resources other than online full text can participate in LinkOut by supplying NCBI with the necessary information for creating links from NCBI database records to the providers' resources.">
|
|
<meta name="og:url" content="https://www.ncbi.nlm.nih.gov/books/NBK3802/">
|
|
<meta name="og:site_name" content="NCBI Bookshelf">
|
|
<meta name="og:image" content="https://www.ncbi.nlm.nih.gov/corehtml/pmc/pmcgifs/bookshelf/thumbs/th-helplinkout-lrg.png">
|
|
<meta name="twitter:card" content="summary">
|
|
<meta name="twitter:site" content="@ncbibooks">
|
|
<meta name="bk-non-canon-loc" content="/books/n/helplinkout/nonbib/?report=reader">
|
|
<link rel="canonical" href="https://www.ncbi.nlm.nih.gov/books/NBK3802/">
|
|
<link href="https://fonts.googleapis.com/css?family=Archivo+Narrow:400,700,400italic,700italic&subset=latin" rel="stylesheet" type="text/css">
|
|
<link rel="stylesheet" href="/corehtml/pmc/jatsreader/ptpmc_3.22/css/libs.min.css">
|
|
<link rel="stylesheet" href="/corehtml/pmc/jatsreader/ptpmc_3.22/css/jr.min.css">
|
|
<meta name="format-detection" content="telephone=no">
|
|
<link rel="stylesheet" href="/corehtml/pmc/css/bookshelf/2.26/css/books.min.css" type="text/css">
|
|
<link rel="stylesheet" href="/corehtml/pmc/css/bookshelf/2.26/css//books_print.min.css" type="text/css" media="print">
|
|
<link rel="stylesheet" href="/corehtml/pmc/css/bookshelf/2.26/css/books_reader.min.css" type="text/css">
|
|
<style type="text/css">p a.figpopup{display:inline !important} .bk_tt {font-family: monospace} .first-line-outdent .bk_ref {display: inline} .body-content h2, .body-content .h2 {border-bottom: 1px solid #97B0C8} .body-content h2.inline {border-bottom: none} a.page-toc-label , .jig-ncbismoothscroll a {text-decoration:none;border:0 !important} .temp-labeled-list .graphic {display:inline-block !important} .temp-labeled-list img{width:100%}</style>
|
|
|
|
<link rel="shortcut icon" href="//www.ncbi.nlm.nih.gov/favicon.ico">
|
|
<meta name="ncbi_phid" content="CE8E4CCE7D9FFA410000000000ED00D1.m_5">
|
|
<meta name='referrer' content='origin-when-cross-origin'/><link type="text/css" rel="stylesheet" href="//static.pubmed.gov/portal/portal3rc.fcgi/4216699/css/3852956/3849091.css"></head>
|
|
<body>
|
|
<!-- Book content! -->
|
|
|
|
|
|
<div id="jr" data-jr-path="/corehtml/pmc/jatsreader/ptpmc_3.22/"><div class="jr-unsupported"><table class="modal"><tr><td><span class="attn inline-block"></span><br />Your browser does not support the NLM PubReader view.<br />Go to <a href="/pmc/about/pr-browsers/">this page</a> to see a list of supported browsers<br />or return to the <br /><a href="/books/NBK3802/?report=classic">regular view</a>.</td></tr></table></div><div id="jr-ui" class="hidden"><nav id="jr-head"><div class="flexh tb"><div id="jr-tb1"><a id="jr-links-sw" class="hidden" title="Links"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" x="0px" y="0px" viewBox="0 0 70.6 85.3" style="enable-background:new 0 0 70.6 85.3;vertical-align:middle" xml:space="preserve" width="24" height="24">
|
|
<style type="text/css">.st0{fill:#939598;}</style>
|
|
<g>
|
|
<path class="st0" d="M36,0C12.8,2.2-22.4,14.6,19.6,32.5C40.7,41.4-30.6,14,35.9,9.8"></path>
|
|
<path class="st0" d="M34.5,85.3c23.2-2.2,58.4-14.6,16.4-32.5c-21.1-8.9,50.2,18.5-16.3,22.7"></path>
|
|
<path class="st0" d="M34.7,37.1c66.5-4.2-4.8-31.6,16.3-22.7c42.1,17.9,6.9,30.3-16.4,32.5h1.7c-66.2,4.4,4.8,31.6-16.3,22.7 c-42.1-17.9-6.9-30.3,16.4-32.5"></path>
|
|
</g>
|
|
</svg> Books</a></div><div class="jr-rhead f1 flexh"><div class="head"><a href="/books/n/helplinkout/ft/?report=reader"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M75,30 c-80,60 -80,0 0,60 c-30,-60 -30,0 0,-60"></path><text x="20" y="28" textLength="60" style="font-size:25px">Prev</text></svg></a></div><div class="body"><div class="t">Information for Other Resource Providers</div><div class="j">LinkOut Help [Internet]</div></div><div class="tail"><a href="/books/n/helplinkout/related/?report=reader"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M25,30c80,60 80,0 0,60 c30,-60 30,0 0,-60"></path><text x="20" y="28" textLength="60" style="font-size:25px">Next</text></svg></a></div></div><div id="jr-tb2"><a id="jr-bkhelp-sw" class="btn wsprkl hidden" title="Help with NLM PubReader">?</a><a id="jr-help-sw" class="btn wsprkl hidden" title="Settings and typography in NLM PubReader"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" preserveAspectRatio="none"><path d="M462,283.742v-55.485l-29.981-10.662c-11.431-4.065-20.628-12.794-25.274-24.001 c-0.002-0.004-0.004-0.009-0.006-0.013c-4.659-11.235-4.333-23.918,0.889-34.903l13.653-28.724l-39.234-39.234l-28.72,13.652 c-10.979,5.219-23.68,5.546-34.908,0.889c-0.005-0.002-0.01-0.003-0.014-0.005c-11.215-4.65-19.933-13.834-24-25.273L283.741,50 h-55.484l-10.662,29.981c-4.065,11.431-12.794,20.627-24.001,25.274c-0.005,0.002-0.009,0.004-0.014,0.005 c-11.235,4.66-23.919,4.333-34.905-0.889l-28.723-13.653l-39.234,39.234l13.653,28.721c5.219,10.979,5.545,23.681,0.889,34.91 c-0.002,0.004-0.004,0.009-0.006,0.013c-4.649,11.214-13.834,19.931-25.271,23.998L50,228.257v55.485l29.98,10.661 c11.431,4.065,20.627,12.794,25.274,24c0.002,0.005,0.003,0.01,0.005,0.014c4.66,11.236,4.334,23.921-0.888,34.906l-13.654,28.723 l39.234,39.234l28.721-13.652c10.979-5.219,23.681-5.546,34.909-0.889c0.005,0.002,0.01,0.004,0.014,0.006 c11.214,4.649,19.93,13.833,23.998,25.271L228.257,462h55.484l10.595-29.79c4.103-11.538,12.908-20.824,24.216-25.525 c0.005-0.002,0.009-0.004,0.014-0.006c11.127-4.628,23.694-4.311,34.578,0.863l28.902,13.738l39.234-39.234l-13.66-28.737 c-5.214-10.969-5.539-23.659-0.886-34.877c0.002-0.005,0.004-0.009,0.006-0.014c4.654-11.225,13.848-19.949,25.297-24.021 L462,283.742z M256,331.546c-41.724,0-75.548-33.823-75.548-75.546s33.824-75.547,75.548-75.547 c41.723,0,75.546,33.824,75.546,75.547S297.723,331.546,256,331.546z"></path></svg></a><a id="jr-fip-sw" class="btn wsprkl hidden" title="Find"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 550 600" preserveAspectRatio="none"><path fill="none" stroke="#000" stroke-width="36" stroke-linecap="round" style="fill:#FFF" d="m320,350a153,153 0 1,0-2,2l170,170m-91-117 110,110-26,26-110-110"></path></svg></a><a id="jr-rtoc-sw" class="btn wsprkl hidden" title="Table of Contents"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M20,20h10v8H20V20zM36,20h44v8H36V20zM20,37.33h10v8H20V37.33zM36,37.33h44v8H36V37.33zM20,54.66h10v8H20V54.66zM36,54.66h44v8H36V54.66zM20,72h10v8 H20V72zM36,72h44v8H36V72z"></path></svg></a></div></div></nav><nav id="jr-dash" class="noselect"><nav id="jr-dash" class="noselect"><div id="jr-pi" class="hidden"><a id="jr-pi-prev" class="hidden" title="Previous page"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M75,30 c-80,60 -80,0 0,60 c-30,-60 -30,0 0,-60"></path><text x="20" y="28" textLength="60" style="font-size:25px">Prev</text></svg></a><div class="pginfo">Page <i class="jr-pg-pn">0</i> of <i class="jr-pg-lp">0</i></div><a id="jr-pi-next" class="hidden" title="Next page"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M25,30c80,60 80,0 0,60 c30,-60 30,0 0,-60"></path><text x="20" y="28" textLength="60" style="font-size:25px">Next</text></svg></a></div><div id="jr-is-tb"><a id="jr-is-sw" class="btn wsprkl hidden" title="Switch between Figures/Tables strip and Progress bar"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><rect x="10" y="40" width="20" height="20"></rect><rect x="40" y="40" width="20" height="20"></rect><rect x="70" y="40" width="20" height="20"></rect></svg></a></div><nav id="jr-istrip" class="istrip hidden"><a id="jr-is-prev" href="#" class="hidden" title="Previous"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M80,40 60,65 80,90 70,90 50,65 70,40z M50,40 30,65 50,90 40,90 20,65 40,40z"></path><text x="35" y="25" textLength="60" style="font-size:25px">Prev</text></svg></a><a id="jr-is-next" href="#" class="hidden" title="Next"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M20,40 40,65 20,90 30,90 50,65 30,40z M50,40 70,65 50,90 60,90 80,65 60,40z"></path><text x="15" y="25" textLength="60" style="font-size:25px">Next</text></svg></a></nav><nav id="jr-progress"></nav></nav></nav><aside id="jr-links-p" class="hidden flexv"><div class="tb sk-htbar flexh"><div><a class="jr-p-close btn wsprkl">Done</a></div><div class="title-text f1">NCBI Bookshelf</div></div><div class="cnt lol f1"><a href="/books/">Home</a><a href="/books/browse/">Browse All Titles</a><a class="btn share" target="_blank" rel="noopener noreferrer" href="https://www.facebook.com/sharer/sharer.php?u=https://www.ncbi.nlm.nih.gov/books/NBK3802/"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 33 33" style="vertical-align:middle" width="24" height="24" preserveAspectRatio="none"><g><path d="M 17.996,32L 12,32 L 12,16 l-4,0 l0-5.514 l 4-0.002l-0.006-3.248C 11.993,2.737, 13.213,0, 18.512,0l 4.412,0 l0,5.515 l-2.757,0 c-2.063,0-2.163,0.77-2.163,2.209l-0.008,2.76l 4.959,0 l-0.585,5.514L 18,16L 17.996,32z"></path></g></svg> Share on Facebook</a><a class="btn share" target="_blank" rel="noopener noreferrer" href="https://twitter.com/intent/tweet?url=https://www.ncbi.nlm.nih.gov/books/NBK3802/&text=Information%20for%20Other%20Resource%20Providers"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 33 33" style="vertical-align:middle" width="24" height="24"><g><path d="M 32,6.076c-1.177,0.522-2.443,0.875-3.771,1.034c 1.355-0.813, 2.396-2.099, 2.887-3.632 c-1.269,0.752-2.674,1.299-4.169,1.593c-1.198-1.276-2.904-2.073-4.792-2.073c-3.626,0-6.565,2.939-6.565,6.565 c0,0.515, 0.058,1.016, 0.17,1.496c-5.456-0.274-10.294-2.888-13.532-6.86c-0.565,0.97-0.889,2.097-0.889,3.301 c0,2.278, 1.159,4.287, 2.921,5.465c-1.076-0.034-2.088-0.329-2.974-0.821c-0.001,0.027-0.001,0.055-0.001,0.083 c0,3.181, 2.263,5.834, 5.266,6.438c-0.551,0.15-1.131,0.23-1.73,0.23c-0.423,0-0.834-0.041-1.235-0.118 c 0.836,2.608, 3.26,4.506, 6.133,4.559c-2.247,1.761-5.078,2.81-8.154,2.81c-0.53,0-1.052-0.031-1.566-0.092 c 2.905,1.863, 6.356,2.95, 10.064,2.95c 12.076,0, 18.679-10.004, 18.679-18.68c0-0.285-0.006-0.568-0.019-0.849 C 30.007,8.548, 31.12,7.392, 32,6.076z"></path></g></svg> Share on Twitter</a></div></aside><aside id="jr-rtoc-p" class="hidden flexv"><div class="tb sk-htbar flexh"><div><a class="jr-p-close btn wsprkl">Done</a></div><div class="title-text f1">Table of Content</div></div><div class="cnt lol f1"><a href="/books/n/helplinkout/?report=reader">Title Information</a><a href="/books/n/helplinkout/toc/?report=reader">Table of Contents Page</a></div></aside><aside id="jr-help-p" class="hidden flexv"><div class="tb sk-htbar flexh"><div><a class="jr-p-close btn wsprkl">Done</a></div><div class="title-text f1">Settings</div></div><div class="cnt f1"><div id="jr-typo-p" class="typo"><div><a class="sf btn wsprkl">A-</a><a class="lf btn wsprkl">A+</a></div><div><a class="bcol-auto btn wsprkl"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 100" preserveAspectRatio="none"><text x="10" y="70" style="font-size:60px;font-family: Trebuchet MS, ArialMT, Arial, sans-serif" textLength="180">AUTO</text></svg></a><a class="bcol-1 btn wsprkl"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M15,25 85,25zM15,40 85,40zM15,55 85,55zM15,70 85,70z"></path></svg></a><a class="bcol-2 btn wsprkl"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M5,25 45,25z M55,25 95,25zM5,40 45,40z M55,40 95,40zM5,55 45,55z M55,55 95,55zM5,70 45,70z M55,70 95,70z"></path></svg></a></div></div><div class="lol"><a class="" href="/books/NBK3802/?report=classic">Switch to classic view</a><a href="/books/NBK3802/pdf/Bookshelf_NBK3802.pdf">PDF (452K)</a><a href="/books/n/helplinkout/pdf/">PDF (2.6M)</a><a href="/books/NBK3802/?report=printable">Print View</a></div></div></aside><aside id="jr-bkhelp-p" class="hidden flexv"><div class="tb sk-htbar flexh"><div><a class="jr-p-close btn wsprkl">Done</a></div><div class="title-text f1">Help</div></div><div class="cnt f1 lol"><a id="jr-helpobj-sw" data-path="/corehtml/pmc/jatsreader/ptpmc_3.22/" data-href="/corehtml/pmc/jatsreader/ptpmc_3.22/img/bookshelf/help.xml" href="">Help</a><a href="mailto:info@ncbi.nlm.nih.gov?subject=PubReader%20feedback%20%2F%20NBK3802%20%2F%20sid%3ACE8BC1E97D9F05E1_0182SID%20%2F%20phid%3ACE8E4CCE7D9FFA410000000000ED00D1.4">Send us feedback</a><a id="jr-about-sw" data-path="/corehtml/pmc/jatsreader/ptpmc_3.22/" data-href="/corehtml/pmc/jatsreader/ptpmc_3.22/img/bookshelf/about.xml" href="">About PubReader</a></div></aside><aside id="jr-objectbox" class="thidden hidden"><div class="jr-objectbox-close wsprkl">✘</div><div class="jr-objectbox-inner cnt"><div class="jr-objectbox-drawer"></div></div></aside><nav id="jr-pm-left" class="hidden"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 800" preserveAspectRatio="none"><text font-stretch="ultra-condensed" x="800" y="-15" text-anchor="end" transform="rotate(90)" font-size="18" letter-spacing=".1em">Previous Page</text></svg></nav><nav id="jr-pm-right" class="hidden"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 800" preserveAspectRatio="none"><text font-stretch="ultra-condensed" x="800" y="-15" text-anchor="end" transform="rotate(90)" font-size="18" letter-spacing=".1em">Next Page</text></svg></nav><nav id="jr-fip" class="hidden"><nav id="jr-fip-term-p"><input type="search" placeholder="search this page" id="jr-fip-term" autocorrect="off" autocomplete="off" /><a id="jr-fip-mg" class="wsprkl btn" title="Find"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 550 600" preserveAspectRatio="none"><path fill="none" stroke="#000" stroke-width="36" stroke-linecap="round" style="fill:#FFF" d="m320,350a153,153 0 1,0-2,2l170,170m-91-117 110,110-26,26-110-110"></path></svg></a><a id="jr-fip-done" class="wsprkl btn" title="Dismiss find">✘</a></nav><nav id="jr-fip-info-p"><a id="jr-fip-prev" class="wsprkl btn" title="Jump to previuos match">◀</a><button id="jr-fip-matches">no matches yet</button><a id="jr-fip-next" class="wsprkl btn" title="Jump to next match">▶</a></nav></nav></div><div id="jr-epub-interstitial" class="hidden"></div><div id="jr-content"><article data-type="main"><div class="main-content lit-style" itemscope="itemscope" itemtype="http://schema.org/CreativeWork"><div class="meta-content fm-sec"><div class="fm-sec"><h1 id="_NBK3802_"><span class="title" itemprop="name">Information for Other Resource Providers</span></h1><p class="fm-aai"><a href="#_NBK3802_pubdet_">Publication Details</a></p><p><em>Estimated reading time: 20 minutes</em></p></div></div><div class="jig-ncbiinpagenav body-content whole_rhythm" data-jigconfig="allHeadingLevels: ['h2'],smoothScroll: false" itemprop="text"><p>LinkOut is a feature of NCBI databases where third parties provide information to link specific NCBI database records to relevant Web-accessible online resources, such as full-text publications, molecular biology databases (i.e., organism-specific, taxonomy, structure, etc.), catalogs of research materials (clones, cell cultures, primers, etc.), funding sources, medical resources, research groups, and others. This document explains how providers of resources other than online full text can participate in LinkOut by supplying NCBI with the necessary information for creating links from NCBI database records to the providers' resources.</p><div id="nonbib.How_It_Works"><h2 id="_nonbib_How_It_Works_">How It Works</h2><p>LinkOut provides links from PubMed records and other NCBI database records to online resources external to the NCBI systems. All linking information is submitted by LinkOut providers - the owner or agent for the owner of the online resource. LinkOut providers are responsible for maintaining their links.</p><p>To submit links to your resource, you will need to upload two XML files, an identity file and a resource file (see below File Preparation). The identity file contains the information about your organization needed to list your resource in LinkOut. The resource file describes the database records you will link from and contains the information that LinkOut needs to generate URLs.</p></div><div id="nonbib.Prerequisites_for_Participation"><h2 id="_nonbib_Prerequisites_for_Participation_">Prerequisites for Participation</h2><p>Resources submitted for inclusion in LinkOut will be evaluated individually to determine whether they meet our inclusion criteria.</p><p>Resources eligible for linking from NCBI databases must be directly relevant to the specific subjects of the NCBI database records and useful to users' study and research. Resources from professional societies, government agencies, educational institutions, or individuals and organizations that have received grants from major funding organizations are preferred.</p><p>Please review the <a href="/books/n/helplinkout/policies/?report=reader#policies.Guidelines_for_Evaluation_of_Re">Guidelines for Evaluation of Resources</a> before applying for inclusion in LinkOut. Resources with a commercial interest should pay particular attention to the <a href="/books/n/helplinkout/policies/?report=reader#policies.Additional_Information_for_Comm">Additional Information for Commercial Interests</a> section of the Guidelines.</p></div><div id="nonbib.Apply_for_Inclusion_in_LinkOut"><h2 id="_nonbib_Apply_for_Inclusion_in_LinkOut_">Apply for Inclusion in LinkOut</h2><p>To apply for inclusion in LinkOut, send an email to <a href="mailto:dev@null" data-email="vog.hin.mln.ibcn@tuoknil" class="oemail">vog.hin.mln.ibcn@tuoknil</a>. Include the following information:</p><ul><li class="half_rhythm"><div>Name, email address, and phone number of a contact person in your organization.</div></li><li class="half_rhythm"><div>The scope of your resource, including the URL of the resource. If a username and password are required to access the resource, please include a temporary username and password that the LinkOut team can use to evaluate the resource. Also, please describe the type of NCBI database records to which you would like to apply links and provide a couple URL examples of your database records and their corresponding NCBI database records.</div></li><li class="half_rhythm"><div>Describe any restrictions on access to the resource.</div></li></ul></div><div id="nonbib.File_Preparation_Identity_File"><h2 id="_nonbib_File_Preparation_Identity_File_">File Preparation: Identity File</h2><p>The identity file contains the information needed to list a provider in LinkOut. This file must be named <b>providerinfo.xml</b>; the file name is case sensitive. This file should be composed in a text editor, such as NotePad, not in a word processing program.</p><p>The following is an example providerinfo.xml file for the LinkOut participant, WebDatabase Co., with Provider Id <b>7777</b> and NameAbbr <b>WebDB</b>.</p><pre><?xml version="1.0"?><br /><!DOCTYPE Provider PUBLIC "-//NLM//DTD LinkOut 1.0//EN"<br />"https://www.ncbi.nlm.nih.gov/projects/linkout/doc/LinkOut.dtd"><br /><Provider><br /><b><!-- ProviderId is assigned by NCBI --></b><br /> <ProviderId>7777</ProviderId><br /> <Name>WebDatabase Co.</Name><br /> <NameAbbr>WebDB</NameAbbr><br /> <SubjectType> gene/protein/disease-specific</SubjectType><br /> <Attribute>registration required</Attribute><br /><b><!-- Url is used in My NCBI and in the lists of LinkOut Providers --></b><br /> <Url>http://www.webdatabase.com</Url><br /><b><!-- Brief is used in My NCBI --></b><br /> <Brief> On-line publisher of biomedical databases</Brief><br /></Provider></pre><p><<a href="/books/n/helplinkout/files/?report=reader#files.Special_Elements_SubjectType">SubjectType</a>> and <<a href="/books/n/helplinkout/files/?report=reader#files.Special_Elements_Attribute">Attribute</a>> elements included in the providerinfo.xml file will apply to all links submitted by the provider. In the example above, access to all databases published by WebDatabase Co. requires a free registration, therefore <Attribute>registration required</Attribute> has been included in the providerinfo.xml file.</p></div><div id="nonbib.File_Preparation_Resource_File_XM"><h2 id="_nonbib_File_Preparation_Resource_File_XM_">File Preparation: Resource File (XML)</h2><p>
|
|
<b>Section Contents:</b>
|
|
</p><ul><li class="half_rhythm"><div>
|
|
<a href="#nonbib.XML_Resource_File_Format">Resource File Format</a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib._ObjectList_Selecting_Records_in"><ObjectList>: Selecting Records in a Resource File</a>
|
|
</div><ul><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Selecting_Records_Using__ObjId">Selecting Records Using <ObjId></a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Selecting_Records_Using__Query">Selecting Records Using <Query></a>
|
|
</div><ul><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Tips_for_Using__Query">Tips for Using <Query></a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Additional_Information_on_Using">Additional Information on Using <Query> When Linking to PubMed Citations</a>
|
|
</div></li></ul></li></ul></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib._ObjectUrl_Specifying_the_Link_to"><ObjectUrl>: Specifying the Link to Access the Resource</a>
|
|
</div><ul><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Creating_a_URL_for_a_Link">Creating the URL for the Link</a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Describing_the_Resource">Describing the Resource</a>
|
|
</div></li></ul></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Resource_File_Examples">Resource File Examples</a>
|
|
</div></li></ul><p>The resource file describes the database records to which your links will be applied and contains the information that LinkOut needs to generate URLs. Links described in the resource file must link directly to the relevant resource, requiring no additional searching to access the resource after a user clicks on the provider’s link.</p><div id="nonbib.XML_Resource_File_Format"><h3>XML: Resource File Format</h3><p>XML resource files must have a file extension <b>.xml</b>; the file extension is case sensitive. File names may contain alpha-numeric characters and underscores only. Special characters and spaces are not allowed. Typically, files are named <b>resources.xml</b>. To help with file management, a provider may supply more than one resource file. File size may not exceed 20 MB. This file should be composed in a text editor, such as NotePad, not in a word processing program.</p><p>The resource file below describes links from NCBI’s Nucleotide database to a <i>C. elegans</i> sequence database provided by WebDatabase Co., ProviderId 7777.</p><pre><?xml version="1.0"?><br /><!DOCTYPE LinkSet PUBLIC "-//NLM//DTD LinkOut 1.0//EN"<br />"https://www.ncbi.nlm.nih.gov/projects/linkout/doc/LinkOut.dtd"<br />[ <!ENTITY icon.url "https://www.webdatabase.com/images/webdb.gif"><br /><!ENTITY base.url "https://www.webdatabase.com/cgi-bin/elegans?">]><br /><LinkSet><br /> <Link><br /> <LinkId>1</LinkId><br /> <ProviderId>7777</ProviderId><br /> <ObjectSelector><br /> <Database>Nucleotide</Database><br /> <ObjectList><br /> <Query>Caenorhabditis elegans [orgn]</Query><br /> </ObjectList><br /> </ObjectSelector><br /> <ObjectUrl><br /> <Base>&base.url;</Base><br /> <Rule>an_lookup=&lo.pacc;</Rule><br /> <UrlName>Caenorhabditis elegans</UrlName><br /> <SubjectType>organism-specific</SubjectType><br /> </ObjectUrl><br /> </Link><br /></LinkSet> </pre></div><div id="nonbib._ObjectList_Selecting_Records_in"><h3><ObjectList>: Selecting Records in a Resource File</h3><p>The <ObjectList> element is used to select the database records to which links will be applied. <ObjectList> contains one or more <Query> elements OR one or more <ObjId> elements. <Query> elements contain a valid search query with a valid field descriptor that will retrieve the records to which the link described in <ObjectUrl> will be applied. <ObjId> elements contain the Unique Identifier of the database records to which the link described in <ObjectUrl> will be applied.</p><div id="nonbib.Selecting_Records_Using__ObjId"><h4>Selecting Records Using <ObjId></h4><p><ObjId> contains the unique identifier for a record in an NCBI database. For example, Taxonomy ID for the Taxonomy database.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTc"><a href="/books/NBK3802/table/nonbib.Tc/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTc"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tc"><a href="/books/NBK3802/table/nonbib.Tc/?report=objectonly" target="object" rid-ob="figobnonbibTc">Table</a></h4></div></div><p>More than one <ObjId> can be used in an <ObjectList>.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTd"><a href="/books/NBK3802/table/nonbib.Td/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTd"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Td"><a href="/books/NBK3802/table/nonbib.Td/?report=objectonly" target="object" rid-ob="figobnonbibTd">Table</a></h4></div></div><p>Because <ObjId> requires more maintenance than <Query>, NCBI recommends using <Query> whenever possible. When <ObjId> is used, the provider is responsible for updating the holdings file as new records are submitted to PubMed.</p></div><div id="nonbib.Selecting_Records_Using__Query"><h4>Selecting Records Using <Query></h4><p>The <Query> element contains a valid NCBI database search. A valid search term or terms should include the corresponding field descriptors. For example, a search query for Arabidopsis Thaliana would be: Arabidopsis Thaliana[orgn]. A search query for the Genbank accession number <a href="/nuccore/330371308" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">HM047434</a> would be <a href="/nuccore/330371308" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">HM047434</a> [pacc].</p><p>See <a href="https://www.ncbi.nlm.nih.gov/books/NBK3837/" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">Entrez Help</a> for information on constructing search queries and field descriptors. Links will be applied to the citations retrieved by the search.</p><div id="nonbib.Tips_for_Using__Query"><h5>Tips for Using <Query></h5><dl class="temp-labeled-list"><dl class="bkr_refwrap"><dt>1.</dt><dd><p class="no_top_margin">Ranging is not allowed in Unique Identifier searches. For journal searches, ranging is additionally not allowed in Volume, Issue, or Page searches.</p></dd></dl><dl class="bkr_refwrap"><dt>2.</dt><dd><p class="no_top_margin">Truncation is not allowed in search statements.</p></dd></dl><dl class="bkr_refwrap"><dt>3.</dt><dd><p class="no_top_margin">Search field descriptors (for example, [orgn] for organism or [pacc] for primary accession number) must be used with <Query></p></dd></dl><dl class="bkr_refwrap"><dt>4.</dt><dd><p class="no_top_margin">To include a date range in searches, use this format: startyear:endyear[dp]. Dates should be notated as YYYY/MM/DD. Month and Day are optional.</p></dd></dl><dl class="bkr_refwrap"><dt>5.</dt><dd><p class="no_top_margin">Do not use the search field descriptors [sb] or [filter].</p></dd></dl><dl class="bkr_refwrap"><dt>6.</dt><dd><p class="no_top_margin">Boolean operators AND, OR, NOT must be in uppercase.</p></dd></dl><dl class="bkr_refwrap"><dt>7.</dt><dd><p class="no_top_margin">Use either NLM’s Title Abbreviations [ta] or ISSN numbers in journal searches. Title Abbreviations must be entered in double quotes, e.g., “J Mol Dis” [ta].<div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTe"><a href="/books/NBK3802/table/nonbib.Te/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTe"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Te"><a href="/books/NBK3802/table/nonbib.Te/?report=objectonly" target="object" rid-ob="figobnonbibTe">Table</a></h4></div></div>
|
|
</p></dd></dl></dl><p>See the <a href="https://www.ncbi.nlm.nih.gov/nuccore?CMD=search&DB=nucleotide&term=Caenorhabditis+elegans%5Borgn%5D+AND+1996%3A1999%5Bpdat%5D" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">results</a> of this <Query> in the Nucleotide database.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTf"><a href="/books/NBK3802/table/nonbib.Tf/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTf"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tf"><a href="/books/NBK3802/table/nonbib.Tf/?report=objectonly" target="object" rid-ob="figobnonbibTf">Table</a></h4></div></div><p>See the <a href="https://www.ncbi.nlm.nih.gov/nuccore?CMD=search&DB=nucleotide&term=Caenorhabditis+elegans%5Borgn%5D+AND+smith+j%5Bauth%5D" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">results</a> of this <Query> in the Nucleotide database.</p><p>More than one <Query> can be listed within the <ObjectList>, as shown in the example below.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTg"><a href="/books/NBK3802/table/nonbib.Tg/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTg"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tg"><a href="/books/NBK3802/table/nonbib.Tg/?report=objectonly" target="object" rid-ob="figobnonbibTg">Table</a></h4></div></div><p>See the <a href="https://www.ncbi.nlm.nih.gov/genome/?term=(chimpanzee%5Borgn%5D+AND+2000%3A2010%5BCreate+Date%5D)+OR+(human%5Borgn%5D+AND+2002%3A2010%5BCreate+Date%5D)" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">results</a> for this <ObjectList> in the Genome database.</p></div><div id="nonbib.Additional_Information_on_Using"><h5>Additional Information on Using <Query> for Linking</h5><p>When using Genbank accession numbers with <Query> include the field descriptor for primary accession number [pacc] to ensure that search results are directly related to the Genbank number included in the search query.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTh"><a href="/books/NBK3802/table/nonbib.Th/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTh"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Th"><a href="/books/NBK3802/table/nonbib.Th/?report=objectonly" target="object" rid-ob="figobnonbibTh">Table</a></h4></div></div><p>See the <a href="https://www.ncbi.nlm.nih.gov/nuccore/330371308" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">results</a> for this <Query> in Nucleotide.</p><p>MeSH headings can be used to create links in PubMed. In this case, the <Query> should be very precise. Only Major headings should be used in the <Query> and noexp should be used so the terms will not be exploded.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTi"><a href="/books/NBK3802/table/nonbib.Ti/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTi"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Ti"><a href="/books/NBK3802/table/nonbib.Ti/?report=objectonly" target="object" rid-ob="figobnonbibTi">Table</a></h4></div></div><p>See the <a href="https://www.ncbi.nlm.nih.gov/pubmed/?term=%22Acupuncture+Therapy%2Fmethods%E2%80%9D%5Bmajr%3Anoexp%5D" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">results</a> for this <Query> in PubMed.</p></div></div></div><div id="nonbib._ObjectUrl_Specifying_the_Link_to"><h3><ObjectUrl>: Specifying the Link to Access the Resource</h3><p>The <ObjectUrl> element is used to describe the link to the online resource. <ObjectUrl> contains the sub-elements <Base>, <Rule>, <SubjectType>, <Attribute>, and <UrlName>. <Base> and <Rule> are concatenated to form the URL for the link. <SubjectType>, <Attribute>, and <UrlName> describe the resource to which the record is being linked.</p><div id="nonbib.Creating_a_URL_for_a_Link"><h4>Creating a URL for a Link</h4><p><Base> is the stable portion of the URL for the provider’s resource. This is usually the provider website or CGI program.</p><p><Rule> is the remainder of the URL needed to access the appropriate record within the resource.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTj"><a href="/books/NBK3802/table/nonbib.Tj/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTj"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tj"><a href="/books/NBK3802/table/nonbib.Tj/?report=objectonly" target="object" rid-ob="figobnonbibTj">Table</a></h4></div></div><p>If the URL for the resource follows a pattern using variable values that are found in a database record, the pattern can be described in the <Rule> element, and LinkOut can insert the appropriate values for each citation. This allows many links to be generated from the information in a single <ObjectUrl>.</p><p>URL patterns are described using LinkOut’s XML entities. An XML entity is a short text string that represents a type of value. During LinkOut processing, the text string is replaced in the URL by the appropriate value for each record.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTk"><a href="/books/NBK3802/table/nonbib.Tk/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTk"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tk"><a href="/books/NBK3802/table/nonbib.Tk/?report=objectonly" target="object" rid-ob="figobnonbibTk">Table</a></h4></div></div><p>Using this <Base> and <Rule>, the URL constructed for the record with accession number <a href="/nuccore/3810674" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">AL032671</a> would be <i>https://www.webdatabase.com/cgi-bin/elegans?an_lookup=<a href="/nuccore/3810674" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">AL032671</a></i></p><p>Entities can be combined with other information in the <Rule>.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTl"><a href="/books/NBK3802/table/nonbib.Tl/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTl"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tl"><a href="/books/NBK3802/table/nonbib.Tl/?report=objectonly" target="object" rid-ob="figobnonbibTl">Table</a></h4></div></div><p>In this case, the URL generated for the record with the unique ID "6016240" would be: https://www.webdatabase.com/cgi-bin/db=elegans&id_lookup=6016240&view=text</p><p>LinkOut does not support Unicode (UTF-8) and requires that certain special characters be encoded in files.</p></div><div id="nonbib.Describing_the_Resource"><h4>Describing the Resource</h4><p>The relevance of resources linked from NCBI database records should be readily apparent to users. The name and/or description of the resource should convey something about the information that is being offered and its relevance.</p><p>The elements <SubjectType> and <Attribute> are used in the <ObjectUrl> to describe resources. Available SubjectTypes can be found in <a href="/books/n/helplinkout/files/?report=reader#files.Special_Elements_SubjectType">Special Elements: SubjectType</a>. Available Attributes can be found in <a href="/books/n/helplinkout/files/?report=reader#files.Special_Elements_Attribute">Special Elements: Attribute.</a></p><p>If the available SubjectTypes and Attributes do not suffice to describe the resource, UrlName can be used as well. If no SubjectType is given, the SubjectType “miscellaneous” will be assigned automatically.</p><p>The application of SubjectTypes and Attributes is at the discretion of the resource provider. However, if there are any barriers to accessing the resource, one of the following Barrier Attributes must be used:</p><blockquote><p><Attribute>registration required</Attribute><br /><Attribute>subscription/membership/fee required</Attribute></p></blockquote><p>Continuing the example above, if WebDatabase Co. requires a subscription to access the <i>C. elegans</i> database, the <ObjectUrl> element might look like this:</p><pre><ObjectUrl><br /><Base>https://www.webdatabase.com/cgi-bin/</Base><br /><Rule>/db=elegans&amp;id_lookup=&lo.id;&amp;view=text</Rule><br /><Attribute>subscription/membership/fee required</Attribute><br /></ObjectUrl></pre></div></div><div id="nonbib.Resource_File_Examples"><h3>Resource File Examples</h3><p><b>Example 1:</b> Molecular Biology Database, Inc., Provider Id 1234, provides links to freely available information for the Taxonomy records with IDs 9606 and 111063. URLs for the database entries are created using a text string that is not included in Taxonomy, so links are created individually for each record. To minimize the repetition of textual data, the Base for the URL has been defined as an Entity in the Prolog of the file.</p><pre><!DOCTYPE LinkSet PUBLIC "-//NLM//DTD LinkOut 1.0//EN"<br />"https://www.ncbi.nlm.nih.gov/projects/linkout/doc/LinkOut.dtd"<br />[<!ENTITY base.url "http://molbioco.com/animals/">]><br /><LinkSet><br /> <Link><br /> <LinkId>1</LinkId><br /> <ProviderId>1234</ProviderId><br /> <ObjectSelector><br /> <Database>taxonomy</Database><br /> <ObjectList><br /> <ObjId>9606</ObjId><br /> </ObjectList><br /> </ObjectSelector><br /> <ObjectUrl><br /> <Base>&base.url;</Base><br /> <Rule>homo/h._sapiens</Rule><br /> <UrlName>Homo sapiens</UrlName><br /> <SubjectType>taxonomy/phylogenetic</SubjectType><br /> </ObjectUrl><br /> </Link><br /><br /> <Link><br /> <LinkId>2</LinkId><br /> <ProviderId>1234</ProviderId><br /> <ObjectSelector><br /> <Database>taxonomy</Database><br /> <ObjectList><br /> <ObjId>9733</ObjId><br /> </ObjectList><br /> </ObjectSelector><br /> <ObjectUrl><br /> <Base>&base.url;</Base><br /> <Rule>orcinus/o._orca</Rule><br /> <UrlName>Orcinus orca</UrlName><br /> <SubjectType>taxonomy/phylogenetic</SubjectType><br /> </ObjectUrl><br /> </Link><br /></LinkSet></pre><p><b>Example 2:</b> Genotypes, Inc., Provider Id 4321, provides free online access to genotyping assays from records in the SNP database. SNP records are selected using the SNP unique identifier. The URL to access the assays at their site follows this pattern for each record: https://gti.com/Gateway?source= SNP&res=Assays&ap1=rs[SNP ID]</p><pre><?xml version="1.0"?><br /><!DOCTYPE LinkSet PUBLIC "-//NLM//DTD LinkOut 1.0//EN" <br />"https://www.ncbi.nlm.nih.gov/projects/linkout/doc/LinkOut.dtd"<br />[<!ENTITY base.url<br />"https://gti.com/Gateway?source=SNP&amp;res=Assays&amp;">]><br /><LinkSet><br /> <Link><br /> <LinkId>1</LinkId><br /> <ProviderId>4321</ProviderId><br /> <ObjectSelector><br /> <Database>SNP</Database><br /> <ObjectList><br /> <ObjId>7928656</ObjId><br /> <ObjId>2049045</ObjId><br /> <ObjId>1811350</ObjId><br /> <ObjId>1871598</ObjId><br /> <ObjId>7947824</ObjId><br /> <ObjId>681267</ObjId><br /> <ObjId>1947741</ObjId><br /> </ObjectList><br /> </ObjectSelector><br /> <ObjectUrl><br /> <Base>&base.url;</Base><br /> <Rule>ap1=rs&lo.id;</Rule><br /> <UrlName>Genotyping Assays</UrlName><br /> </ObjectUrl><br /> </Link><br /></LinkSet></pre><p><b>Example 3:</b> A record may be retrieved by more than one <Query>. When this happens, link assignment will be handled as described in the LinkOut Policy: Duplicate Links and Multiple Links.</p><p>If these queries are in different Link elements, <Attribute>preference</Attribute> can be used to indicate which <Link> element should be applied to the record. This is generally used in situations where the links for a subset of a range have a different URL pattern or different access restrictions. In the example below, the records included in LinkId 1 will also be selected by LinkId 2.</p><p>The LinkOut provider WebDatabase Co. provides links from the Nucleotide database to the <i>C. elegans</i> sequence database.</p><p><b>LinkId 1</b> describes links from particular Nucleotide records. The records are selected using <Query> and have a special <Rule>. Because these records are also included in LinkId 2, <Attribute>preference</Attribute> is used to indicate that only these links should be applied to these citations.</p><p><b>LinkId 2</b> provides links from all Nucleotide records on <i>C. elegans</i> to WebDatabase Co.’s <i>C. elegans</i> records, except for the records selected in LinkId 1.</p><p>As <b>LinkId 1</b> describes specific requirements, it is listed before the general <b>LinkId 2</b>.</p><pre><?xml version="1.0"?><br /><!DOCTYPE LinkSet PUBLIC "-//NLM//DTD LinkOut 1.0//EN"<br />"https://www.ncbi.nlm.nih.gov/projects/linkout/doc/LinkOut.dtd"<br />[<!ENTITY base.url "https://www.webdatabase.com/cgi-bin/elegans?">]><br /><LinkSet><br /> <Link><br /> <LinkId>1</LinkId><br /> <ProviderId>7777</ProviderId><br /> <ObjectSelector><br /> <Database>Nucleotide</Database><br /> <ObjectList><br /> <Query>Caenorhabditis elegans [orgn] AND 1997:1999 [pdat] AND smith j [auth]</Query><br /> </ObjectList><br /> </ObjectSelector><br /> <ObjectUrl><br /> <Base>&base.url;</Base><br /> <Rule>auth_lookup=j-smith&view=pdf</Rule><br /> <Attribute>Full-text PDF</Attribute><br /> <Attribute>preference</Attribute><br /> </ObjectUrl><br /> </Link><br /> <br /> <Link><br /> <LinkId>2</LinkId><br /> <ProviderId>7777</ProviderId><br /> <ObjectSelector><br /> <Database>Nucleotide</Database><br /> <ObjectList><br /> <Query>Caenorhabditis elegans [orgn]</Query><br /> </ObjectList><br /> </ObjectSelector><br /> <ObjectUrl><br /> <Base>&base.url;</Base><br /> <Rule>an_lookup=&lo.pacc;&amp;view=full</Rule><br /> </ObjectUrl><br /></Link><br /></LinkSet></pre></div></div><div id="nonbib.File_Preparation_Resource_CSV_Fil"><h2 id="_nonbib_File_Preparation_Resource_CSV_Fil_">File Preparation: Resource CSV File</h2><p>Links data can also be provided in CSV (comma separated values) files. The CSV resource file contains LinkOut data provider identifiers, database record Ids or queries, and links data to your resource pages, all of which is used to create links in <a href="https://www.ncbi.nlm.nih.gov/books/NBK3807/#files.Databases_Available_for_Linking" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">NCBI databases</a>.</p><p>A LinkOut program converts CSV files in to XML files that validate against the LinkOut DTD. Links provided in CSV files must link directly from a NCBI database record to a resource page that provides information directly related to the database record.</p><p>CSV files need to have the file extension <b>.csv</b>; the file extension is case sensitive. File names may contain alpha-numeric characters and underscores only. Special characters and spaces are not allowed. Examples of file name and extension: linksgene2015.csv, or linksnucleotide2015.csv. To help with file management, a provider may submit more than one resource file. CSV files may not exceed 10 MB each.</p><p>
|
|
<b>Section Contents</b>
|
|
</p><ul><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Resource_CSV_File_Data_Fields">Resource CSV File Data Fields</a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Resource_File_CSV_Format">Resource File CSV Format</a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Resource_CSV_File_Examples">Resource CSV File Examples</a>
|
|
</div></li></ul><div id="nonbib.Resource_CSV_File_Data_Fields"><h3>Resource CSV File Data Fields</h3><p>The CSV files used by LinkOut to create links have required and optional data fields:</p><p>Field 1: PrId (required). Provider Id assigned by NCBI to links data providers. A four-digit number.</p><p>Field 2: DB (required). NCBI database name. Enter the name of the NCBI database for which you want to provide links data.</p><p>Field 3: UID or Query (required). Each record in an NCBI database has a numerical unique identifier (UID). For example, in this Taxonomy record: <a href="https://www.ncbi.nlm.nih.gov/taxonomy/?term=37572" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">https://www.ncbi.nlm.nih.gov/taxonomy/?term=37572</a> the Taxonomy Id 37572.</p><p>NCBI database records can also be retrieved using queries. For example, Nucleotide query: Caenorhabditis elegans [orgn] AND 2011:2015[pdat] AND smith j [auth]</p><p>Field 4: URL (required). URL to the supplemental information page in your resource, which is directly related to the selected NCBI database record.</p><p>Filed 5: IconUrl (optional). URL of an icon file that you would like to represent your resource. The icon should meet the specifications described in <a href="https://www.ncbi.nlm.nih.gov/books/NBK3807/#files.Icons" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">Icons</a>. The icon URL should point directly to the icon file in your server. If an icon is not provided, LinkOut will use the LinkOut <a href="https://www.ncbi.nlm.nih.gov/corehtml/query/gifs/unknown.gif" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">generic icon</a>. Icons are only displayed in PubMed.</p><p>Field 6: UrlName(optional). Additional description about the link to content.</p><p>Field 7: SubjectType (required<b>*</b>). In this field enter a subject type selected from <a href="https://www.ncbi.nlm.nih.gov/books/NBK3807/#files.Special_Elements_SubjectType" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">this page</a> that best describes your resource. (<b>*</b>) If the subject type is present in the <a href="https://www.ncbi.nlm.nih.gov/books/NBK3802/#nonbib.File_Preparation_Identity_File" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">identity file</a>, this field should be left empty.</p><p>Field 8: Attribute (required). If access to the resource requires a license or membership, enter the following in this field: Subscription/membership/fee required. If access is free, but registration is required enter: registration required. Otherwise, if access to the resource is free and registration is not required, this field can be left empty.</p></div><div id="nonbib.Resource_File_CSV_Format"><h3>Resource File CSV Format</h3><p>Your CSV file can be formatted as a table. Each field must be separated by commas.</p><p>Field 1: PrId. Provider Id, a four-digit number. For example: 1234.</p><p>Field 2: DB. Enter the selected NCBI database name in this field. For example: Nucleotide</p><p>Field 3: Two options UID or Query:</p><p>UID. Taxonomy ID. For example: 37572</p><p>Query. A query that retrieves the Nucleotide records selected: Caenorhabditis elegans [orgn] AND 2011:2015[pdat] AND smith j [auth]</p><p>Field 4: URL. https://treebase.org/treebase-web/search/taxonSearch.html</p><p>Filed 5: IconUrl. Only needed for PubMed. Leave blank for other databases.</p><p>Field 6: UrlName. Caenorhabditis elegans</p><p>Field 7: SubjectType. organism-specific (<b>*</b>) If the ‘organism-specific’ subject type is present in the <a href="https://www.ncbi.nlm.nih.gov/books/NBK3802/#nonbib.File_Preparation_Identity_File" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">identity file</a>, this field should be left blank.</p><p>Field 8: Attribute. If access to the resource requires a license or membership, enter the following in this field: Subscription/membership/fee required. If access is free, but registration is required enter: registration required. Otherwise, if access to the resource is free and registration is not required, this field can be left empty.</p></div><div id="nonbib.Resource_CSV_File_Examples"><h3>Resource CSV File Examples</h3><p><b>Example 1.</b>
|
|
<u>Access to a resource is through license or membership</u>: Provider Id 1234, provides links for the Nucleotide record 3810674. The URL provided leads to a page that has information that supplements the Nucleotide record. The UrlName indicates the resource page topic. The subject type was provided in the <a href="https://www.ncbi.nlm.nih.gov/books/NBK3802/#nonbib.File_Preparation_Identity_File" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">identity file</a>, and consequently this field is left blank. Access to the resource is through license or membership only, therefore enter the attribute “subscription/membership/fee required” in this field.</p><p>Note that each field must be comma separated.</p><p>Field 1: PrId. 1234</p><p>Field 2: DB. Nucleotide</p><pre>Field 3: Query. <a href="/nuccore/449020133" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">BX284601.5</a>[pacc]</pre><p>Field 4: URL. http://www.origene.com/cdna/search-all.mspx?product=HCLONES&term=1B%20%28VP2%29</p><p>Filed 5: IconUrl. None needed for Nucleotide.</p><pre>Field 6: UrlName Caenorhabditis elegans chromosome I</pre><p>Field 7: SubjectType.</p><p>Field 8: Attribute. Subscription/membership/fee required</p><p>A sample file using a spreadsheet program such as MS Excel.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTm"><a href="/books/NBK3802/table/nonbib.Tm/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTm"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tm"><a href="/books/NBK3802/table/nonbib.Tm/?report=objectonly" target="object" rid-ob="figobnonbibTm">Table</a></h4></div></div><p>The same entries in a <b>sample CSV file</b> can be downloaded <a href="https://www.ncbi.nlm.nih.gov/projects/linkout/doc/LinkOutresourcecsvexample3.csv" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">here</a>. Save files with the extension <b>.csv</b>, and upload them to the “holdings” directory of the FTP assigned to you.</p><p><b>Example 2.</b>
|
|
<u>Access to a resource is free, but requires registration</u>: Provider Id 1234, provides links for Gene database records, however, queries are used instead of UID numbers. The URL provided leads to a page that has information that supplements the Gene record. The UrlName field is left blank. The subject type was not provided in the <a href="https://www.ncbi.nlm.nih.gov/books/NBK3802/#nonbib.File_Preparation_Identity_File" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">identity file</a>, and consequently it must be listed here. Access to the resource is free, but registration is required, therefore, enter the attribute “registration required” in this field. Note that each field must be comma separated.</p><p>Field 1: PrId. 1234</p><p>Field 2: DB. Gene</p><p>Field 3: Query. APOE[sym] AND chromosome 7</p><p>Field 4: URL. https://biogps.org/#goto=genereport&id=11816</p><p>Filed 5: IconUrl. None needed for Gene</p><p>Field 6: UrlName</p><p>Field 7: SubjectType. gene/protein/disease-specific</p><p>Field 8: Attribute. Registration required</p><p>A sample file using a spreadsheet program such as MS Excel.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTn"><a href="/books/NBK3802/table/nonbib.Tn/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTn"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tn"><a href="/books/NBK3802/table/nonbib.Tn/?report=objectonly" target="object" rid-ob="figobnonbibTn">Table</a></h4></div></div><p>The same entries in a <b>sample CSV file</b> can be downloaded <a href="https://www.ncbi.nlm.nih.gov/projects/linkout/doc/LinkOutresourcecsvexample4.csv" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">here</a>. Save files with the extension <b>.csv</b>, and upload them to the “holdings” directory of the FTP assigned to you.</p><p><b>Example 3.</b>
|
|
<u>Access to a resource is free and registration is not required</u>: Provider Id 1234, provides links for the Taxonomy record 314297. The URL provided leads to a page that has information that supplements the Taxonomy record. The UrlName indicates the resource page topic. The subject type was provided in the <a href="https://www.ncbi.nlm.nih.gov/books/NBK3802/#nonbib.File_Preparation_Identity_File" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">identity file</a>, and consequently this field is left blank. Access to the resource is free and registration is not required, consequently, the field is left blank. Note that each field must be comma separated.</p><p>Field 1: PrId. 1234</p><p>Field 2: DB. Taxonomy</p><p>Field 3: UID. 314297</p><p>Field 4: URL. https://www.marinespecies.org/aphia.php?p=taxdetails&id=611463</p><p>Filed 5: IconUrl. None needed for Taxonomy</p><p>Field 6: UrlName Compsopogon hookeri Montagne</p><p>Field 7: SubjectType.</p><p>Field 8: Attribute.</p><p>A sample file using a spreadsheet program such as MS Excel.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTo"><a href="/books/NBK3802/table/nonbib.To/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTo"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.To"><a href="/books/NBK3802/table/nonbib.To/?report=objectonly" target="object" rid-ob="figobnonbibTo">Table</a></h4></div></div><p>The same entries in a <b>sample CSV file</b> can be downloaded <a href="https://www.ncbi.nlm.nih.gov/projects/linkout/doc/LinkOutresourcecsvexample5.csv" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">here</a>. Save files with the extension <b>.csv</b>, and upload them to the “holdings” directory of the FTP assigned to you.</p></div></div><div id="nonbib.File_Preparation_Resource_File_Si"><h2 id="_nonbib_File_Preparation_Resource_File_Si_">File Preparation: Resource File (Simple Text)</h2><p>
|
|
<b>Section Contents:</b>
|
|
</p><ul><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Simple_Text_Resource_File_Format">Resource File Format</a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Simple_Text_Global_Information">Global Information</a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Simple_Text_Creating_Links">Creating Links</a>
|
|
</div><ul><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Simple_Text_Selecting_Records">Selecting Records</a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Simple_Text_Specifying_the_Link">Specifying the Link</a>
|
|
</div></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Simple_Text_Describing_the_Resour">Describing the Resource</a>
|
|
</div></li></ul></li><li class="half_rhythm"><div>
|
|
<a href="#nonbib.Simple_Text_Resource_File_Example">Resource File Examples</a>
|
|
</div></li></ul><div id="nonbib.Simple_Text_Resource_File_Format"><h3>Simple Text: Resource File Format</h3><p>Providers may choose to submit the <a href="#nonbib.File_Preparation_Resource_File_XM">resource</a> file in a simple text file instead of XML.</p><p>Text resource files must have a file extension <b>.ft</b>; the file extension is case sensitive. File names may contain alpha-numeric characters and underscores only. Special characters and spaces are not allowed. Typically, files are named “resources.ft”. To help with file management, a provider may supply more than one resource file. File size may not exceed 10 MB.</p><p>This file should be composed in a text editor, such as NotePad, not in a word processing program.</p><p>The resource file below describes links from NCBI’s Nucleotide database to a <i>C. elegans</i> sequence database provided by WebDatabase Co., ProviderId 7777.</p><pre>--- lines starting with "-" are comments ---<br />--- information in the first block is global --- <br />prid: 7777 <br />dbase: nucleotide <br />stype: organism-specific<br />!base: http://www.webdatabase.com/cgi-bin/elegans?<br /><br />------<br />linkid: 1<br />query: Caenorhabditis elegans [orgn]<br />base: &base;<br />rule: an_lookup=&lo.pacc;<br />name: Caenorhabditis elegans<br />------</pre></div><div id="nonbib.Simple_Text_Global_Information"><h3>Simple Text: Global Information</h3><p>The first block holds global information that will be used throughout the file.</p><blockquote><p><b>prid:</b> LinkOut Provider ID</p><p><b>dbase:</b> NCBI database that will be hosting the links, e.g., pubmed, nucleotide, taxonomy</p><p><b>stype:</b> SubjectType. See <a href="/books/n/helplinkout/files/?report=reader#files.Special_Elements_SubjectType">Special Elements: SubjectType</a> for all available SubjectTypes.</p><p><b>attr:</b> Attribute. See <a href="/books/n/helplinkout/files/?report=reader#files.Special_Elements_Attribute">Special Elements: Attribute</a> for all available Attributes.</p></blockquote></div><div id="nonbib.Simple_Text_Creating_Links"><h3>Simple Text: Creating Links</h3><p>Each subsequent block specifies a LinkOut link. This has two basic parts, a valid search query with a valid field descriptor and a URL pointing back to the provider's site. Each search query will be evaluated, and a link to the specified URL will be applied to records that are retrieved by the query. See <a href="https://www.ncbi.nlm.nih.gov/books/NBK3837/" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">Entrez Help</a> for information on constructing search queries and on field descriptors. Links will be applied to the citations retrieved by the search.</p><p>In the simplest case, each block could be:</p><pre>----- <br />query: [a valid NCBI database query with a valid database field descriptor]<br />rule:  [the URL that will be applied to the records retrieved by the query]<br />-----</pre><div id="nonbib.Simple_Text_Selecting_Records"><h4>Simple Text: Selecting Records</h4><p>Any valid search query may be used to select records. Each query should appear on a single <b>query</b> line and must include a database field descriptor. Multiple query lines in one block will be OR-ed together: See <a href="https://www.ncbi.nlm.nih.gov/books/NBK3837/" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">Entrez Help</a> for information on constructing search queries and on field descriptors.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTp"><a href="/books/NBK3802/table/nonbib.Tp/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTp"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tp"><a href="/books/NBK3802/table/nonbib.Tp/?report=objectonly" target="object" rid-ob="figobnonbibTp">Table</a></h4></div></div><p>Genbank accession numbers can be used as queries to create links. For example: a Genbank sequence accession number for Arabidopsis Thaliana is <a href="/nuccore/330371308" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">HM047434</a>. A query for this sequence would be <a href="/nuccore/330371308" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">HM047434</a> [pacc] – pacc is the field descriptor for primary accession numbers.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTq"><a href="/books/NBK3802/table/nonbib.Tq/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTq"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tq"><a href="/books/NBK3802/table/nonbib.Tq/?report=objectonly" target="object" rid-ob="figobnonbibTq">Table</a></h4></div></div><p>Each record in an NCBI database has a numerical unique identifier (UID). You can select the NCBI database records that you would like to link from by UID in the <b>uids:</b> line.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTr"><a href="/books/NBK3802/table/nonbib.Tr/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTr"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tr"><a href="/books/NBK3802/table/nonbib.Tr/?report=objectonly" target="object" rid-ob="figobnonbibTr">Table</a></h4></div></div></div><div id="nonbib.Simple_Text_Specifying_the_Link"><h4>Simple Text: Specifying the Link</h4><p>The link is specified using the <b>base:</b> and <b>rule:</b> lines. <b>base:</b> is the stable portion of the URL for the resource. This is usually the URL of the provider’s website or CGI program. <b>rule:</b> is the remainder of the URL needed to access the online resource.</p><p><b>base:</b> and <b>rule:</b> are concatenated to form the URL for the link.</p><p>If desired, the entire URL for the resource can be included on the <b>rule:</b> line, and the <b>base:</b> line can be omitted.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTs"><a href="/books/NBK3802/table/nonbib.Ts/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTs"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Ts"><a href="/books/NBK3802/table/nonbib.Ts/?report=objectonly" target="object" rid-ob="figobnonbibTs">Table</a></h4></div></div><p>If the URL for the resource follows a pattern using variable values that are found in the database record, the pattern can be described on the <b>rule:</b> line, and LinkOut can insert the appropriate values for each citation.</p><p>URL patterns are described using LinkOut’s XML entities. An XML entity is a short text string that represents a type of value. During LinkOut processing, the text string is replaced in the URL by the appropriate value for each record.</p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTt"><a href="/books/NBK3802/table/nonbib.Tt/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTt"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tt"><a href="/books/NBK3802/table/nonbib.Tt/?report=objectonly" target="object" rid-ob="figobnonbibTt">Table</a></h4></div></div><p>Using this <b>base:</b> and <b>rule:</b>, the URL constructed for the record with accession number <a href="/nuccore/3810674" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">AL032671</a> would be <i>https://www.webdatabase.com/cgi-bin/elegans?an_lookup=<a href="/nuccore/3810674" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">AL032671</a></i></p><p>Entities can be combined with other information in the <b>rule:</b></p><div class="iconblock whole_rhythm clearfix ten_col table-wrap" id="fignonbibTu"><a href="/books/NBK3802/table/nonbib.Tu/?report=objectonly" target="object" title="Table" class="img_link icnblk_img" rid-ob="figobnonbibTu"><img class="small-thumb" src="/corehtml/pmc/css/bookshelf/2.26/img/table-icon.gif" alt="Table Icon" /></a><div class="icnblk_cntnt"><h4 id="nonbib.Tu"><a href="/books/NBK3802/table/nonbib.Tu/?report=objectonly" target="object" rid-ob="figobnonbibTu">Table</a></h4></div></div><p>In this case, the URL generated for the record with the unique ID 6016240 would be: <i>https://www.webdatabase.com/cgi-bin/db=elegans&id_lookup=6016240&view=text</i></p><p>To minimize the repetition of textual data, the <b>base:</b> portion of the URL can be defined as an entity in the global information block, as shown below.</p><pre>prid: 4592<br />dbase: PubMed<br />!base.url: https://a257.g.akamaitech.net/7/257/2422/<br />-------------------------------------------------------------------<br />linkid: 704411419<br />uids: 15754467 <br />base: &base.url;<br />rule: 01jan20051800/edocket.access.gpo.gov/2005/pdf/05-4062.pdf<br />attr: full-text PDF<br />-------------------------------------------------------------------<br />linkid: 70389516<br />uids: 15736310 <br />base: &base.url;<br />rule: 01jan20051800/edocket.access.gpo.gov/2005/pdf/05-3829.pdf<br />attr: full-text PDF<br />-------------------------------------------------------------------<br />linkid: 70379232<br />uids: 15732197 <br />base: &base.url;<br />rule: 01jan20051800/edocket.access.gpo.gov/2005/pdf/05-3728.pdf<br />attr: full-text PDF<br />-------------------------------------------------------------------</pre></div><div id="nonbib.Simple_Text_Describing_the_Resour"><h4>Simple Text: Describing the Resource</h4><p>The relevance of resources linked from NCBI database records should be readily apparent to users. The name and/or description of the resource should convey something about the information that is being offered and its relevance.</p><p>The following optional fields allow you to describe your links and resources.</p><blockquote><p><b>icon:</b> URL of an icon file that you would like to represent your link and resources. Only applicable to links in PubMed. The icon should meet the specifications described in <a href="/books/n/helplinkout/files/?report=reader#files.Icons">Icons</a>.</p><p><b>name:</b> Additional description of the link. <b>name:</b> should only be used when the values in the LinkOut SubjectType and Attribute lists do not suffice.</p><p><b>stype:</b> SubjectType. See <a href="/books/n/helplinkout/files/?report=reader#files.Special_Elements_SubjectType">Special Elements: SubjectType</a> for all available SubjectTypes. SubjectType is used to determine where links will be placed in the <a href="/books/n/helplinkout/using/?report=reader#using.Viewing_LinkOut_Resources_in_NCBI">LinkOut Display</a>. If no SubjectType is given, the SubjectType “miscellaneous” will be assigned automatically.</p><p><b>attr:</b> Attribute. See <a href="/books/n/helplinkout/files/?report=reader#files.Special_Elements_Attribute">Special Elements: Attribute</a> for all available Attributes.</p></blockquote><p>The application of SubjectTypes and Attributes is at the discretion of the resource provider. However, if there are any barriers to accessing the resource, one of the following Barrier Attributes <i>must</i> be used:</p><blockquote><p>registration required<br />subscription/membership/fee required</p></blockquote></div></div><div id="nonbib.Simple_Text_Resource_File_Example"><h3>Simple Text: Resource File Examples</h3><p><b>Example 1:</b> The following file shows five links to taxonomic resource on the Web. Because each link has an individual URL, the links are made separately.</p><pre>----------NCBI taxonomy bookmark links ----<br />prid: 3206<br />dbase: Taxonomy<br />------Apis mellifera)------<br />linkid: 1<br />query: Apis mellifera [name]<br />rule: http://beelab.cas.psu.edu/intro.html<br />name: Honey Bee Lab (Penn State)<br />------<br />linkid: 2<br />query: Apis mellifera [name]<br />rule: http://www.barc.usda.gov/psi/brl/<br />name: Bee Research Lab (USDA Beltsville)<br />------<br />linkid: 3<br />query: Apis mellifera [name]<br />rule: http://www.hgsc.bcm.tmc.edu/projects/honeybee/<br />name: Baylor Honey Bee Genome<br />------<br />linkid: 4<br />query: Apis mellifera [name]<br />rule: http://titan.biotec.uiuc.edu/bee/honeybee_project.htm<br />name: Honey Bee Brain EST Project<br />------<br />linkid: 5<br />query: Apis mellifera [name]<br />rule: http://ourworld.compuserve.com/homepages/Beekeeping/weblinks.htm<br />name: Bee Web Links<br />------</pre><p><b>Example 2:</b> The hypothetical provider Genotypes, Inc., Provider Id 4321, provides free online access to genotyping assays from records in the SNP database. SNP records are selected using the SNP unique identifier. The URL to access assays at their site follows this pattern for each record: https://genotypinc.com/servlet/web.Gateway?source=NCBI.SNP&res=genotypAssay&ap1=rs[SNP ID]</p><pre>-----Geotypes SNP links global info ---<br />prid: 4321<br />dbase: SNP<br /><br />-----Begin Links ---<br />linkid: 1<br />uids: 7928656 2049045 1811350 1871598 7947824 681267 1947741<br />base: https://genotypinc.com/servlet/web.Gateway?<br /> source=NCBI.SNP&res=genotypAssay& <br />rule: ap1=rs&lo.id;<br />name: Genotyping Assays<br />------ </pre><p>
|
|
<b>Example 3:</b>
|
|
</p><p>A record may be retrieved by more than one <Query>. When this happens, link assignment will be handled as described in <a href="/books/n/helplinkout/policies/?report=reader#policies.Duplicate_Links">Duplicate Links</a> and <a href="/books/n/helplinkout/policies/?report=reader#policies.Multiple_Links">Multiple Links</a>.</p><p>If these queries are in different <b>linkids</b>, you can use <b>attr: preference</b> to indicate which link should be applied to the record. This is generally used in situations where the links for a subset of a range have a different URL pattern or different access restrictions.</p><p>In the example below, the records included in LinkId 1 below will also be selected by LinkId 2.</p><p>The hypothetical LinkOut provider WebDatabase Co. provides links from the Nucleotide database to the <i>C. elegans</i> sequence database.</p><p><b>LinkId 1</b> describes links from all Nucleotide records on <i>C. elegans</i> published by J. Smith from 1997 to 1999 to a set of <i>C. elegans</i> records in PDF format. Because these records are also included in LinkId 2, <b>attr: preference</b> is used to indicate that only this link should be applied to these citations.</p><p><b>LinkId 2</b> provides links from all Nucleotide records on <i>C. elegans</i> to WebDatabase Co.’s <i>C. elegans</i> records, except for the records selected in LinkId 1.</p><p>Because <b>LinkId 1</b> describes specific requirements, it is listed before the general <b>LinkId 2.</b></p><pre>----- Nucleotide links ----<br />prid: 7777<br />dbase: nucleotide<br />!base: "https://www.webdatabase.com/cgi-bin/elegans?"<br /><br />------<br />linkid: 1<br />query: Caenorhabditis elegans [orgn] AND<br /> 1997:1999 [pdat] AND smith j [auth] <br />base: &base;<br />rule: auth_lookup=j-smith&view=pdf<br />attr: full-text PDF<br />attr: preference<br />------<br />linkid: 2<br />query: Caenorhabditis elegans [orgn]<br />base: &base;<br />rule: an_lookup=&lo.pacc;&view=full<br />------</pre><p><b>Example 4:</b> The following file shows three links to The Restriction Enzyme Database. Each query uses a specific sequence accession number. Because each link has an individual URL, the links are made separately.</p><pre>prid: 1234<br />dbase: Nucleotide<br />!base: https://rebase.neb.com/rebase/enz/<br />------------<br />linkid: 1<br />query: <a href="/nuccore/1498742" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">U65398</a>[pacc]<br />base: &base;<br />rule: 7.html<br />name: REBASE enzyme AatII<br /><br />------<br />linkid: 2<br />query: <a href="/nuccore/38660" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">X62690</a>[pacc]<br />base: &base;<br />rule: 8.html<br />name: REBASE enzyme AbrI<br /><br />------<br />linkid: 3<br />query: <a href="/nuccore/216195" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">D10671</a> [pacc]<br />base: &base;<br />rule: 18.html<br />name: REBASE enzyme AccI<br /><br />------</pre></div></div><div id="nonbib.File_Evaluation"><h2 id="_nonbib_File_Evaluation_">File Evaluation</h2><p>After your application for inclusion in LinkOut has been accepted, prepare an identity file and sample resource files according to the instructions above. Resource files should contain links to at least five records from the selected database.</p><p>Validate the files using the LinkOut <a href="https://www.ncbi.nlm.nih.gov/projects/linkout/doc/file-validator.html" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">File Validation Utility</a>. Email the files to <a href="mailto:dev@null" data-email="vog.hin.mln.ibcn@tuoknil" class="oemail">vog.hin.mln.ibcn@tuoknil</a>.</p><p>Your files will be evaluated by the LinkOut team, and you will be contacted regarding any corrections. The evaluation process will continue until your files are substantially error free.</p></div><div id="nonbib.Account_Assignment"><h2 id="_nonbib_Account_Assignment_">Account Assignment</h2><p>When the submitted files are substantially error free, you will be assigned a ProviderId (PrId) and an approved name abbreviation (NameAbbr), and you will be given a password for an NCBI private FTP account.</p><p>Please note that each provider will be given only one account at NCBI.</p></div><div id="nonbib.File_Transfer"><h2 id="_nonbib_File_Transfer_">File Transfer</h2><p>When you receive your account information, validate the files using the LinkOut <a href="https://www.ncbi.nlm.nih.gov/projects/linkout/doc/file-validator.html" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">File Validation Utility</a> and <a href="/books/n/helplinkout/files/?report=reader#files.Allowable_Rule_Keywords">transfer all files via FTP</a> to the host FTP-private.ncbi.nlm.nih.gov. Place the files in the “holdings” directory of your FTP account. No subdirectories may be created in the holdings subdirectory.</p><p>When files have been submitted, inform the LinkOut team at <a href="mailto:dev@null" data-email="vog.hin.mln.ibcn@tuoknil" class="oemail">vog.hin.mln.ibcn@tuoknil</a>. Your files will be given a final evaluation before being placed in the production queue. From this point on, files will be processed automatically every day.</p><p>Links should appear in the selected NCBI database within 2 days of file submission. If 2 days have passed and you do not see your links, please write to <a href="mailto:dev@null" data-email="vog.hin.mln.ibcn@tuoknil" class="oemail">vog.hin.mln.ibcn@tuoknil</a>.</p></div><div id="nonbib.File_Maintenance"><h2 id="_nonbib_File_Maintenance_">File Maintenance</h2><div id="nonbib.Provider_Responsibilities"><h3>Provider Responsibilities</h3><p>Link providers are responsible for:</p><ul><li class="half_rhythm"><div>maintaining their LinkOut files</div></li><li class="half_rhythm"><div>transferring any additions, changes or deletions of their links to NCBI</div></li><li class="half_rhythm"><div>updating files and informing NCBI when access rights are changed</div></li><li class="half_rhythm"><div>correcting broken or incorrect links in a timely manner</div></li></ul><p>Providers may transfer new versions of current files or add new resource files at any time. It is the responsibility of the provider to keep files current and valid. Links are regenerated every day based on the resource files in each provider’s directory. Therefore, providers must delete obsolete files from their /holdings directory.</p><p>Additional provider responsibilities are described in <a href="/books/n/helplinkout/policies/?report=reader#policies.Provider_Responsibilities">LinkOut Policies: Provider Responsibilities</a>.</p></div><div id="nonbib.Confirmation_and_Error_Messages"><h3>Confirmation and Error Messages</h3><p>Upon processing an updated file, NCBI will send an acknowledgment to the designated LinkOut contact. If you prefer not to receive this acknowledgment, please notify the LinkOut Team.</p><p>If files cannot be processed because of errors, a message with the subject line “LinkOut files uploaded to NCBI - Critical ERRORS!” will be sent to the LinkOut contact. In this case, please correct the files and resubmit them. If you have any questions about the errors, contact LinkOut at <a href="mailto:dev@null" data-email="vog.hin.mln.ibcn@tuoknil" class="oemail">vog.hin.mln.ibcn@tuoknil</a>.</p></div></div><div id="nonbib.Provider_Statistics"><h2 id="_nonbib_Provider_Statistics_">Provider Statistics</h2><p>LinkOut collects statistics on the number of clicks on each providers’ links in the LinkOut display.</p><p>Statistics can be emailed to the LinkOut contact monthly. If you would like to receive statistics, please notify the LinkOut Team at <a href="mailto:dev@null" data-email="vog.hin.mln.ibcn@tuoknil" class="oemail">vog.hin.mln.ibcn@tuoknil</a></p><p>Statistics send via email include the yearly and monthly totals for clicks on a provider’s links (a CSV file with the same information is provided as an attachment as well).</p><p>Statistics may change for the first 2 weeks that they are available. After 2 weeks, statistics will be stable.</p><p>A sample statistics report is shown below.</p><p>
|
|
<div class="graphic"><img src="/books/NBK3802/bin/nonbib-Image001.jpg" alt="Image nonbib-Image001.jpg" /></div>
|
|
</p></div><div id="bk_toc_contnr"></div></div></div><div class="fm-sec"><h2 id="_NBK3802_pubdet_">Publication Details</h2><h3>Publication History</h3><p class="small">Created: <span itemprop="datePublished">September 14, 2005</span>; Last Update: <span itemprop="dateModified">June 30, 2023</span>.</p><h3>Copyright</h3><div><div class="half_rhythm"><a href="/books/about/copyright/">Copyright Notice</a></div></div><h3>Publisher</h3><p><a href="http://www.ncbi.nlm.nih.gov/" ref="pagearea=page-banner&targetsite=external&targetcat=link&targettype=publisher">National Center for Biotechnology Information (US)</a>, Bethesda (MD)</p><h3>NLM Citation</h3><p>LinkOut Help [Internet]. Bethesda (MD): National Center for Biotechnology Information (US); 2006-. Information for Other Resource Providers. 2005 Sep 14 [Updated 2023 Jun 30].<span class="bk_cite_avail"></span></p></div><div class="small-screen-prev"><a href="/books/n/helplinkout/ft/?report=reader"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M75,30 c-80,60 -80,0 0,60 c-30,-60 -30,0 0,-60"></path><text x="20" y="28" textLength="60" style="font-size:25px">Prev</text></svg></a></div><div class="small-screen-next"><a href="/books/n/helplinkout/related/?report=reader"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><path d="M25,30c80,60 80,0 0,60 c30,-60 30,0 0,-60"></path><text x="20" y="28" textLength="60" style="font-size:25px">Next</text></svg></a></div></article><article data-type="table-wrap" id="figobnonbibTc"><div id="nonbib.Tc" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tc/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tc_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tc_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:center;vertical-align:top;">Example: Select record with Taxonomy ID 37572 in the Taxonomy database</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tc_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><ObjectList><br /><ObjId>37572</ObjId><br /></ObjectList></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTd"><div id="nonbib.Td" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Td/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Td_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Td_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:center;vertical-align:top;">Example: Select records with Taxonomy IDs 37572 and 33392</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Td_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><ObjectList><br /><ObjId>37572</ObjId><br /><ObjId>33392</ObjId><br /></ObjectList></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTe"><div id="nonbib.Te" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Te/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Te_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Te_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Select records with the organism “Caenorhabditis elegans” published from 1996 to 1999 in the Nucleotide database</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Te_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><Database>Nucleotide</Database><br /><ObjectList><br /><Query>Caenorhabditis elegans [orgn] AND 1996:1999 [pdat]</Query><br /></ObjectList></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTf"><div id="nonbib.Tf" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tf/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tf_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tf_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Select records with the organism “Caenorhabditis elegans” published by J. Smith in Nucleotide. As new records are submitted to the database, links will be applied automatically.</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tf_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><Database>Nucleotide</Database><br /><ObjectList><br /><Query>Caenorhabditis elegans [orgn] AND smith j [auth]</Query><br /></ObjectList></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTg"><div id="nonbib.Tg" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tg/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tg_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tg_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Select records for chimpanzees starting from the publication date January 1, 2000 and records for humans starting from January 1, 2002 in the Genome database. As new records are submitted, links will be applied automatically.</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tg_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><Database>Genome</Database><br /><ObjectList><br /><Query>chimpanzee [orgn] AND 2000:2010[dp]</Query><br /><Query>human [orgn] AND 2002:2010[dp] </Query><br /></ObjectList></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTh"><div id="nonbib.Th" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Th/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Th_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Th_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Use a Genbank accession number as a search query to create links in Nucleotide.</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Th_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><Database>Nucleotide</Database><br /><ObjectList><br /><Query><a href="/nuccore/330371308" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">HM047434</a> [pacc]</Query><br /></ObjectList></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTi"><div id="nonbib.Ti" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Ti/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Ti_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Ti_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Use MeSH headings to select citations on acupuncture therapy methods in PubMed.</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Ti_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><Database>PubMed</Database><br /><ObjectList><br /><Query>”Acupuncture Therapy/methods”[majr:noexp] </Query><br /></ObjectList></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTj"><div id="nonbib.Tj" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tj/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tj_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tj_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Create the URL https://www.webdatabase.com/cgi-bin/elegans?OID=1988</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tj_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><Base>https://www.webdatabase.com/ cgi-bin/elegans?<Base><br /><Rule>OID=1988</Rule></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTk"><div id="nonbib.Tk" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tk/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tk_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tk_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Create URLs following the pattern:<br />https://www.webdatabase.com/cgi-bin/an_lookup=[PACC]</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tk_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><Base>https://www.webdatabase.com/cgi-bin/</Base><br /><Rule> an_lookup=&lo.pacc;</Rule></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTl"><div id="nonbib.Tl" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tl/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tl_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tl_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Create URLs following the pattern:<br /><a href="https://www.webdatabase.com/cgi-bin/db=elegans&id_lookup=%5bNCBI" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">https://www.webdatabase.com/cgi-bin/db=elegans&id_lookup=[NCBI</a> database Unique Identifier]&view=text</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tl_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><Base>https://www.webdatabase.com/cgi-bin</Base> <br /><Rule>/db=elegans&amp;id_lookup=&lo.id;&amp;view=text</Rule></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTm"><div id="nonbib.Tm" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tm/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tm_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tm_1_1_1_1" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">PrId</th><th id="hd_h_nonbib.Tm_1_1_1_2" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">DB</th><th id="hd_h_nonbib.Tm_1_1_1_3" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">Query</th><th id="hd_h_nonbib.Tm_1_1_1_4" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">URL</th><th id="hd_h_nonbib.Tm_1_1_1_5" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">IconUrl</th><th id="hd_h_nonbib.Tm_1_1_1_6" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">UrlName</th><th id="hd_h_nonbib.Tm_1_1_1_7" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">SubjectType</th><th id="hd_h_nonbib.Tm_1_1_1_8" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">Attribute</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tm_1_1_1_1" scope="row" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">1234</td><td headers="hd_h_nonbib.Tm_1_1_1_2" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Nucleotide</td><td headers="hd_h_nonbib.Tm_1_1_1_3" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">
|
|
<pre><br /><a href="/nuccore/449020133" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">BX284601.5</a>[pacc]<br /></pre>
|
|
</td><td headers="hd_h_nonbib.Tm_1_1_1_4" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">http://www.origene.com/cdna/search-all.mspx?product=HCLONES&term=1B(VP2)</td><td headers="hd_h_nonbib.Tm_1_1_1_5" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"></td><td headers="hd_h_nonbib.Tm_1_1_1_6" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">
|
|
<pre><br />Caenorhabditis elegans chromosome I<br /></pre>
|
|
</td><td headers="hd_h_nonbib.Tm_1_1_1_7" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"></td><td headers="hd_h_nonbib.Tm_1_1_1_8" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Subscription/membership/fee required</td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTn"><div id="nonbib.Tn" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tn/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tn_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tn_1_1_1_1" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">PrId</th><th id="hd_h_nonbib.Tn_1_1_1_2" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">DB</th><th id="hd_h_nonbib.Tn_1_1_1_3" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">Query</th><th id="hd_h_nonbib.Tn_1_1_1_4" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">URL</th><th id="hd_h_nonbib.Tn_1_1_1_5" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">IconUrl</th><th id="hd_h_nonbib.Tn_1_1_1_6" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">UrlName</th><th id="hd_h_nonbib.Tn_1_1_1_7" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">SubjectType</th><th id="hd_h_nonbib.Tn_1_1_1_8" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">Attribute</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tn_1_1_1_1" scope="row" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">1234</td><td headers="hd_h_nonbib.Tn_1_1_1_2" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Gene</td><td headers="hd_h_nonbib.Tn_1_1_1_3" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">APOE[sym] AND chromosome 7</td><td headers="hd_h_nonbib.Tn_1_1_1_4" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">https://biogps.org/#goto=genereport&id=11816</td><td headers="hd_h_nonbib.Tn_1_1_1_5" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"></td><td headers="hd_h_nonbib.Tn_1_1_1_6" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"></td><td headers="hd_h_nonbib.Tn_1_1_1_7" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">gene/protein/disease-specific</td><td headers="hd_h_nonbib.Tn_1_1_1_8" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Registration required</td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTo"><div id="nonbib.To" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.To/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.To_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.To_1_1_1_1" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">PrId</th><th id="hd_h_nonbib.To_1_1_1_2" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">DB</th><th id="hd_h_nonbib.To_1_1_1_3" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">UID</th><th id="hd_h_nonbib.To_1_1_1_4" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">URL</th><th id="hd_h_nonbib.To_1_1_1_5" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">IconUrl</th><th id="hd_h_nonbib.To_1_1_1_6" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">UrlName</th><th id="hd_h_nonbib.To_1_1_1_7" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">SubjectType</th><th id="hd_h_nonbib.To_1_1_1_8" scope="col" rowspan="1" colspan="1" style="background-color:rgb(197,224,179);text-align:left;vertical-align:top;">Attribute</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.To_1_1_1_1" scope="row" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">1234</td><td headers="hd_h_nonbib.To_1_1_1_2" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Taxonomy</td><td headers="hd_h_nonbib.To_1_1_1_3" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">314297</td><td headers="hd_h_nonbib.To_1_1_1_4" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">https://www.marinespecies.org/aphia.php?p=taxdetails&id=611463</td><td headers="hd_h_nonbib.To_1_1_1_5" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"></td><td headers="hd_h_nonbib.To_1_1_1_6" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Compsopogon hookeri Montagne</td><td headers="hd_h_nonbib.To_1_1_1_7" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"></td><td headers="hd_h_nonbib.To_1_1_1_8" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"></td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTp"><div id="nonbib.Tp" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tp/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tp_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tp_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: This search will be translated as: human[name] OR chimpanzee[name]</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tp_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">query: human [name] <br />query: chimpanzee [name]</td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTq"><div id="nonbib.Tq" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tq/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tq_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tq_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: enter the query with the field descriptor [pacc]</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tq_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><a href="/nuccore/330371308" class="bk_tag" ref="pagearea=body&targetsite=entrez&targetcat=link&targettype=nuccore">HM047434</a> [pacc]</td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTr"><div id="nonbib.Tr" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tr/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tr_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tr_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Place links on records with UIDs 123456, 123469, and 3847559</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tr_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">---- separate unique identifiers (UIDs) with a blank space. Each new line should start with the “uids:” label --- <br />uids: 123456 123469 3847559</td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTs"><div id="nonbib.Ts" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Ts/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Ts_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Ts_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: The following will both create a link to the URL http://www.webdatabase.com/cgi-bin/elegans?OID=1988</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Ts_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">------<br />rule: https://www.webdatabase.com/ cgi-bin/elegans?OID=1988<br />-------<br />------<br />base: https://www.webdatabase.com/cgi-bin/elegans?<br />rule: OID=1988<br />------</td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTt"><div id="nonbib.Tt" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tt/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tt_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tt_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Create URLs following the pattern: http://www.webdatabase.com/cgi-bin/an_lookup=[PACC]</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tt_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><b>base:</b> https://www.webdatabase.com/cgi-bin/<br /><b>rule:</b> an_lookup=&lo.pacc;</td></tr></tbody></table></div></div></article><article data-type="table-wrap" id="figobnonbibTu"><div id="nonbib.Tu" class="table"><p class="large-table-link" style="display:none"><span class="right"><a href="/books/NBK3802/table/nonbib.Tu/?report=objectonly" target="object">View in own window</a></span></p><div class="large_tbl" id="__nonbib.Tu_lrgtbl__"><table><thead><tr><th id="hd_h_nonbib.Tu_1_1_1_1" scope="col" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;">Example: Create URLs following the pattern:<br /><a href="https://www.webdatabase.com/cgi-bin/db=elegans&id_lookup=%5bNCBI" ref="pagearea=body&targetsite=external&targetcat=link&targettype=uri">https://www.webdatabase.com/cgi-bin/db=elegans&id_lookup=[NCBI</a> database Unique Identifier]&view=text</th></tr></thead><tbody><tr><td headers="hd_h_nonbib.Tu_1_1_1_1" rowspan="1" colspan="1" style="text-align:left;vertical-align:top;"><b>base:</b> https://www.webdatabase.com/cgi-bin<br /><b>rule:</b> db=elegans&amp;id_lookup=&lo.id;&view=text</td></tr></tbody></table></div></div></article></div><div id="jr-scripts"><script src="/corehtml/pmc/jatsreader/ptpmc_3.22/js/libs.min.js"> </script><script src="/corehtml/pmc/jatsreader/ptpmc_3.22/js/jr.min.js"> </script></div></div>
|
|
|
|
|
|
|
|
|
|
<!-- Book content -->
|
|
|
|
<script type="text/javascript" src="/portal/portal3rc.fcgi/rlib/js/InstrumentNCBIBaseJS/InstrumentPageStarterJS.js"> </script>
|
|
|
|
|
|
<!-- CE8BC1E97D9F05E1_0182SID /projects/books/PBooks@9.11 portal107 v4.1.r689238 Tue, Oct 22 2024 16:10:51 -->
|
|
<span id="portal-csrf-token" style="display:none" data-token="CE8BC1E97D9F05E1_0182SID"></span>
|
|
|
|
<script type="text/javascript" src="//static.pubmed.gov/portal/portal3rc.fcgi/4216699/js/3968615.js" snapshot="books"></script></body>
|
|
</html>
|