Name Last Update
dspace-source Loading commit data...
Readme.md Loading commit data...

Readme.md

How to install the Add-on

The detailed instructions can be found in the docs folder.

Copy the new files

Copy the new files to the source directory

If you are in Linux

cp -r $PATH_TO _ADDON/dspace-source/* $DSPACE_SRC/

Where $PATH_TO ADDON is the directory where you put the add-on for instalation and $DSPACESRC/ is the source directory.

As an example: If the addon is in the opt directory and dspace source is in /src-dspace/dspace32 the command is:

cp -r /opt/dspace-source/* /src-dspace/dspace32/

Change the dspace.cfg

Edit dspace.cfg in $DSPACE_SRC/dspace/config/dspace.cfg. Add the following values:

#---------------------------------------------------------------#
#-------------------DeGois CONFIGURATIONS-----------------------#
#---------------------------------------------------------------#
# These configs are used by DeGois Addon                        #
#---------------------------------------------------------------#

# To activate, or deactivate DeGois add-on, true will show DeGois step at submission time, 
# false will hide it from the final user.
degois.active = true
# To succefully configure DeGois add-on you will need to request the Repository ID, supllied 
# by DeGois project. Please contact degois@fct.mctes.pt
degois.repository.id = ##VAR##
# DeGois Base URL
degois.url = http://www.degois.pt/WSRCAAP/services/XMLRCAAP

# DeGois More Info
degois.info.url = http://projecto.rcaap.pt/index.php/lang-pt/como-gerir-um-repositorio/integracao-com-degois
# blank (new window) self (same window) ...
degois.info.open = blank

# Default Values
degois.default.situation = Publicado
degois.default.dspace.title = Sem t\u00edtulo
degois.default.degois.title = Sem t\u00edtulo
degois.default.publisher = Sem publicadora definida
degois.default.number = 1
degois.default.first.page = 1
degois.default.last.page = 10
degois.default.location = Sem local
degois.default.language = pt
degois.default.author = Sem autor
degois.default.journal.type = Jornal de not\u00edcias
degois.default.presentation.type = Comunica\u00e7\u00e3o

Note: The ##VAR## must be replace with the repository id in Degois

Adding the new entries in the Messages.properties and in Messages_pt_PT.properties

Add the fowlowing messages to Messages.properties: Edit $DSPACE_SRC/dspace/dspace-api/src/main/resources/Messages.properties and add:

jsp.submit.degois.title = Send bibliographic record to DeGóis
jsp.submit.degois.form.title = Fill in your data to access platform Curriculum DeGóis
jsp.submit.degois.heading = Send bibliographic record to DeGóis
jsp.submit.degois.username = Username
jsp.submit.degois.password = Password
jsp.submit.degois.area = Scientific domain
jsp.submit.degois.skip = Skip
jsp.submit.degois.error.title = An error has occurred during submission
jsp.submit.degois.error.heading = An error has occurred during submission
jsp.submit.degois.send.error.info = An error has occurred during submission of information to Degois. Please try again.
jsp.submit.degois.user.error.info = Invalid login.
jsp.submit.degois.retry.button = Retry
jsp.submit.degois.success = Record successfully submitted.
jsp.submit.degois.send.success = Record successfully submitted.
jsp.submit.degois.areas.naturalSciences = Natural Sciences
jsp.submit.degois.areas.technology = Engineering and Technology
jsp.submit.degois.areas.medicalSciences = Medical Sciences
jsp.submit.degois.areas.agriculturalSciences = Agricultural Sciences
jsp.submit.degois.areas.socialSciences = Social Sciences
jsp.submit.degois.areas.humanities = Humanities
jsp.submit.degois.areas.sciences = Exact Sciences
jsp.submit.progressbar.degois=DeGois
jsp.submit.degois.info.text=This feature allow users to send this deposit metadata to Degóis online curriculum.
jsp.submit.degois.info.label=More info...

Edit $DSPACE_SRC/dspace/dspace-api/src/main/resources/Messages_pt_PT.properties and add:

jsp.submit.degois.title = Enviar registo bibliográfico para o DeGóis?
jsp.submit.degois.form.title = Preencha com os seus dados de acesso à plataforma de Currículos DeGóis
jsp.submit.degois.heading = Enviar registo bibliográfico para o DeGóis?
jsp.submit.degois.username = Utilizador
jsp.submit.degois.password = Senha
jsp.submit.degois.area = Área científica
jsp.submit.degois.skip = Saltar
jsp.submit.degois.error.title = Erro na submissão de informação ao Degóis
jsp.submit.degois.error.heading = Erro na submissão de informação ao Degóis
jsp.submit.degois.send.error.info = Ocorreu um erro durante a submissão de informação ao Degóis. Por favor verifique que introduziu toda a informação necessária.
jsp.submit.degois.user.error.info = Utilizador ou senha inválida.
jsp.submit.degois.retry.button = Tentar de novo
jsp.submit.degois.success = Registo submetido com sucesso.
jsp.submit.degois.send.success = Registo submetido com sucesso. 
jsp.submit.degois.areas.naturalSciences = Ciências Naturais
jsp.submit.degois.areas.technology = Engenharia e Tecnologia
jsp.submit.degois.areas.medicalSciences = Ciências Médicas
jsp.submit.degois.areas.agriculturalSciences = Ciências Agrárias
jsp.submit.degois.areas.socialSciences = Ciências Sociais
jsp.submit.degois.areas.humanities = Humanidades
jsp.submit.degois.areas.sciences = Ciências Exatas
jsp.submit.progressbar.degois=DeGois
jsp.submit.degois.info.text=Esta funcionalidade permite-lhe enviar os dados do depósito em curso para o seu currículo DeGóis
jsp.submit.degois.info.label=Mais informação...

Create file degois.map if does not exist.

Create file degois.map in $DSPACE_SRC/dspace/config/degois.map

vi $DSPACE_SRC/dspace/config/degois.map

Add:

article = artigo-cientifico
bookPart = capitulo-de-livro-publicado
book = livro-publicado
bachelorThesis = outra-producao-cientifica
masterThesis = outra-producao-cientifica
doctoralThesis = outra-producao-cientifica
contributionToPeriodical = texto-em-jornal-ou-revista
other = outra-producao-cientifica
review = outra-producao-cientifica
conferenceObject = apresentacao-oral-de-trabalho
workingPaper = outra-producao-cientifica
annotation = outra-producao-cientifica
report = relatorio-de-investigacao
lecture = outra-producao-cientifica
preprint = outra-producao-cientifica

Create file degois-metadata.xml in $DSPACE_SRC/dspace/config/registries/degois-metadata.xml if does not exist.

vi $DSPACE_SRC/dspace/config/registries/degois-metadata.xml

Add the following entries:

<?xml version="1.0"?>
<dspace-dc-types>

  <dspace-header>
    <title>Metadata Types Registry for DeGois</title>
    <contributor.author>KEEP Solutions</contributor.author>
    <date.created>2010-08-11</date.created>
    <description>
        This file contains bibliographic metadata explicitly required by the
        DeGois interface for DSpace
    </description>
  </dspace-header>

  <dc-schema>
          <name>degois</name>
          <namespace>http://www.degois.pt/rcaap</namespace>
  </dc-schema>

  <dc-type>
    <schema>degois</schema>
    <element>publication</element>
    <qualifier>firstPage</qualifier>
       <scope_note></scope_note>
  </dc-type>
  <dc-type>
    <schema>degois</schema>
    <element>publication</element>
    <qualifier>lastPage</qualifier>
       <scope_note></scope_note>
  </dc-type>
  <dc-type>
    <schema>degois</schema>
    <element>publication</element>
    <qualifier>issue</qualifier>
       <scope_note></scope_note>
  </dc-type>
  <dc-type>
    <schema>degois</schema>
    <element>publication</element>
    <qualifier>location</qualifier>
       <scope_note></scope_note>
  </dc-type>
  <dc-type>
    <schema>degois</schema>
    <element>publication</element>
    <qualifier>title</qualifier>
       <scope_note></scope_note>
  </dc-type>
  <dc-type>
    <schema>degois</schema>
        <element>publication</element>
        <qualifier>volume</qualifier>
       <scope_note></scope_note>
  </dc-type>
</dspace-dc-types>

Edit input-forms.xml

Edit $DSPACE_SRC/dspace/config/input-forms.xml Add after <page number="2">::

 <field>
         <dc-schema>degois</dc-schema>
         <dc-element>publication</dc-element>
         <dc-qualifier>issue</dc-qualifier>
         <repeatable>false</repeatable>
         <label>Número da Edição</label><label>Primeira Página</label>
         <input-type>onebox</input-type>
         <hint>Se o registo tiver um número de edição associado.</hint>
         <required></required>
       </field>
     <field>
     <dc-schema>degois</dc-schema>
         <dc-element>publication</dc-element>
         <dc-qualifier>firstPage</dc-qualifier>
         <repeatable>false</repeatable>
         <label>Primeira Página</label>
         <input-type>onebox</input-type>
         <hint>No caso de artigos em revista, capítulos de livro, etc...</hint>
         <required></required>
       </field>
       <field>
         <dc-schema>degois</dc-schema>
         <dc-element>publication</dc-element>
         <dc-qualifier>lastPage</dc-qualifier>
         <repeatable>false</repeatable>
         <label>Última Página</label>
         <input-type>onebox</input-type>
         <hint>No caso de artigos em revista, capítulos de livro, etc...</hint>
         <required></required>
       </field>
       <field>
         <dc-schema>degois</dc-schema>
         <dc-element>publication</dc-element>
         <dc-qualifier>title</dc-qualifier>
         <repeatable>false</repeatable>
         <label>Título da Revista, Periódico, Monografia ou Evento</label>
         <input-type>onebox</input-type>
         <hint></hint>
       </field>
       <field>
         <dc-schema>degois</dc-schema>
         <dc-element>publication</dc-element>
         <dc-qualifier>location</dc-qualifier>
         <repeatable>false</repeatable>
         <label>Local de Edição ou do Evento</label>
         <input-type>onebox</input-type>
         <hint></hint>
       </field>
       <field>
         <dc-schema>degois</dc-schema>
         <dc-element>publication</dc-element>
         <dc-qualifier>volume</dc-qualifier>
         <repeatable>false</repeatable>
         <label>Volume</label>
         <input-type>onebox</input-type>
         <hint></hint>
   </field>

Edit item-submission.xml

Edit $DSPACE_SRC/dspace/config/item-submission.xml Add before </submission-process>:

<!-- Step: DeGois -->
<step>
    <heading>submit.progressbar.degois</heading>
    <processing-class>org.dspace.submit.step.DeGoisStep</processing-class>
    <jspui-binding>org.dspace.app.webui.submit.step.JSPDeGoisStep</jspui-binding> 
    <workflow-editable>false</workflow-editable>
</step>

Edit log4j

Edit $DSPACE_SRC/dspace/config/log4j.properties Add the following entries

###########################################################################
# A4 is the name of the appender for DeGois
###########################################################################
# Set these to DEBUG to see extra detailed logging.
log4j.logger.pt.keep.degois.xml=INFO, A4
# The name of the file appender
log4j.appender.A4=org.dspace.app.util.DailyFileAppender
# The filename of the log file created. A date stamp is appended to this
log4j.appender.A4.File=${log.dir}/degois.log
# Set this to yyyy-MM-DD for daily log files, or yyyy-MM for monthly files
log4j.appender.A4.DatePattern=yyyy-MM-dd
# The number of log files to keep, or 0 to keep them all
log4j.appender.A4.MaxLogs=0
# A2 uses PatternLayout.
log4j.appender.A4.layout=org.apache.log4j.PatternLayout
log4j.appender.A4.layout.ConversionPattern=%m%n

Change build.xml

Edit $DSPACE_SRC/dspace/src/main/config/build.xml

After <arg line="-f '${dspace.dir}/config/registries/sword-metadata.xml'" /></java> add:

<!-- import the DeGois required metadata -->
    <java classname="org.dspace.administer.MetadataImporter" classpathref="class.path" fork="yes" failonerror="yes">
    <sysproperty key="log4j.configuration" value="file:config/log4j-console.properties" />
    <sysproperty key="dspace.log.init.disable" value="true" />
    <sysproperty key="dspace.configuration" value="${config}" />
    <arg line="-f '${dspace.dir}/config/registries/degois-metadata.xml'" />
   </java>

Change pom.xml of dspace-api

Edit $DSPACE_SRC/dspace-api/pom.xml

Before postgresql add:

<!-- DEGOIS -->
    <dependency>
        <groupId>rcaap</groupId>
        <artifactId>degois</artifactId>
        <version>3.0</version>
    </dependency>
    <dependency>
        <groupId>axis</groupId>
        <artifactId>axis</artifactId>
        <version>1.2-RC2</version>
    </dependency>
    <dependency>
        <groupId>axis</groupId>
        <artifactId>axis-jaxrpc</artifactId>
        <version>1.2-RC2</version>
    </dependency>
    <dependency>
        <groupId>axis</groupId>
        <artifactId>axis-wsdl4j</artifactId>
        <version>1.2-RC2</version>
    </dependency>
    <dependency>
        <groupId>axis</groupId>
        <artifactId>axis-saaj</artifactId>
        <version>1.2-RC2</version>
    </dependency>
    <dependency>
        <groupId>javax.xml.bind</groupId>
        <artifactId>jaxb-api</artifactId>
        <version>2.1</version>
</dependency>

Change pom.xml of dspace

Edit $DSPACE_SRC/pom.xml

Add before </repositories>:

<repository>
  <id>KEEP Artifacts</id>
  <name>KEEP Artifacts-releases</name>     
  <url>http://artifactory.keep.pt/keep</url>
    </repository>

Change web.xml

Edit $DSPACE_SRC/dspace-jspui/src/main/webapp/WEB-INF/web.xml

Add after <!-- Servlets -->:

<servlet>
    <servlet-name>item-handle</servlet-name>
    <servlet-class>org.dspace.app.webui.servlet.ItemHandleServlet</servlet-class>
</servlet>

And after <!-- Servlets -->: item-handle /item-handle/*

Build DSpace

Proceed according to DSpace Documentation to build and update your DSpace installation.

Developers

The Sharing Bar Add-on was developed in the context of RCAAP ProjectRCAAP by KEEP SOLUTIONS, a spin-off of the University of Minho, specialized in digital preservation and advanced solutions for digital archives and libraries, in partnership with the Documentation Services of the University of Minho.

Need help, or give any type of contribution?

Please contact us at FCT|FCCN or any commiter.

License

Please contact us at FCT|FCCN.