Skip to Content

Zdrojový kód wiki NCIP (CPK, NKP)

Naposledy změněno Martin Mahr 2024/10/21 22:17
Hide last authors
Jan Šimeček 1.1 1 NCIP protokol poskytuje rozhraní pro čtení informací o čtenářích, dílech, výpůjčkách a nabízí operace pro základní operace výpůjčního protokolu.
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
6 = Dokumentace protokolu =
7
8 |=Popis|=Odkaz
9 |Dokumentace 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 |XSD NCIP protokolu|[[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 |CPK Dokumentace|[[http:~~/~~/moravianlibrary.github.io/CPK-standardy/>>url:http://moravianlibrary.github.io/CPK-standardy/]]
12 |(% colspan="1" %)Minimální požadavky CPK|(% colspan="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 )))
15 |(% colspan="1" %)CPK popis požadavků a odpovědí|(% 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" %)Příklady požadavků / odpovědí|(% colspan="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
22 = Implementace v Tritiu =
23
24 NCIP modul je v Tritiu vždy zapnutý a běží na URL adrese:
25
Martin Mahr 2.1 26 * [[https:~~/~~/demo.tritius.cz/tritius/ncip/>>url:https://demo.tritius.cz/Tritius/ncip/]]
Jan Šimeček 1.1 27
28 == Testování ==
29
30 Pro účely testování správnosti XML zpráv je možné použít tzv. ozvěnu. Na adrese **/ncip/echo** je k dispozici služba, která zpracuje příchozí XML zprávu, provede její převod na vnitřní struktury systému Tritius a zase je vrací zpět na výstup. Služba tak vrací zase XML.
31
32
33 Pro testování komunikace lze použít nástroje:
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
41 === HTTP komunikace ===
42
43 Pro komunikaci s NCIP serverem je třeba dodržet několik požadavků:
44
45 * Content-Type:
46
47 == Hlavička InitiationHeader ==
48
49 Protože systém Tritius je multi-knihovní, je třeba v každém požadavku zadat cílovou knihovnu, které se dotaz týká. Ta se zadává v prvku InitiationHeader jako atribut ToAgencyId, který je součástí každé NCIP služby.
50
Martin Mahr 2.1 51 |
Jan Šimeček 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
Martin Mahr 2.1 66 |
Jan Šimeček 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
Martin Mahr 2.1 99 |
Jan Šimeček 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
Martin Mahr 2.1 124 |
Jan Šimeček 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
Martin Mahr 2.1 154 |
Jan Šimeček 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
Martin Mahr 2.1 192 |
Jan Šimeček 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
Martin Mahr 2.1 211 |
Jan Šimeček 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
Martin Mahr 2.1 235 |
Jan Šimeček 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
Martin Mahr 2.1 261 |
Jan Šimeček 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
Martin Mahr 2.1 280 |
Jan Šimeček 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
Martin Mahr 2.1 309 |
Jan Šimeček 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
Martin Mahr 2.1 314 |
Jan Šimeček 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
Martin Mahr 2.1 321 |
Jan Šimeček 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
Martin Mahr 2.1 353 |
Jan Šimeček 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
Martin Mahr 2.1 389 |
Jan Šimeček 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
Martin Mahr 2.1 415 |
Jan Šimeček 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
Martin Mahr 2.1 445 |
Jan Šimeček 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
Martin Mahr 2.1 468 |
Jan Šimeček 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
Martin Mahr 2.1 490 |
Jan Šimeček 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
520 = Často kladené dotazy =
521
522 **Zůstaly po převodu identifikátory uživatelů stejné jako v Claviu?**
523
524 Stručná odpověď je **ne**. Při převodu z Clavia do Tritia dojde k vytvoření nového jednoznačného identifikátoru čtenáře (ID). Stejně tak to funguje i s jinými systémy mimo Clavius. Původní identifikátor je uložen jako importId. Uživatelské jméno, login, email, heslo atd. samozřejmě zůstávají stejná.
525
526 = Chyby nastavení NCIP =
527
528 **Chyba 400 Not allowed**
529
530 Většinou se jedná o chybné nastavení IIS na serveru jako reverzní proxy. Správce musí nastavit IIS tak, aby neposílal v x-forwarded-for port(y), jinak nefunguje nastavení NCIP_ALLOWED_ADDRESS.
531
532 Případně konzultovat s Martinem.
533
534