Page Comparison

...

language	xml
title	Request - Submit Collection Records (SCSB XML)
linenumbers	true

...

Submit Collection API is a REST service where users can provide MARC content in either SCSB XML or MARC XML formats and update the underlying record in SCSB. Sample XML content data can be found below.

Submit Collection process doesn't update Collection Group Designation (CGD) while the data is uploaded in the cgd_protection folder in FTP or with is CGD Protected as true through the API. It is also not possible to update Customer Code through Submit Collection process. Also records that have already been deaccessioned cannot be updated or modified through the Submit Collection process.

Code Block

language	xml
title	Request - Submit Collection Records (SCSB XML)
linenumbers	true

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bibRecords>
    <bibRecord>
        <bib>
            <owningInstitutionId>PUL</owningInstitutionId>
            <owningInstitutionBibId>22</owningInstitutionBibId>
            <content>
                <collection>
                    <record>
                        <leader>00885cas a2200289 i 4500</leader>
                        <controlfield tag="001">SCSB-5</controlfield>
                        <controlfield tag="005">20160317172955.0</controlfield>
                   <bib>     <controlfield tag="008">801201d197219uururar p      <owningInstitutionId>PUL</owningInstitutionId> 0uuuc0rusr </controlfield>
          <owningInstitutionBibId>22</owningInstitutionBibId>             <content> <datafield ind1=" " ind2=" " tag="010">
          <collection>                  <subfield code="a">  <record> 72357714  </subfield>
                     <leader>00885cas a2200289 i 4500<</leader>datafield>
                        <controlfield<datafield tagind1="001 ">SCSB-5</controlfield>
   ind2=" " tag="035">
                     <controlfield tag="005">20160317172955.0</controlfield>          <subfield code="a">(OCoLC)5062456</subfield>
              <controlfield tag="008">801201d197219uururar p       0uuuc0rusr </controlfield>datafield>
                        <datafield ind1=" " ind2=" " tag="010035">
                            <subfield code="a">   72357714  <(CStRLIN)NJPG0127-S</subfield>
                        </datafield>
                        <datafield ind1=" " ind2=" " tag="035">
                            <subfield code="a">(OCoLC)5062456<9">AAF4256TS</subfield>
                        </datafield>
                        <datafield ind1=" " ind2=" " tag="035040">
                            <subfield code="a">(CStRLIN)NJPG0127-S<>NjP</subfield>
                            <subfield code="c">NjP</subfield>
                        </datafield>
                        <datafield ind1=" " ind2=" " tag="035043">
                            <subfield code="9">AAF4256TS<a">e-ur---</subfield>
                        </datafield>
                        <datafield ind1=" 0" ind2=" " tag="040050">
                            <subfield code="a">NjP<>UA772</subfield>
                            <subfield code="cb">NjP<>.S82</subfield>
                        </datafield>
                        <datafield ind1=" 1" ind2=" " tag="043212">
                            <subfield code="a">e-ur---<>Sto voprosov- sto otvetov</subfield>
                        </datafield>
                        <datafield ind1="0" ind2=" 0" tag="050245">
                            <subfield code="a">UA772</subfield>>10000 voprosov - 100 otvetov.</subfield>
                        </datafield>
                  <subfield code="b">.S82</subfield>      <datafield ind1=" " ind2=" " tag="260">
                            <subfield code="a">Moskva :</datafield>subfield>
                        <datafield ind1="1" ind2=" " tag="212">   <subfield code="b">Mol. Gvardii︠a︡,</subfield>
                            <subfield code="ac">Sto voprosov- sto otvetov<>1972-</subfield>
                        </datafield>
                        <datafield ind1="0 " ind2="0 " tag="245300">
                            <subfield code="a">10000 voprosov - 100 otvetov.>v. :</subfield>
                        </datafield>                         <datafield ind1=" " ind2=" " tag="260"><subfield code="b">ill. ;</subfield>
                            <subfield code="ac">Moskva :>26-41 cm.</subfield>
                        </datafield>
   <subfield code="b">Mol. Gvardii︠a︡,</subfield>                     <datafield ind1="0" ind2=" " tag="362">
                            <subfield code="ca">1972-</subfield>
                        </datafield>
                        <datafield ind1=" " ind2=" " tag="300500">
                            <subfield code="a">v. :</subfield>>Cover title.</subfield>
                        </datafield>
                        <datafield ind1=" " ind2=" <subfield" codetag="b">ill. ;</subfield>515">
                            <subfield code="c">26-41 cma">Vols. for 1972-&lt;1982&gt; called also vyp. 1-&lt;8/2&gt;.</subfield>
                        </datafield>
                        <datafield ind1="0 " ind2=" 0" tag="362651">
                            <subfield code="a">1972-</subfield>
                        </datafield>>Soviet Union</subfield>
                        <datafield ind1=" " ind2=" "<subfield tagcode="500">x">Armed forces.</subfield>
                            <subfield code="a">Cover title.<0">(uri)http://id.loc.gov/authorities/subjects/sh85125707</subfield>
                        </datafield>
                        <datafield ind1=" " ind2=" " tag="515998">
                            <subfield code="a">Vols. for 1972-&lt;1982&gt; called also vyp. 1-&lt;8/2&gt;.</subfield>>06/29/94</subfield>
                            <subfield code="s">9114</subfield>
                             </datafield><subfield code="n">NjP</subfield>
                         <datafield ind1=" " ind2="0" tag<subfield code="651w">>NJPG0127S</subfield>
                            <subfield code="a">Soviet Union<d">10/05/81</subfield>
                            <subfield code="x">Armed forces.<c">APG</subfield>
                            <subfield code="0">(uri)http://id.loc.gov/authorities/subjects/sh85125707<b">DPK</subfield>
                        </datafield>    <subfield code="i">940629</subfield>
                   <datafield ind1=" " ind2=" " tag="998">    <subfield code="l">NJPG</subfield>
                       <subfield code="a">06/29/94</subfield> </datafield>
                        <datafield ind1=" " ind2=" <subfield" codetag="s948">9114</subfield>>
                            <subfield code="n">NjP<a">AACR2 CONV.</subfield>
                            <subfield code="w">NJPG0127S</subfield></datafield>
                        <datafield ind1=" " ind2=" " <subfield codetag="d">10/05/81</subfield>911">
                            <subfield code="ca">APG<>19940708</subfield>
                            <subfield code="b">DPK</subfield></datafield>
                        <datafield ind1=" " ind2=" <subfield" codetag="i912">940629</subfield>>
                            <subfield code="la">NJPG<>19940629000000.0</subfield>
                        </datafield>
                        <datafield ind1=" " ind2=" " tag="948"></record>
                </collection>
            </content>
  <subfield code="a">AACR2 CONV.</subfield>    </bib>
        <holdings>
           </datafield> <holding>
                <owningInstitutionHoldingsId>23</owningInstitutionHoldingsId>
      <datafield ind1=" " ind2=" " tag="911">     <content>
                    <collection>
  <subfield code="a">19940708</subfield>                     <record>
   </datafield>                         <datafield ind1=" 0" ind2=" 1" tag="912852">
                                <subfield code="ab">19940629000000.0<>rcppa</subfield>
                        </datafield>                     </record>
       <subfield code="h">UA772.S82</subfield>
        </collection>             </content>         </bib>datafield>
        <holdings>             <holding>       <datafield ind1=" " ind2="0" tag="866">
     <owningInstitutionHoldingsId>23</owningInstitutionHoldingsId>                 <content>          <subfield code="6">0</subfield>
         <collection>                       <subfield  <record>
           code="x">OK to add by imprint year per DLJ 6-18-87</subfield>
                <datafield ind1="0" ind2="1" tag="852">         </datafield>
                       <subfield code="b">rcppa</subfield> </record>
                    </collection>
           <subfield code="h">UA772.S82</subfield>     </content>
                <items>
           </datafield>         <content>
                   <datafield ind1=" " ind2="0" tag="866"> <collection>
                            <record>
  <subfield code="6">0</subfield>                             <datafield ind1=" " ind2=" <subfield" codetag="x876">OK>
 to add by imprint year per DLJ 6-18-87</subfield>                             </datafield>
 <subfield code="p">32101075649143</subfield>
                      </record>              <subfield code="h"/>
     </collection>                 </content>              <subfield code="a">5591314</subfield>
 <items>                     <content>              <subfield code="j">Available</subfield>
         <collection>                           <subfield  <record>code="t">1</subfield>
                                 <datafield ind1=" " ind2=" " tag<subfield code="8763">>1979 (vyp.7) </subfield>
                                  <subfield code="p">32101075649143</subfield></datafield>
                                <datafield ind1=" " ind2=" <subfield" codetag="h900"/>
                                    <subfield code="a">5591314<>Shared</subfield>
                                    <subfield code="jb">Available<>PA</subfield>
                                </datafield>
   <subfield code="t">1</subfield>                         </record>
                            <record>
 <subfield code="3">1979 (vyp.7) </subfield>                            <datafield ind1=" " ind2="  </datafield>" tag="876">
                                <datafield ind1=" " ind2=" "<subfield tagcode="900p">>32101075649150</subfield>
                                    <subfield code="ah">Shared</subfield>>
                                    <subfield code="ba">PA<>5591315</subfield>
                                </datafield>    <subfield code="j">Available</subfield>
                       </record>             <subfield code="t">1</subfield>
              <record>                                 <datafield ind1=" " ind2=" " tag="876"><subfield code="3">1981 (vyp.8) </subfield>
                                    <subfield code="p">32101075649150</subfield></datafield>
                                <datafield ind1=" " ind2=" <subfield" codetag="h900"/>
                                    <subfield code="a">5591315<>Shared</subfield>
                                    <subfield code="jb">Available<>PA</subfield>
                                </datafield>
     <subfield code="t">1</subfield>                       </record>
                            <record>
 <subfield code="3">1981 (vyp.8) </subfield>                            <datafield ind1=" " ind2="  </datafield>" tag="876">
                                <datafield ind1=" " ind2=" "<subfield tagcode="900p">>32101075649168</subfield>
                                    <subfield code="ah">Shared</subfield>>
                                    <subfield code="ba">PA<>5591317</subfield>
                                </datafield>    <subfield code="j">Not Available</subfield>
                      </record>                <subfield code="t">1</subfield>
            <record>                                 <datafield ind1<subfield code=" 3" ind2=" " tag="876">>1982 (vyp.8/2) </subfield>
                                    <subfield code="p">32101075649168</subfield></datafield>
                                <datafield ind1=" " ind2=" <subfield" codetag="h900"/>
                                    <subfield code="a">5591317<>Shared</subfield>
                                    <subfield code="jb">Not Available<>PA</subfield>
                                </datafield>
   <subfield code="t">1</subfield>                         </record>
                            <record>
 <subfield code="3">1982 (vyp.8/2) </subfield>                            <datafield ind1=" " ind2="  </datafield>" tag="876">
                                <datafield ind1=" " ind2=" "<subfield tagcode="900p">>32101075649176</subfield>
                                    <subfield code="ah">Shared</subfield>>
                                    <subfield code="ba">PA<>5591320</subfield>
                                  </datafield>  <subfield code="j">Not Available</subfield>
                                     </record><subfield code="t">1</subfield>
                                 <record>   <subfield code="3">1985 </subfield>
                           <datafield ind1=" " ind2=" " tag="876"> </datafield>
                                <datafield ind1=" " ind2=" <subfield" codetag="p900">32101075649176</subfield>>
                                    <subfield code="ha">Shared</>subfield>
                                    <subfield code="ab">5591320<>PA</subfield>
                                    <subfield code="j">Not Available</subfield></datafield>
                                    <subfield code="t">1</subfield></record>
                            <record>
       <subfield code="3">1985 </subfield>                       <datafield ind1=" " ind2="    " tag="876">
  </datafield>                                 <datafield ind1=" " ind2<subfield code=" " tag="900">p">32101075649184</subfield>
                                    <subfield code="ah">Shared</subfield>>
                                    <subfield code="ba">PA<>5591324</subfield>
                                  </datafield>  <subfield code="j">Not Available</subfield>
                                     </record><subfield code="t">1</subfield>
                                 <record>   <subfield code="3">1986 </subfield>
                           <datafield ind1=" " ind2=" " tag="876"> </datafield>
                                <datafield ind1=" " ind2=" <subfield" codetag="p900">32101075649184</subfield>>
                                    <subfield code="ha">Shared</>subfield>
                                    <subfield code="ab">5591324<>PA</subfield>
                                    <subfield code="j">Not Available</subfield></datafield>
                            </record>
       <subfield code="t">1</subfield>                 </collection>
                   <subfield code="3">1986 </subfield>content>
                   </items>
            </datafield>holding>
        </holdings>
    </bibRecord>
                  <datafield ind1=" " ind2=" " tag="900">
