Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Make

...

the

...

following

...

changes

...

in

...

OLE

...

to

...

enable

...

searching

...

of

...

external

...

datasources

...

with

...

Z39.50

...

protocol

Setting up external dependencies for jz3950 library for connecting to Z39.50

...

datasources.

...

  1. Get

...

  1. source

...

  1. code

...

  1. from

...

  1. https://jz3950.svn.sourceforge.net/svnroot/jz3950/trunk

...

  1. and

...

  1. build

...

  1. the

...

  1. jar file.

    Warning
    titleDependency Resolution
    While building if you encounter any dependency resolution issues, it would be most likely due to the fact that Kuali developers have a local maven settings.xml file that forces dependencies to be resolved from our internal Nexus repository. If you have it, uncomment the mirrors/servers section in the settings.xml and then re-run the build. It should get all the necessary plugins and dependent jar files down. Don't forget to un-comment the portions in the settings.xml after a successful build as it will be needed for regular Kuali development.
  2. Create maven dependency for the above created jar file using below command;

    Code Block
    mvn install:install-file -DgroupId=net.sf.jz3950 -DartifactId=jz3950 -Dversion=1.0-SNAPSHOT -Dfile=<path_to_your_jar_file> -Dpackaging=jar -DgeneratePom=true
    
    

...

You may do these two steps in this way:

Code Block
svn checkout https://svn.code.sf.net/p/jz3950/code/trunk/ jz3950
cd jz3950/
mvn clean install -DskipTests=true

 

Changes in ole-docstore-search

...

project

File pom.xml

...

Uncomment

...

the

...

following

...

lines.

...

Code Block
<!--
      <dependency>
          <groupId>net.sf.jz3950</groupId>
          <artifactId>jz3950</artifactId>
          <version>1.0-SNAPSHOT</version>
      </dependency>
      <dependency>
          <groupId>org.jzkit</groupId>
          <artifactId>a2j</artifactId>
          <version>2.0.4</version>
      </dependency>
-->

{code}

h3. Class Z3950DataSource

Uncomment the code in this class.

h2. Changes in ole-rice2 project


h3. Class ImportBibController

Uncomment the following line.

{code}
//List<String>

Class Z3950DataSource

Uncomment the code in this class  ( /* code */ ).

Changes in ole project

Class ImportBibController

Uncomment the following code.

Code Block
  /* try {
             results = externalDataSource.searchForBibs(searchParams, dataSourceConfig);
 {code}  h3. File ImportBibSearchPage.xml  Uncomment the commented} linecatch in the following snippet.

{code}
<bean id="search_button" parent="Uif-SecondaryActionButton-Small"(Exception e){
             LOG.error("Error occurred while fetching the records :ImportBibController"+e);
         p:methodToCall="search" p:actionLabel="Search"/>   GlobalVariables.getMessageMap().putError(KRADConstants.GLOBAL_ERRORS, OLEConstants.DATA_IMPORT_ERROR);   
         }
     */

File ImportBibSearchPage.xml

Uncomment the commented line in the following snippet.

Code Block
<!--p:methodToCall<ref bean="search" p:actionLabel="Search" p:refreshIdExternalSourceSearch-Buttons"/>-->
<!--<ref bean="ExternalSourceResults-Section"/>-->

{code}<!--<ref bean="externalNext-Button"/>-->

Creating an external data source:

Create an external data source. E.g.(  

 1)

z3950.loc.gov    
z3950.loc.gov
z3950.loc.gov  
7090
 VOYAGER
     
     Empty/Empty

 

2)

 

Abertay Dundee University-voyager    
Abertay Dundee University    
catalogue.abertay.ac.uk    
10790    
kuali/voyager    
     
     

 

 Note :  Domain Name, Port Number ,Database Name are mandatory . Format for Login Id/Database Name is kuali/voyager   .  If we are not mentioning with '/' it will consider as  Database Name .

For more info about external data sources, please refer to http://www.loc.gov/z3950/lcserver.html  , http://staff.library.mun.ca/staff/toolbox/z3950hosts.htm

Importing records from external source:

  • Navigate to Describe tab in OLE home page.

  • Click “Import Bib” link.

  • Select tab “Import from External Data Source”.

  • Select the source which you are created.

  • Enter the search criteria and click “Search” button.