Email - BiblioTECH Library System

Go to content

Main menu:

Email

Support > Tech Notes (for IT)

Patron Email Addresses
In order to be able to send an email to a Patron, that patron's record must include their email address. These can be populated manually or via an import
NB   Contact BiblioTECH Support if you are unsure of how to perform an email address import
NB   When generating “Letter” reports, you have the option of either producing Patron or Guardian variants. If you select a Guardian report, the email address used will be the Patron’s "guardian email". Therefore, if you intend to use that option, each Patron’s guardian email address field will also need to be populated.


Email Types
BiblioTECH uses two separate methods to send email messages.

“Direct” email
This uses the "default email client‟ established on the local client computer.
(ie MS-Outlook)
NB This method cannot be used with web-based email systems

In the Circulation module, once a patron has been selected, you can click on the [Email] button.
BiblioTECH will ...

  • check that the patron has an email address entered (if not, it will advise it cannot send the message)

  • tell the default email client to create a new message, and will populate that message with relevant info

  • the message will then be displayed so you can update as required then send it


NB As the email client does the actual sending of the message, the message's “From” address will be the email address entered into the email client.

Configuration and Testing
NB   If possible, create and use a generic “library@yourdomain” email address rather than a specific person as this will ensure that if the librarian changes, the messages being sent (and any replies) will be consistently handled.

On the machine running Circulation, setup and test the local email client
(ie MS-Outlook).

Once you know that email messages can be sent from the computer, open the Circulation module and send a test email to one of the patrons.

“Indirect” email

All other email messages sent by BiblioTECH are forwarded by the BiblioTECH server via its SMTP Gateway service.

  • The BiblioTECH SMTP Gateway service is a Server Add-On which is installed as part of the 'core' server install.
    Initially, the service is set at Manual startup. Once configured, this will need to be changed to Auto start.

  • If this service is started and the settings are invalid, it will automatically stop.


How it works ....
Whenever an email message needs to be sent (either from a “Letter” report or from an automated system), it is queued on the BiblioTECH server.
That is, a 'message' file is saved into the BiblioTECH server's Email folder.

Periodically, the SMTP Gateway service will process messages from the queue.

  • The Email folder is checked to see if there are any messages to send

  • If any are found, the system will attempt to forward a 'batch' of messages
    Default Cycle : 10 messages every 3 minutes
    This is to ensure ...
    - the SMTP Gateway in not seen as a SPAM source and blocked, and
    - the BiblioTECH is not 'swamped' processing a large number of email requests


Basic Configuration and Testing
On the BiblioTECH server, you must configure the SMTP Gateway settings using the BiblioTECH SMTP Gateway Manager

  • The term 'local SMTP server' means the SMTP server used by your local clients to forward messages - it does not need to be physically on your local network.

  • You will need to ensure that any firewalls used by your network have rules which allow the BiblioTECH server to communicate with the target SMTP server.

SMTP Host

The IP address of your local SMTP server

SMTP Port

The port used by your local SMTP server

EHLO Response

If your local SMTP server implements an EHLO check, enter a response which would be acceptable to the SMTP server

(leave empty if EHLO not used by your SMTP Email server)

SMTP UserID
SMTP Password

If your local SMTP server requires a login, enter a valid UserID & Password

(leave empty if the SMTP Email server does not require login)

Folder to Monitor

Select the folder used to store the queued email messages(refer to BiblioTECH Support if you need to change this from the default)

From email address

Enter a valid email address which will be used as the sending "From" address on all messages

Minutes between checks

The cycle time between checking of the email queue

Messages sent each check

This is the maximum number of messages sent each time the SMTP Gateway checks the email queue

Test To Address

The destination email address used when you click on the [Test] button

After the changes have been made, click on the [Save] button. The settings will be saved and the SMTP Gatway service restarted.

Testing the SMTP Gateway ...

Basic Communications

  • Open Windows Explorer to the email queue folder


  • Open the BiblioTECH SMTP Gateway Manager and click on the [Test] button<br>A TMP file should appear in the above folder<br>


  • The next time the SMTP Gateway checks the folder it will see the file and attempt to send it<br>If it successfully passes the message on to the SMTP server, the TMP file will disappear<br>If it could NOT pass the message on to the SMTP server, the file extension will change to BAD<br>If after a time greater than the "Check Cycle Time", nothing happens, check the SMTP Gateway settings and click on the [Save] button.<br>


“Reports” Configuration and Testing

On the server, open Windows Explorer to the email queue folder<br>

In Circulation ...

  • locate a patron who has overdue resources.<br>


In Patron Manager ...

  • Create a new group named TEST.<br>


  • Locate the above patron (note the entered email address and group so these can be restored later)<br>

  • Re-assign them into the TEST group<br>


  • Change their email address so that you will receive any messages<br>

  • Save the record


In Reports Manager ...

  • Run the report “Letters – Overdue First


  • Select the TEST group<br>


>> Monitor the server's queue folder ....<br>

  • Select Print and choose “Email”<br>


  • Verify that a TMP message file does appear in the server's queue folder and then, after a short while, disappears.<br>

  • Verify that the overdue message does come through<br>If all OK, use Patron Manager to reset the patron‟s Group and Email Address entries.


“Auto-Overdue” Configuration and Testing
NB   Only enable this is it is specifically required<br>

NB   This feature can generate a large number of email messages so you should check that the SMTP Gateway is configured and operating correctly prior to enabling auto-send.<br>

When enabled, the BiblioTECH server will check every day at a set time for all resources still on loan and where the Due date

  • is in 3 days time (warning messages)

  • was yesterday (now overdue messages)

  • was 3 days ago (reminder messages)


If any are found and the borrower has an email and is enabled for Auto-Overdue notices, the server will automatically send the relevant email message to the patron.

On the server ...<br>

  • Open Windows Explorer to the folder selected as the folder to hold the email queue.<br>


In Circulation ...<br>

  • Locate someone who has an overdue resource which is due “today”.<br>


In Patron Manager ...<br>

  • Locate the above patron (note the entered email address)<br>

  • Change their email address so that you will receive it<br>

  • Tick the box to enable Auto-Sending of Overdue Alerts<br>


In System Utilities<br>

  • Select the General – Email Handling page<br>

  • Ensure the Enable option is ticked and set the time to 6:30 am<br>


>>> Wait till “tomorrow” …

  • Check your email, you should have received an “overdue alert” email.<br><br>If all OK ...

Use Patron Manager to reset the patron‟s Email Address entry.<br>Enable any relevant patrons for receiving of Auto-Overdue alert messages.


# Repeat the above for someone with a resource Due in 3 days time and another with a resource that was due 3 days ago.

Daily Log
The BiblioTECH SMTP Gateway maintains a log of the actions it has taken.<br><br>
This Log will be forwarded to the librarian each day
(ie is sent to the configured “From” address).<br>
The librarian should expect to receive this log each day. Failure to receive the Log is an indication that the email system is not functioning correctly and needs attention

Back to content | Back to main menu