Difference between revisions of "Library Usage Instructions"

From Knoesis wiki
Jump to: navigation, search
(Other Important Information About Library Code)
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
==Add a Resource to the Library==
 
==Add a Resource to the Library==
* Link to add a resource - http://knoesis.wright.edu/lib-manager/  (This interface requires a login. Please contact [mailto:web-support@knoesis.org Kno.e.sis Web Support] in case you do not have a login/have lost your login)
+
* Link to log in to Drupal account - http://knoesis.org/user (This interface requires a login. Please contact [mailto:austin@knoesis.org Kno.e.sis Help Desk] in case you do not have a login/have lost your login)
* Once Logged in, you would see following 4 options -
+
* Once Logged in, go to "Content" tab, select "Add content", then select "Library"
** Publication Resource - To enter any kind of publications (Conference Paper, workshop paper etc)
+
* You have two options to add your library:
** Person Resource - To enter information about a person to the RDF store
+
** Either use one of these four options to auto-populate your new library entry:
** Other Resource - To add a Demo,Dataset, Service Resource
+
*** PubMed Lookup - enter a PubMed ID and click "Populate using PubMed"
** Add Project - Add a project name and its URL (This will automatically get added to the selectable list of projects/ Add a project
+
*** Paste RIS Record - Paste RIS Record of your library in the text field and click "populate using RES record"
* Please read the instructions on each of the forms carefully before adding your resource
+
*** Paste BibTex Record- Paste BibTex Record of your library in the text field and click "populate using BibTex"
* Whenever you see an ADD button next to a input field please make sure you enter your data and PRESS ADD. Now you should see the item below. You can now add another item to the same box.
+
*** DOI Lookup - Enter a DOI name in the given format and populate the entry. NOTE: You need to register with CrossRef and then enter your CrossRef UserID in your profile before using DOI Lookup.
* You should see a message on submitting the form which would say “Publication added successfully!!”.
+
** Or select one of the publication type from the drop-down menu available below "Next" button and enter the library details manually. Please verify your library details before publishing.
 +
 
 +
* You can upload any external file you need to attach with the library entry in the "Related Files" section.
 +
 +
* Please read the instructions on each of the forms carefully before adding your resource.
 +
 
 +
* You can click on "save" button available on the bottom of the page to save and publish your library.
  
 
==Edit a Resource in the Library==
 
==Edit a Resource in the Library==
 
* In order to change some information in a resource you would have to use the edit interface.
 
* In order to change some information in a resource you would have to use the edit interface.
* Start with a resource in the library. As an example http://knoesis.wright.edu/library/resource.php?id=780
+
* First, log in to your Drupal account - http://knoesis.org/user
* Now click on the link “Edit this page”. You would see 2 buttons
+
* Then click on the "Content" tab
** Edit_Entry
+
* Search for the publication that you want to edit and you have two options under the "Operations" column:
*** Login is required for this functionality
+
** Edit
 
*** Will show all the information for this resource to be edited
 
*** Will show all the information for this resource to be edited
 
*** You should see a message on submitting the form which would say “Publication edited successfully!!"
 
*** You should see a message on submitting the form which would say “Publication edited successfully!!"
** Delete_Entry
+
** Delete
*** Login is required for this functionality
+
 
*** Will delete all the triples from the RDF store for this resource
 
*** Will delete all the triples from the RDF store for this resource
 
*** You should see a message on submitting the form which would say “Publication deleted successfully!!”
 
*** You should see a message on submitting the form which would say “Publication deleted successfully!!”
 
==Important Note==
 
==Important Note==
* '''For all the forms after submission please click the link “Jump Reload To Library” in order to see the changes in the front end at http://knoesis.wright.edu/library'''
 
 
* '''It might happen that your browser might cache the page http://knoesis.wright.edu/library  and hence you would not see the new resource added. It is better to use the a different browser in such a case.'''
 
* '''It might happen that your browser might cache the page http://knoesis.wright.edu/library  and hence you would not see the new resource added. It is better to use the a different browser in such a case.'''
==Other Important Information About Library Code==
 
 
*So here are some high level steps
 
*We used forms for adding data/records to the database. The forms were built using JSP. On submit data was converted to RDF using JENA and was written to the database (I think we were using RDF Sesame version 2.4.1).
 
 
*The main page (Simile exhibit) requires the data to be in Exhibit JSON format. In order to convert RDF data (stored in the database), we used simile babel service (http://service.simile-widgets.org/babel/)
 
 
*The problem with Simile exhibit is that it loads all the data in the JSON at once. This overloads some browsers like Internet explorer. In order to over come this issue Ajith wrote some scripts that would create JSON - smaller chunks of data (i think by reading the big JSON converted using babel).
 
 
*The other pages (individual records E.g - http://knoesis.org/library/resource.php?id=1690) are PHP pages, that get all their content from the JSON itself.
 

Latest revision as of 15:40, 12 July 2017

Add a Resource to the Library

  • Link to log in to Drupal account - http://knoesis.org/user (This interface requires a login. Please contact Kno.e.sis Help Desk in case you do not have a login/have lost your login)
  • Once Logged in, go to "Content" tab, select "Add content", then select "Library"
  • You have two options to add your library:
    • Either use one of these four options to auto-populate your new library entry:
      • PubMed Lookup - enter a PubMed ID and click "Populate using PubMed"
      • Paste RIS Record - Paste RIS Record of your library in the text field and click "populate using RES record"
      • Paste BibTex Record- Paste BibTex Record of your library in the text field and click "populate using BibTex"
      • DOI Lookup - Enter a DOI name in the given format and populate the entry. NOTE: You need to register with CrossRef and then enter your CrossRef UserID in your profile before using DOI Lookup.
    • Or select one of the publication type from the drop-down menu available below "Next" button and enter the library details manually. Please verify your library details before publishing.
  • You can upload any external file you need to attach with the library entry in the "Related Files" section.
  • Please read the instructions on each of the forms carefully before adding your resource.
  • You can click on "save" button available on the bottom of the page to save and publish your library.

Edit a Resource in the Library

  • In order to change some information in a resource you would have to use the edit interface.
  • First, log in to your Drupal account - http://knoesis.org/user
  • Then click on the "Content" tab
  • Search for the publication that you want to edit and you have two options under the "Operations" column:
    • Edit
      • Will show all the information for this resource to be edited
      • You should see a message on submitting the form which would say “Publication edited successfully!!"
    • Delete
      • Will delete all the triples from the RDF store for this resource
      • You should see a message on submitting the form which would say “Publication deleted successfully!!”

Important Note

  • It might happen that your browser might cache the page http://knoesis.wright.edu/library and hence you would not see the new resource added. It is better to use the a different browser in such a case.