{"id":326,"date":"2014-06-28T17:34:27","date_gmt":"2014-06-28T15:34:27","guid":{"rendered":"http:\/\/www.valeriofinazzo.it\/wordpress\/?p=326"},"modified":"2014-06-28T17:34:50","modified_gmt":"2014-06-28T15:34:50","slug":"vufind-tutorial-3-importare-record","status":"publish","type":"post","link":"http:\/\/www.valeriofinazzo.it\/wordpress\/2014\/06\/vufind-tutorial-3-importare-record\/","title":{"rendered":"VUFIND – Tutorial 3 – Importare Record"},"content":{"rendered":"

Nell’articolo di oggi vedremo come popolare la base dati di VUFIND. VUFIND presenta delle utility per il caricamento dati, che si interfacciano con Solr per la creazione del nostro catalogo.<\/p>\n

Sono presenti due modalit\u00e0 di caricamenti: tramite file in formato MARC21 oppure tramite file xml con un foglio xsl associato.<\/p>\n

Nel caso del formato MARC21 rimando al sito ufficiale<\/a>. Sostanzialmente si tratta di aver un file MARC21 e di caricarlo tramite il comando<\/p>\n

import-marc.bat nomefile.mrc<\/pre>\n
Per chi non conoscesse MARC21 (ad esempio me) VUFIND da la possibilit\u00e0 di caricare i libri in formato XML associando un foglio di stile xsl che effettui la trasformazione del file nel formato xml supportato da Solr, le cui specifiche sono consultabili qui<\/a>.<\/p>\n
Personalmente preferisco questa seconda soluzione, pi\u00f9 abbordabile e alla portata di tutti. Inoltre permette a chiunque abbia un catalogo xml di poterlo caricare sul nostro sistema agevolmente.<\/p>\n
Facciamo un caso pratico, l’esempio vale pi\u00f9 di 1000 parole. Supponiamo di avere un file xml che contiene il nostro catalogo cos\u00ec fatto:<\/p>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<books>\r\n<book>\r\n<id>0000000001<\/id>\r\n<title>titolo1<\/title>\r\n<\/book>\r\n<book>\r\n<id>0000000002<\/id>\r\n<title>titolo2<\/title>\r\n<\/book>\r\n<book>\r\n<id>0000000003<\/id>\r\n<title>titolo3<\/title>\r\n<\/book>\r\n<\/books><\/pre>\n
A questo punto definiamo un foglio xsl che trasforma il file xml nel formato atteso da Solr.<\/p>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<xsl:stylesheet version=\"1.0\" xmlns:xsl=\"http:\/\/www.w3.org\/1999\/XSL\/Transform\">\r\n<xsl:template match=\"\/\">\r\n<add>\r\n<xsl:for-each select=\"\/books\/book\">\r\n<doc>\r\n<field name=\"id\">\r\n<xsl:value-of select=\"id\"\/>\r\n<\/field>\r\n<field name=\"title\">\r\n<xsl:value-of select=\"title\"\/>\r\n<\/field>\r\n<field name=\"recordtype\">book<\/field>\r\n<\/doc>\r\n<\/xsl:for-each>\r\n<\/add>\r\n<\/xsl:template>\r\n<\/xsl:stylesheet>\r\n\r\n<\/pre>\n
Questo file permetter\u00e0 di trasformare il file xml nel seguente formato atteso da Solr:<\/p>\n
<?<\/span>xml version<\/span>=<\/span>\"1.0\"<\/span> encoding<\/span>=<\/span>\"UTF-8\"<\/span>?><\/span><add><\/span><doc><\/span><field<\/span>name<\/span>=<\/span>\"id\"<\/span>><\/span>0000000001<\/span><\/field><\/span><field<\/span>name<\/span>=<\/span>\"title\"<\/span>><\/span>titolo1<\/span><\/field><\/span><field<\/span>name<\/span>=<\/span>\"recordtype\"<\/span>><\/span>book<\/span><\/field><\/span><\/doc><\/span><doc><\/span><field<\/span>name<\/span>=<\/span>\"id\"<\/span>><\/span>0000000002<\/span><\/field><\/span><field<\/span>name<\/span>=<\/span>\"title\"<\/span>><\/span>titolo2<\/span><\/field><\/span><field<\/span>name<\/span>=<\/span>\"recordtype\"<\/span>><\/span>book<\/span><\/field><\/span><\/doc><\/span><doc><\/span><field<\/span>name<\/span>=<\/span>\"id\"<\/span>><\/span>0000000003<\/span><\/field><\/span><field<\/span>name<\/span>=<\/span>\"title\"<\/span>><\/span>titolo3<\/span><\/field><\/span><field<\/span>name<\/span>=<\/span>\"recordtype\"<\/span>><\/span>book<\/span><\/field><\/span><\/doc><\/span><\/add><\/span><\/pre>\n
Per Solr ogni documento \u00e8 definito come una sequenza di field, ciascuno con il proprio nome e valore. Il file deve rispettare lo schema definito in solr, in caso contrario il file verr\u00e0 rifiutato durante l’importazione.<\/p>\n
A questo punto non ci resta che caricare il file tramite la direttiva<\/p>\n
c:\\vufind\\import>php import-xsl.php books.xml opac.properties<\/pre>\n
Tale direttiva processa il file books.xml applicando le regole definite nel file opac.properties che contiene i parametri per invocare il servizio esposto da solr. \u00a0La configurazione minimale \u00e8 la seguente:<\/p>\n
[General]\r\nxslt = opac.xsl\r\ncustom_class[] = VuFind\r\ntruncate_custom_class = true<\/pre>\n
Il parametro xslt indica il file xsl da usare e deve essere disponibile all’interno della directory xsl<\/p>\n
C:\\vufind\\import\\xsl<\/pre>\n
A questo punto se abbiamo operato riceveremo come risposta<\/p>\n
c:\\vufind\\import>php import-xsl.php books.xml opac.properties\r\n<pre>2014-06-28T11:21:46-04:00 DEBUG: => POST http:\/\/localhost:8080\/solr\/biblio\/\r\nupdate<\/pre>\r\n<pre>2014-06-28T11:21:46-04:00 DEBUG: <= 200 OK<\/pre>\r\nSuccessfully imported books.xml...<\/pre>\n
Buon caricamento dati<\/p>\n
\n","protected":false},"excerpt":{"rendered":"
Nell’articolo di oggi vedremo come popolare la base dati di VUFIND. VUFIND presenta delle utility per il caricamento dati, che si interfacciano con Solr per la creazione del nostro catalogo. Sono presenti due modalit\u00e0 di caricamenti: tramite file in formato MARC21 oppure tramite file xml con un foglio xsl associato. Nel caso del formato MARC21 … Continua la lettura di VUFIND – Tutorial 3 – Importare Record<\/span> →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[60],"tags":[62,61,13],"_links":{"self":[{"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/posts\/326"}],"collection":[{"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/comments?post=326"}],"version-history":[{"count":4,"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/posts\/326\/revisions"}],"predecessor-version":[{"id":330,"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/posts\/326\/revisions\/330"}],"wp:attachment":[{"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/media?parent=326"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/categories?post=326"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.valeriofinazzo.it\/wordpress\/wp-json\/wp\/v2\/tags?post=326"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}