</bibRecords>

Code Block

language	xml
title	Request - Submit Collection Records (MARC XML)
linenumbers	true

<?xml version="1.0"?>
<collection xmlns="http://www.loc.gov/MARC21/slim" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.loc.gov/MARC21/slim http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd">
<record>
    <leader>00855cam a2200253 a 4500</leader>
    <controlfield tag="001">175157</controlfield>
                     <subfield code="a">Shared</subfield><controlfield tag="005">20160518221807.0</controlfield>
    <controlfield tag="008">830914s1982 gw b 00010 ger d</controlfield>
    <datafield ind1=" " ind2="        " tag="020">
         <subfield code="ba">PA<>3877395317</subfield>
    </datafield>
    <datafield   ind1=" " ind2=" " tag="035">
        <subfield code="a">(OCoLC)74575525</subfield>
     </datafield>
    <datafield ind1=" " ind2=" " tag="035">
             <subfield code="a">(CStRLIN)NJPG83-B61980</subfield>
    </record>datafield>
    <datafield ind1=" " ind2=" " tag="035">
        <subfield code="9">AAZ0042TS</subfield>
    </collection>datafield>
    <datafield ind1=" " ind2="   " tag="040">
         </content><subfield code="a">NjP</subfield>
        <subfield code="c">NjP</subfield>
      </items>datafield>
    <datafield ind1="1" ind2=" " tag="100">
   </holding>     <subfield code="a">Rottmann, Johannes  H.</holdings>subfield>
    </bibRecord>
