Passa al contenuto principale
Supporto OCLC

Caricamento dati utente delimitato da tabulazioni

  1. Ultimo aggiornamento
  2. Salva come PDF
Questa documentazione spiega i requisiti per i file di dati utente delimitati da tabulazioni, le regole e i requisiti per l'invio dei dati utente in formato delimitato da tabulazioni e fornisce un modello per il file di dati utente.
File Descrizione
Modello dati utente delimitato da tabulazioni (Microsoft Excel) Contiene 46 colonne. Salva come file di testo delimitato da tabulazioni (non è possibile utilizzare un file Excel per inviare dati).

Colonne

Utilizzare i criteri seguenti per creare colonne per i dati:

  • Il file di testo deve contenere tutte le 46 colonne delimitate da tabulazioni 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.
  • Column header names are not case sensitive, but must be spelled correctly.
  • Ogni riga nel file delimitato da tabulazioni deve contenere 45 caratteri di tabulazione, che fungono da separatori di colonna.
  • All values in columns are strings (text string, numeric string, etc.).
  • Se non sono presenti dati da inserire in una colonna, lasciarla vuota.

Filename

La denominazione dei file deve seguire regole specifiche:

  • I nomi dei file possono contenere lettere, numeri, punti e caratteri di sottolineatura.
  • I nomi dei file non possono contenere spazi o caratteri speciali.
  • Se si utilizza una macchina non Windows, salvare il file come file di testo formattato Windows.

Esempio: OCLCsymbolpatrons.txt

Inviare i dati dell'utente

Una volta preparati i dati, inviare i file di dati utente tramite SFTP con il proprio account di scambio file OCLC.

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

Dati in fase di valutazione per caricamenti automatici di dati

 Nota: per garantire che il file di test venga gestito correttamente, avvisare il supporto OCLC dopo aver caricato un file nella directory di test e fornire una spiegazione dell'analisi richiesta.
/xfer/wms/in/patron Dati approvati per caricamenti dati automatizzati

Aggiornamenti del caricamento degli utenti in corso

  • Se vengono inclusi nuovi dati in un record di aggiornamento, tutti verranno sostituiti con le nuove informazioni. Questo non si applica ai campi sourceSystem/idAtSource. Se questi campi vengono modificati, verrà aggiunta una nuova voce nell'elenco a discesa dell'account.
  • Le informazioni su nome e indirizzo postale sono 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 solo con il paese. Se non viene fornito nulla di nuovo nel record di aggiornamento, il vecchio indirizzo verrà mantenuto.
  • Se un record di aggiornamento non include dati per un campo facoltativo, ma conteneva dati in un aggiornamento precedente, i dati originali verranno mantenuti.
  • Se si desidera eliminare in blocco i record degli utenti della biblioteca, vedere Eliminazione in blocco di dati delimitati da tabulazioni.
Fields Azione
Per WorldShare Circulation, se uno di questi campi è presente > barcode, sede, categoria del prestatario, data data di registrazione > Verrà trattato come un record WorldShare Circulation e presuppone la presenza dei campi obbligatori di WorldShare Circulation.
Per Tipasa, se è presente uno dei campi ILL > illId, illApprovalStatus, illPatronType, illPickupLocation > Verrà trattato come un record ILL e presuppone che i campi obbligatori ILL siano presenti.
Per WorldShare Circulation, se manca un campo obbligatorio di WorldShare Circulation > NomeDato OPPURE NomeFamiglia, ID istituto, codice a barre, Categoria prestatario, Sede, > Il record verrà ignorato.
Per Tipasa, se manca qualche campo > NomeDato o NomeFamiglia, ID istituto, ID ill, almeno un'informazione di contatto (indirizzo postale, telefono o e-mail) > Il record verrà ignorato.
Se sono presenti entrambi i campi WorldShare Circulation e Tipasa > Soddisferà i requisiti per entrambi i tipi di record.

Campi record

Colonne 1-17

Numero di colonna

 Nome colonna Obbligatorio per
le biblioteche WorldShare Circulation		 Obbligatorio per
le biblioteche di Tipasa		 Descrizione Character limit
1 prefisso Optional Optional
  1. Prefisso o titolo, come Ms, Dr, Sir.
 254
2 datoNome

Obbligatorio

È necessario inserire il Nome o il Nome di famiglia

Obbligatorio

È necessario inserire il Nome o il Nome di famiglia
  1. Nome dell'utente.
  2. È necessario inserire il Nome o il Nome di famiglia.
 50
