Skip to content

Public demo help

iGor milhit edited this page Sep 2, 2020 · 21 revisions

⚠️ Not up to date. Try instead https://ils.test.rero.ch/help/

~~This page explains how to use the public demo site of RERO ILS, which runs the last released version of RERO ILS.

This help isn't very detailed and isn't translated. But feel free to reach us on gitter or on twitter to ask anything!

Data persistence

⚠️ ils.test.rero.ch is a demo site, therefore the data created or modified by any users is not meant to persist. The data will be refreshed at the deployment of every new version.

Search

By default, the search retrieves documents — i.e. books or other document types, and their items — and person authorities that match the typed keywords.

As you type a query into a search input field, an autocompletion mechanism provides suggestions, either for document titles or for persons authorities that matches the query. As you select one of these, a new query is ready to be sent to the system.

You can have a look at how these data are structured by exporting the JSON of a document. Find a document which is not an ebook and which has some items. At the bottom of this document's page, you will find a link to export the complete data of the documents in JSON format (web embedded).

Observing this data, you should be able to type advanced requests in the search input, using the Elasticsearch simple query string syntax.

Consortium

RERO ILS will support many consortium features. Several organisations (networks) will share the same software base, the same RERO ILS instance. For now, the public demo website has two organisations:

  1. Réseau des bibliothèques du Canton d'Aoste
  2. Libraries of the British Ministry of Magic

Each organisation has one or many libraries, which have one or many locations.

Views

There's three different views, one for each organisation, with it's own content, and a global view, which is an union catalog. Depending on the visited view, the home page provides link to the other views.

Sign up and Log in

User and patron accounts

User accounts

You can create yourself an account, using the Sign Up button in the My account menu. All you need is a valid email and a password. You have to confirm your email. For now, the user account has no other right than the ability to log in.

The librarian, through the Resources > Users menu, can also create a new user, which can be a patron or a librarian. The system librarian is able to create a new user with the system librarian role.

Patron accounts

There are several patron accounts already registered. You can log in through any of them using their email address and the 123456 password. You can use available accounts such as:

  • reroilstest+simonetta@gmail.com (organisation 1)
  • reroilstest+helder@gmail.com (organisation 1)
  • reroilstest+harry@gmail.com (organisation 2)

Notifications messages are sent to these emails, but for obvious reasons, the access to these email accounts is restricted to the development team.

These patrons already have borrowed and requested items. You can see them in the profile once you're connected with one of the patrons IDs.

Patrons can make requests on items, except for missing or already requested items by the same patron.

Librarian accounts

Four professional accounts exist and are ready for use, with two distinct roles: librarian and system librarian. Each one is attached to a library. You can log in through any of them using their email address and the 123456 password:

  • reroilstest@gmail.com (organisation 1, system librarian)
  • reroilstest+jean@gmail.com (organisation 1, librarian)
  • reroilstest+elena@gmail.com (organisation 1, librarian)
  • reroilstest+virgile@gmail.com (organisation 1, librarian)
  • reroilstest+irma@gmail.com (organisation 2, system librarian)

The librarians can manage, i.e. create, edit and delete:

  • documents (and items),
  • libraries and locations (this is the beginning of the consortium structure of reroils),
  • users,
  • item types, patron types, circulation policies.

The librarian can also perform circulation actions, such as check in and check out, extension and request validation.

All these features are available through the professional menu at the left of the header.

Documents

RERO ILS is populated with bibliographic records imported from the RERO catalog. The document types are the following:

  • article
  • book
  • ebook
  • journal
  • score
  • sound
  • video

Creating new documents

In addition to the ability of searching for documents and items, this view enables the librarian to create a new document. The create button is on the top of the documents result list. At this stage, the document editor is very simple, accordingly to the very simple metadata model used at the beginning of this project.

At the top of the editor, there's an input field with a blue import button. If a EAN-13 number that exists in the BNF catalog is entered into that field, clicking on the import button will populate the editor with existing data.

Once the form is completed, the submit button will add the new document to the index.

Editing and deleting documents

In order to edit, delete documents and to add items to it, use the Catalogue / Document menu, or display the detailed view of the document.

ebooks

The ebooks are a special document type. They are imported and synchronized regularly from external sources (Commercial platforms). Thus, it's not possible to edit or delete these records and no item are attached to them. A link is provided to enable the end user to borrow the ebook through the intended web service.

Libraries

This view displays the list of libraries existing in the demo instance. To simplify, all of them are attached to a unique organisation. Clicking on a given library lists all of the locations inside it.

This is a minimal consortium structure implemented yet.

Through this view, a librarian can create, edit, delete libraries and locations. The elements of this structure are linked together, so there are checks performed when the librarian decides to delete a record. Be it a library, a location, a document, an item or a patron, existing links or transactions will block the deletion.

Users

This view lists the existing users. The librarian can create, edit and delete users the same way as documents and libraries.

When creating a new user, or when editing an existing user, the librarians can check boxes in order to attributes roles to them. Some additional information is needed, depending on the role(s) attributed.

Patron types

Four patron types are available: standard, student, children1 and children2.

Item types

Four item types are available: standard, short, on-site and no-checkout.

Circulation

Circulation settings

To set circulation settings, use the Admin & monitoring menu and edit patron types, item types and circulation policies. The minimum required is to have a default circulation policy.

The design of the circulation interface has to be further explored; at this stage, this is only a proof of concept. The idea is to reduce drastically the need to use other input devices than a barcode scanner or a RFID reader in order to do most of the circulation actions.

The circulation interface is reachable through the User services / Circulation menu. It contains two tabs, the first for check in / check out and the second to manage pending requests.

Check in / check out

When the check in / check out view is loaded, the focus is by default in the input field: patron card or item barcode are ready to be scanned!

Basically, the librarian can use the input field either to enter a patron barcode or an item barcode. Then, the system tries to understand what is the default action to be proposed to the librarian, or to be done if it is crystal clear.

If a patron barcode is entered, the needed information of the patron is displayed. The focus stays on the input field, because most of the time, the librarian will then scan item barcode to borrow or return items. When all items have been processed, the librarian sees a list of items with the most probable action selected, that the librarian can modify if needed before validating.

If an item barcode is entered, it could be an item to be returned, a missing item that has been found or an item to be loaned to a patron, but the patron barcode is not given yet.

Some messages are displayed to the operator, for instance to alert that a given item has been requested by another patron (and thus cannot be loaned), or that an item is now in transit because it has to be returned in another library.

Pending requests

In case of an item requested for a patron, the librarian can switch to the tab that allows to manage pending requests. It displays requests on items that are available on shelf (only the first request per item). Once the librarian picked up the document on shelf, he can enter the item barcode and thus validate the request. An email is automatically send to the patron who made the request as soon as the item is available at desk.

Authorities

For the time, only person authorities from the catalogs of the BnF, GND and RERO are available for the librarian. These records from various catalogs are aligned automatically through the use of VIAF. This project launched by RERO is called MEF for Multilingual Entity File. Like for the other records, a brief and a detailed view is proposed for each person record. This last one highlights the potential of the project by providing two separates views of the person records, one displaying all sources in one frame with data tagged by source, the other displaying data separately by source. The prototype server under development by RERO will propose in the future records for persons, organisations, works, expressions, places, time spans and common names for reuse in integrated library systems (ILS). All information about the project can be found on the MEF page

All the existing documents have to physical persons records. When a new document is created, in the author field, when a person type is selected, you can search for a person through the name field. The search fetch all records that matches in the MEF index and displays suggestions.~~