|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
namespace lordelph\SIP2\Request; |
|
4
|
|
|
|
|
5
|
|
|
/** |
|
6
|
|
|
* PatronInformationRequest is a superset of the Patron Status Request message. It should be used to request patron |
|
7
|
|
|
* information. The ACS should respond with the Patron Information Response message. |
|
8
|
|
|
* |
|
9
|
|
|
* The setType() method accepts one of none, hold, overdue, charged, fine, recall and unavail |
|
10
|
|
|
* |
|
11
|
|
|
* @method setLanguage(string $languageCode) |
|
12
|
|
|
* @method setType(string $informationType) |
|
13
|
|
|
* @method setInstitutionId(string $institutionId) |
|
14
|
|
|
* @method setPatronIdentifier(string $patron) |
|
15
|
|
|
* @method setTerminalPassword(string $terminalPassword) |
|
16
|
|
|
* @method setPatronPassword(string $patronPassword) |
|
17
|
|
|
* @method setStart(string $start) |
|
18
|
|
|
* @method setEnd(string $end) |
|
19
|
|
|
* |
|
20
|
|
|
* @licence https://opensource.org/licenses/MIT |
|
21
|
|
|
* @copyright John Wohlers <[email protected]> |
|
22
|
|
|
* @copyright Paul Dixon <[email protected]> |
|
23
|
|
|
*/ |
|
24
|
|
|
class PatronInformationRequest extends SIP2Request |
|
25
|
|
|
{ |
|
26
|
|
|
protected $var = [ |
|
27
|
|
|
'Language' => ['type' => 'nnn', 'default' => '001'], |
|
28
|
|
|
'Type' => ['default' => 'none'], |
|
29
|
|
|
'InstitutionId' => [], |
|
30
|
|
|
'PatronIdentifier' => [], |
|
31
|
|
|
'TerminalPassword' => ['default' => ''], |
|
32
|
|
|
'PatronPassword' => ['default' => ''], |
|
33
|
|
|
'Start' => ['default' => '1'], |
|
34
|
|
|
'End' => ['default' => '5'], |
|
35
|
|
|
]; |
|
36
|
|
|
|
|
37
|
1 |
|
public function getMessageString($withSeq = true, $withCrc = true): string |
|
38
|
|
|
{ |
|
39
|
|
|
/* |
|
40
|
|
|
* According to the specification: |
|
41
|
|
|
* Only one category of items should be requested at a time, i.e. it would take 6 of these messages, |
|
42
|
|
|
* each with a different position set to Y, to get all the detailed information about a patron's items. |
|
43
|
|
|
*/ |
|
44
|
1 |
|
$summary = []; |
|
45
|
1 |
|
$summary['none'] = ' '; |
|
46
|
1 |
|
$summary['hold'] = 'Y '; |
|
47
|
1 |
|
$summary['overdue'] = ' Y '; |
|
48
|
1 |
|
$summary['charged'] = ' Y '; |
|
49
|
1 |
|
$summary['fine'] = ' Y '; |
|
50
|
1 |
|
$summary['recall'] = ' Y '; |
|
51
|
1 |
|
$summary['unavail'] = ' Y'; |
|
52
|
|
|
|
|
53
|
1 |
|
$type = $this->getVariable('Type'); |
|
54
|
|
|
|
|
55
|
1 |
|
$this->newMessage('63'); |
|
56
|
1 |
|
$this->addFixedOption($this->getVariable('Language'), 3); |
|
57
|
1 |
|
$this->addFixedOption($this->datestamp(), 18); |
|
58
|
1 |
|
$this->addFixedOption(sprintf("%-10s", $summary[$type]), 10); |
|
59
|
1 |
|
$this->addVarOption('AO', $this->getVariable('InstitutionId')); |
|
60
|
1 |
|
$this->addVarOption('AA', $this->getVariable('PatronIdentifier')); |
|
61
|
1 |
|
$this->addVarOption('AC', $this->getVariable('TerminalPassword')); |
|
62
|
1 |
|
$this->addVarOption('AD', $this->getVariable('PatronPassword'), true); |
|
63
|
|
|
/* old function version used padded 5 digits, not sure why */ |
|
64
|
1 |
|
$this->addVarOption('BP', $this->getVariable('Start'), true); |
|
65
|
|
|
/* old function version used padded 5 digits, not sure why */ |
|
66
|
1 |
|
$this->addVarOption('BQ', $this->getVariable('End'), true); |
|
67
|
|
|
|
|
68
|
1 |
|
return $this->returnMessage($withSeq, $withCrc); |
|
69
|
|
|
} |
|
70
|
|
|
} |
|
71
|
|
|
|
lordelph /
php-sip2