</bibRecords>

Code Block

language	xml
title	Request - Submit Collection Records (MARC XML)
linenumbers	true

<?xml version="1.0"?>
<collection xmlns="http://www.loc.gov/MARC21/slim" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.loc.gov/MARC21/slim http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd">
<record>
    <leader>00855cam a2200253 a 4500</leader>
    <controlfield tag="001">175157</controlfield>
    <controlfield tag="005">20160518221807.0</controlfield>
    <controlfield tag="008">830914s1982 gw b 00010 ger d</controlfield>datafield>
    <datafield ind1="1" ind2="0" tag="245">
        <subfield code="a">-und werden den Lehren der Da&#x308;monen anhangen /</subfield>
        <subfield code="c">Johannes H. Rottmann.</subfield>
    </datafield>
    <datafield ind1=" " ind2=" " tag="250">
        <subfield code="a">1. Aufl.</subfield>
    </datafield>
    <datafield ind1=" " ind2=" " tag="020260">
        <subfield code="a">3877395317<>Asslar :</subfield>
    </datafield>    <subfield <datafield ind1code=" b">Schulte ind2=" " tag="035">und Gerth,</subfield>
        <subfield code="a">(OCoLC)74575525<c">1982.</subfield>
    </datafield>
    <datafield ind1=" " ind2=" " tag="035300">
        <subfield code="a">(CStRLIN)NJPG83-B61980<>127 p. ;</subfield>
        <subfield code="c">20 cm.</subfield>
    </datafield>
    <datafield ind1=" " ind2=" " tag="035504">
        <subfield code="9">AAZ0042TS< code="a">Bibliography: p. 124-127.</subfield>
    </datafield>
    <datafield ind1=" " ind2=" 0" tag="040650">
        <subfield code="a">NjP<>Demonology.</subfield>
        <subfield code="c0">NjP</subfield>>
    </datafield>     <datafield ind1="1" ind2=" " tag="100">
  (uri)http://id.loc.gov/authorities/subjects/sh85036663
      <subfield code="a">Rottmann, Johannes H.</subfield>
    </datafield>
    <datafield ind1="1 " ind2="0" tag="245">="0" tag="650">
        <subfield code="a">God.</subfield>
        <subfield code="a0">-und
