TNS Internal:NDR/API/2.0/specification/modifyMetadataRecord

From NSDLWiki

Jump to: navigation, search


 NDR Project Documentation   Conceptual Framework   v1.0 NDR-API Index   v2.0 NDR-API Index   Model 

Under Construction
Proposed method for inclusion in NDR/API 2.x.

Please provide feedback and comments in the NSDL Data Repository (NDR) API 2.0 Forum of the NSDL Community Forums.


NDR API Documentation - modifyMetadataRecord

Modify a metadata record about a resource.



Request URL

http://ndr.nsdlib.org/api/modifyMetadataRecord


Must be an HTTP POST request.


Arguments

Structure of input:

  • inputXML (required)
    • handle (required) - the externally resolvable identifier of the metadata record (returned by addMetadataRecord).
    • metadataXML (required) - metadata in the format specified by the XMLFormat parameter
    • XMLFormat (required) - id of the format of metadataXML NOTE: requires registration in advance
    • resourceURL (optional) - URL to a web resource NOTE: Do not include this element to leave the resourceURL unchanged.
    • externalIdentifier (optional) - application specific identifier that can be stored to facilitate retrieval by applications NOTE: Do not include this element to leave the externalIdentifier unchanged.



InputXML Example

Below is example inputXML for modifying a metadata record about a resource to the NDR.


<?xml version="1.0" encoding="UTF-8"?>
<inputXML 
    xmlns="http://ns.nsdlib.org/ndr/request_v2.00/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ns.nsdlib.org/ndr/request_v2.00/ http://ns.nsdlib.org/schemas/ndr/request_v2.00.xsd" 
    schemaVersion="1.00.000">
  <handle>2200/20061212656</handle>
  <metadataXML>
    <nsdl_dc:nsdl_dc 
        xmlns:nsdl_dc="http://ns.nsdl.org/nsdl_dc_v1.02/" 
        schemaVersion="1.02.000" xmlns:dc="http://purl.org/dc/elements/1.1/" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xsi:schemaLocation="http://ns.nsdl.org/nsdl_dc_v1.02/ http://ns.nsdl.org/schemas/nsdl_dc/nsdl_dc_v1.02.xsd"> 
      <dc:title>My life: a Monster's Story.</nowiki></dc:title> 
      <dc:description>The story of Frankenstein, blah blah blah.</dc:description> 
      <dc:identifier>http://www.frankenstein.org/autobiography</dc:identifier> 
      <dc:creator>Baron Von Frankenstein</dc:creator> 
      <dc:author>Mary Shelly</dc:author> 
    </nsdl_dc:nsdl_dc>   
  </metadataXML>
  <XMLFormat>nsdl_dc</XMLFormat>
</inputXML>




Response

Structure of response:

  • handle - the externally resolvable identifier for the Metadata.
  • handleURL - the permanent URL to an XML representation of the metadata record in the NDR.


Response Example

Below is an example response for this request.

<?xml version="1.0" encoding="UTF-8"?>
<NSDLDataRepository schemaVersion="1.00.000" 
    xmlns="http://ns.nsdlib.org/ndr/response_v2.00/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ns.nsdlib.org/ndr/response_v2.00/ http://ns.nsdlib.org/schemas/ndr/response_v2.00.xsd">
  <responseTime>2006-04-10T18:07:53Z</responseTime>
  <requestURL>http://ndr.nsdlib.org/api/modifyMetadataRecord</requestURL>
  
  <resultData>
    <handle>2200/20061212656</handle>
    <handleURL>http://ndr.nsdlib.org/api/getMetadataRecord/2200/20061212656</handleURL>
  <resultData>
</NSDLDataRespository>



API Links:


Additional Links Related to This Call:

Personal tools