Usare software di terze parti con Koha

MarcEdit

Molte biblioteche trovano utile usare MarcEdit per modificare o uniformare i propri dati. Se lo vuoi usare lo devi scaricare da http://marcedit.reeset.net/

Importante

Molte di queste operazioni qui descritte possono essere fatte in Koha usando i Templates di modifica MARC, ma qui descriviamo come farle usando MarcEdit.

Aggiungere un prefisso alle collocazioni

Quando si importano dati in Koha, innanzitutto può essere necessario bonificarli. Un’operazione comune tra gli utenti di Koha è di aggiungere un prefisso alla collocazione.

  • Apri MarcEdit

    image1089

  • Click “MarcEditor”

  • Vai a Strumenti > Modifica i sottocampi

    image1090

  • Per aggiungere un prefissio ai dati, il carattere speciale è ^b. Per aggiungere semplicemente dei dati all’inizio di un sottocampo, aggiungere ^b alla casella di testo Field Data, ed i dati da aggiungere in testa nella casella Replace

    image1091

    • Per aggiungere dati all’inizio di un sottocampo e contemporaneamente sostituire del testo, aggiungere ^b[stringa-da-sostituire] alla casella di testo Field Data ed i dati da aggiungere nella casella Replace With.

Importare dati da Excel in Koha

Si supponga di avere il catalogo della biblioteca registrato sotto forma di fogli excel e di volerli importare in Koha. Come fare? Koha non permette di importare dati da excel direttamente.Bene, c’è una soluzione semplicissima, che permette di importare dati da excel in Koha facilmente. Prima si converte il file excel in un file Marc, poi si importa quest’ultimo in Koha.

Per importare dati da excel in Koha, seguire i passi di seguito descritti

Convertire un file dal formato Excel al formato .mrk

Come prima cosa, bisogna convertire il file in formato excel in formato .mrk. Per questo scopo si usa MarcEdit, che si può scaricare all’indirizzo http://marcedit.reeset.net/

Dopo aver scaricato ed installato MarcEdit, lanciarlo e secegliere Add-ins–>Delimited Text Translator.

image1092

Quando appare la seguente finestra, fare clic su Next.

image1093

Fare clic ssul pulsantino evidenziato nell’illustrazione per sfogliare le cartelle del disco ed individuare il file excel desiderato.

image1094

Individuare il file excel selezionando il formato Excel File(*.xls).

image1095

Analogamente, compilare le altre informazioni richieste: Output File ed Excel Sheet Name; spuntare la casella UTF-8 Encoded se necessario e fare clic su Next.

image1096

Ora il programma richiede di indicare la corrispondenza tra le colonne del foglio excel ed i campi del formato standard marc.

Supponiamo di voler mappare la prima colonna al campo 022$a (ISSN valido per la risorsa in continuazione). Per far ciò, si seleziona Field 0 dall’elenco Select e si digita 022$a nella casella Map To; infine si fa clic su Apply.

image1097

Nota

E” possibile personalizzare gli indicatori e tutto il resto; per maggiori informazioni sul formato MARC21 vedere il sito ufficiale della Biblioteca del Congresso.

Seguire la stessa procedura per mappare gli altri campi e fare clic su Finish.

image1098

Quindi appare la finestra sottostante; essa indica che è stato prodotto il file di testo in formato Marc (*.mrk) nella posizione indicata.

image1099

Fare clic su Chiudere: è stato generato un file .mrk a partire da un file .xls. E” possibile vedere il file prodotto facendo doppio clic su di esso.

Convertire il file .mrk in .mrc

E” necessario convertire il file .mrk prodotto nella fase precedente in formato Marc «grezzo», che può essere importato direttamente in Koha.

A questo scopo, aprire di nuovo MarcEdit e scegliere MARC Tools.

image1100

Quindi selezionare markMaker per convertire il file .mrk nel formato .mrc.

image1101

Individuare il file di ingresso ed assegnare un nome al file di uscita. Quindi fare clic su Execute.

image1102

Ed al termine dell’operazione appaiono i risultati.

image1103

Fare clic su Chiudere; adesso i dati sono convertiti in formato Marc grezzo (il file .mrc).

Importe il file .mrc in Koha

More information on importing records into Koha can be found in the Stage MARC records for import section of this manual.

