Passa al contenuto principale
Supporto OCLC

Caricamento dei dati degli avventori in formato tab-delimitato

Questa documentazione spiega i requisiti per i file di dati degli assistenti, le regole e i requisiti per l'invio dei dati degli assistenti in formato tab-delimitato e fornisce un modello per il vostro file di dati degli assistenti.
File Descrizione
Modello di dati degli avventori delimitato da tabelle (Microsoft Excel) Contiene 46 colonne. Salvare come file di testo delimitato da tabelle (non è possibile utilizzare un file Excel per inviare i dati).

Colonne

Utilizzare i seguenti criteri per creare colonne per i dati:

  • Il file di testo deve contenere tutte le 46 colonne delimitate da tabelle nell'ordine elencato nella tabella seguente.
  • La prima riga del file di testo è l'intestazione e deve contenere i nomi delle colonne separati da tabulazioni.
  • I nomi delle intestazioni delle colonne non sono sensibili alle maiuscole e alle minuscole, ma devono essere scritti correttamente.
  • Ogni riga del file delimitato da tabulazione deve contenere 45 caratteri di tabulazione, che fungono da separatori di colonna.
  • Tutti i valori delle colonne sono stringhe (stringhe di testo, stringhe numeriche, ecc.).
  • Se non si hanno dati da inserire in una colonna, lasciarla vuota.

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.
  • Se si utilizza un computer non Windows, salvare il file come file di testo in formato Windows.

Esempio: OCLCsymbolpatrons.txt

Inviare i dati del mecenate

Una volta preparati i dati, inviare i file dei dati dei patroni via SFTP con il proprio account di scambio file OCLC.

Elenco Usato per
/xfer/wms/test/in/patron

Dati in fase di valutazione per il caricamento automatico dei dati

 Nota: Per garantire che il vostro file di prova sia gestito in modo appropriato, informate il supporto OCLC dopo aver caricato un file nella directory di prova e fornite una spiegazione dell'analisi richiesta.

/xfer/wms/in/patron Dati approvati per il caricamento automatico dei dati

Aggiornamenti continui del carico di clienti

  • Se in un record di aggiornamento sono inclusi nuovi dati, tutti saranno sostituiti con le nuove informazioni. Questo non si applica ai campi sourceSystem/idAtSource. Se questi campi vengono modificati, viene aggiunta una nuova voce nell'accordion del conto.
  • 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 di dati delimitati da tabelle.
  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.

Campi del record

Colonne 1-17

Colonna
numero

Nome della colonna Richiesto per
Biblioteche con circolazione WorldShare
Richiesto per
Biblioteche Tipasa
Descrizione Limite di caratteri
1 prefisso Opzionale Opzionale
  1. Prefisso o titolo, come Ms, Dr, Sir.
254
2 nome dato

Richiesto

è richiesto il nome di battesimo o il nome di famiglia

Richiesto

è richiesto il nome di battesimo o il nome di famiglia

  1. Nome del committente.
  2. è richiesto il nome del cognome o il nome della famiglia.
50
3 nome medio Opzionale Opzionale
  1. Secondo nome del committente.
100
4 nome famiglia

Richiesto

è richiesto il nome di battesimo o il nome di famiglia

Richiesto

è richiesto il nome di battesimo o il nome di famiglia

  1. Cognome del committente.
  2. è richiesto il nome del cognome o il nome della famiglia.
50
5 suffisso Opzionale Opzionale
  1. Un indicatore di generazione come Jr, III, e/o un epiteto come PhD, FRS.
254
6 soprannome Opzionale Opzionale
  1. Nome alternativo, non include saluti o epiteti come PhD.
  2. Non viene visualizzato nel record del patrono, ma è indicizzato per la ricerca.
50
7 puòAuto-modificarsi Opzionale Opzionale
  1. Indica che l'utente può gestire il nome da solo per funzionalità future.
  2. Permette i valori di:
    Vero
    Falso
  3. Il valore predefinito è false.
 
8 dataDellaNascita Opzionale Opzionale
  1. Data di nascita nel formato anno-mese-giorno: AAAA-MM-GG
 
9 genere Opzionale Opzionale
  1. Se presente, deve contenere uno dei seguenti valori:
    Femmina o F
    Maschio o M
    Sconosciuto o U
     

     Nota: tutti i valori sono insensibili alle maiuscole e alle minuscole.

  2. Il valore predefinito è Sconosciuto se lasciato vuoto.
 
