1 SMS Messaging in Aleph 500 Version 20 and upYoel Kortick
2 SMS Messaging in Aleph 500. Yoel Kortick, 2010Introduction The information contained here may also partially be found in the “Aleph 20 Syslib Guide – Circulation”. SMS Messaging in Aleph Yoel Kortick, 2010
3 Cases where an SMS may be sentThere are three specific cases in which Aleph 500 may be configured to send SMS messages to library patrons: Patron hold request is fulfilled Overdue letter is sent to patron An item that is on loan to a patron is recalled In this presentation we will use an example with the recall functionality. SMS Messaging in Aleph Yoel Kortick, 2010
4 SMS Proxy configurationSending SMS messages depends on configuring and activating the SMS Server. The SMS Proxy documentation with information on the required configurations for the SMS Server may be found on the Doc Portal under: Cross Product Information > SMS Proxy SMS Messaging in Aleph Yoel Kortick, 2010
5 SMS Messaging in Aleph 500. Yoel Kortick, 2010Conditions Conditions by which the relevant printout will be sent by SMS The patron has a valid SMS number in his patron card. The SMS number may be input using the Address Information form of the Circulation GUI or using the Patron Registration and Address Information forms in the Web OPAC. The patron has agreed to receive SMS messages. The patron agreement is registered in the Global Patron Information and Patron Registration forms of the Circulation GUI, or in the Patron Registration and Address Information forms in the Web OPAC. The library has configured the form to trigger an SMS message (described further on here) SMS Messaging in Aleph Yoel Kortick, 2010
6 SMS Messaging in Aleph 500. Yoel Kortick, 2010SMS Configuration #1 The first step is to define the sms_server in the $alephe_root/aleph_start file. For example: setenv server_sms " :1894" SMS Messaging in Aleph Yoel Kortick, 2010
7 SMS Messaging in Aleph 500. Yoel Kortick, 2010SMS Configuration #2 The second step is to define the $data_tab/form_sms table in the ADM library. This table is used to set which forms will trigger SMS sending. The following forms may be sent via SMS: hold-request-letter-xx. The xx is the hold request send action loan-recall-x. The x is the recall letter type (1 or 2) overdue-letter-x. The x is the optional letter number overdue-summary-x . The x is the optional letter number overdue-sum-single-x. The x is the optional letter number SMS Messaging in Aleph Yoel Kortick, 2010
8 SMS Messaging in Aleph 500. Yoel Kortick, 2010SMS Configuration #2 $data_tab/form_sms table in the ADM library. The table includes the following columns: Column 1 – Name of the form Column 2 – The form number Column 3 – The SMS text number. This number must be aligned with the codes used in the $aleph_root/error_lng/sms_messages table, as described below. Column 4 – Whether or not the SMS message will be sent SMS Messaging in Aleph Yoel Kortick, 2010
9 SMS Messaging in Aleph 500. Yoel Kortick, 2010SMS Configuration #3 In the $aleph_root/error_lng directory, the sms_messages table includes the SMS messages text. Column 1 of this table is the message text, and must be aligned with the code that is used in column 3 of the $data_tab/form_sms table. SMS Messaging in Aleph Yoel Kortick, 2010
10 SMS Messaging in Aleph 500. Yoel Kortick, 2010SMS Configuration #4 If fee charging is required, tab18.lng must be set with the relevant charge. The SMS charge is 0072. SMS Messaging in Aleph Yoel Kortick, 2010
11 Example (standard recall setup)We will use an example where an SMS message is sent when an item is recalled. In tab15.eng item status 07 is defined as recallable: 15A 07 ## L Seven Days Y Y Y Y Y N N Y Y 00 N A We will use an example where an SMS message is sent when an item is recalled. In tab16 item status 07 is defined as being due one day from the time cir-13 (recall) is run, and has a minimum loan period of 1 day: 16A 07 ## ## A M SMS Messaging in Aleph Yoel Kortick, 2010
12 Example (standard recall setup)In tab100 the RECALL-METHOD is defined as 1 RECALL-METHOD=1 In tab18.eng the SMS charge is defined as 5 (units of currency) in the YOELK sub library. 0072 YOELK 07 ## Y SMS Message SMS Messaging in Aleph Yoel Kortick, 2010
13 SMS Messaging in Aleph 500. Yoel Kortick, 2010Example (SMS setup) In USM50 $data_tab/form_sms we state that letters the loan-recall-1 and loan-recall-2 will be sent by SMS and will use message number 1207 from $aleph_error_eng/sms_messages Here is $data_tab/form_sms !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!-!!-!!!!-! loan-recall Y loan-recall Y Here is $aleph_error_eng/sms_messages L The following $2 items have been recalled in library $1: $3 due date is $4 SMS Messaging in Aleph Yoel Kortick, 2010
14 SMS Messaging in Aleph 500. Yoel Kortick, 2010Example (SMS setup) Third party SMS servers may be used for the actual SMS sending. If the files: $data_tab/form_sms and $aleph_root/error_lng/sms_messages are set up as explained then a
15 SMS Messaging in Aleph 500. Yoel Kortick, 2010Example (SMS setup) The patron has an SMS number defined in his address: SMS Messaging in Aleph Yoel Kortick, 2010
16 SMS Messaging in Aleph 500. Yoel Kortick, 2010Example (SMS setup) The patron has “Receive SMS” checked in his global patron record: SMS Messaging in Aleph Yoel Kortick, 2010
17 Example (recall workflow)Item barcode is item status 07 in sub-library YOELK. It uses tab15 and tab16 identifier 15A and 16A. It is on loan to patron for 7 days (until June 8th) SMS Messaging in Aleph Yoel Kortick, 2010
18 Example (recall workflow)The item is requested by patron SMS Messaging in Aleph Yoel Kortick, 2010
19 Example (SMS and recall workflow)The service “Recall items on loan (cir-13)” is run. The SMS is sent when the service completes, and not when the letters are printed. In this respect it differs from when s are sent. SMS Messaging in Aleph Yoel Kortick, 2010
20 Example (recall workflow)The due date has changed in accordance with tab16 definitions and the running of cir-13 It used to be 08/06/2010 SMS Messaging in Aleph Yoel Kortick, 2010
21 Example (SMS and recall workflow)The output file is created. SMS Messaging in Aleph Yoel Kortick, 2010
22 Example (SMS workflow)The letter is “loan-recall-1”. This letter was defined previously is $data_tab/form_sms. SMS Messaging in Aleph Yoel Kortick, 2010
23 Example (SMS workflow)If the sms_server defined in aleph_start is an active 3rd party sms server then the following
24