Infine si importa in Koha il file .mrc creato sopra.

Fare clic su Strumenti nel client per lo staff di Koha.

image1104

Quindi fare clic su Deposito MARC records per l’importazione.

image1105

Dopo di che, selezionare il file .mrc creato prima e fare clic su Carica il file.

image1106

E” anche possibile aggiungere annotazioni sul file, ed infine fare clic su Prepara per l’importazione.

image1107

Quando l’importazione è terminata, si vedrà un risultato simile al seguente

image1108

Quindi fare clic su Gestisci record preparati.

Qui è anche possibile cambiare le regole di corrispondenza, se necessario.

image1109

Una volta terminato, fare clic su Importa nel catalogo.

Fatto. Dopo che tutti i record sono stati importati, controllare la riga Status: dev’essere «Importato»

image1110

E” anche possibile annullare l’importazione.

E in pochi minuti abbiamo importato circa 10.000 record in Koha

OCLC Cataloging Services

Koha can be set to work with the OCLC cataloging services such as

This allows librarians to use the WorldShare Record Manager web interface or the OCLC Connexion Client desktop software as their cataloging tool and send those records to Koha with a single click.

Setting up the OCLC Connexion Daemon

First, you will need to set up the OCLC Connexion Daemon on your server. If you have a system administrator you will want to consult with them on this process.

  1. Find the script on your server and view its documentation.

    /usr/share/koha/bin/connexion_import_daemon.pl --help
    
  2. Create a configuration file. You could put this anywhere that is readable by the user that will be running the service, e.g., /etc/koha/sites/my_instance/oclc_connexion.conf. The output of the help command provides the details about what this file should contain. Here is an example:

    host: 0.0.0.0
    port: 5500
    log: /var/log/koha/my_instance/oclc_connexion.log
    koha: https://staff.mylibrary.example.com
    user: koha_staff_user_name
    password: koha_staff_user_password
    connexion_user: oclc_connexion_user_name
    connexion_password: oclc_connexion_user_password
    import_mode: direct
    
  3. Since the configuration file contains passwords, make sure that it’s only readable by the user running the script, and nobody else.

    chmod 400 /etc/koha/sites/my_instance/oclc_connexion.conf
    
  4. Run the script.

    • You can do this manually to test it out:

      /usr/share/koha/bin/connexion_import_daemon.pl --config /etc/koha/sites/my_instance/oclc_connexion.conf
      
    • Or you can set up a systemd unit to keep the script running even when it crashes or the server reboots:

      1. Create a file at /etc/systemd/system/koha-oclc-connexion.service:

        [Unit]
        Description=Koha OCLC Connexion Daemon
        After=network.target
        
        [Service]
        Type=exec
        ExecStart=/usr/share/koha/bin/connexion_import_daemon.pl --config /etc/koha/sites/my_instance/oclc_connexion.conf
        Restart=always
        
        [Install]
        WantedBy=multi-user.target
        
      2. Enable and start the service:

        systemctl enable koha-oclc-connexion
        systemctl start koha-oclc-connexion
        
      3. Check the status of the service:

        systemctl status koha-oclc-connexion
        

WorldShare Record Manager

Setting up WorldShare Record Manager

  1. Log in to your WorldShare account.

  2. Go to the «Metadata» tab.

  3. Select «Record Manager» in the sidebar.

  4. Select «User Preferences» in the sidebar.

    Nota

    Since these are User Preferences, they must be configured for each user who will be using the service.

    Screenshot of 'User Preferences' in the WorldShare web interface.

  5. Go to «Exporting – Bibliographic Records».

    The official documentation from OCLC for all settings under this heading is found at https://help.oclc.org/Metadata_Services/WorldShare_Record_Manager/Record_Manager_user_preferences/Exporting_Bibliographic_records#Set_preferences_for_TCP.2FIP_export .

  6. Go to the «General» tab.

    Screenshot of setting the 'Format' to 'UTF-8' under the 'General' export preferences in the WorldShare web interface.

    1. Set the «Format» to «MARC 21 with UTF-8 Unicode», since Koha always uses UTF-8.

    2. Click «Save».

  7. Go to the «TCP/IP» tab.

    Screenshot of setting the 'TCP/IP' export preferences in the WorldShare web interface.

    1. Enter the host name or IP address at which the OCLC connexion daemon service (configured above) can be reached.

    2. Set the Authentication to «Login ID» and enter the connexion_user and connexion_password from the configuration file (created above).

    3. Optionally set the connection delay, connection attempts, and other settings.

    4. Click «Save».

