The Library Cards Renewal Edition Page
This screen is used to create, view, update and delete Validity period /
Renewal records, a metadata of the Library Card object. This data
keeps track of the validity of your Library Card each time you renew it.
During initial creation, of the card, a first Validity period / renewal
is created and linked, based on the information provided on that screen.
Validity period / renewal records will then be used, if the user
checked the appropriate flag on the Library Cards Edition Page, to warn him each time the
expiration date for his/her cards approaches. These reminders are
handled through a helper script (see Helper Scripts).
The Renewals management screens are not available straight from
the Main Application Menu, but can be reached only from the Library Cards Edition Page. To reach the
Edition Page of an existing Validity period / Renewal, you can:
- Start from the Libraries List:
- Start from the Users Edition Page (open on the user to whom the card belongs, of
course):
- From the Main Application Menu (or indeed almost any other Project Hirtius page),
click on the "Manage Users" (
) icon
in the header.
- Browse the Users List until you locate the owner of the library card
that you're looking for.
- Mark him/her in the list (radio button in the first column), select
Edit Selected User in the drop-down menu in the bottom left corner,
then click Submit. This leads you to the Users Edition Page.
- On the Users Edition Page, click on the Library Cards link located
in the bottom left corner. This gets you to the Library Cards List.
- Browse the Library Cards List until you locate the library card that you're
looking for.
- Then click on the card ID (first column). This gets you to the Library Cards Edition Page
in 'view' mode.
- Scroll down the Library Cards Edition Page until you reach the Validity periods /
Renewals section, then locate the renewal that you're looking for.
- Click on the renewal ID (first column). This gets you to the Library Card Renewal Edition Page
in 'view' mode.
To add a new Validity period / Renewal record:
- First reach the Library Cards Edition Page for the appropriate Library Card as
indicated above.
- Scroll down the Library Cards Edition Page until you reach the Validity periods /
Renewals section.
- Click the Add action link in the bottom-right corner
of the list.
The Validity period / Renewal Edition Page supports the following
actions:
- Add: the form to fill in and submit in order to create a new
Validity period / Renewal record.
- Insert: creating the new Validity period / Renewal record in the
database (post Add action).
- Edit: modifying an existing Validity period / Renewal record through a
form populated based on the current database contents.
- Update: storing the modified data in the database, updating
the appropriate Validity period / Renewal record (post Edit action).
- View: display the current database contents for the selected
Validity period / Renewal record. No form in this case.
- DelCon: first step when requesting the deletion of a record --
issues a prompt for confirmation.
- Del: the actual removal of the selected record (as well as
all linked metadata records) from the database (post DelCon
action).
That action will be recorded: a new entry will be added to the Event
Log.
Of these, only Add, Edit, View
and DelCon are entry points. They are typically reached from the
Library Cards Edition Page.
Here below are the fields that you can expect to find on the Validity period
/ Renewal Edition Page. The goal here is not to simply duplicate the database
layout information. If this is what interests you, please refer to the Database Layout,
the database creation script or the database itself. The purpose is rather to
explain what each field is meant for [D], what format it is expected to
follow [F] and what are the conditions for its validity (if applicable)
[V].
A star (*) after the name of the field denotes a mandatory field (the
star is shown in red with the same meaning in the application user
interface).
| Object ID |
D |
Sequential ID, automatically assigned by the DB during record
creation. Displayed read-only once available. This is in fact the ID of the
Card (an a link back to the Library Cards Edition Page), not that of the
Renewal. |
| Library |
D |
The library that issued the card. This field is shown read-only. |
| Card reference |
D |
The unique ID of the card, as issued by the Library. May be reprensented
as a bar code. This field is shown read-only. |
| Validity start |
D |
Start of the initial or renewed validity period for this card. |
| F |
ISO format: year in 4 digits, then month in 2 digits (padded with zero
if needed), then day in 2 digits (padded with zero as needed). The date
parts can be separated with either '-' (hyphen), '/' (forward slash), or
'.' (dot). Defaults to today's date in "Add" mode.
Example: "2012-10-31", "2012/10/31" or "2012.10.31". |
| Validity end |
D |
End of the initial or renewed validity period for this card. Put it
hundreds of years in the future if the card doesn't expire (but then, there
is little point in tracking it in Project Hirtius to start
with). |
| F |
ISO format: year in 4 digits, then month in 2 digits (padded with zero
if needed), then day in 2 digits (padded with zero as needed). The date
parts can be separated with either '-' (hyphen), '/' (forward slash), or
'.' (dot).
Example: "2012-10-31", "2012/10/31" or "2012.10.31". |
| Fee |
D |
Cost of the initial subscription or
of the subsequent renewals. Use this field to track how much your patronage
is worth to the Library, or how much these charges evolved over time.
Entirely optional. |
| F |
Decimal number. |
| V |
Contents is expected to be numeric. For decimal values, either dot ('.')
or comma (',') are accepted as decimal separator. The value should be
positive or null. |
| Currency |
D |
Currency for the fee. For information only -- no further processing is
done on this field. You can use either the currency symbol (e.g. €) or
the three-letter acronym (e.g. "EUR"). If a fee value is specified and that
value is not null, then a currency should be specified. |
| F |
Free text. |
| Comment |
D |
Any comment you might have on the renewal itself. Only provided for
user convenience. |
| F |
Free text. HTML markup allowed. |
- Card link
- The ID field in the top left corner offers a link back to the
Card record this Renewal is attached to. This link will open
the Library Cards Edition Page in 'view' mode.
- Switch to edit mode link
- Located at the bottom of the page, just above the footer. Click on this
link to edit the current object (switches the view from a R/O
rendering of the contents to an HTML form that allows you to modify that
contents and submit it afterward).
- Card link
- The ID field in the top left corner offers a link back to the
Card record this Renewal is attached to. This link will open
the Library Cards Edition Page in 'view' mode.
- Submit button
- (Also in "Add" mode). Commits the locally
modified HTML form fields contents to the database that stores
Project Hirtius data. Use it to save your latest modifications.
- Reset button
- (Also in "Add" mode). Cancels any un-committed
change, and returns all HTML form fields to their initial value (i.e. the
one they had when the page was last loaded in the browser). Use this button
to revert any erroneous edit you might have done (Beware:
this only works on local changes that have not been saved to the
database yet, i.e. for which you've not clicked on Submit yet).
- Switch to view mode link
- Located at the bottom of the page, just above the footer. Click on this
link to view the current object (switches from the current HTML form that
allows you to modify the object contents and submit it afterward to a R/O
rendering of that contents).
This result page appears once you have clicked the Submit
button on the Add or Edit page. It will offer the
following links:
- Library cards list link
- Returns you to the Library Cards List.
- Back to card edition screen link
- Returns you to the current Library Card record in edit mode. Use
this link to further edit the card in question.
See also:
Project Hirtius, © Les Ateliers du Héron, 2012.
Last updated: Friday, Oct. 21, 2022.
) or
"Manage Books" (
) icon in the header.