Researcher Name Resolver holds external direct links for researchers. Direct links usually refer to an URI of the researcher in a database. Researcher Name Resolver currently holds direct links to KAKEN, CiNii, Webcat, ResearcherID, ReaD(J-Global), campus directories, and Researcher Name Resolver. These links are available if Researcher Name Resolver holds these link information. Researcher Name Resolver automatically process link information in the background for KAKEN, CiNii, ReaD(J-Global), and campus directories. Instutition staff can upload researcher profiles including direct link information. These direct link URIs is often based on the original identity(ID) of the database. Researcher Name Resolver holds these IDs and types of database.

By means of relationship among IDs with types of database for researchers, we provide a table search function of IDs of each researcher over XML-RPC.

You need to POST a request XML to the XML-RPC entry point. You should send a request in POST method with "Content-Type: text/xml" header and a XML text for request.

API Type

 

  Method Type XML-RPC

  methodName in XML-RPC Researcher.resolveID

  Entry Point http://rns.nii.ac.jp/services/xmlrpc

XML Schema Definition for Query

Tag name and layrers								range
layer 1	layer 2	layer 3	layer 4	layer 5	layer 6	layer 7	layer 8	minOccurs	maxOccurs	notes
methodCall								1	1	Root node
	methodName							1	1	Method （You should set "Researcher.resolveID" ）
	params							1	1
		param						1	1
			value					1	1
				struct				1	1
					member			1	3
						name		1	1	Name can be set to:          source          id          target
						value		1	1
							string	1	1	A value according to the source, id, and target

 

Value of "source" and "target" list

Value of "source" and "target"	Value of "id" according to the value of "source"
resolver	Researcher Name Resolver ID
kaken	KAKENHI Researcher Number
cinii	CiNii Author ID
readresearchmap	ReaD Researcher Code
jglobal	JGLOBAL ID
researcherid	ResearcherID
webcat	Webcat ID
rdb:no:XXXXXXX   (Note : XXXXXXX is institution ID)	employeeID (in researcher profiles uploaded by institution staff)
anyURI	URI for the researcher (registered in this system)

 

 

If you already know KAKENHI Researcher Number "80252831" and want to know Researcher Name Resolver ID of the researcher, you need to set "source=kaken", "id=80252831" and "target=resolver" in such a following XML format.

 

Example. XML for query

<?xml version="1.0" encoding="UTF-8" ?> <methodCall> <methodName>Researcher.resolveID</methodName> <params> <param> <value> <struct> <member> <name>source</name> <value> <string>kaken</string> </value> </member> <member> <name>id</name> <value> <string>80252831</string> </value> </member> <member> <name>target</name> <value> <string>resolver</string> </value> </member> </struct> </value> </param> </params> </methodCall>  

You can examine this API by sending a request with a unix command. You should prepare the above example request xml as "request.xml" file, then you may use "curl" like this.

 

$ curl -v --data @request.xml -H "Content-Type: text/xml" http://rns.nii.ac.jp/services/xmlrpc

 

You may get the following output.
* About to connect() to rns.nii.ac.jp port 80 (#0) * Trying 136.187.33.141... connected * Connected to rns.nii.ac.jp (136.187.33.141) port 80 (#0) > POST /services/xmlrpc HTTP/1.1 > User-Agent: curl/7.21.4 (universal-apple-darwin11.0) libcurl/7.21.4 OpenSSL/0.9.8r zlib/1.2.5 > Host: rns.nii.ac.jp > Accept: */* > Content-Type: text/xml > Content-Length: 898 > < HTTP/1.1 200 OK < Date: Tue, 18 Oct 2011 10:14:51 GMT < Content-Type: text/xml < Content-Length: 254 < Connection: close < * Closing connection #0 <methodResponse> <params> <param> <value> <struct> <member> <name>target</name> <value> <string>resolver</string> </value> </member> <member> <name>id</name> <value> <array> <data> <value> <string>1000010332769</string> </value> </data> </array> </value> </member> </struct> </value> </param> </params> </methodResponse>

 

 

The response XML format is the following.

 

XML Schema Definition for Response

Tag name and layrers											range
layer 1	layer 2	layer 3	layer 4	layer 5	layer 6	layer 7	layer 8	layer 9	layer 10	layer 11	minOccurs	maxOccurs	notes
methodResponse											1	1	Root node
	params										0	1	Normal Response
		param									1	1
			value								1	1
				struct							1	1
					member						1	1
						name					1	1	name can be set to:           "target"           "id"
						value					1	1
							string				0	1	Value for name "target"
							array				0	1	Value for name "id"
								data			1	1
									value		1	unbounded
										string	1	1
	fault										0	1	Fault Response
		value
			struct								1	1
				member							3	3
					name						1	1	"faultCode" or "faultString"
					value						1	1
						i4					0	1	"faultCode" value
						string					0	1	"faultString" message

 

"faultCode" value and "faultString" Message

"faultCode" value	Corresponding "faultString" message
1	source not found
2	source id not found
3	target not found
4	target id not found

 

 

Examples are here.

Example. Normal Response

<?xml version="1.0" encoding="UTF-8"?> <methodResponse> <params> <param> <value> <struct> <member> <name>target</name> <value> <string>resolver</string> </value> </member> <member> <name>id</name> <value> <array> <data> <value> <string>1000010332769</string> </value> </data> </array> </value> </member> </struct> </value> </param> </params> </methodResponse>

 

Example. Fault Response

<?xml version="1.0" encoding="UTF-8"?> <methodResponse> <fault> <value> <struct> <member> <name>faultCode</name> <value> <i4>2</i4> </value> </member> <member> <name>faultString</name> <value> <string>source id not found</string> </value> </member> </struct> </value> </fault> </methodResponse>