10 istituzioneId Richiesto Richiesto
  1. L'institutionId (alias ID del registro WorldCat) è un identificativo unico di una biblioteca.
  2. I gruppi sono supportati consentendo alle biblioteche di inviare un file in institutionIds.
  3. L'institutionId è fornito dal vostro OCLC Implementation Manager o può essere trovato utilizzando una ricerca per simbolo di istituzione (identificatori).
 
11 codice a barre Richiesto Non applicabile (il codice a barre può essere inviato come illId)
  1. Solo funzionalità di WorldShare Circulation.
  2. Un identificatore unico per ogni cliente.
  3. Può contenere lettere o numeri.
  4. Gli spazi all'interno della stringa del codice a barre sono accettabili, ma gli spazi iniziali e finali sono problematici.
  5. La corrispondenza degli aggiornamenti degli avventori inizia con idAtSource e sourceSystem (se forniti) e poi con il codice a barre.
  6. Per ulteriori informazioni, vedere Riferimento al file di dati del patrono.
20
12 idAtSource

Opzionale

Richiesto se si utilizza un sistema di autenticazione non OCL.

Opzionale

Richiesto se si utilizza un sistema di autenticazione non OCLC

  1.  ID di un utente nel sistema esterno (ad es. ILS, PeopleSoft, Banner, CAS) da cui vengono migrati i dati.
  2. Se il sistema non è sensibile alle maiuscole e minuscole, queste devono essere uniche e in minuscolo.
  3. Se presente, deve essere presente anche sourceSystem.
  4. Per ulteriori informazioni, vedere Riferimento al file di dati del patrono.
50
13 sistema sorgente

Opzionale

Richiesto se si utilizza un sistema di autenticazione non OCL.

Opzionale

Richiesto se si utilizza un sistema di autenticazione non OCL.

  1. URN che identifica il sistema di autenticazione esterno (ad es. urn:mace:oclc:idm:testlibrary.ldap).
  2. Fornito da OCLC (ad es. LDAP) o dell'istituzione (ad es. Shibboleth).
  3. Se presente, deve essere presente anche idAtSource.
  4. Per ulteriori informazioni, vedere Riferimento al file di dati del patrono.
255
14 mutuatarioCategoria Richiesto Non applicabile (può essere utilizzato illPatronType)
  1. Solo per la funzionalità WorldShare Circulation.
  2. Categoria di prestatore (tipo di cliente) fornita dalla biblioteca.
  3. Utilizzato per impostare i criteri di circolazione.
  4. I nuovi valori possono essere forniti nei file di aggiornamento dei patroni e aggiunti nella configurazione del servizio OCLC.
  5. Esempi: Studente, Adulto, Facoltà, Personale, ecc.
30
15 data di registrazione Opzionale Non applicabile
  1. Solo funzionalità WMS.

  2. Data di creazione dell'account del patrono.

  3. Utilizzare questo formato per la data:
    AAAA-MM-GG 2016-12-31

  4. Se non viene fornita alcuna data, per impostazione predefinita verrà aggiunta la data in cui il record è stato aggiunto.

 

16

oclcData di scadenza Opzionale Opzionale
  1. Se si utilizza l'autenticazione di base di WorldShare, la data in cui scade l'accesso a determinati servizi forniti da OCLC; dopo questa data l'utente non sarà più autenticato né autorizzato a utilizzare servizi quali la circolazione o l'ILL. Nota: se si utilizza l'autenticazione di terzi (ad esempio, LDAP/CAS/SAML), questo campo non ha alcun effetto. 
  2. Utilizzare questo formato di data e ora:
    AAAA-MM-DDThh:mm:ss
    2016-12-31T00:00:00
  3. Se non è stato configurato un periodo di scadenza predefinito, non apparirà alcuna data di scadenza.
  4. Se è stato configurato un periodo di scadenza predefinito, ma non è stata fornita alcuna data, la data di scadenza sarà impostata su 60 mesi (cinque anni) per impostazione predefinita.
  5. Se viene incluso un componente temporale, questo verrà scartato poiché oclcExpirationDate viene memorizzato come una data senza componente temporale.
  6. Se presente, questa data può anche essere utilizzata da WorldShare Circulation per calcolare la data di scadenza degli articoli durante il checkout.
 