3 secondo nome Optional Optional
  1. Secondo nome dell'utente.
 100
4 familyName

Obbligatorio

È necessario inserire il Nome o il Nome di famiglia

Obbligatorio

È necessario inserire il Nome o il Nome di famiglia
  1. Cognome utente.
  2. È necessario inserire il Nome o il Nome di famiglia.
 50
5 suffisso Optional Optional
  1. Un indicatore di generazione come Jr, III e/o un epiteto come PhD, FRS.
 254
6 soprannome Optional Optional
  1. Nome alternativo, non include saluto o epiteti come PhD.
  2. Compila il campo Nome preferito nei moduli Amministrazione e Circolazione.
 50
7 canSelfEdit Optional Optional
  1. Indica che un utente può gestire il nome per funzionalità future.
  2. Consente i valori di:
    Vero
    Falso
  3. Il valore predefinito è falso.
8 DataDiBirth Optional Optional
  1. Data di nascita nel formato anno-mese-giorno: AAAA-MM-GG
9 genere Optional Optional
  1. Se presente, deve contenere uno di questi valori:
    Femmina o F
    Maschio o M
    Sconosciuto o U
     

     Nota: tutti i valori non fanno distinzione tra maiuscole e minuscole.

  2. Il valore predefinito è Sconosciuto se lasciato vuoto.
10 InstitutionId Obbligatorio Obbligatorio
  1. InstitutionId (aka WorldCat Registry ID) è un identificatore univoco di una biblioteca.
  2. I gruppi sono supportati consentendo alle biblioteche di inviare un file in InstitutionIds.
  3. L'ID istituto viene fornito dal responsabile dell'implementazione OCLC o può essere trovato utilizzando una ricerca del simbolo dell'istituzione (identificatori).
11 barcode Obbligatorio Non applicabile (il barcode può essere inviato come illId)
  1. Solo funzionalità WorldShare Circulation.
  2. Un identificatore univoco per utente.
  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 sugli aggiornamenti degli utenti inizia con idAtSource e sourceSystem (se forniti) e quindi corrisponde al codice a barre.
  6. Per ulteriori informazioni, vedere Riferimento file di dati utente.
 20
12 idAtSource

Optional

Obbligatorio se si utilizza un sistema di autenticazione non OCLC .

Optional

Obbligatorio 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 è in corso la migrazione dei dati.
  2. Se il sistema non distingue tra maiuscole e minuscole, queste devono essere univoche e scritte in minuscolo.
  3. Se presente, deve essere presente anche sourceSystem.
  4. Per ulteriori informazioni, vedere Riferimento file di dati utente.
 50
13 sourceSystem

Optional

Obbligatorio se si utilizza un sistema di autenticazione non OCLC .

Optional

Obbligatorio se si utilizza un sistema di autenticazione non OCLC .
  1. URN che identifica il sistema di autenticazione esterno (es urn:mace:oclc:idm:testlibrary.ldap).
  2. Fornito da OCLC (ad es LDAP) o istituzione (ad es Shibboleth).
  3. Se presente, deve essere presente anche idAtSource.
  4. Per ulteriori informazioni, vedere Riferimento file di dati utente.
 255
14 categoria prestatario Obbligatorio Non applicabile (è possibile utilizzare illPatronType)
  1. Solo funzionalità WorldShare Circulation.
  2. Categoria del destinatario del prestito (tipo di utente) fornita dalla biblioteca.
  3. Usato per impostare i criteri di circolazione.
  4. Nuovi valori possono essere forniti nei file di aggiornamento utente e anche aggiunti in OCLC Service Configuration.
  5. Esempi: studenti, adulti, docenti, personale, ecc.
 30
15 circRegistrationDate Optional Not applicable

  1. Solo funzionalità WMS.

  2. Data di creazione dell'account utente.

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

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

16

 oclcExpirationDate Optional Optional
  1. Se si utilizza l'autenticazione di base di WorldShare, la data di scadenza dell'accesso a determinati servizi forniti OCLC; l'utente non sarà più autenticato o autorizzato a utilizzare servizi come circolazione o ILL dopo questa data.
  2. Usa questo formato data e ora:
    AAAA-MM-GGThh:mm:ss
    2016-12-31T00:00:00
  3. Se non è stato configurato alcun periodo di scadenza predefinito, non verrà visualizzata alcuna data di scadenza.
  4. Se è stato configurato un periodo di scadenza predefinito, ma non viene fornita alcuna data, la data di scadenza sarà impostata su 60 mesi (cinque anni) per impostazione predefinita.
  5. Se è incluso un componente timestamp, verrà scartato poiché oclcExpirationDate viene archiviato come data senza un componente timestamp.
  6. Se presente, questa data può essere utilizzata anche da WorldShare Circulation per calcolare la data di scadenza dell'elemento durante il prestito.
