{"id":407,"date":"2016-12-13T11:39:05","date_gmt":"2016-12-13T02:39:05","guid":{"rendered":"http:\/\/id.ndl.go.jp\/information\/?page_id=407"},"modified":"2021-09-29T09:57:14","modified_gmt":"2021-09-29T00:57:14","slug":"function_en","status":"publish","type":"page","link":"https:\/\/id.ndl.go.jp\/information\/function_en\/","title":{"rendered":"Description of Functions"},"content":{"rendered":"<style>img {max-width: 650px;} fieldset{\/*border:none;*\/ padding: 1em; margin-bottom: 1em} .entry form {text-align: left} .example {background: #f3f3f3; padding: 0.1em 1em} p {margin: 1em 0} h3, h4 {margin: 2em 0 1em} #systemname {margin:0} h4 {font-size: 110%; font-weight: bold} textarea {font-size: 95%; padding: 0.3em; width: 100%; height: 10em} #note1 {color: #444} .menu ol { counter-reset: section; } .menu li { list-style: none; display:block; } .menu ol>li:before { content : counters(section, '-') '. ';  counter-increment : section;} figcaption {text-align:center} .topnav {text-align: right} code {font-size: 100%} html>body .entry ul {padding-left: 20px}  div.utilmenu>p{margin:0} p.nakanavi:before {content: '\u25b2'; display: inline-block; width: 1em;  text-indent: 0;} strong {color: #B50000;}<\/style>\n<div lang=\"en\">\n<hr \/>\n<div class=\"menu\" style=\"padding: 10px; margin-bottom: 10px; border: 1px solid #A9A9A9;\">\n<ol>\n<li><a href=\"#anchor01\" target=\"_self\" rel=\"noopener noreferrer\">Search\/Display<\/a><\/li>\n<li><a href=\"#anchor02\" target=\"_self\" rel=\"noopener noreferrer\">URI Links<\/a><\/li>\n<li><a href=\"#anchor03\">URI Links to Search Results<\/a><\/li>\n<li><a href=\"#anchor04\">Getting Data in a Specific Format<\/a><\/li>\n<li><a href=\"#anchor05\">Downloads<\/a><\/li>\n<li><a href=\"#anchor06\">Automatic Updates<\/a><\/li>\n<li><a href=\"#anchor07\">RSS Feed Notifications of New Subject Headings, etc.<\/a><\/li>\n<\/ol>\n<\/div>\n<h3><a name=\"anchor01\"><\/a>1. Search\/Display<\/h3>\n<p>There are three ways to search for authority data on the front page.<\/p>\n<ol>\n<li>Search by keywords for Name(s)\/Title(s) , Variant Name(s)\/Title(s) and Variant Term(s)<\/li>\n<li>Search by representative classification numbers from the Nippon Decimal Classification (<abbr title=\"Nippon Decimal Classification\">NDC<\/abbr>) 9th Revised Edition, the <abbr title=\"Nippon Decimal Classification\">NDC<\/abbr> 10th Revised Edition, or the National Diet Library Classification (<a href=\"https:\/\/www.ndl.go.jp\/en\/data\/classification_subject.html\"><abbr title=\"National Diet Library Classification\">NDLC<\/abbr><\/a>)<\/li>\n<li>Search by the NDL\u2019s authority ID<\/li>\n<\/ol>\n<p>Please refer to the \u201c<a href=\"\/information\/help_en\/\">Help<\/a>\u201d page for further information on how to use search functions, normalization, and display descriptions.<\/p>\n<p>Please refer to &#8220;<a href=\"\/information\/wp-content\/uploads\/2018\/05\/api-spec-en.pdf\">Web NDL Authorities <abbr title=\"SPARQL Protocol and RDF Query Language\">SPARQL<\/abbr> <abbr title=\" Application Programming Interface\">API<\/abbr> Specifications 2018-03-31(PDF: 341KB)<\/a>&#8221; for information on how to search using the SPARQL, a kind of Application Programming Interface (API).<\/p>\n<h3><a name=\"anchor02\"><\/a>2. URI Links<\/h3>\n<p>A <abbr title=\"Uniform Resource Identifier\">URI<\/abbr> is assigned to each authority data. The type of URI assigned varies according to the type of authority data, as shown in the chart below.<\/p>\n<p>Key: \u201c\u25cb\u201d indicates an applicable URI, \u201c\u2015\u201d indicates no applicable URI<\/p>\n<table class=\"datatable\" summary=\"This table shows whether or not each authority data type has an Authority Information URI (ID type and Name type) and\/or a Name Entity URI as well as whether its name space is ndlna or ndlsh.\"  border=\"1\">\n<caption>URI type assignment per authority data type<\/caption>\n<thead>\n<tr>\n<th rowspan=\"2\"><\/th>\n<th colspan=\"2\">Authority Information<a href=\"#a\" target=\"_self\" rel=\"noopener noreferrer\">*<\/a> URI<\/th>\n<th rowspan=\"2\">Name Entity<a href=\"#a\" target=\"_self\" rel=\"noopener noreferrer\">*<\/a> URI<\/th>\n<th rowspan=\"2\"> Name Space<\/th>\n<\/tr>\n<tr>\n<th>ID Type<\/th>\n<th>Label Type<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<th>Personal Name<\/th>\n<td>\u25cb<\/td>\n<td>\u2015<\/td>\n<td>\u25cb<\/td>\n<td>ndlna<\/td>\n<\/tr>\n<tr>\n<th>Family Name<\/th>\n<td>\u25cb<\/td>\n<td>\u2015<\/td>\n<td>\u25cb<\/td>\n<td>ndlna<\/td>\n<\/tr>\n<tr>\n<th>Corporate Body Name<\/th>\n<td>\u25cb<\/td>\n<td>\u2015<\/td>\n<td>\u25cb<\/td>\n<td>ndlna<\/td>\n<\/tr>\n<tr>\n<th>Geographic Name<\/th>\n<td>\u25cb<\/td>\n<td>\u2015<\/td>\n<td>\u2015<\/td>\n<td>ndlna<\/td>\n<\/tr>\n<tr>\n<th>Uniform Title<\/th>\n<td>\u25cb<\/td>\n<td>\u2015<\/td>\n<td>\u2015<\/td>\n<td>ndlna<\/td>\n<\/tr>\n<tr>\n<th>Work<\/th>\n<td>\u25cb<\/td>\n<td>\u2015<\/td>\n<td>\u25cb<\/td>\n<td>ndlna<\/td>\n<\/tr>\n<tr>\n<th>Topical Term<\/th>\n<td>\u25cb<\/td>\n<td>\u25cb<\/td>\n<td>\u2015<\/td>\n<td>ndlsh<\/td>\n<\/tr>\n<tr>\n<th>Subdivision<\/th>\n<td>\u25cb<\/td>\n<td>\u2015<\/td>\n<td>\u2015<\/td>\n<td>ndlsh<\/td>\n<\/tr>\n<tr>\n<th>Genre\/Form Term<\/th>\n<td>\u25cb<\/td>\n<td>\u25cb<\/td>\n<td>\u2015<\/td>\n<td>ndlgft<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><a name=\"a\"><\/a>*Please see \u201c<a href=\"\/information\/model_en\/\">About the <abbr title=\"Resource Description Framework\">RDF<\/abbr> Model<\/a>\u201d for more information on \u201cAuthority Information\u201d and \u201cName Entity\u201d.<\/p>\n<h4>2-1. Authority Information URI with ID<\/h4>\n<p>Every type of authority data has a URI with ID.<\/p>\n<p>Example:<\/p>\n<ul>\n<li>URI for \u201cShakespeare, William, 1564-1616\u201d (ID:00456207)<br \/>\n<a href=\"\/auth\/ndlna\/00456207\">http:\/\/id.ndl.go.jp\/auth\/ndlna\/00456207<\/a><\/li>\n<li>URI for \u201c\u30bb\u30de\u30f3\u30c6\u30a3\u30c3\u30af\u30a6\u30a7\u30d6\u201d (ID:01017771)<br \/>\n<a href=\"\/auth\/ndlsh\/01017771\">http:\/\/id.ndl.go.jp\/auth\/ndlsh\/01017771<\/a><\/li>\n<li>URI for \u201c\u8b70\u4f1a\u8cc7\u6599\u201d (ID:001347333)<br \/>\n<a href=\"\/auth\/ndlsh\/001347333\">http:\/\/id.ndl.go.jp\/auth\/ndlgft\/001347333<\/a><\/li>\n<\/ul>\n<h4>2-2. Authority Information URI with Label Type<\/h4>\n<p>Every topical term and Genre\/Form term has a URI <a href=\"#b\" target=\"_self\" rel=\"noopener noreferrer\">*<\/a> using the literal value of the &#8220;Name\/Title&#8221; as well as a URI with ID.<\/p>\n<p>Example:<\/p>\n<ul>\n<li><a href=\"\/auth\/ndlsh\/\u56f3\u66f8\u9928\">http:\/\/id.ndl.go.jp\/auth\/ndlsh\/\u56f3\u66f8\u9928<\/a><\/li>\n<li><a href=\"\/auth\/ndlsh\/\u30a4\u30f3\u30bf\u30fc\u30cd\u30c3\u30c8\">http:\/\/id.ndl.go.jp\/auth\/ndlsh\/\u30a4\u30f3\u30bf\u30fc\u30cd\u30c3\u30c8<\/a><\/li>\n<li><a href=\"\/auth\/ndlgft\/\u6f2b\u753b\">http:\/\/id.ndl.go.jp\/auth\/ndlgft\/\u6f2b\u753b<\/a><\/li>\n<\/ul>\n<p><a name=\"b\"><\/a>*The URI is equivalent of <a href=\"https:\/\/tools.ietf.org\/html\/rfc3987\">Internationalized Resource Identifier (<abbr title=\"Internationalized Resource Identifier\">IRI<\/abbr>)<\/a>, which is a standard to extend on the URI schemes. An IRI is a sequence of characters from the Universal Character Set (Unicode\/ISO10646), including kanji, hiragana and katakana. Thus, there is no need to encode the Japanese characters contained in the URI, i.e. there is no need to convert the text such as \u201c\u56f3\u66f8\u9928\u201d into the percent encoded strings \u201c<code>%E5%9B%B3%E6%9B%B8%E9%A4%A8<\/code>\u201d.<\/p>\n<p>For example, the RDF\/<abbr title=\"Terse RDF Triple Language\">Turtle<\/abbr> description of a website, &lt;http:\/\/example.org\/&gt;, containing the subject heading \u201c\u30a4\u30f3\u30bf\u30fc\u30cd\u30c3\u30c8\u201d is as follows.<\/p>\n<div class=\"sticky\">\n<pre><code>@prefix dcterms: &lt;http:\/\/purl.org\/dc\/terms\/&gt;.\r\n&lt;http:\/\/example.org\/&gt; dcterms:subject &lt;http:\/\/id.ndl.go.jp\/auth\/ndlsh\/\u30a4\u30f3\u30bf\u30fc\u30cd\u30c3\u30c8&gt;.<\/code><\/pre>\n<\/div>\n<h4>2-3. Name Entity URI<\/h4>\n<p>As described in \u201c<a href=\"\/information\/model_en\/#anchor01\">About the RDF Model&gt; 1. About the RDF Model for Authority Data<\/a>\u201d, authority data for personal names, family names, corporate body names, and works is comprised of both a description of the authority information (which is an information resource) and a description of the name entity (which is a non-information resource). Since the subject URI used in the description of the name entity is a 303 URI, referencing the subject URI returns an HTTP code <code>303 see other<\/code> and the response is redirected to an authority information URI.<\/p>\n<p>Example:<\/p>\n<ul>\n<li><a href=\"\/auth\/entity\/00054222\">http:\/\/id.ndl.go.jp\/auth\/entity\/00054222<\/a>(URI for the name entity \u201cSoseki Natsume\u201d)<br \/>\n\u2193<\/li>\n<li><a href=\"\/auth\/ndlna\/00054222\">http:\/\/id.ndl.go.jp\/auth\/ndlna\/00054222<\/a>(URI for the authority information \u201cSoseki Natsume\u201d)<\/li>\n<\/ul>\n<p>If the author of a certain literary work (whose URI is &lt;http:\/\/example.org\/&gt;) is \u201cSoseki Natsume\u201d, that fact can be described in RDF\/Turtle as follows.<\/p>\n<div class=\"sticky\">\n<pre><code>@prefix dcterms: &lt;http:\/\/purl.org\/dc\/terms\/&gt;.\r\n&lt;http:\/\/example.org\/&gt; dcterms:creator &lt;http:\/\/id.ndl.go.jp\/auth\/entity\/00054222&gt;.<\/code><\/pre>\n<\/div>\n<div align=\"right\">\n<p class=\"nakanavi\"><a href=\"#header\"><u>To the head of this page<\/u><\/a><\/p>\n<\/div>\n<h3><a name=\"anchor03\"><\/a>3. URI Links to Search Results<\/h3>\n<p>You can use URI to link to search results.<\/p>\n<ul>\n<li><a href=\"\/auth\/ndla\/?qw=\u6587\u5b66&amp;g=all\">https:\/\/id.ndl.go.jp\/auth\/ndla\/?qw=\u6587\u5b66&amp;g=all<\/a><\/li>\n<li><a href=\"\/auth\/ndla\/?qw=\u592a\u967d&amp;g=na\">https:\/\/id.ndl.go.jp\/auth\/ndla\/?qw=\u592a\u967d&amp;g=na<\/a><\/li>\n<li><a href=\"\/auth\/ndla\/?qw=\u91ce\u7403&amp;g=corporateNames\">https:\/\/id.ndl.go.jp\/auth\/ndla\/?qw=\u91ce\u7403&amp;g=corporateNames<\/a><\/li>\n<li><a href=\"\/auth\/ndla\/?qc=KS113&amp;pfx=NDLC\">https:\/\/id.ndl.go.jp\/auth\/ndla\/?qc=KS113&amp;pfx=NDLC<\/a><\/li>\n<\/ul>\n<p>The parameter of the request is shown below.<\/p>\n<table class=\"datatable\" summary=\"This table shows functions and match conditions of the parameters w, g, c and pfx in requests that link to search results using URI. The parameters are listed in the second column. Usable values of each parameter are listed in the third column, and match conditions  (e.g., partial or exact match)  are in the fourth column.\" border=\"1\">\n<thead>\n<tr bgcolor=\"#2b4362\">\n<th scope=\"col\">No<\/th>\n<th scope=\"col\">Item<\/th>\n<th scope=\"col\">Explanation<\/th>\n<th scope=\"col\">Match Conditions<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<th scope=\"row\">1<\/th>\n<td>w<\/td>\n<td>Perform a keyword search.<\/td>\n<td>Partial match<\/td>\n<\/tr>\n<tr>\n<th scope=\"row\">2<\/th>\n<td>g<\/td>\n<td>Use the following values to specify the authority type to be searched.<br \/>\nThe value \u201call\u201d specifies all of the authority type.<br \/>\nThe value \u201cna\u201d specifies Personal Name, Family Name, Corporate Body Name, Geographic Name, and Uniform Title.<br \/>\nThe value \u201csh\u201d specifies Topical Term and Subdivision.<br \/>\nThe value \u201cgf\u201d specifies Genre\/Form Term.<br \/>\nThe value \u201cpersonalNames\u201d specifies Personal Name.<br \/>\nThe value \u201cfamilyNames\u201d specifies Family Name.<br \/>\nThe value \u201ccorporateNames\u201d specifies Corporate Body Name.<br \/>\nThe value \u201cgeographicNames\u201d specifies Geographic Name.<br \/>\nThe value \u201cuniformTitles\u201d specifies Uniform Title.<br \/>\nThe value \u201cwork\u201d specifies Work.<br \/>\nThe value \u201ctopicalTerms\u201d specifies Topical Terms.<br \/>\nThe value \u201csub\u201d specifies Subdivision.<br \/>\nThe value \u201cgenreformTerms\u201d specifies Genre\/Form Terms.<\/td>\n<td>Exact match<\/td>\n<\/tr>\n<tr>\n<th scope=\"row\">3<\/th>\n<td>c<\/td>\n<td>Search authority data using the classification numbers in the NDC 9th Revised Edition, NDC 10th Revised Edition or <a href=\"https:\/\/www.ndl.go.jp\/en\/data\/classification_subject.html\">NDLC<\/a>.<\/td>\n<td>Exact match<\/td>\n<\/tr>\n<tr>\n<th scope=\"row\">4<\/th>\n<td>pfx<\/td>\n<td>The following parameters are essential to perform a search by classification.<br \/>\nThe value \u201cNDC9\u201d specifies a search by NDC 9th Revised Edition numbers.<br \/>\nThe value \u201cNDC10\u201d specifies a search by NDC 10th Revised Edition numbers.<br \/>\nThe value \u201cNDC9\/10\u201d specifies a search by NDC 9th Revised Edition and 10th Revised Edition numbers.<br \/>\nThe value \u201cNDLC\u201d specifies a search by NDLC numbers.<\/td>\n<td>Exact match<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div align=\"right\">\n<p class=\"nakanavi\"><a href=\"#header\"><u>To the head of this page<\/u><\/a><\/p>\n<\/div>\n<h3><a name=\"anchor04\"><\/a>4. Getting Data in a Specific Format (Data format and filename extension)<\/h3>\n<p>Web NDL Authorities supports content negotiation. When accessing the URI for an authority data, you can get the detailed information in HTML with a browser or graphs in RDF\/XML in an RDF application. To specify a data format, add the filename extension to the URI.<br \/>\nThe following data formats and filename extensions are currently supported.<\/p>\n<table class=\"datatable\" border=\"1\">\n<thead>\n<tr>\n<th>Data Format<\/th>\n<th>Filename extension<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>HTML<\/td>\n<td>.html<\/td>\n<\/tr>\n<tr>\n<td>RDF\/XML<\/td>\n<td>.rdf<\/td>\n<\/tr>\n<tr>\n<td>RDF\/Turtle<\/td>\n<td>.ttl<\/td>\n<\/tr>\n<tr>\n<td><abbr title=\"JavaScript Object Notation for Linked Data\">JSON-LD<\/abbr><\/td>\n<td>.json<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3><a name=\"anchor05\"><\/a>5. Downloads<\/h3>\n<ul>\n<li>Batch Downloads<br \/>\nPlease refer to the \u201c<a href=\"\/information\/download_en\/\">Files for Batch Download<\/a>\u201d.<\/li>\n<li>Individual Downloads<br \/>\nIndividual authority data file can be downloaded in RDF\/XML, RDF\/Turtle, and JSON-LD by clicking the links at the bottom of the Detailed Information pages.<\/li>\n<\/ul>\n<h3><a name=\"anchor06\"><\/a>6. Automatic Updates<\/h3>\n<p>New, corrected, or deleted authority data is automatically updated on a daily basis.<\/p>\n<h3><a name=\"anchor07\"><\/a>7. RSS Feed Notifications of New Subject Headings, etc.<\/h3>\n<p>Please refer to \u201c<a href=\"\/information\/ndlsh-rss_en\/\">RSS Feed Notifications of New Subject Headings, etc.<\/a>\u201d.<\/p>\n<div align=\"right\">\n<p class=\"nakanavi\"><a href=\"#header\"><u>To the head of this page<\/u><\/a><\/p>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Search\/Display URI Links URI Links to Search Results Getting Data in a Specific Format Downloads Automatic Upd [&hellip;]<\/p>\n","protected":false},"author":6,"featured_media":0,"parent":0,"menu_order":13,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-407","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/id.ndl.go.jp\/information\/wp-json\/wp\/v2\/pages\/407"}],"collection":[{"href":"https:\/\/id.ndl.go.jp\/information\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/id.ndl.go.jp\/information\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/id.ndl.go.jp\/information\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/id.ndl.go.jp\/information\/wp-json\/wp\/v2\/comments?post=407"}],"version-history":[{"count":30,"href":"https:\/\/id.ndl.go.jp\/information\/wp-json\/wp\/v2\/pages\/407\/revisions"}],"predecessor-version":[{"id":1190,"href":"https:\/\/id.ndl.go.jp\/information\/wp-json\/wp\/v2\/pages\/407\/revisions\/1190"}],"wp:attachment":[{"href":"https:\/\/id.ndl.go.jp\/information\/wp-json\/wp\/v2\/media?parent=407"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}