17 homeBranch Richiesto Non applicabile
  1. Solo per la funzionalità WorldShare Circulation.
  2. ID della filiale di provenienza del cliente, che è un codice numerico (non il codice della biblioteca di deposito).
  3. Gli ID delle filiali sono forniti dal responsabile dell'implementazione di OCLC.
  4. Questo valore si trova nella Configurazione del servizio OCLC > WorldCat Discovery e WorldCat Local > Tabella di traduzione dei codici dei possedimenti
 

 

Colonne 18-35

Colonna
numero

Nome della colonna Richiesto per
Biblioteche con circolazione WorldShare
Richiesto per
Biblioteche Tipasa
Descrizione Limite di caratteri
È richiesto almeno un dato di contatto, indirizzo postale, e-mail o numero di telefono.
18 primaryStreetAddressLine1 Opzionale Opzionale
  1. Indirizzo stradale primario riga 1.
120
19 primaryStreetAddressLine2 Opzionale Opzionale
  1. Indirizzo stradale principale riga 2, se applicabile.
120
20 città o località primaria Opzionale Opzionale
  1. Città o località principale.
50
21 Stato o Provincia primaria Opzionale Opzionale
  1. Stato o provincia principale.
  2. Per gli Stati americani, utilizzare le abbreviazioni dello United States Post Office.
120
22 codice postale primario Opzionale Opzionale
  1. Codice postale primario degli Stati Uniti o codice postale non statunitense.
20
23 paese primario Opzionale Opzionale
  1. Paese primario.
  2. Non abbreviare. Usare Stati Uniti, non Stati Uniti d'America o USA.
120
24 telefono primario Opzionale Opzionale
  1. Numero di telefono principale.
  2. Può essere utilizzato qualsiasi formato.
50
25 secondaryStreetAddressLine1 Opzionale Opzionale
  1. Indirizzo secondario riga 1.
120
26 secondaryStreetAddressLine2 Opzionale Opzionale
  1. Riga dell'indirizzo secondario 2.
120
27 città o località secondaria Opzionale Opzionale
  1. Città o località secondaria.
50
28 Stato o provincia secondaria Opzionale Opzionale
  1. Stato o provincia secondaria.
  2. Per gli Stati americani, utilizzare le abbreviazioni dello United States Post Office.
120
29 codice postale secondario Opzionale Opzionale
  1. Codice postale statunitense secondario o codice postale non statunitense.
20
30 paese secondario Opzionale Opzionale
  1. Paese secondario.
  2. Non abbreviare. Usare Stati Uniti, non Stati Uniti d'America o USA.
120
31 telefono secondario Opzionale Opzionale
  1. Numero di telefono secondario.
50
32 Indirizzo e-mail Opzionale Opzionale
  1. Per l'accesso dei patroni tramite l'autenticazione OCLC è necessario un indirizzo e-mail.
  2. Per i clienti senza indirizzo e-mail, è meglio fornire un valore predefinito (si può usare qualsiasi valore).
254
33 telefono cellulare Opzionale Opzionale
  1. Numero di telefono cellulare.
50
34 notificaEmail Non applicabile Opzionale
  1. Solo funzionalità Tipasa.
4,096
35 notificationTextPhone Non applicabile

Opzionale

 Nota: se un numero di cellulare è presente in questo campo e non viene convalidato, il carico del patrono verrà rifiutato.

  1. Solo funzionalità Tipasa.
  2. È richiesto il formato internazionale completo, compreso il codice del paese (ad es. +1 232-456-5678 per un numero statunitense, +44 20 4961 5678 per un numero britannico o +61 (0) 3 9929 0800 per un numero australiano). Per ulteriori informazioni, vedere Notazione dei numeri di telefono, degli indirizzi e-mail e degli indirizzi web nazionali e internazionali.
4,096

 

Colonne 36-46

Colonna
numero

Nome della colonna Richiesto per
Biblioteche con circolazione WorldShare
Richiesto per
Biblioteche Tipasa
Descrizione Limite di caratteri
36 patronoNote Opzionale Opzionale
  1. Le note provenienti da carichi di dati in corso che sono identiche a quelle caricate in precedenza vengono ignorate.
  2. Vengono aggiunte le note dei carichi di dati in corso che non sono identiche alle note caricate in precedenza.
255
37 photoURL Opzionale Opzionale
  1. Un URL che visualizza o rimanda alla foto dell'utente.
  2. La foto viene visualizzata nel profilo del cliente nei moduli WorldShare Admin e Circulation.
  3. OCLC non archivia attualmente foto.
  4. L'istituzione può garantire la sicurezza della foto ospitandola su un server sicuro. Consultate le politiche del vostro istituto in materia di sicurezza dei file fotografici collegati.
