Caricamento dei dati del mecenate in XML
Nota: queste informazioni presuppongono una conoscenza di base di XML. Poiché i sistemi e le pratiche locali delle biblioteche variano notevolmente, il presente documento è da intendersi come una panoramica di alto livello.
File | Descrizione |
---|---|
Patron persona XSD | Modello per la creazione del file XML dei dati del patrono. |
Simboli e codice HTML
I file XML devono contenere codice HTML valido. Questi simboli, se presenti nei dati del patrono, devono essere sostituiti come codice HTML (riferimenti alle entità), come indicato di seguito:
Simbolo | Codice HTML (riferimenti alle entità) |
---|---|
& | & |
< | < |
> | > |
" | " |
Nome del file
La denominazione dei file deve seguire regole specifiche:
- I nomi dei file possono contenere lettere, numeri, punti e trattini bassi.
- I nomi dei file non possono contenere spazi o caratteri speciali.
- I file XML devono avere l'estensione XML.
Esempio: OCLCsymbolpatrons.xml
Inviare i dati dell'utente
Aggiornamenti continui del carico di clienti
- Se in un record di aggiornamento sono inclusi nuovi dati, tutti saranno sostituiti con le nuove informazioni.
- Le informazioni sul nome e sull'indirizzo postale vengono trattate come un gruppo; se in precedenza esisteva un indirizzo completo e il record di aggiornamento include solo il paese, l'indirizzo postale verrà sovrascritto con il solo paese. Se nel record di aggiornamento non viene fornito nulla di nuovo, viene mantenuto il vecchio indirizzo.
- Se un record di aggiornamento non include dati per un campo opzionale, ma conteneva dati in un aggiornamento precedente, i dati originali saranno mantenuti.
- Se si desidera eliminare in blocco i record degli avventori della biblioteca, vedere Eliminazione in blocco dei dati degli avventori XML.
Campi | Azione | |
---|---|---|
Per WorldShare Circulation, se è presente uno dei seguenti campi > | codice a barre, homeBranch, borrowerCategory, circRegistrationDate > | Verrà trattato come un record di WorldShare Circulation e si presuppone che i campi obbligatori di WorldShare Circulation siano presenti. |
Per Tipasa, se è presente uno qualsiasi dei campi ILL > | illId, illApprovalStatus, illPatronType, illPickupLocation > | Verrà trattato come un record ILL e si presuppone che i campi obbligatori ILL siano presenti. |
Per la Circolazione WorldShare, se manca uno dei campi obbligatori della Circolazione WorldShare > | givenName OR familyName, institutionId, barcode, borrowerCategory, homeBranch > | Il record verrà ignorato. |
Per Tipasa, se manca qualche campo > | givenName OR familyName, institutionId, illId, almeno una informazione di contatto (indirizzo postale, telefono o e-mail) > | Il record verrà ignorato. |
Se sono presenti entrambi i campi WorldShare Circulation e Tipasa > | Si occuperà dei requisiti per entrambi i tipi di registri. |
Elementi di registrazione
OCLCPersonas e Persona
tipo complesso | Attributo / Elemento | Tipo | Richiesto / Ripetibile per le biblioteche WorldShare Circulation | Richiesto / ripetibile per le biblioteche Tipasa | Descrizione | Limite di caratteri |
---|---|---|---|---|---|---|
OCLCPersonas | persona | Persona |
Richiesto |
Richiesto |
|
|
Persona | correlazioneInfo | CorrelazioneInfo |
Opzionale Richiesto se si utilizza un sistema di autenticazione non OCL. |
Opzionale Richiesto se si utilizza un sistema di autenticazione non OCL. |
|
|
oclcUserName | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
50 | |
oclcData di scadenza | dateTime | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
nomeInfo | NomeInfo | Richiesto Non ripetibile |
Richiesto Non ripetibile |
|
||
soprannome | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
50 | |
dataDellaNascita | Data | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
genere | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
wmsCircPatronInfo | WmsCircPatron Info |
Richiesto Non ripetibile |
Richiesto Non ripetibile |
|
||
wsILLInfo | WsILLInfo | Non applicabile |
Richiesto |
|
||
contattoInfo | Informazioni sul contatto |
Opzionale |
Richiesto Repeatable |
|
||
notifica |
Notifica |
Non applicabile |
Opzionale Nota: se un numero di cellulare presente in questo campo (quando abbinato al valore deliveryService SMS) non viene convalidato, il carico del patrono verrà rifiutato. |
|
||
nota | Nota | Opzionale Ripetibile |
Opzionale Ripetibile |
|
||
additionalInfo | ChiaveValorePaio | Opzionale Ripetibile |
Opzionale Ripetibile |
|
||
photoURL | qualsiasi URL | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
8,192 | |
istituzioneId (Attributo) |
numerico | Richiesto Non ripetibile |
Richiesto Non ripetibile |
|
NameInfo e WMSCircPatronInfo
tipo complesso | Attributo / Elemento | Tipo | Richiesto / Ripetibile per le biblioteche WorldShare Circulation | Richiesto / ripetibile per le biblioteche Tipasa | Descrizione | Limite di caratteri |
---|---|---|---|---|---|---|
NomeInfo | prefisso | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
254 |
nome dato | stringa |
Richiesto è richiesto il nome di battesimo o il nome di famiglia |
Richiesto è richiesto il nome di battesimo o il nome di famiglia |
|
50 | |
nome medio | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
100 | |
nome famiglia | stringa |
Richiesto è richiesto il nome di battesimo o il nome di famiglia |
Richiesto è richiesto il nome di battesimo o il nome di famiglia |
|
50 | |
suffisso | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
254 | |
puòAuto-modificarsi | booleano | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
WMSCircPatronInfo | codice a barre | stringa | Richiesto Non ripetibile |
Non applicabile (il codice a barre può essere inviato come illID) |
|
20 |
spillo | stringa | Facoltativo Non ripetibile |
Non applicabile |
|
||
mutuatarioCategoria | stringa | Richiesto Non ripetibile |
Non applicabile (è possibile utilizzare illPatronType) |
|
30 | |
circRegistrazione Data |
dateTime | Facoltativo Non ripetibile |
Non applicabile |
|
||
homeBranch | stringa | Richiesto Non ripetibile |
Non applicabile |
|
||
isCircBlocked | booleano | Facoltativo Non ripetibile |
Non applicabile |
|
||
isCollectionExempt | booleano | Facoltativo Non ripetibile |
Non applicabile |
|
||
isFineExempt | booleano | Facoltativo Non ripetibile |
Non applicabile |
|
||
èVerificato | booleano |
Facoltativo |
Non applicabile |
|
||
negozioCheckout La storia |
booleano | Facoltativo Non ripetibile |
Non applicabile |
|
ContactInfo e PostalAddress
tipo complesso | Attributo / Elemento | Tipo | Richiesto / Ripetibile per le biblioteche WorldShare Circulation | Richiesto / ripetibile per le biblioteche Tipasa | Descrizione | Limite di caratteri |
---|---|---|---|---|---|---|
Informazioni sul contatto Nota: è richiesto almeno un dato, indirizzo postale, e-mail o numero di telefono. |
Scelta: indirizzo postale | Indirizzo postale | Opzionale Ripetibile |
Opzionale Ripetibile |
|
|
Scelta: e-mail | Indirizzo e-mail | Opzionale Ripetibile |
Opzionale Ripetibile |
|
||
Scelta: telefono | Telefono | Opzionale Ripetibile |
Opzionale Ripetibile |
|
||
etichetta | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
isInvalid | booleano | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
Indirizzo postale Nota: è richiesto almeno un dato di contatto, indirizzo postale, e-mail o numero di telefono. |
viaLineaIndirizzo1 | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
120 |
streetAddressLine2 | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
120 | |
cittàOrLocalità | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
50 | |
statoOrProvincia | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
120 | |
codice postale | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
20 | |
Paese | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
120 | |
isPrimary | booleano | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
èPermanente | booleano | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
validoDa | dateTime | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
validTo | dateTime | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
Indirizzo e-mail, Telefono, CorrelationInfo, Nota, KeyValuePair, NotificationDeliveryDestination e WSILLInfo
tipo complesso | Attributo / Elemento | Tipo | Richiesto / Ripetibile per le biblioteche WorldShare Circulation | Richiesto / ripetibile per le biblioteche Tipasa | Descrizione | Limite di caratteri |
---|---|---|---|---|---|---|
Indirizzo e-mail Nota: è richiesto almeno un dato di contatto, indirizzo postale, e-mail o numero di telefono. |
Indirizzo e-mail | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
254 | |
isPrimary | booleano | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
Telefono Nota: è richiesto almeno un dato di contatto, indirizzo postale, e-mail o numero di telefono. |
numero | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
50 |
isPrimary | booleano | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
CorrelazioneInfo | sistema sorgente | stringa |
Opzionale Richiesto se si utilizza un sistema di autenticazione non OCL. |
Opzionale Richiesto se si utilizza un sistema di autenticazione non OCL. |
|
255 |
idAtSource | stringa |
Opzionale Richiesto se si utilizza un sistema di autenticazione non OCL. |
Opzionale Richiesto se si utilizza un sistema di autenticazione non OCL. |
|
50 | |
Nota | testo | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
255 |
ChiaveValorePaio | businessContext | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
|
chiave | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
||
valore | stringa | Facoltativo Non ripetibile |
Facoltativo Non ripetibile |
|
8,192 | |
NotificaConsegna Nota: Se si utilizza notificationDelivery |
servizio di consegna | stringa | Non applicabile |
Facoltativo |
|
|
destinazione | stringa | Non applicabile | Facoltativo Non ripetibile |
|
4,096 | |
WsILLInfo | illId | stringa | Non applicabile | Richiesto Non ripetibile |
|
254 |
illApprovalStatus | stringa | Non applicabile | Facoltativo Non ripetibile |
|
||
illPatronType | stringa | Non applicabile | Facoltativo Non ripetibile |
|
50 | |
illPickupLocation | stringa | Non applicabile | Facoltativo Non ripetibile |
|
1000 |
Registri di esempio
Rapporti di elaborazione del file dei dati dei clienti