werden den Lehren der Da&#x308;monen anhangen /</subfield>      (uri)http://id.loc.gov/authorities/subjects/sh85055517
    <subfield code="c">Johannes H. Rottmann.    </subfield>
    </datafield>
    <datafield ind1=" " ind2=" " tag="250998">
        <subfield code="a">1. Aufl.</subfield>>04/02/86</subfield>
         </datafield><subfield code="s">9118</subfield>
    <datafield ind1=" " ind2=" "<subfield tagcode="260n">>NjP</subfield>
        <subfield code="a">Asslar :<w">NJPG83B61980</subfield>
        <subfield code="b">Schulte und Gerth,<d">09/14/83</subfield>
        <subfield code="c">1982.<>GMA</subfield>
    </datafield>    <subfield <datafield ind1code=" " ind2=" " tag="300">b">MT</subfield>
        <subfield code="a">127 p. ;<i">860402</subfield>
        <subfield code="c">20 cm.<l">NJPG</subfield>
    </datafield>
    <datafield ind1=" " ind2=" " tag="504911">
        <subfield code="a">Bibliography: p. 124-127.<>19921028</subfield>
    </datafield>
    <datafield ind1=" " ind2="0 " tag="650912">
        <subfield code="a">Demonology>19900821000000.<0</subfield>
    </datafield>
    <subfield<datafield codeind1="0 "> ind2=" " tag="959">
        <subfield  (uri)http://id.loc.gov/authorities/subjects/sh85036663
        <code="a">2000-06-13 00:00:00 -0400</subfield>
    </datafield>
    <datafield ind1=" 0" ind2="0" tag="852">
        <subfield code="650">"0">193086</subfield>
        <subfield code="ab">God.<>rcppa</subfield>
        <subfield code="0h">>BT975 .R67</subfield>
        <subfield   (uri)http://id.loc.gov/authorities/subjects/sh85055517code="t">1</subfield>
        <subfield  <code="x">tr fr f</subfield>
    </datafield>
    <datafield ind1=" 0" ind2=" 0" tag="998876">
        <subfield code="a">04/02/86<0">193086</subfield>
        <subfield code="sa">9118<>187267</subfield>
        <subfield code="nh">NjP</subfield>
        <subfield code="w">NJPG83B61980</subfield>/>
        <subfield code="dj">09/14/83</>Not Charged</subfield>
        <subfield code="cp">GMA<>32101079749824</subfield>
        <subfield code="bt">MT<>1</subfield>
        <subfield code="ix">860402<>Shared</subfield>
        <subfield code="lz">NJPG<>PA</subfield>
    </datafield>
