Versions Compared

Key

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

...

  1. Enable the Discovery Aspects in the XMLUI by changing the following settings in xmlui.xconf
    Code Block
    XML
    XML
    <xmlui>
        <aspects>
            <aspect name="Artifact Browser" path="resource://aspects/ArtifactBrowser/" />
            <aspect name="Administration" path="resource://aspects/Administrative/" />
            <aspect name="E-Person" path="resource://aspects/EPerson/" />
            <aspect name="Submission and Workflow" path="resource://aspects/Submission/" />
    	<aspect name="Statistics" path="resource://aspects/Statistics/" />
    
            <!--
                To enable Discovery, uncomment this Aspect that will enable it
                within your existing XMLUI
                <aspect name="Discovery" path="resource://aspects/Discovery/" />
            -->
    
            <!--
                This aspect tests the various possible DRI features,
                it helps a theme developer create themes
            -->
            <!-- <aspect name="XML Tests" path="resource://aspects/XMLTest/"/> -->
        </aspects>
    
  2. Enable the Discovery Indexing Consumer that will update Discovery Indexes on changes to content in XMLUI, JSPUI, SWORD, and LNI.
  3. Code Block
    #### Event System Configuration ####
    
    # default synchronous dispatcher (same behavior as traditional DSpace)
    event.dispatcher.default.class = org.dspace.event.BasicDispatcher
    event.dispatcher.default.consumers = search, browse, eperson, harvester
    
    # comment out above and uncomment below to enable discovery indexing
    # event.dispatcher.default.consumers = search, browse, discovery, eperson, harvester
    
  4. Reindex you DSpace instance into Discovery by executing the commandline reindex using the discovery IndexClient class
    Code Block
    ./dspace dsrun org.dspace.discovery.IndexClient
    

Instructions for Configuring Discovery

Discovery can be configured at multiple levels of the application. Outlined below will be where in Discovery changes can be made that will alter the presentation. The primary place that the user experience is altered in XMLUi is through the dspace-solr-search.cfg file

Configuring Facets that are Exposed for Search Results

Code Block

##### Search Indexing #####
solr.search.server = http://localhost:8080/solr/search

# Should no solr facet be configured for a certain page, this one will be used as default
#Every solr facet field which ends with :date will be handled as a date
#Handeling as date implies that {field.name}.year will be used for faceting
solr.facets.search.1=dc.contributor.author_lc,dc.subject_lc,dateissued:date
solr.facets.community=dc.contributor.author_lc,dc.subject_lc,dateissued:date
solr.facets.collection=dc.contributor.author_lc,dc.subject_lc,dateissued:date

# solr.facets.item=dc.contributor.author,dc.subject,dc.date.issued_dt
# solr.facets.site=dc.contributor.author,dc.subject,dc.date.issued_dt

# Makes sure that we have a gap from 6 years for our date fields (past 5 & the current)
solr.date.gap=5
solr.date.skip.empty = true

# Put any default search filters here, these filters will be applied to any search in discovery
# You can specify multiple filters by separating them using ;
#solr.default.filter=location:l2
# You can also specify (additional) filter(s)
## for homepage recent submissions
#solr.site.default.filter=
## for community recent submissions
#solr.community.default.filter=
## for collection recent submissions
#solr.collection.default.filter=
## for searches
#solr.search.default.filter=
## for browsing
#solr.browse.default.filter=


# The filters which can be selected in the search form
solr.search.filter.type.1=dc.title.split
solr.search.filter.type.2=dc.contributor.author.split
solr.search.filter.type.3=dc.subject.split
solr.search.filter.type.4=dateissued.year

Advanced Configuration in Solr

Solr itself now runs two cores.  One for collection DSpace Solr based "statistics", the other for Discovery Solr based "search"

Code Block

solr
├── search
│   ├── conf
│   │   ├── admin-extra.html
│   │   ├── elevate.xml
│   │   ├── protwords.txt
│   │   ├── schema.xml
│   │   ├── scripts.conf
│   │   ├── solrconfig.xml
│   │   ├── spellings.txt
│   │   ├── stopwords.txt
│   │   ├── synonyms.txt
│   │   └── xslt
│   │       ├── DRI.xsl
│   │       ├── example.xsl
│   │       ├── example_atom.xsl
│   │       ├── example_rss.xsl
│   │       └── luke.xsl
│   └── conf2
├── solr.xml
└── statistics
    └── conf
        ├── admin-extra.html
        ├── elevate.xml
        ├── protwords.txt
        ├── schema.xml
        ├── scripts.conf
        ├── solrconfig.xml
        ├── spellings.txt
        ├── stopwords.txt
        ├── synonyms.txt
        └── xslt
            ├── example.xsl
            ├── example_atom.xsl
            ├── example_rss.xsl
            └── luke.xsl

Design Premis for Discovery

...