Nota: Esta información presupone un conocimiento fundamental de XML. Dado que los sistemas y prácticas locales de las bibliotecas varían mucho, este documento se utiliza mejor como una visión general de alto nivel.
File | Descripción |
---|---|
Patrón persona XSD | Plantilla para crear un fichero XML de datos de los usuarios. |
Los archivos XML deben contener código HTML válido. Estos símbolos, si están presentes en los datos del patrón, deben sustituirse como código HTML (referencias de entidad), como se indica a continuación:
Symbol | Código HTML (referencias a entidades) |
---|---|
& | & |
< | < |
> | > |
" | " |
La denominación de los archivos debe seguir unas reglas específicas:
Ejemplo: OCLCsymbolpatrons.xml
Una vez que sus datos estén preparados, envíe sus archivos de datos de usuarios a través de SFTP con su cuenta de intercambio de archivos de OCLC.
Directory | Uso para |
---|---|
/xfer/wms/test/in/patron |
Datos evaluados para cargas de datos automatizadas Nota: Para asegurarse de que su archivo de prueba se maneje adecuadamente, notifique al Servicio de asistencia de OCLC después de cargar un archivo en el directorio de prueba y proporcione una explicación del análisis requerido. |
/xfer/wms/in/patron | Datos aprobados para cargas de datos automatizadas |
Fields | Action | |
---|---|---|
Para WorldShare Circulation, si alguno de estos campos está presente > | código de barras, homeBranch, borrowerCategory, circRegistrationDate > | Se tratará como un registro de WorldShare Circulation y se asumirá que los campos obligatorios de WorldShare Circulation están presentes. |
Para Tipasa, si alguno de los campos ILL está presente > | illId, illApprovalStatus, illPatronType, illPickupLocation > | Se tratará como un registro de ILL y se asumirá que los campos obligatorios de ILL están presentes. |
Para WorldShare Circulation, si falta algún campo obligatorio de WorldShare Circulation > | givenName OR familyName, institutionId, barcode, borrowerCategory, homeBranch > | El registro será ignorado. |
Para Tipasa, si falta algún campo > | givenName OR familyName, institutionId, illId, al menos un dato de contacto (dirección postal, teléfono o correo electrónico) > | El registro será ignorado. |
Si los campos WorldShare Circulation y Tipasa están presentes > | Asumirá los requisitos para ambos tipos de registros. |
complexType | Atributo / Elemento | Type | Obligatorio / Repetible para las bibliotecas de WorldShare Circulation | Obligatorio / Repetible para Bibliotecas Tipasa | Descripción | Límite de caracteres |
---|---|---|---|---|---|---|
OCLCPersonas | persona | Persona |
Requerido |
Requerido |
|
|
Persona | correlationInfo | CorrelationInfo |
Opcional Obligatorio si se utiliza un sistema de autenticación que no sea OCLC. |
Opcional Obligatorio si se utiliza un sistema de autenticación que no sea OCLC. |
|
|
oclcUserName | cadena | Opcional No repetible |
Opcional No repetible |
|
50 | |
oclcFechaExpiración | dateTime | Opcional No repetible |
Opcional No repetible |
|
||
nameInfo | NameInfo | Requerido No repetible |
Requerido No repetible |
|
||
apodo | cadena | Opcional No repetible |
Opcional No repetible |
|
50 | |
fechaDeNacimiento | Date | Opcional No repetible |
Opcional No repetible |
|
||
género | cadena | Opcional No repetible |
Opcional No repetible |
|
||
wmsCircPatronInfo | WmsCircPatron Información |
Requerido No repetible |
Requerido No repetible |
|
||
wsILLInfo | WsILLInfo | No aplicable |
Requerido |
|
||
contactInfo | Información de contacto |
Opcional |
Requerido Repeatable |
|
||
notificación |
Notificación |
No aplicable |
Opcional Nota: Si un número de móvil está presente en este campo (cuando se empareja con el valor deliveryService SMS) no se valida, la carga del patrón será rechazada. |
|
||
note | Nota | Opcional Repetible |
Opcional Repetible |
|
||
additionalInfo | KeyValuePair | Opcional Repetible |
Opcional Repetible |
|
||
photoURL | cualquierURL | Opcional No repetible |
Opcional No repetible |
|
8,192 | |
institutionId (atributo) |
numeric | Requerido No repetible |
Requerido No repetible |
|
complexType | Atributo / Elemento | Type | Obligatorio / Repetible para las bibliotecas de WorldShare Circulation | Obligatorio / Repetible para Bibliotecas Tipasa | Descripción | Límite de caracteres |
---|---|---|---|---|---|---|
NameInfo | prefijo | cadena | Opcional No repetible |
Opcional No repetible |
|
254 |
givenName | cadena |
Requerido se requiere givenName o familyName |
Requerido se requiere givenName o familyName |
|
50 | |
middleName | cadena | Opcional No repetible |
Opcional No repetible |
|
100 | |
familyName | cadena |
Requerido se requiere givenName o familyName |
Requerido se requiere givenName o familyName |
|
50 | |
sufijo | cadena | Opcional No repetible |
Opcional No repetible |
|
254 | |
canSelfEdit | booleano | Opcional No repetible |
Opcional No repetible |
|
||
WMSCircPatronInfo | código de barras | cadena | Requerido No repetible |
No aplicable (el código de barras puede enviarse como illID) |
|
20 |
pin | cadena | Opcional No repetible |
No aplicable |
|
||
prestatarioCategoría | cadena | Requerido No repetible |
No aplicable (puede utilizarse illPatronType) |
|
30 | |
circRegistro Date |
dateTime | Opcional No repetible |
No aplicable |
|
||
InicioSucursal | cadena | Requerido No repetible |
No aplicable |
|
||
isCircBlocked | booleano | Opcional No repetible |
No aplicable |
|
||
isCollectionExempt | booleano | Opcional No repetible |
No aplicable |
|
||
isFineExempt | booleano | Opcional No repetible |
No aplicable |
|
||
isVerified | booleano |
Opcional |
No aplicable |
|
||
storeCheckout Historial |
booleano | Opcional No repetible |
No aplicable |
|
complexType | Atributo / Elemento | Type | Obligatorio / Repetible para las bibliotecas de WorldShare Circulation | Obligatorio / Repetible para Bibliotecas Tipasa | Descripción | Límite de caracteres |
---|---|---|---|---|---|---|
Información de contacto Nota: Se requiere al menos un dato, dirección postal, correo electrónico o número de teléfono. |
Elección: dirección postal | Dirección postal | Opcional Repetible |
Opcional Repetible |
|
|
Elección: correo electrónico | Dirección de correo electrónico | Opcional Repetible |
Opcional Repetible |
|
||
Elección: teléfono | Phone | Opcional Repetible |
Opcional Repetible |
|
||
etiqueta | cadena | Opcional No repetible |
Opcional No repetible |
|
||
isInvalid | booleano | Opcional No repetible |
Opcional No repetible |
|
||
Dirección postal Nota: Se requiere al menos una información de contacto, dirección postal, correo electrónico o número de teléfono. |
direcciónLínea1 | cadena | Opcional No repetible |
Opcional No repetible |
|
120 |
direcciónLínea2 | cadena | Opcional No repetible |
Opcional No repetible |
|
120 | |
ciudadOrLocalidad | cadena | Opcional No repetible |
Opcional No repetible |
|
50 | |
stateOrProvince | cadena | Opcional No repetible |
Opcional No repetible |
|
120 | |
código postal | cadena | Opcional No repetible |
Opcional No repetible |
|
20 | |
country | cadena | Opcional No repetible |
Opcional No repetible |
|
120 | |
isPrimary | booleano | Opcional No repetible |
Opcional No repetible |
|
||
isPermanent | booleano | Opcional No repetible |
Opcional No repetible |
|
||
validFrom | dateTime | Opcional No repetible |
Opcional No repetible |
|
||
validTo | dateTime | Opcional No repetible |
Opcional No repetible |
|
complexType | Atributo / Elemento | Type | Obligatorio / Repetible para las bibliotecas de WorldShare Circulation | Obligatorio / Repetible para Bibliotecas Tipasa | Descripción | Límite de caracteres |
---|---|---|---|---|---|---|
Dirección de correo electrónico Nota: Se requiere al menos una información de contacto, dirección postal, correo electrónico o número de teléfono. |
dirección de correo electrónico | cadena | Opcional No repetible |
Opcional No repetible |
254 | |
isPrimary | booleano | Opcional No repetible |
Opcional No repetible |
|
||
Phone Nota: Se requiere al menos una información de contacto, dirección postal, correo electrónico o número de teléfono. |
número | cadena | Opcional No repetible |
Opcional No repetible |
|
50 |
isPrimary | booleano | Opcional No repetible |
Opcional No repetible |
|
||
CorrelationInfo | sourceSystem | cadena |
Opcional Obligatorio si se utiliza un sistema de autenticación que no sea OCLC. |
Opcional Obligatorio si se utiliza un sistema de autenticación que no sea OCLC. |
|
255 |
idAtSource | cadena |
Opcional Obligatorio si se utiliza un sistema de autenticación que no sea OCLC. |
Opcional Obligatorio si se utiliza un sistema de autenticación que no sea OCLC. |
|
50 | |
Nota | texto | cadena | Opcional No repetible |
Opcional No repetible |
|
255 |
KeyValuePair | businessContext | cadena | Opcional No repetible |
Opcional No repetible |
|
|
clave | cadena | Opcional No repetible |
Opcional No repetible |
|
||
value | cadena | Opcional No repetible |
Opcional No repetible |
|
8,192 | |
NotificaciónEntrega Nota: Si se utiliza notificationDelivery |
servicio de entrega | cadena | No aplicable |
Opcional |
|
|
destino | cadena | No aplicable | Opcional No repetible |
|
4,096 | |
WsILLInfo | illId | cadena | No aplicable | Requerido No repetible |
|
254 |
illApprovalStatus | cadena | No aplicable | Opcional No repetible |
|
||
illPatronType | cadena | No aplicable | Opcional No repetible |
|
50 | |
illPickupLocation | cadena | No aplicable | Opcional No repetible |
|
1000 |
Los informes de datos de los usuarios están disponibles en el directorio de intercambio de archivos wms/reports y pueden descargarse utilizando un cliente SFTP de código abierto o mediante comandos SFTP.
Esta tabla muestra los directorios para descargar archivos e informes.
Tipo de fichero | Ubicación del directorio de archivos SFTP | Nota |
---|---|---|
Informe de excepciones de los usuarios | /xfer/wms/informes | Enumera los registros de clientes que no se han podido cargar en el SGA y el motivo del fallo. El informe de excepciones sólo se ejecutará si hay al menos un registro de cliente que no se ha podido cargar en WMS dentro de un archivo de cliente. |
Patron Summary Report | /xfer/wms/informes | Se ejecuta después de cargar un fichero de clientes en el SGA e indica el número de clientes del fichero leídos, procesados, buenos (cargados), malos (no cargados), nuevos y actualizados. |