</record>
   <datafield ind1=" " ind2=" " tag="911">
        <subfield code="a">19921028</subfield>
    </datafield>
    <datafield ind1=" " ind2=" " tag="912">
        <subfield code="a">19900821000000.0</subfield>
    </datafield>
    <datafield ind1=" " ind2=" " tag="959">
        <subfield code="a">2000-06-13 00:00:00 -0400</subfield>
    </datafield>
    <datafield ind1="0" ind2="0" tag="852">
        <subfield code="0">193086</subfield>
        <subfield code="b">rcppa</subfield>
        <subfield code="h">BT975 .R67</subfield>
        <subfield code="t">1</subfield>
        <subfield code="x">tr fr f</subfield>
    </datafield>
    <datafield ind1="0" ind2="0" tag="876">
        <subfield code="0">193086</subfield>
        <subfield code="a">187267</subfield>
        <subfield code="h"/>
        <subfield code="j">Not Charged</subfield>
        <subfield code="p">32101079749824</subfield>
        <subfield code="t">1</subfield>
        <subfield code="x">Shared</subfield>
        <subfield code="z">PA</subfield>
    </datafield>
</record>
</collection>

Code Block

title	Response - Submit Collection Records
linenumbers	true

Success, One or more record(s) updated.

Bulk Upload