Using WorldShare Record Manager

Sending a single record from the WorldShare Record Manager to Koha
  1. Log in to your WorldShare account.

  2. Go to the «Metadata» tab.

  3. Select «Record Manager» in the sidebar.

  4. Search for a record.

    Screenshot of search results in the WorldShare web interface.

  5. Click on the title of a record to open it.

  6. Click on the «Record» dropdown menu, then «Send to», then «Local System (via TCP/IP)»

    Screenshot of the record screen in the WorldShare web interface, the Record menu is open, the Send to submenu is open and the Local System (via TCP/IP) option is selected

  7. After a while, depending on your «connection delay» settings, you should see the record in Koha.

    • If you used import_mode: direct in your configuration file, the record will be available in the catalog.

    • If you used import_mode: staged in your configuration file, the record will be staged for import.

Sending multiple records from the WorldShare Record Manager to Koha
  1. Log in to your WorldShare account.

  2. Go to the «Metadata» tab.

  3. Select «Record Manager» in the sidebar.

  4. Search for a record.

    Screenshot of search results in the WorldShare web interface.

  5. Click on the title of a record to open it.

  6. Click on the «Record» dropdown menu, then «Send to», then «Export List …». Select a list to which to add the record.

  7. Repeat from step 4 as needed.

  8. Click on «Export Lists» in the sidebar.

  9. Click on the name of a list to open it.

  10. Click on the «Export» dropdown menu, then «Send to local system (via TCP/IP)».

Screenshot of the 'Export lists' page in the WorldShare web interface.

  1. After a while, depending on your «connection delay» settings, you should see the record in Koha.

  • If you used import_mode: direct in your configuration file, the record will be available in the catalog.

  • If you used import_mode: staged in your configuration file, the record will be staged for import.

OCLC Connexion Client desktop software

See https://wiki.koha-community.org/wiki/OCLC_Connexion_Client for instructions on setting up and using the OCLC Connexion Client desktop software.

Talking Tech

Talking Tech i-tiva is a third party, proprietary, product that libraries can subscribe to. Learn more here: http://www.talkingtech.com/solutions/library.

Installation and setup instructions

Assicurarsi di aver eseguito installer/data/mysql/atomicupdate/Bug-4246-Talking-Tech-itiva-phone-notifications.pl per installare il pacchetto dati richiesto (nuova preferenza di sistema, preferenze sui segnaposto negli avvisi e sul protocollo di messaggistica)

To use, TalkingTechItivaPhoneNotification system preference must be turned on.

If you wish to process PREOVERDUE or RESERVES messages, you’ll need the EnhancedMessagingPreferences system preference turned on, and patrons to have filled in a preference for receiving these notices by phone.

Per i messaggi OVERDUE, i trigger per gli avvisi di scadenza devono essere configurati sotto Koha -> Tools -> Triggers per messaggi di ritardo/status. Si possono usare o trigger specifici per biblioteca, oppure quelli predefiniti; lo script selezionerà automaticamente i trigger appropriati.

Sending notices file

  1. Aggiungere lo script TalkingTech_itiva_outbound.pl alla lista delle esecuzioni pianificate

  2. Add an FTP/SFTP or other transport method to send the output file to the i-tiva server

  3. Se desiderato, archiviare i file di avviso in un’altra cartella dopo l’invio.

Eseguire TalkingTech_itiva_outbound.pl –help per maggiori informazioni

Receiving results file

  1. Aggiungere un’operazione FTP/SFTP alla lista delle operazioni pianificate, per ricevere il file Results in una cartella stabilita sul server di Koha

  2. Aggiungere lo script TalkingTech_itiva_inbound.pl <cron-receiving-notices-file-label> alla lista delle operazioni pianificate, impostato per lavorare su tale cartella

  3. Se desiderato, archiviare i file di risultati in un’altra cartella, dopo l’elaborazione

Eseguire TalkingTech_itiva_inbound.pl –help per maggiori informazioni