Tämä plugin lisää EDItX tuen Kohaan.
Koha-Suomessa uudet kontainerit muodostetaan konew -skriptillä. Pääosa asetuksista tulee uuden kontin muodostamisvaiheessa valmiina. Erikseen täytyy luoda vielä SFTP tiedonsiirtoja varten tunnukset sekä päivittää rajapinnan konfiguraatioon käytettävä procurement-config.xml
SFTP tunnukset ovat muotoa [k]-[r]-editx, mutta jos kyseessä on tuotantotunnus -[r] jätetään pois. Kutakin kimppaa varten tarvitaan periaatteessa kaksi tunnusta. "kimppa-test-editx" ja "kimppa-editx". Tunnukset luodaan makeeditxaccount -skriptillä (host-toolsissa). Skripti luo tunnukset ja ohjeistaa niiden käyttöönoton.
Konfiguraatio on tiedostossa /etc/koha/procurement_config.xml:
<?xml version="1.0"?>
<data>
<settings>
<import_tmp_path>/home/koha/koha-dev/var/spool/editx/tmp</import_tmp_path> <!-- The folder where files should be first put. The Integrations external entrypoint -->
<import_load_path>/home/koha/koha-dev/var/spool/editx/load</import_load_path> <!-- The path from where the script reads files to import -->
<import_archive_path>/home/koha/koha-dev/var/spool/editx/archive</import_archive_path> <!-- The path where files are archived after succesfull import-->
<import_failed_path>/home/koha/koha-dev/var/spool/editx/fail</import_failed_path> <!-- The path where files are archived if something fails during import-->
<import_failed_archived_path>/home/koha/koha-dev/var/spool/editx/failed_archived</import_failed_archived_path> <!-- The path where files are archived if something fails during import-->
<authoriser>nnnnnn</authoriser> <!-- A borrowers id (borrowernumber) used in import, change this! -->
<allowed_locations>LN,AIK,MUS,OU</allowed_locations>
<productform_alternative_triggers>LAP</productform_alternative_triggers> <!-- The shelving location that is found in fundnumber, used for assigning productform_alternative from db map_productform-->
<automatch_biblios>yes</automatch_biblios> <!-- Set to 'no' if you want to create a new biblio and biblioitem on every order. -->
</settings>
<notifications>
<mailto>osoite1@ouka.fi,osoite2@ouka.fi,osoite3@ouka.fi</mailto> <!-- comma separated list of email-addresses to send error reports to -->
</notifications>
</data>
Polkuihin ei yleensä tarvitse koskea, oletuspolut toimivat jos käyttöönotto tehdään tässä dokumentissa kuvatulla tavalla. Authoriser on Kohassa määritelty EditX-tilausten luoja (Kohaan tarkoitusta varten lisätyn editx-käyttäjän borrowernumber) ja allowed_locations kertoo mille hyllypaikoille aineistoa voi hankkia. Kuvailutietueiden tuplakontrollin voi halutessaan kytkeä pois muuttamalla automatch_biblios asetukseksi no. Silloin tilatuista nimekkeistä muodostuu aina uudet kuvailutietueet omine niteineen.
Notifications-osan mailto-elementissä määritellään sähköpostitse lähetettävien virhesanomien vastaanottajat.
Ajastukset sanomien käsittelyyn on valmiina koha-käyttäjän crontabissa, mutta uuden kontin luontivaiheessa ne on kommentoitu pois käytöstä. Käyttöönottovaiheessa kommenttimerkit täytyy poistaa seuraavilta riveiltä:
*/1 06-22 * * * $TRIGGER cronjobs/runEditXImport.pl
45 23 * * * $TRIGGER cronjobs/notify_failed_editx.sh
00 21 * * * $TRIGGER cronjobs/requeue_failed_editx.sh
Sanomat käsitellään klo 6.00-22.00 välisenä aikana minuutin välein tai niin nopeassa tahdissa kuin mahdollista.
Sanoman tiedosto tulee olla xml-muodossa.
Header-osio sisältää yleisiä tilauksen tietoja, kun taas jokaisella teoksella on oma ItemDetail-elementtinsä. LineNumber-arvoa tulee kasvattaa jokaisen ItemDetail-elementin kohdalla. Summary-tagi tarjoaa yhteenvedon kaikista ItemDetail-elementeistä.
<?xml version="1.0" encoding="UTF-8"?>
<LibraryShipNotice version="1.0">
<Header>
<ShipNoticeNumber>12345</ShipNoticeNumber>
<IssueDateTime>20250205T1730</IssueDateTime>
<PurposeCode>Original</PurposeCode>
<DateCoded>
<Date>20250205</Date>
<DateQualifierCode>Shipped</DateQualifierCode>
</DateCoded>
<BuyerParty>
<PartyID>
<PartyIDType>VendorAssignedID</PartyIDType>
<Identifier>12345</Identifier>
</PartyID>
<PartyName>
<NameLine>Kohala;FI-KOHA;016</NameLine>
</PartyName>
</BuyerParty>
<SellerParty>
<PartyID>
<PartyIDType>BuyerAssignedID</PartyIDType>
<Identifier>FI-BTJ</Identifier>
</PartyID>
<PartyName>
<NameLine>BTJ Finland Oy</NameLine>
</PartyName>
</SellerParty>
</Header>
<ItemDetail>
<LineNumber>1</LineNumber>
<ProductID>
<ProductIDType>EAN13</ProductIDType>
<Identifier>9789510506103</Identifier>
</ProductID>
<ProductID>
<ProductIDType>ISBN</ProductIDType>
<Identifier>978-951-0-50610-3</Identifier>
</ProductID>
<ItemDescription>
<ProductForm>BK</ProductForm>
<Title>Izak.</Title>
<Author>Elstelä, Joel</Author>
<SeriesTitle></SeriesTitle>
<VolumeOrPart/>
<EditionStatement/>
<CityOfPublication></CityOfPublication>
<PublisherName>WSOY</PublisherName>
<YearOfPublication>2024</YearOfPublication>
</ItemDescription>
<QuantityShipping>1</QuantityShipping>
<ReferenceCoded>
<ReferenceTypeCode>VendorsOrderReference</ReferenceTypeCode>
<ReferenceNumber>12345</ReferenceNumber>
<ReferenceDate>05.02.2025</ReferenceDate>
</ReferenceCoded>
<PricingDetail>
<Price>
<MonetaryAmount>13.68</MonetaryAmount>
<CurrencyCode>EUR</CurrencyCode>
<CountryCode>FI</CountryCode>
<PriceQualifierCode>FixedRPIncludingTax</PriceQualifierCode>
<Tax>
<TaxTypeCode>VAT</TaxTypeCode>
<Percent>14</Percent>
</Tax>
</Price>
</PricingDetail>
<PricingDetail>
<Price>
<MonetaryAmount>12.00</MonetaryAmount>
<CurrencyCode>EUR</CurrencyCode>
<CountryCode>FI</CountryCode>
<PriceQualifierCode>FixedRPExcludingTax</PriceQualifierCode>
<Tax>
<TaxTypeCode>VAT</TaxTypeCode>
<Percent>14</Percent>
</Tax>
</Price>
</PricingDetail>
<PricingDetail>
<Price>
<MonetaryAmount>12.00</MonetaryAmount>
<CurrencyCode>EUR</CurrencyCode>
<PriceQualifierCode>SRPExcludingTax</PriceQualifierCode>
<Tax>
<TaxTypeCode>VAT</TaxTypeCode>
<Percent>14</Percent>
</Tax>
</Price>
</PricingDetail>
<CopyDetail>
<SubLineNumber>1</SubLineNumber>
<CopyQuantity>1</CopyQuantity>
<DeliverToLocation>FOOPKAIK2025</DeliverToLocation>
<DestinationLocation>FOOPKAIK2025</DestinationLocation>
<ProcessingInstructionCode>Catalog</ProcessingInstructionCode>
<CopyValue>
<MonetaryAmount>12.00</MonetaryAmount>
<CurrencyCode>EUR</CurrencyCode>
</CopyValue>
<LocationCode>FI-KOHA;210;1</LocationCode>
<ReaderInterestCode/>
<FundDetail>
<FundNumber>FOOPKAIK2025</FundNumber>
<MonetaryAmount>12.00</MonetaryAmount>
</FundDetail>
<Message>
<MessageType>04</MessageType>
<MessageLine><?xml version="1.0" encoding="UTF-8"?>
<collection xmlns="http://www.loc.gov/MARC21/slim">
<record>
<leader>00962nam a22002898a 4500</leader>
<controlfield tag="001">978-951-0-50610-3</controlfield>
<controlfield tag="003">FI-Woima</controlfield>
<controlfield tag="005">20240326101401.0</controlfield>
<controlfield tag="008">240315s2024 fi fin</controlfield>
<datafield tag="020" ind1=" " ind2=" ">
<subfield code="a">978-951-0-50610-3</subfield>
<subfield code="q">kovakantinen</subfield>
</datafield>
<datafield tag="035" ind1=" " ind2=" ">
<subfield code="a">(FI-BTJ)7459348</subfield>
</datafield>
<datafield tag="040" ind1=" " ind2=" ">
<subfield code="a">FI-Woima</subfield>
<subfield code="b">fin</subfield>
<subfield code="e">rda</subfield>
</datafield>
<datafield tag="041" ind1=" " ind2=" ">
<subfield code="a">fin</subfield>
</datafield>
<datafield tag="084" ind1=" " ind2=" ">
<subfield code="2">ykl</subfield>
<subfield code="a">84.2</subfield>
</datafield>
<datafield tag="100" ind1="1" ind2=" ">
<subfield code="a">Elstelä, Joel</subfield>
<subfield code="e">kirjoittaja</subfield>
</datafield>
<datafield tag="245" ind1="1" ind2="0">
<subfield code="a">Izak.</subfield>
</datafield>
<datafield tag="250" ind1=" " ind2=" ">
<subfield code="a">1. p.</subfield>
</datafield>
<datafield tag="260" ind1=" " ind2=" ">
<subfield code="b">WSOY</subfield>
<subfield code="c">2024</subfield>
</datafield>
<datafield tag="263" ind1=" " ind2=" ">
<subfield code="a">20240904</subfield>
</datafield>
<datafield tag="264" ind1="3" ind2="1">
<subfield code="b">WSOY</subfield>
<subfield code="c">2024</subfield>
</datafield>
<datafield tag="300" ind1=" " ind2=" ">
<subfield code="c">korkeus 221 mm, leveys 144 mm, paksuus 46 mm</subfield>
</datafield>
<datafield tag="336" ind1=" " ind2=" ">
<subfield code="2">rdacontent</subfield>
<subfield code="a">teksti</subfield>
<subfield code="b">txt</subfield>
</datafield>
<datafield tag="337" ind1=" " ind2=" ">
<subfield code="2">rdamedia</subfield>
<subfield code="a">käytettävissä ilman laitetta</subfield>
<subfield code="b">n</subfield>
</datafield>
<datafield tag="338" ind1=" " ind2=" ">
<subfield code="2">rdacarrier</subfield>
<subfield code="a">nide</subfield>
<subfield code="b">nc</subfield>
</datafield>
<datafield tag="500" ind1=" " ind2=" ">
<subfield code="a">EI VIELÄ ILMESTYNYT, arvioitu ilmestymisaika 04.09.2024</subfield>
</datafield>
<datafield tag="856" ind1="4" ind2="2">
<subfield code="q">image</subfield>
<subfield code="u">https://sopimusasiakkaat.booky.fi/image.php?size=medium&amp;id=9789510506103</subfield>
<subfield code="z">Kansikuva</subfield>
</datafield>
<datafield tag="856" ind1="4" ind2="2">
<subfield code="q">text</subfield>
<subfield code="u">https://sopimusasiakkaat.booky.fi/description.php?ean=9789510506103</subfield>
<subfield code="z">Kuvaus</subfield>
</datafield>
</record>
</collection>
</MessageLine>
</Message>
<RequestedBy/>
<ApprovedBy/>
</CopyDetail>
</ItemDetail>
<Summary>
<NumberOfLines>1</NumberOfLines>
<UnitsShipped>1</UnitsShipped>
</Summary>
</LibraryShipNotice>Yleisiin käyttöohjeisiin pääset tästä