...

</collection>

Other Parameters

Parameter	Data Type	Description
institution	String	Valid values are PUL, CUL, HL and NYPL
isCGDProtected	Boolean	Valid values are true and false. If true is selected, the record's CGD is not updated in SCSB. if false is selected, no protection is accorded to the CGD and it will be updated and subsequent matching algorithm will happen.

Code Block

title	Response - Submit Collection Records
linenumbers	true

[
  {
    "itemBarcode": "32101075649143",
    "message": "SuccessRecord"				//	Successfully edited
  },
  {
    "itemBarcode": "32101075649143",
    "message": "RejectionRecord"			//	Rejected
  },
  {
    "itemBarcode": "32101075649168",
    "message": "RejectionRecord"
  },
  {
    "itemBarcode": "32101075649176",
    "message": "RejectionRecord"
  },
  {
    "itemBarcode": "32101075649184",
    "message": "RejectionRecord"
  }
]

Code Block

language	js
title	Alternate Response - Submit Collection Records
linenumbers	true

[
  {
    "itemBarcode": null,
    "message": "Invalid SCSB xml format"	//	Invalid SCSBXML format
  }
]

Code Block

language	js
title	Alternate Response - Submit Collection Records
linenumbers	true

[
  {
    "itemBarcode": null,
    "message": "Invalid Marc xml format"	//	Invalid MARCXML format
  }
]

Code Block

language	js
title	Alternate Response - Submit Collection Records
linenumbers	true

[
  {
    "itemBarcode": "4324234234234324",
    "message": "ExceptionRecord"			//	Exception record
  }
]

Code Block

language	js
title	Alternate Response - Submit Collection Records
linenumbers	true

[
  {
    "itemBarcode": "4324234234234324",
    "message": "Exception record - Item not updated, it is a deaccessioned item" 	//	When a deaccessioned item is being updated through the Submit Collection API.
  }
]

Bulk Upload

Information on bulk upload of files for submit collection is available here.

Constraints on what can be edited

Except Availability status and Customer Code everything else can be updated through the Submit Collection API. However, when the item is out (Not available in ReCAPa Storage Location), the Collection Group Designation (CGD) and Use Restriction cannot be updated. There is a limit on the number of records that can be edited through the API in a single call. It is currently set at 100 and is configured in the external properties file under external.submit.collection.input.limit. Items that have been deaccessioned cannot be edited through Submit Collection.

Versions Compared

Old Version 10

New Version Current

Key

Bulk Upload

Other Parameters

Bulk Upload

Constraints on what can be edited