17 principaleSede Obbligatorio Not applicable
  1. Solo funzionalità WorldShare Circulation.
  2. ID sede dell'utente, che è un codice numerico (non il codice posseduto della biblioteca).
  3. Gli ID delle sedi sono forniti dal responsabile dell'implementazione OCLC .
  4. Questo valore è disponibile in OCLC Service Configuration > WorldCat Discovery e WorldCat Local >Tabella di conversione del codice del posseduto

 

Colonne 18-35

Numero di colonna

 Nome colonna Obbligatorio per
le biblioteche WorldShare Circulation		 Obbligatorio per
le biblioteche di Tipasa		 Descrizione Character limit
È richiesta almeno un'informazione di contatto, indirizzo postale, e-mail o numero di telefono.
18 primaryStreetAddressLine1 Optional Optional
  1. Riga indirizzo principale 1.
 120
19 primaryStreetAddressLine2 Optional Optional
  1. Indirizzo principale riga 2, se applicabile.
 120
20 primaryCityOrLocality Optional Optional
  1. Città o posizione principale.
 50
21 primaryStateOrProvince Optional Optional
  1. Stato o provincia principale.
  2. Per gli stati degli Stati Uniti, utilizzare le abbreviazioni degli uffici postali degli Stati Uniti.
 120
22 primaryPostalCode Optional Optional
  1. Codice postale principale USA o codice postale non USA.
 20
23 paese primario Optional Optional
  1. Paese principale.
  2. Non abbreviare. Utilizzare Stati Uniti, non Stati Uniti d'America o USA.
 120
24 primaryPhone Optional Optional
  1. Numero di telefono principale.
  2. Può utilizzare qualsiasi formato.
 50
25 secondaryStreetAddressLine1 Optional Optional
  1. Riga indirizzo secondario 1.
 120
26 secondaryStreetAddressLine2 Optional Optional
  1. Riga indirizzo secondario 2.
 120
27 secondaryCityOrLocality Optional Optional
  1. Città o posizione secondaria.
 50
28 secondaryStateOrProvince Optional Optional
  1. Stato o provincia secondaria.
  2. Per gli stati degli Stati Uniti, utilizzare le abbreviazioni degli uffici postali degli Stati Uniti.
 120
29 codice postale secondario Optional Optional
  1. Codice postale secondario USA o codice postale non USA.
 20
30 paese secondario Optional Optional
  1. Paese secondario.
  2. Non abbreviare. Utilizzare Stati Uniti, non Stati Uniti d'America o USA.
 120
31 secondario Optional Optional
  1. Numero di telefono secondario.
 50
32 Indirizzo e-mail Optional Optional
  1. È necessario un indirizzo e-mail per l'accesso degli utenti tramite l'autenticazione OCLC .
  2. Per gli utenti senza indirizzo e-mail, è meglio fornire un valore predefinito (può utilizzare qualsiasi valore).
 254
33 cellulare Optional Optional
  1. Numero di cellulare.
 50
34 e-mail di notifica Not applicable Optional
  1. Solo funzionalità Tipasa.
 4.096
35 testo di notifica Not applicable

Optional

 Nota: se un numero di cellulare è presente in questo campo e non viene convalidato, il caricamento dell'utente verrà rifiutato.
  1. Solo funzionalità Tipasa.
  2. È richiesto il formato internazionale completo, incluso il prefisso internazionale (ad es +1 232-456-5678 per un numero USA, +44 20 4961 5678 per un numero UK o +61 (0) 3 9929 0800 per un numero australiano). Per ulteriori informazioni, vedere Notazione per numeri di telefono, indirizzi e-mail e indirizzi web nazionali e internazionali.
 4.096

 

Colonne 36-46

Numero di colonna

 Nome colonna Obbligatorio per
le biblioteche WorldShare Circulation		 Obbligatorio per
le biblioteche di Tipasa		 Descrizione Character limit
36 Note dell'utente Optional Optional
  1. Le note dai caricamenti di dati in corso che sono identiche alle note caricate in precedenza vengono ignorate.
  2. Vengono aggiunte note dai caricamenti di dati in corso che non sono identiche alle note caricate in precedenza.
 255
