Personalizzazione e porting delle
procedure esterne connesse ad Aleph
Il caricamento degli utenti della circolazione da files esterni
Modifiche introdotte in Aleph 500 Ver. 16
Marco Bortolami
Università degli Studi di Udine
[email protected]
Varese - 1 Aprile 2005
Argomenti trattati






Cos’è cambiato in generale dalla versione 14 alla 16
Esempi di configurazione su installazione single-ADM o
multi-ADM
Variazioni dei tracciati record dalla versione 14 alla versione
16
Registrazione dati in un ambiente con Utenti Non Condivisi
fra più library
Registrazione dati in un ambiente con Utenti Condivisi fra
più library
L’utilità PLIF (file-20)
Concetti generali
ALEPH 500 Ver. 14
ALEPH 500 Ver. 16
ADM50
Z303 – Informazioni globali utente
Z304 – Indirizzi
Z305 – Iscrizione alle sublibrary
Z308 – Password
$usr_library
Z303 – Informazioni globali utente
Z304 – Indirizzi
Z308 – Password
Z353 – Chiavi per la ricerca
ADM51
Z303 – Informazioni globali utente
Z304 – Indirizzi
Z305 – Iscrizione alle sublibrary
Z308 – Password
ADM50
Z305 – Iscrizione alle sublibrary
ADM5x
Z303 – Informazioni globali utente
Z304 – Indirizzi
Z305 – Iscrizione alle sublibrary
Z308 – Password
MULTI-ADM
ADM51
Z305 – Iscrizione alle sublibrary
ADM5x
Z305 – Iscrizione alle sublibrary
MULTI-ADM in Aleph 500 V.16
$alephe_root/aleph_start
Installazione con singola base
amministrativa (Es. UDN50)
…
#
setenv
#
…
usr_library
UDN50
UDN50
Z303 – Informazioni globali utente
Z304 – Indirizzi
Z305 – Iscrizione alle sublibrary
Z308 – Password
Z353 – Chiavi per la ricerca
Installazione con più basi
amministrative (Es. BIN50, BIN51)
…
#
setenv
#
…
usr_library
PWD50
PWD50
Z303 – Informazioni globali utente
Z304 – Indirizzi
Z308 – Password
Z353 – Chiavi per la ricerca
BIN50
Z305 – Iscrizione
alle sublibrary
BIN51
Z305 – Iscrizione
alle sublibrary
Variazioni dei tracciati record
TABELLA Z303 – Informazioni globali utente
(parte 1)
ALEPH 500 Ver. 14
Name
Null?
Type
--------------------- -------- ---Z303_REC_KEY
NOT NULL CHAR(12)
Z303_PROXY_ID
VARCHAR2(12)
Z303_PRIMARY_ID
VARCHAR2(12)
Z303_NAME_KEY
CHAR(50)
Z303_OPEN_DATE
Z303_UPDATE_DATE
Z303_CON_LNG
Z303_ALPHA
Z303_NAME
Z303_TITLE
Z303_DELINQ_1
Z303_DELINQ_N_1
NUMBER(8)
NUMBER(8)
CHAR(3)
CHAR(1)
VARCHAR2(200)
CHAR(10)
NUMBER(2)
VARCHAR2(200)
Z303_DELINQ_2
Z303_DELINQ_N_2
NUMBER(2)
VARCHAR2(200)
Z303_DELINQ_3
Z303_DELINQ_N_3
NUMBER(2)
VARCHAR2(200)
…(segue)
ALEPH 500 Ver. 16
Name
Null?
-------------------------- -------Z303_REC_KEY
NOT NULL
Z303_PROXY_FOR_ID
Z303_PRIMARY_ID
Z303_NAME_KEY
Z303_USER_LIBRARY
Z303_OPEN_DATE
Z303_UPDATE_DATE
Z303_CON_LNG
Z303_ALPHA
Z303_NAME
Z303_TITLE
Z303_DELINQ_1
Z303_DELINQ_N_1
Z303_DELINQ_1_UPDATE_DATE
Z303_DELINQ_1_CAT_NAME
Z303_DELINQ_2
Z303_DELINQ_N_2
Z303_DELINQ_2_UPDATE_DATE
Z303_DELINQ_2_CAT_NAME
Z303_DELINQ_3
Z303_DELINQ_N_3
Z303_DELINQ_3_UPDATE_DATE
Z303_DELINQ_3_CAT_NAME
(…segue)
Type
-------------CHAR(12)
CHAR(12)
VARCHAR2(12)
CHAR(50)
CHAR(5)
NUMBER(8)
NUMBER(8)
CHAR(3)
CHAR(1)
VARCHAR2(200)
CHAR(10)
NUMBER(2)
VARCHAR2(200)
NUMBER(8)
CHAR(10)
NUMBER(2)
VARCHAR2(200)
NUMBER(8)
CHAR(10)
NUMBER(2)
VARCHAR2(200)
NUMBER(8)
CHAR(10)
Variazioni dei tracciati record
TABELLA Z303 – Informazioni globali utente
(parte 1)
ALEPH 500 Ver. 14
(…continua)
Name
Null?
--------------------- -------Z303_BUDGET
Z303_PROFILE_ID
Z303_ILL_LIBRARY
Z303_HOME_LIBRARY
Z303_FIELD_1
Z303_FIELD_2
Z303_FIELD_3
Z303_ILL_TOTAL_LIMIT
Z303_ILL_ACTIVE_LIMIT
Z303_DISPATCH_LIBRARY
Z303_BIRTH_DATE
Z303_EXPORT_CONSENT
Z303_PROXY_ID_TYPE
Type
---VARCHAR2(20)
CHAR(10)
CHAR(5)
CHAR(5)
VARCHAR2(100)
VARCHAR2(100)
VARCHAR2(100)
NUMBER(4)
NUMBER(4)
CHAR(5)
NUMBER(8)
CHAR(1)
NUMBER(2)
ALEPH 500 Ver. 16
(…continua)
Name
Null?
-------------------------- -------Z303_BUDGET
Z303_PROFILE_ID
Z303_ILL_LIBRARY
Z303_HOME_LIBRARY
Z303_FIELD_1
Z303_FIELD_2
Z303_FIELD_3
Z303_ILL_TOTAL_LIMIT
Z303_ILL_ACTIVE_LIMIT
Z303_DISPATCH_LIBRARY
Z303_BIRTH_DATE
Z303_EXPORT_CONSENT
Z303_PROXY_ID_TYPE
Z303_SEND_ALL_LETTERS
Z303_PLIF_MODIFICATION
Type
-------------VARCHAR2(50)
VARCHAR2(12)
CHAR(5)
CHAR(5)
VARCHAR2(100)
VARCHAR2(100)
VARCHAR2(100)
NUMBER(4)
NUMBER(4)
CHAR(5)
NUMBER(8)
CHAR(1)
NUMBER(2)
CHAR(1)
VARCHAR2(50)
Variazioni dei tracciati record
TABELLA Z304 - Indirizzi
ALEPH 500 Ver. 14
Name
Null?
-------------------- -------Z304_REC_KEY
NOT NULL
Z304_ADDRESS
Z304_ZIP
Z304_EMAIL_ADDRESS
Z304_TELEPHONE
Z304_DATE_FROM
Z304_DATE_TO
Z304_ADDRESS_TYPE
Z304_TELEPHONE_2
Z304_TELEPHONE_3
Z304_TELEPHONE_4
Type
---CHAR(14)
VARCHAR2(250)
CHAR(9)
VARCHAR2(60)
VARCHAR2(30)
NUMBER(8)
NUMBER(8)
NUMBER(2)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
ALEPH 500 Ver. 16
Name
Null?
----------------------- -------Z304_REC_KEY
NOT NULL
Z304_ADDRESS
Z304_ZIP
Z304_EMAIL_ADDRESS
Z304_TELEPHONE
Z304_DATE_FROM
Z304_DATE_TO
Z304_ADDRESS_TYPE
Z304_TELEPHONE_2
Z304_TELEPHONE_3
Z304_TELEPHONE_4
Z304_UPDATE_DATE
Z304_CAT_NAME
Type
------------CHAR(14)
VARCHAR2(250)
CHAR(9)
VARCHAR2(60)
VARCHAR2(30)
NUMBER(8)
NUMBER(8)
NUMBER(2)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
NUMBER(8)
CHAR(10)
Variazioni dei tracciati record
TABELLA Z305 – Iscrizione alle sublibrary
(parte 1)
ALEPH 500 Ver. 14
Name
Null?
------------------------ -------Z305_REC_KEY
NOT NULL
Z305_OPEN_DATE
Z305_UPDATE_DATE
Z305_BOR_TYPE
Z305_BOR_STATUS
Z305_EXPIRY_DATE
Z305_NOTE
Z305_LOAN_PERMISSION
Z305_PHOTO_PERMISSION
Z305_OVER_PERMISSION
Z305_MULTI_HOLD
Z305_LOAN_CHECK
Z305_DELIVERY_TYPE
Z305_HOLD_PERMISSION
Z305_RENEW_PERMISSION
Z305_RR_PERMISSION
Z305_IGNORE_LATE_RETURN
Z305_LAST_ACTIVITY_DATE
Z305_PHOTO_CHARGE
Z305_NO_LOAN
Z305_NO_HOLD
(…segue)
ALEPH 500 Ver. 16
Type
---CHAR(17)
NUMBER(8)
NUMBER(8)
CHAR(2)
CHAR(2)
NUMBER(8)
VARCHAR2(80)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
NUMBER(8)
CHAR(1)
NUMBER(4)
NUMBER(4)
Name
Null?
---------------------------- -------Z305_REC_KEY
NOT NULL
Z305_OPEN_DATE
Z305_UPDATE_DATE
Z305_BOR_TYPE
Z305_BOR_STATUS
Z305_EXPIRY_DATE
Z305_NOTE
Z305_LOAN_PERMISSION
Z305_PHOTO_PERMISSION
Z305_OVER_PERMISSION
Z305_MULTI_HOLD
Z305_LOAN_CHECK
Z305_DELIVERY_TYPE
Z305_HOLD_PERMISSION
Z305_RENEW_PERMISSION
Z305_RR_PERMISSION
Z305_IGNORE_LATE_RETURN
Z305_LAST_ACTIVITY_DATE
Z305_PHOTO_CHARGE
Z305_NO_LOAN
Z305_NO_HOLD
(…segue)
Type
-----------CHAR(17)
NUMBER(8)
NUMBER(8)
CHAR(2)
CHAR(2)
NUMBER(8)
VARCHAR2(80)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
CHAR(1)
NUMBER(8)
CHAR(1)
NUMBER(4)
NUMBER(4)
Variazioni dei tracciati record
TABELLA Z305 – Iscrizione alle sublibrary
(parte 2)
ALEPH 500 Ver. 14
ALEPH 500 Ver. 16
(…continua)
Name
Null?
------------------------ -------Z305_NO_PHOTO
Z305_NO_CASH
Z305_CASH_LIMIT
Z305_CREDIT_DEBIT
Z305_SUM
Z305_DELINQ_1
Z305_DELINQ_N_1
(…continua)
Name
Null?
---------------------------- -------Z305_NO_PHOTO
Z305_NO_CASH
Z305_CASH_LIMIT
Z305_CREDIT_DEBIT
Z305_SUM
Z305_DELINQ_1
Z305_DELINQ_N_1
Z305_DELINQ_1_UPDATE_DATE
Z305_DELINQ_1_CAT_NAME
Z305_DELINQ_2
Z305_DELINQ_N_2
Z305_DELINQ_2_UPDATE_DATE
Z305_DELINQ_2_CAT_NAME
Z305_DELINQ_3
Z305_DELINQ_N_3
Z305_DELINQ_3_UPDATE_DATE
Z305_DELINQ_3_CAT_NAME
Z305_FIELD_1
Z305_FIELD_2
Z305_FIELD_3
Z305_HOLD_ON_SHELF
Z305_END_BLOCK_DATE
Type
---NUMBER(4)
NUMBER(4)
CHAR(10)
CHAR(1)
CHAR(10)
NUMBER(2)
VARCHAR2(200)
Z305_DELINQ_2
Z305_DELINQ_N_2
NUMBER(2)
VARCHAR2(200)
Z305_DELINQ_3
Z305_DELINQ_N_3
NUMBER(2)
VARCHAR2(200)
Z305_FIELD_1
Z305_FIELD_2
Z305_FIELD_3
Z305_HOLD_ON_SHELF
Z305_END_BLOCK_DATE
VARCHAR2(100)
VARCHAR2(100)
VARCHAR2(100)
CHAR(1)
NUMBER(8)
Type
------------NUMBER(4)
NUMBER(4)
CHAR(10)
CHAR(1)
CHAR(10)
NUMBER(2)
VARCHAR2(200)
NUMBER(8)
CHAR(10)
NUMBER(2)
VARCHAR2(200)
NUMBER(8)
CHAR(10)
NUMBER(2)
VARCHAR2(200)
NUMBER(8)
CHAR(10)
VARCHAR2(200)
VARCHAR2(200)
VARCHAR2(200)
CHAR(1)
NUMBER(8)
Variazioni dei tracciati record
TABELLA Z308 - Password
ALEPH 500 Ver. 14
Name
Null?
----------------------- -------Z308_REC_KEY
NOT NULL
Z308_VERIFICATION
Z308_VERIFICATION_TYPE
Z308_ID
Z308_STATUS
Z308_ENCRYPTION
Type
---CHAR(22)
VARCHAR2(20)
CHAR(2)
VARCHAR2(12)
CHAR(2)
CHAR(1)
ALEPH 500 Ver. 16
Name
Null?
------------------------ -------Z308_REC_KEY
NOT NULL
Z308_VERIFICATION
Z308_VERIFICATION_TYPE
Z308_ID
Z308_STATUS
Z308_ENCRYPTION
Type
-----------CHAR(27)
VARCHAR2(20)
CHAR(2)
CHAR(12)
CHAR(2)
CHAR(1)
Variazioni dei tracciati record
TABELLA Z353 – Chiavi per la ricerca
ALEPH 500 Ver. 14
ALEPH 500 Ver. 16
Name
Null?
---------------------------- -------Z353_REC_KEY
NOT NULL
Z353_ID
Type
--------CHAR(115)
CHAR(12)
Z303/Z308/Z353 in ambiente “Utenti NON condivisi”
(TAB100 – USER-SHARING=N)
1 Record nella tabella Z303 (per ogni library in cui l’utente è iscritto)
Z303_REC_KEY:
....
Z303_USER_LIBRARY:
....
<ID dell’utente>
UDN50
Library in cui è valido il record
<blank> in ambiente utenti condivisi
Z303/Z308/Z353 in ambiente “Utenti NON Condivisi”
(TAB100 – USER-SHARING=N)
2 Record (per ogni library in cui l’utente è iscritto), nella tabella Z308 con il campo
Z308_REC_KEY così compilato:
1
2
123456789012345678901234567
00<ID Utente>
UDN50
01<BARCODE Utente>
UDN50
Tipo chiave:
00 – ID
01 – Barcode
Valore della chiave
Library
<blank> in ambiente
“Utenti condivisi”
Z303/Z308/Z353 in ambiente “Utenti NON Condivisi”
(TAB100 – USER-SHARING=N)
3 Record (per ogni library in cui l’utente è iscritto), nella tabella Z353 con z353_REC_KEY:
1
2
3
4
5
12345678901234567890123456789012345678901234567890123…
UDN50ID
<ID utente>
UDN50BC
<BARCODE utente>
UDN50NAME <NOME utente minuscolo><ID utente>
+ 3 Record nella tabella Z353 per ogni library nella quale è iscritto, con z353_REC_KEY:
UDN50UDN50ID
<ID utente>
UDN50UDN50BC
<BARCODE utente>
UDN50UDN50NAME <NOME utente minuscolo><ID utente>
Library in cui
L’utente è iscritto
Library in cui è valido il
record
<blank> in ambiente utenti
condivisi
Identificativo della chiave
ID / BC / NAME
Valore della chiave
ID Utente
Compilato solo per
La chiave NAME
Z303/Z308/Z353 in ambiente “Utenti Condivisi”
(TAB100 – USER-SHARING=Y)
1 Record nella tabella Z303
Z303_REC_KEY:
....
Z303_USER_LIBRARY:
....
<ID dell’utente>
<non impostato>
Library in cui è valido il record
<blank> in ambiente utenti condivisi
Z303/Z308/Z353 in ambiente “Utenti Condivisi”
(TAB100 – USER-SHARING=Y)
2 Record nella tabella Z308 con il campo Z308_REC_KEY così compilato:
1
2
123456789012345678901234567
00<ID Utente>
01<BARCODE Utente>
Tipo chiave:
00 – ID
01 – Barcode
Valore della chiave
Library
<blank> in ambiente
“Utenti condivisi”
Z303/Z308/Z353 in ambiente “Utenti Condivisi”
TAB100 – USERSHARING=Y
3 Record nella tabella Z353 con z353_REC_KEY:
1
2
3
4
5
12345678901234567890123456789012345678901234567890123…
ID
<ID utente>
BC
<BARCODE utente>
NAME <NOME utente minuscolo><ID utente>
+ 3 Record nella tabella Z353 per ogni library nella quale è iscritto, con z353_REC_KEY:
BIN50
BIN50
BIN50
ID
<ID utente>
BC
<BARCODE utente>
NAME <NOME utente minuscolo><ID utente>
BIN51
BIN51
BIN51
ID
<ID utente>
BC
<BARCODE utente>
NAME <NOME utente minuscolo><ID utente>
Library in cui
L’utente è iscritto
Library in cui è valido il
record
<blank> in ambiente utenti
condivisi
Identificativo della chiave
ID / BC / NAME
Valore della chiave
ID Utente
Compilato solo per
La chiave NAME
L’Utilità PLIF (file-20)
La procedura permette di aggiungere,
aggiornare o eliminare i record degli
utenti e può includere un
aggiornamento per un utente globale
(Z303), un utente locale (Z305), chiavi
ID (Z308) e/o tabelle degli indirizzi
(Z304).
L’Utilità PLIF (file-20)
E’ disponibile un’esauriente documentazione dell’Ex-Libris sul portale
All’indirizzo http://www.exlibrisgroup.com/docportal/logon.php