8,192
38 dati personalizzati1 Opzionale Opzionale
  1. Può corrispondere a valori predefiniti in OCLC Service Configuration o essere un testo libero (non inserito in OCLC Service Configuration).
  2. I campi di dati personalizzati provenienti da carichi di dati in corso che non sono identici ai campi caricati in precedenza sostituiscono il valore caricato in precedenza.
  3. I campi di dati personalizzati provenienti da carichi di dati in corso che sono identici ai campi caricati in precedenza vengono ignorati.
  4. I campi di dati personalizzati lasciati vuoti nei carichi di dati in corso vengono ignorati e viene mantenuto il valore precedente, se esistente.
  5. I campi dati personalizzati possono essere eliminati nei moduli WorldShare Admin o Circulation.
8,192
39 dati personalizzati2 Opzionale Opzionale
40 dati personalizzati3 Opzionale Opzionale
41 customdata4 Opzionale Opzionale
42 nome utente Opzionale Opzionale
  1. È il nome di accesso dell'utente da utilizzare solo per l'autenticazione gestita da OCLC.
  2. Questo deve essere fornito solo se l'istituzione non utilizza il codice a barre come nome utente.
  3. A seconda della configurazione dell'istituto, il codice a barre e il nome utente possono essere collegati.
  4. Ignorato se l'autenticazione è effettuata dall'istituzione o da una terza parte (nel qual caso OCLC non memorizza le credenziali di accesso).
  5. Deve essere unico.
50
43 illId Non applicabile Richiesto
  1. Solo funzionalità Tipasa.
  2. Un identificativo unico per l'utente nel sistema Tipasa.
  3. Può essere, ma non necessariamente, il codice a barre della biblioteca dell'utente.

     Nota: l'integrazione WMS Circ-Tipasa funziona solo se l'illld dell'utente e il valore del codice a barre sono gli stessi.

  4. Per ulteriori informazioni, vedere Riferimento al file di dati del patrono.
254
44 illApprovalStatus Non applicabile Opzionale
  1. Solo funzionalità Tipasa.
  2. Consente alle biblioteche di pre-approvare o bloccare gli avventori per Tipasa tramite il carico degli avventori o di modificare lo stato di approvazione degli avventori per Tipasa.
  3. I valori supportati sono:
    Nuovo
    Approvato
    Bloccato
  4. Se il valore viene lasciato vuoto al primo caricamento di un patrono e nel file del patrono è presente un valore illId, il valore predefinito verrà impostato su "New".
  5. Se il valore viene lasciato vuoto negli aggiornamenti dei patroni esistenti, verrà mantenuto il valore esistente impostato nel database.
 
45 illPatronType Non applicabile Opzionale
  1. Solo funzionalità Tipasa.
  2. Questo valore viene inserito automaticamente nel campo Stato dei moduli di lavoro delle richieste dei clienti se i valori dei campi sono configurati in modo da corrispondere ai valori inviati nei record dei dati dei clienti.
  3. Se il campo dello stato del patrono è incluso nei moduli di richiesta del patrono, i dati di illPatronType vengono acquisiti nelle statistiche di utilizzo di ILL.
50
46 illPickupLocation Non applicabile Opzionale
  1. This value will automatically populate in the Pickup Location field on Patron Request Workforms.
  2. Se una biblioteca ha più sedi, è consigliabile utilizzare per illPickupLocation nel carico degli avventori gli stessi valori utilizzati nei moduli di richiesta degli avventori.
1,000

Rapporti di elaborazione del file dei dati dei clienti

I rapporti sui dati degli utenti sono disponibili nella directory di scambio file wms/reports e possono essere scaricati utilizzando un client SFTP open-source o utilizzando i comandi SFTP.

Questa tabella mostra le directory per il download di file e rapporti.

Tipo di file Posizione della directory dei file SFTP Nota
Rapporto di eccezione per i clienti /xfer/wms/report Elenca i record degli avventori che non sono stati caricati nel WMS e il motivo del fallimento. Il rapporto di eccezione viene eseguito solo se c'è almeno un record di cliente che non è riuscito a essere caricato in WMS all'interno di un file di cliente.
Rapporto di riepilogo dei clienti /xfer/wms/report Viene eseguito dopo che un file di patroni è stato caricato nel WMS e indica quanti patroni nel file sono stati letti, elaborati, buoni (caricati), cattivi (non caricati), nuovi e aggiornati.