Kod źródłowy Wiki NCIP (CPK, NKP)
Ostatnio modyfikowane 2025/11/13 09:36 przez Jan Slezák
Ukryj ostatnich autorów
| author | version | line-number | content |
|---|---|---|---|
| |
2.1 | 1 | NCIP protokół zapewnia interfejs do odczytu informacji o czytelnikach, dziełach, wypożyczeniach oraz oferuje operacje niezbędne do podstawowego funkcjonowania protokołu wypożyczeń. |
| |
1.1 | 2 | |
| 3 | * [[https:~~/~~/en.wikipedia.org/wiki/NISO_Circulation_Interchange_Protocol>>url:https://en.wikipedia.org/wiki/NISO_Circulation_Interchange_Protocol]] | ||
| 4 | * [[http:~~/~~/www.niso.org/standards-committees/ncip>>url:http://www.niso.org/standards-committees/ncip]]) | ||
| 5 | |||
| |
2.1 | 6 | = Dokumentacja protokołu = |
| |
1.1 | 7 | |
| |
2.1 | 8 | |=Opis|=Link |
| 9 | |Dokumentacja standardu|[[http:~~/~~/www.ncip.info/uploads/7/1/4/6/7146749/z39-83-1-2012_ncip.pdf>>url:http://www.ncip.info/uploads/7/1/4/6/7146749/z39-83-1-2012_ncip.pdf]] | ||
| 10 | |Protokół XSD NCIP|[[http:~~/~~/www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd>>url:http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd]] | ||
| 11 | |Dokumentacja CPK|[[http:~~/~~/moravianlibrary.github.io/CPK-standardy/>>url:http://moravianlibrary.github.io/CPK-standardy/]] | ||
| 12 | |(% colspan="1" %)Minimalne wymagania CPK|(% colspan="1" %)((( | ||
| |
1.1 | 13 | [[https:~~/~~/docs.google.com/document/d/1yzXOjSzl56jK_K5A9TgYpz4ddPsIHEvnrzUdf0dO8eQ/edit#heading=h.s3328d2tu52t>>url:https://docs.google.com/document/d/1yzXOjSzl56jK_K5A9TgYpz4ddPsIHEvnrzUdf0dO8eQ/edit#heading=h.s3328d2tu52t]] |
| 14 | ))) | ||
| |
2.1 | 15 | |(% colspan="1" %)CPK opis wymagań i odpowiedzi|(% colspan="1" %)[[https:~~/~~/docs.google.com/spreadsheets/d/1u1jCYenyQYLnhx7UQ94hL_9DRV8rVxyAt2ZszTn9taU/edit#gid=3>>url:https://docs.google.com/spreadsheets/d/1u1jCYenyQYLnhx7UQ94hL_9DRV8rVxyAt2ZszTn9taU/edit#gid=3]] |
| 16 | |(% colspan="1" %)Przykłady wymagań / odpowiedzi|(% colspan="1" %)((( | ||
| |
1.1 | 17 | [[https:~~/~~/github.com/moravianlibrary/xcncip2toolkit/tree/master/connectors/aleph/22/trunk/web/src/main/webapp>>url:https://github.com/moravianlibrary/xcncip2toolkit/tree/master/connectors/aleph/22/trunk/web/src/main/webapp]] |
| 18 | |||
| 19 | [[https:~~/~~/github.com/moravianlibrary/xcncip2toolkit/tree/master/connectors/koha/3.xx/trunk/web/src/main/webapp>>url:https://github.com/moravianlibrary/xcncip2toolkit/tree/master/connectors/koha/3.xx/trunk/web/src/main/webapp]] | ||
| 20 | ))) | ||
| 21 | |||
| |
2.1 | 22 | = Wdrożenie w Tritiu = |
| |
1.1 | 23 | |
| |
2.1 | 24 | Moduł NCIP jest zawsze włączony w Tritiu i działa pod adresem URL: |
| |
1.1 | 25 | |
| |
2.1 | 26 | * [[https:~~/~~/demo.tritius.cz/tritius/ncip/>>url:https://demo.tritius.cz/Tritius/ncip/]] |
| |
1.1 | 27 | |
| |
2.1 | 28 | == Testowanie == |
| |
1.1 | 29 | |
| |
2.1 | 30 | W celu sprawdzenia poprawności komunikatów XML można użyć tzw. echa. Pod adresem **/ncip/echo** dostępna jest usługa, która przetwarza przychodzący komunikat XML, konwertuje go do wewnętrznej struktury systemu Tritius i ponownie zwraca go na wyjście. Usługa zwraca więc ponownie XML. |
| |
1.1 | 31 | |
| 32 | |||
| |
2.1 | 33 | Do testowania komunikacji można użyć następujących narzędzi: |
| |
1.1 | 34 | |
| 35 | * [[https:~~/~~/curl.se/>>url:https://curl.se/]] | ||
| 36 | * [[https:~~/~~/www.postman.com/>>url:https://www.postman.com/]] | ||
| 37 | * [[Advanced REST Client Desktop>>url:https://install.advancedrestclient.com/install]] | ||
| 38 | * [[Advanced REST Client for Chrome>>url:https://chrome.google.com/webstore/detail/advanced-rest-client/hgmloofddffdnphfgcellkdfbfbjeloo]] | ||
| 39 | * [[Vývojové prostředí IntelliJ IDEA>>url:https://www.jetbrains.com/help/idea/http-client-in-product-code-editor.html]] | ||
| 40 | |||
| |
2.1 | 41 | === Komunikacja HTTP === |
| |
1.1 | 42 | |
| |
2.1 | 43 | Aby komunikować się z serwerem NCIP, należy spełnić kilka wymagań: |
| |
1.1 | 44 | |
| 45 | * Content-Type: | ||
| 46 | |||
| |
2.1 | 47 | == Nagłówek InitiationHeader == |
| |
1.1 | 48 | |
| |
2.1 | 49 | Ponieważ system Tritius jest wielobiblioteczny, w każdym zapytaniu należy podać bibliotekę docelową, której dotyczy zapytanie. Podaje się ją w elemencie InitiationHeader jako atrybut ToAgencyId, który jest częścią każdej usługi NCIP. |
| |
1.1 | 50 | |
| |
2.1 | 51 | | |
| |
1.1 | 52 | |
| 53 | {{{<InitiationHeader> | ||
| 54 | <!-- Nepovinné --> | ||
| 55 | <FromAgencyId> | ||
| 56 | <AgencyId>CPK</AgencyId> | ||
| 57 | </FromAgencyId> | ||
| 58 | |||
| 59 | <ToAgencyId> | ||
| 60 | <AgencyId>ULG001</AgencyId> | ||
| 61 | </ToAgencyId> | ||
| 62 | </InitiationHeader>}}} | ||
| 63 | |||
| 64 | == LookupUser == | ||
| 65 | |||
| |
2.1 | 66 | | |
| |
1.1 | 67 | |
| 68 | {{{<?xml version="1.0" encoding="UTF-8" standalone="yes"?> | ||
| 69 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 70 | <LookupUser> | ||
| 71 | <InitiationHeader> | ||
| 72 | <ToAgencyId> | ||
| 73 | <AgencyId>KOG001</AgencyId> | ||
| 74 | </ToAgencyId> | ||
| 75 | </InitiationHeader> | ||
| 76 | <UserId> | ||
| 77 | <AgencyId>Tábor</AgencyId> | ||
| 78 | <UserIdentifierType>Institution Id Number</UserIdentifierType> | ||
| 79 | <UserIdentifierValue>12345</UserIdentifierValue> | ||
| 80 | </UserId> | ||
| 81 | |||
| 82 | <UserElementType>Authentication Input</UserElementType> | ||
| 83 | <UserElementType>Block Or Trap</UserElementType> | ||
| 84 | <UserElementType>Date Of Birth</UserElementType> | ||
| 85 | <UserElementType>Name Information</UserElementType> | ||
| 86 | <UserElementType>User Address Information</UserElementType> | ||
| 87 | <UserElementType>User Language</UserElementType> | ||
| 88 | <UserElementType>User Privilege</UserElementType> | ||
| 89 | <UserElementType>User Id</UserElementType> | ||
| 90 | <UserElementType>Previous User Id</UserElementType> | ||
| 91 | |||
| 92 | <LoanedItemsDesired>true</LoanedItemsDesired> | ||
| 93 | <RequestedItemsDesired>true</RequestedItemsDesired> | ||
| 94 | <UserFiscalAccountDesired>true</UserFiscalAccountDesired> | ||
| 95 | </LookupUser> | ||
| 96 | </ns1:NCIPMessage>}}} | ||
| 97 | |||
| 98 | |||
| |
2.1 | 99 | | |
| |
1.1 | 100 | |
| 101 | {{{<?xml version="1.0" encoding="UTF-8" standalone="yes"?> | ||
| 102 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 103 | <ns1:LookupUser> | ||
| 104 | <ns1:InitiationHeader> | ||
| 105 | <ns1:FromAgencyId> | ||
| 106 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">CPK</ns1:AgencyId> | ||
| 107 | </ns1:FromAgencyId> | ||
| 108 | <ns1:ToAgencyId> | ||
| 109 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">AAA001</ns1:AgencyId> | ||
| 110 | </ns1:ToAgencyId> | ||
| 111 | </ns1:InitiationHeader> | ||
| 112 | <ns1:UserId> | ||
| 113 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">AAA001</ns1:AgencyId> | ||
| 114 | <ns1:UserIdentifierType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/visibleuseridentifiertype/visibleuseridentifiertype.scm">Institution Id Number</ns1:UserIdentifierType> | ||
| 115 | <ns1:UserIdentifierValue>4</ns1:UserIdentifierValue> | ||
| 116 | </ns1:UserId> | ||
| 117 | <ns1:LoanedItemsDesired /> | ||
| 118 | <ns1:RequestedItemsDesired /> | ||
| 119 | <ns1:UserFiscalAccountDesired /> | ||
| 120 | </ns1:LookupUser> | ||
| 121 | </ns1:NCIPMessage>}}} | ||
| 122 | |||
| 123 | |||
| |
2.1 | 124 | | |
| |
1.1 | 125 | |
| 126 | {{{<?xml version="1.0" encoding="UTF-8" standalone="yes"?> | ||
| 127 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" | ||
| 128 | ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd" | ||
| 129 | xmlns:ns2="https://ncip.knihovny.cz/ILSDI/ncip/2015/extensions"> | ||
| 130 | <ns1:LookupUser> | ||
| 131 | <ns1:InitiationHeader> | ||
| 132 | <ns1:FromAgencyId> | ||
| 133 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">CPK</ns1:AgencyId> | ||
| 134 | </ns1:FromAgencyId> | ||
| 135 | <ns1:ToAgencyId> | ||
| 136 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">KTG001</ns1:AgencyId> | ||
| 137 | </ns1:ToAgencyId> | ||
| 138 | </ns1:InitiationHeader> | ||
| 139 | <ns1:UserId> | ||
| 140 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">KTG001</ns1:AgencyId> | ||
| 141 | <ns1:UserIdentifierType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/visibleuseridentifiertype/visibleuseridentifiertype.scm"> | ||
| 142 | Institution Id Number</ns1:UserIdentifierType> | ||
| 143 | <ns1:UserIdentifierValue>4</ns1:UserIdentifierValue> | ||
| 144 | </ns1:UserId> | ||
| 145 | <ns1:Ext> | ||
| 146 | <ns2:HistoryDesired> | ||
| 147 | <ns2:Page>1</ns2:Page> | ||
| 148 | </ns2:HistoryDesired> | ||
| 149 | </ns1:Ext> | ||
| 150 | </ns1:LookupUser> | ||
| 151 | </ns1:NCIPMessage>}}} | ||
| 152 | |||
| 153 | |||
| |
2.1 | 154 | | |
| |
1.1 | 155 | |
| 156 | {{{<?xml version="1.0" encoding="UTF-8" standalone="yes"?> | ||
| 157 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 158 | <ns1:LookupUser> | ||
| 159 | <ns1:InitiationHeader> | ||
| 160 | <ns1:FromAgencyId> | ||
| 161 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">CPK</ns1:AgencyId> | ||
| 162 | </ns1:FromAgencyId> | ||
| 163 | |||
| 164 | <ns1:ToAgencyId> | ||
| 165 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">ULG001</ns1:AgencyId> | ||
| 166 | </ns1:ToAgencyId> | ||
| 167 | </ns1:InitiationHeader> | ||
| 168 | <ns1:UserId> | ||
| 169 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">ULG001</ns1:AgencyId> | ||
| 170 | <ns1:UserIdentifierType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/visibleuseridentifiertype/visibleuseridentifiertype.scm">Institution Id Number</ns1:UserIdentifierType> | ||
| 171 | <ns1:UserIdentifierValue>11111</ns1:UserIdentifierValue> | ||
| 172 | </ns1:UserId> | ||
| 173 | |||
| 174 | <ns1:UserElementType>Authentication Input</ns1:UserElementType> | ||
| 175 | <ns1:UserElementType>Block Or Trap</ns1:UserElementType> | ||
| 176 | <ns1:UserElementType>Date Of Birth</ns1:UserElementType> | ||
| 177 | <ns1:UserElementType>Name Information</ns1:UserElementType> | ||
| 178 | <ns1:UserElementType>User Address Information</ns1:UserElementType> | ||
| 179 | <ns1:UserElementType>User Language</ns1:UserElementType> | ||
| 180 | <ns1:UserElementType>User Privilege</ns1:UserElementType> | ||
| 181 | <ns1:UserElementType>User Id</ns1:UserElementType> | ||
| 182 | <ns1:UserElementType>Previous User Id</ns1:UserElementType> | ||
| 183 | |||
| 184 | <ns1:LoanedItemsDesired /> | ||
| 185 | <ns1:RequestedItemsDesired /> | ||
| 186 | <ns1:UserFiscalAccountDesired /> | ||
| 187 | </ns1:LookupUser> | ||
| 188 | </ns1:NCIPMessage>}}} | ||
| 189 | |||
| 190 | == Lookup Agency == | ||
| 191 | |||
| |
2.1 | 192 | | |
| |
1.1 | 193 | |
| 194 | {{{<?xml version="1.0" encoding="UTF-8"?> | ||
| 195 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 196 | <LookupAgency> | ||
| 197 | <InitiationHeader> | ||
| 198 | <ToAgencyId> | ||
| 199 | <AgencyId>KOG001</AgencyId> | ||
| 200 | </ToAgencyId> | ||
| 201 | </InitiationHeader> | ||
| 202 | <AgencyId>KOG001</AgencyId> | ||
| 203 | |||
| 204 | <AgencyElementType>Agency Address Information</AgencyElementType> | ||
| 205 | <AgencyElementType>Organization Name Information</AgencyElementType> | ||
| 206 | </LookupAgency> | ||
| 207 | </ns1:NCIPMessage>}}} | ||
| 208 | |||
| 209 | == Lookup Item == | ||
| 210 | |||
| |
2.1 | 211 | | |
| |
1.1 | 212 | |
| 213 | {{{<?xml version="1.0" encoding="UTF-8"?> | ||
| 214 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> <LookupItem> | ||
| 215 | |||
| 216 | <InitiationHeader> | ||
| 217 | <ToAgencyId> | ||
| 218 | <AgencyId>KOG001</AgencyId> | ||
| 219 | </ToAgencyId> | ||
| 220 | </InitiationHeader> | ||
| 221 | |||
| 222 | <ItemId> | ||
| 223 | <AgencyId>Tábor</AgencyId> | ||
| 224 | <ItemIdentifierType>ACCESSION_NUMBER</ItemIdentifierType> | ||
| 225 | <ItemIdentifierValue>123</ItemIdentifierValue> | ||
| 226 | </ItemId> | ||
| 227 | |||
| 228 | <ItemElementType>Circulation Status</ItemElementType> | ||
| 229 | <ItemElementType>Hold Queue Length</ItemElementType> | ||
| 230 | <ItemElementType>Location</ItemElementType> | ||
| 231 | </LookupItem> | ||
| 232 | </ns1:NCIPMessage>}}} | ||
| 233 | |||
| 234 | |||
| |
2.1 | 235 | | |
| |
1.1 | 236 | |
| 237 | {{{<?xml version="1.0" encoding="UTF-8" standalone="yes"?> | ||
| 238 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" | ||
| 239 | ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 240 | <ns1:LookupItem> | ||
| 241 | <ns1:InitiationHeader> | ||
| 242 | <ns1:ToAgencyId> | ||
| 243 | <ns1:AgencyId>TAG001</ns1:AgencyId> | ||
| 244 | </ns1:ToAgencyId> | ||
| 245 | </ns1:InitiationHeader> | ||
| 246 | |||
| 247 | <ns1:ItemId> | ||
| 248 | <ns1:AgencyId>TAG001</ns1:AgencyId> | ||
| 249 | <ns1:ItemIdentifierType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/visibleitemidentifiertype/visibleitemidentifiertype.scm">Accession Number</ns1:ItemIdentifierType> | ||
| 250 | <ns1:ItemIdentifierValue>436668</ns1:ItemIdentifierValue> | ||
| 251 | </ns1:ItemId> | ||
| 252 | |||
| 253 | <ns1:ItemElementType>Circulation Status</ns1:ItemElementType> | ||
| 254 | <ns1:ItemElementType>Hold Queue Length</ns1:ItemElementType> | ||
| 255 | <ns1:ItemElementType>Location</ns1:ItemElementType> | ||
| 256 | </ns1:LookupItem> | ||
| 257 | </ns1:NCIPMessage>}}} | ||
| 258 | |||
| 259 | == Lookup Item Set == | ||
| 260 | |||
| |
2.1 | 261 | | |
| |
1.1 | 262 | |
| 263 | {{{<NCIPMessage> | ||
| 264 | <LookupItemSet> | ||
| 265 | <InitiationHeader> | ||
| 266 | <ToAgencyId> | ||
| 267 | <AgencyId>KOG001</AgencyId> | ||
| 268 | </ToAgencyId> | ||
| 269 | </InitiationHeader> | ||
| 270 | <BibliographicId> | ||
| 271 | <BibliographicItemId> | ||
| 272 | <BibliographicItemIdentifier>978-80-86829-91-3</BibliographicItemIdentifier> | ||
| 273 | <BibliographicItemIdentifierCode>ISBN</BibliographicItemIdentifierCode> | ||
| 274 | </BibliographicItemId> | ||
| 275 | </BibliographicId> | ||
| 276 | </LookupItemSet> | ||
| 277 | </NCIPMessage>}}} | ||
| 278 | |||
| 279 | |||
| |
2.1 | 280 | | |
| |
1.1 | 281 | |
| 282 | {{{curl -X POST \ | ||
| 283 | https://most.tritius.cz/tritius/ncip/ \ | ||
| 284 | -H 'Content-Type: application/xml' \ | ||
| 285 | -H 'Postman-Token: 5a5eb1fd-f895-4d48-a6bf-a17170598295' \ | ||
| 286 | -H 'cache-control: no-cache' \ | ||
| 287 | -d '<?xml version="1.0" encoding="UTF-8" standalone="yes"?> | ||
| 288 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 289 | <ns1:LookupItemSet> | ||
| 290 | <ns1:InitiationHeader> | ||
| 291 | <ns1:FromAgencyId> | ||
| 292 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">CPK</ns1:AgencyId> | ||
| 293 | </ns1:FromAgencyId> | ||
| 294 | <ns1:ToAgencyId> | ||
| 295 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">KHG001</ns1:AgencyId> | ||
| 296 | </ns1:ToAgencyId> | ||
| 297 | </ns1:InitiationHeader> | ||
| 298 | |||
| 299 | <BibliographicId> | ||
| 300 | <BibliographicItemId> | ||
| 301 | <BibliographicItemIdentifier>55361</BibliographicItemIdentifier> | ||
| 302 | <BibliographicItemIdentifierCode>Legal Deposit Number</BibliographicItemIdentifierCode> | ||
| 303 | </BibliographicItemId> | ||
| 304 | </BibliographicId> | ||
| 305 | </ns1:LookupItemSet> | ||
| 306 | </ns1:NCIPMessage>'}}} | ||
| 307 | |||
| 308 | |||
| |
2.1 | 309 | | |
| |
1.1 | 310 | |
| 311 | {{{curl -X POST https://most.tritius.cz/tritius/ncip/ -H 'Content-Type: application/xml' -H 'Postman-Token: 5a5eb1fd-f895-4d48-a6bf-a17170598295' -H 'cache-control: no-cache' -d '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> <ns1:LookupItemSet> <ns1:InitiationHeader> <ns1:FromAgencyId> <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">CPK</ns1:AgencyId> </ns1:FromAgencyId> <ns1:ToAgencyId> <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">KHG001</ns1:AgencyId> </ns1:ToAgencyId> </ns1:InitiationHeader> <BibliographicId> <BibliographicItemId> <BibliographicItemIdentifier>55361</BibliographicItemIdentifier> <BibliographicItemIdentifierCode>Legal Deposit Number</BibliographicItemIdentifierCode> </BibliographicItemId> </BibliographicId> </ns1:LookupItemSet></ns1:NCIPMessage>'}}} | ||
| 312 | |||
| 313 | |||
| |
2.1 | 314 | | |
| |
1.1 | 315 | |
| 316 | {{{curl -X POST https://tritius.svkul.cz/tritius/ncip/ -H "Content-Type: application/xml" -H "Postman-Token: 5a5eb1fd-f895-4d48-a6bf-a17170598295" -H "cache-control: no-cache" -d "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><ns1:NCIPMessage xmlns:ns1=\"http://www.niso.org/2008/ncip\" ns1:version=\"http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd\"> <ns1:LookupItemSet> <ns1:InitiationHeader> <ns1:FromAgencyId> <ns1:AgencyId ns1:Scheme=\"http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm\">CPK</ns1:AgencyId> </ns1:FromAgencyId> <ns1:ToAgencyId> <ns1:AgencyId ns1:Scheme=\"http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm\">KHG001</ns1:AgencyId> </ns1:ToAgencyId> </ns1:InitiationHeader> <BibliographicId> <BibliographicItemId> <BibliographicItemIdentifier>55361</BibliographicItemIdentifier> <BibliographicItemIdentifierCode>Legal Deposit Number</BibliographicItemIdentifierCode> </BibliographicItemId> </BibliographicId> </ns1:LookupItemSet></ns1:NCIPMessage>"}}} | ||
| 317 | |||
| 318 | |||
| 319 | == Lookup Request == | ||
| 320 | |||
| |
2.1 | 321 | | |
| |
1.1 | 322 | |
| 323 | {{{<NCIPMessage> | ||
| 324 | <LookupRequest> | ||
| 325 | <InitiationHeader> | ||
| 326 | <ToAgencyId> | ||
| 327 | <AgencyId>KOG001</AgencyId> | ||
| 328 | </ToAgencyId> | ||
| 329 | </InitiationHeader> | ||
| 330 | <RequestId> | ||
| 331 | <RequestIdentifierValue>983</RequestIdentifierValue> | ||
| 332 | </RequestId> | ||
| 333 | |||
| 334 | <RequestElementType>User Id</RequestElementType> | ||
| 335 | <RequestElementType>Request Type</RequestElementType> | ||
| 336 | <RequestElementType>Request Scope Type</RequestElementType> | ||
| 337 | <RequestElementType>Request Status Type</RequestElementType> | ||
| 338 | <RequestElementType>Hold Queue Position</RequestElementType> | ||
| 339 | <RequestElementType>Shipping Information</RequestElementType> | ||
| 340 | <RequestElementType>Earliest Date Needed</RequestElementType> | ||
| 341 | <RequestElementType>Need Before Date</RequestElementType> | ||
| 342 | <RequestElementType>Pickup Date</RequestElementType> | ||
| 343 | <RequestElementType>Pickup Location</RequestElementType> | ||
| 344 | <RequestElementType>Pickup Expiry Date</RequestElementType> | ||
| 345 | <RequestElementType>Date Of User Request</RequestElementType> | ||
| 346 | <RequestElementType>Date Available</RequestElementType> | ||
| 347 | <RequestElementType>Acknowledged Fee Amount</RequestElementType> | ||
| 348 | <RequestElementType>Paid Fee Amount</RequestElementType> | ||
| 349 | </LookupRequest> | ||
| 350 | </NCIPMessage>}}} | ||
| 351 | |||
| 352 | |||
| |
2.1 | 353 | | |
| |
1.1 | 354 | |
| 355 | {{{<NCIPMessage> | ||
| 356 | <LookupRequest> | ||
| 357 | <UserId> | ||
| 358 | <AgencyId>SIG001</AgencyId> | ||
| 359 | <UserIdentifierType>Institution Id Number</UserIdentifierType> | ||
| 360 | <UserIdentifierValue>1</UserIdentifierValue> | ||
| 361 | </UserId> | ||
| 362 | <ItemId> | ||
| 363 | <AgencyId>SIG001</AgencyId> | ||
| 364 | <ItemIdentifierType>Accession Number</ItemIdentifierType> | ||
| 365 | <ItemIdentifierValue>1</ItemIdentifierValue> | ||
| 366 | </ItemId> | ||
| 367 | <RequestType>Hold</RequestType> | ||
| 368 | |||
| 369 | <RequestElementType>User Id</RequestElementType> | ||
| 370 | <RequestElementType>Request Type</RequestElementType> | ||
| 371 | <RequestElementType>Request Scope Type</RequestElementType> | ||
| 372 | <RequestElementType>Request Status Type</RequestElementType> | ||
| 373 | <RequestElementType>Hold Queue Position</RequestElementType> | ||
| 374 | <RequestElementType>Shipping Information</RequestElementType> | ||
| 375 | <RequestElementType>Earliest Date Needed</RequestElementType> | ||
| 376 | <RequestElementType>Need Before Date</RequestElementType> | ||
| 377 | <RequestElementType>Pickup Date</RequestElementType> | ||
| 378 | <RequestElementType>Pickup Location</RequestElementType> | ||
| 379 | <RequestElementType>Pickup Expiry Date</RequestElementType> | ||
| 380 | <RequestElementType>Date Of User Request</RequestElementType> | ||
| 381 | <RequestElementType>Date Available</RequestElementType> | ||
| 382 | <RequestElementType>Acknowledged Fee Amount</RequestElementType> | ||
| 383 | <RequestElementType>Paid Fee Amount</RequestElementType> | ||
| 384 | </LookupRequest> | ||
| 385 | </NCIPMessage>}}} | ||
| 386 | |||
| 387 | == Renew Item == | ||
| 388 | |||
| |
2.1 | 389 | | |
| |
1.1 | 390 | |
| 391 | {{{<NCIPMessage> | ||
| 392 | <RenewItem> | ||
| 393 | <InitiationHeader> | ||
| 394 | <!-- Nepovinné --> | ||
| 395 | <FromAgencyId> | ||
| 396 | <AgencyId>CPK</AgencyId> | ||
| 397 | </FromAgencyId> | ||
| 398 | |||
| 399 | <ToAgencyId> | ||
| 400 | <AgencyId>KOG001</AgencyId> | ||
| 401 | </ToAgencyId> | ||
| 402 | </InitiationHeader> | ||
| 403 | |||
| 404 | <UserId> | ||
| 405 | <UserIdentifierValue>302709</UserIdentifierValue> | ||
| 406 | </UserId> | ||
| 407 | |||
| 408 | <ItemId> | ||
| 409 | <ItemIdentifierValue>2809808</ItemIdentifierValue> | ||
| 410 | </ItemId> | ||
| 411 | </RenewItem> | ||
| 412 | </NCIPMessage>}}} | ||
| 413 | |||
| 414 | |||
| |
2.1 | 415 | | |
| |
1.1 | 416 | |
| 417 | {{{<?xml version="1.0" encoding="UTF-8" standalone="yes"?> | ||
| 418 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 419 | <ns1:RenewItem> | ||
| 420 | <ns1:InitiationHeader> | ||
| 421 | <ns1:FromAgencyId> | ||
| 422 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">CPK</ns1:AgencyId> | ||
| 423 | </ns1:FromAgencyId> | ||
| 424 | |||
| 425 | <ns1:ToAgencyId> | ||
| 426 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">AAA001</ns1:AgencyId> | ||
| 427 | </ns1:ToAgencyId> | ||
| 428 | </ns1:InitiationHeader> | ||
| 429 | |||
| 430 | <ns1:UserId> | ||
| 431 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">AAA001</ns1:AgencyId> | ||
| 432 | <ns1:UserIdentifierType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/visibleuseridentifiertype/visibleuseridentifiertype.scm">Institution Id Number</ns1:UserIdentifierType> | ||
| 433 | <ns1:UserIdentifierValue>12</ns1:UserIdentifierValue> | ||
| 434 | </ns1:UserId> | ||
| 435 | |||
| 436 | <ns1:ItemId><ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">AAA001</ns1:AgencyId> | ||
| 437 | <ns1:ItemIdentifierType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/visibleitemidentifiertype/visibleitemidentifiertype.scm">Accession Number</ns1:ItemIdentifierType> | ||
| 438 | <ns1:ItemIdentifierValue>993550215536</ns1:ItemIdentifierValue> | ||
| 439 | </ns1:ItemId> | ||
| 440 | </ns1:RenewItem> | ||
| 441 | </ns1:NCIPMessage>}}} | ||
| 442 | |||
| 443 | == Request Item == | ||
| 444 | |||
| |
2.1 | 445 | | |
| |
1.1 | 446 | |
| 447 | {{{<?xml version="1.0" encoding="UTF-8" standalone="yes"?> | ||
| 448 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 449 | <RequestItem> | ||
| 450 | <InitiationHeader> | ||
| 451 | <ToAgencyId> | ||
| 452 | <AgencyId>KOG001</AgencyId> | ||
| 453 | </ToAgencyId> | ||
| 454 | </InitiationHeader> | ||
| 455 | |||
| 456 | <UserId> | ||
| 457 | <UserIdentifierValue>45562</UserIdentifierValue> | ||
| 458 | </UserId> | ||
| 459 | |||
| 460 | <ItemId> | ||
| 461 | <ItemIdentifierValue>231070275595</ItemIdentifierValue> | ||
| 462 | </ItemId> | ||
| 463 | </RequestItem> | ||
| 464 | </ns1:NCIPMessage>}}} | ||
| 465 | |||
| 466 | == Cancel Request Item == | ||
| 467 | |||
| |
2.1 | 468 | | |
| |
1.1 | 469 | |
| 470 | {{{<?xml version="1.0" encoding="UTF-8" standalone="yes"?> | ||
| 471 | <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 472 | <CancelRequestItem> | ||
| 473 | <InitiationHeader> | ||
| 474 | <ToAgencyId> | ||
| 475 | <AgencyId>AAA001</AgencyId> | ||
| 476 | </ToAgencyId> | ||
| 477 | </InitiationHeader> | ||
| 478 | |||
| 479 | <UserId> | ||
| 480 | <UserIdentifierValue>9</UserIdentifierValue> | ||
| 481 | </UserId> | ||
| 482 | |||
| 483 | <ItemId> | ||
| 484 | <ItemIdentifierValue>993550249985</ItemIdentifierValue> | ||
| 485 | </ItemId> | ||
| 486 | </CancelRequestItem> | ||
| 487 | </ns1:NCIPMessage>}}} | ||
| 488 | |||
| 489 | |||
| |
2.1 | 490 | | |
| |
1.1 | 491 | |
| 492 | {{{<?xml version="1.0" encoding="UTF-8" standalone="yes"?><ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip" ns1:version="http://www.niso.org/schemas/ncip/v2_02/ncip_v2_02.xsd"> | ||
| 493 | <ns1:CancelRequestItem> | ||
| 494 | <ns1:InitiationHeader> | ||
| 495 | <ns1:FromAgencyId> | ||
| 496 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">CPK</ns1:AgencyId> | ||
| 497 | </ns1:FromAgencyId> | ||
| 498 | <ns1:ToAgencyId> | ||
| 499 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">AAA001</ns1:AgencyId> | ||
| 500 | </ns1:ToAgencyId> | ||
| 501 | </ns1:InitiationHeader> | ||
| 502 | |||
| 503 | <ns1:UserId> | ||
| 504 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">AAA001</ns1:AgencyId> | ||
| 505 | <ns1:UserIdentifierType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/visibleuseridentifiertype/visibleuseridentifiertype.scm">Institution Id Number</ns1:UserIdentifierType> | ||
| 506 | <ns1:UserIdentifierValue>12</ns1:UserIdentifierValue> | ||
| 507 | </ns1:UserId> | ||
| 508 | |||
| 509 | <ns1:RequestId> | ||
| 510 | <ns1:AgencyId ns1:Scheme="http://www.niso.org/ncip/v1_0/schemes/agencyidtype/agencyidtype.scm">AAA001</ns1:AgencyId> | ||
| 511 | <ns1:RequestIdentifierType ns1:Scheme="http://www.library.sk/ncip/v2_02/schemes.scm">IDX</ns1:RequestIdentifierType> | ||
| 512 | <ns1:RequestIdentifierValue>591</ns1:RequestIdentifierValue> | ||
| 513 | </ns1:RequestId> | ||
| 514 | |||
| 515 | <ns1:RequestType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/requesttype/requesttype.scm">Estimate</ns1:RequestType> | ||
| 516 | <ns1:RequestScopeType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/requestscopetype/requestscopetype.scm">Bibliographic Item</ns1:RequestScopeType> | ||
| 517 | </ns1:CancelRequestItem> | ||
| 518 | </ns1:NCIPMessage>}}} | ||
| 519 | |||
| |
2.1 | 520 | = Często zadawane pytania = |
| |
1.1 | 521 | |
| |
2.1 | 522 | **Czy po przeniesieniu identyfikatory użytkowników pozostały takie same jak w Claviu?** |
| |
1.1 | 523 | |
| |
2.1 | 524 | Krótka odpowiedź brzmi: **nie**. Podczas przenoszenia danych z Claviusa do Tritia tworzony jest nowy, unikalny identyfikator czytelnika (ID). Tak samo działa to w przypadku innych systemów poza Claviusem. Pierwotny identyfikator jest zapisywany jako importId. Nazwa użytkownika, login, adres e-mail, hasło itp. pozostają oczywiście bez zmian. |
| |
1.1 | 525 | |
| |
2.1 | 526 | = Błędy w ustawieniach NCIP = |
| |
1.1 | 527 | |
| |
2.1 | 528 | **Błąd 400 Not allowed** |
| |
1.1 | 529 | |
| |
2.1 | 530 | W większości przypadków jest to spowodowane nieprawidłowym ustawieniem IIS na serwerze jako odwrotnego serwera proxy. Administrator musi skonfigurować IIS tak, aby nie wysyłał portów x-forwarded-for, w przeciwnym razie ustawienie NCIP_ALLOWED_ADDRESS nie będzie działać. |
| |
1.1 | 531 | |
| |
2.1 | 532 | W razie potrzeby skonsultuj się z Martinem. |
| |
1.1 | 533 | |
| 534 |