37 URL foto Optional Optional
  1. Un URL che visualizza o collega alla foto dell'utente.
  2. La foto viene visualizzata nel profilo dell'utente nei moduli WorldShare Admin e Circulation.
  3. OCLC non archivia attualmente foto.
  4. L'istituto può fornire sicurezza per la foto ospitando su un server sicuro. Consultare le politiche del proprio istituto per quanto riguarda la sicurezza per i file di foto collegati.
 8.192
38 customdata1 Optional Optional
  1. Può corrispondere a valori predefiniti in OCLC Service Configuration o essere testo libero (non inserito in OCLC Service Configuration).
  2. I campi di dati personalizzati dei caricamenti di dati in corso che non sono identici ai campi caricati in precedenza sostituiranno il valore caricato in precedenza.
  3. I campi di dati personalizzati dei caricamenti di dati in corso identici ai campi caricati in precedenza vengono ignorati.
  4. I campi di dati personalizzati lasciati vuoti nei caricamenti di dati in corso vengono ignorati e il valore precedente, se esistente, viene mantenuto.
  5. I campi di dati personalizzati possono essere eliminati nei moduli WorldShare Admin o Circulation.
 8.192
39 customdata2 Optional Optional
40 customdata3 Optional Optional
41 customdata4 Optional Optional
42 nome utente Optional Optional
  1. Questo è il nome di accesso dell'utente per l'uso solo in OCLC-autenticazione mantenuta.
  2. Questo dovrebbe essere fornito solo se l'istituto non utilizza il codice a barre come nome utente.
  3. A seconda della configurazione dell'istituto, il codice a barre e il nome utente potrebbero essere collegati.
  4. Ignorato se l'autenticazione viene eseguita dall'istituzione o da una terza parte (in tal caso OCLC non memorizza le credenziali di accesso).
  5. Deve essere univoco.
 50
43 illId Not applicable Obbligatorio
  1. Solo funzionalità Tipasa.
  2. Identificatore univoco per l'utente nel sistema Tipasa.
  3. Può, ma non è necessario, essere il barcode della biblioteca dell'utente.

     Nota: l'integrazione WMS Circ-Tipasa funziona solo se illld e il valore del barcode dell'utente sono uguali.

  4. Per ulteriori informazioni, vedere Riferimento file di dati utente.
 254
44 illApprovalStatus Not applicable Optional
  1. Solo funzionalità Tipasa.
  2. Consente alle biblioteche di pre-approvare o bloccare gli utenti per Tipasa tramite il caricamento utenti o di modificare lo stato di approvazione degli utenti per Tipasa.
  3. I valori supportati sono:
    Nuovo
    Approvato
    Bloccato
  4. Se il valore viene lasciato vuoto al primo caricamento di un utente ed è presente un valore illId nel file utente, il valore predefinito sarà impostato su "Nuovo".
  5. Se il valore viene lasciato vuoto durante gli aggiornamenti agli utenti esistenti, il valore esistente impostato nel database verrà mantenuto.
45 illPatronType Not applicable Optional
  1. Solo funzionalità Tipasa.
  2. Questo valore verrà compilato automaticamente nel campo Stato dei moduli di lavoro di richiesta utente se i valori dei campi sono configurati in modo da corrispondere ai valori inviati nei record di dati utente.
  3. Se il campo stato utente è incluso nei moduli di lavoro richiesta utente, i dati da illPatronType vengono acquisiti nelle statistiche di utilizzo ILL.
 50
46 illPickupLocation Not applicable Optional
  1. Questo valore verrà inserito automaticamente nel campo Posizione di ritiro sui moduli di lavoro di richiesta utente.
  2. Se una biblioteca ha più posizioni, è consigliabile utilizzare gli stessi valori per illPickupLocation nel caricamento degli utenti utilizzati nei moduli di richiesta degli utenti.
 1.000

Report elaborazione file di dati utente

I report dati utente 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 scaricare file e report.

File type Percorso della directory del file SFTP Note
Report eccezione utente /xfer/wms/reports Elenca i record utente che non sono stati caricati in WMS e il motivo dell'errore. Il report dell'eccezione verrà eseguito solo se esiste almeno un record utente che non è stato caricato in WMS all'interno di un file utente.
Patron Summary Report /xfer/wms/reports Viene eseguito dopo che un file utente è stato caricato in WMS e indica quanti utenti nel file sono stati letti, elaborati, validi (caricati), non validi (non caricati), nuovi e aggiornati.