Carga de datos XML de clientes
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.
Archivo | Descripción |
---|---|
Patrón persona XSD | Plantilla para crear un fichero XML de datos de los usuarios. |
Símbolos y código HTML
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:
Símbolo | Código HTML (referencias a entidades) |
---|---|
& | & |
< | < |
> | > |
" | " |
Archivo
La denominación de los archivos debe seguir unas reglas específicas:
- Los nombres de archivo pueden contener letras, números, puntos y guiones bajos.
- Los nombres de archivo no pueden contener espacios ni caracteres especiales.
- Los archivos XML deben tener la extensión XML.
Ejemplo: OCLCsymbolpatrons.xml
Enviar datos del patrón
Actualizaciones continuas de la carga de usuarios
- Si se incluyen nuevos datos en un registro de actualización, todos serán sustituidos por la nueva información.
- La información sobre el nombre y la dirección postal se tratan como un grupo; si antes había una dirección completa y el registro de actualización sólo incluye el país, la dirección postal se sobrescribirá con sólo el país. Si no se aporta nada nuevo en el registro de actualización, se mantendrá la dirección antigua.
- Si un registro de actualización no incluye datos para un campo opcional, pero contenía datos en una actualización anterior, se mantendrán los datos originales.
- Si desea eliminar de forma masiva registros de usuarios de la biblioteca, consulte Eliminación masiva de datos de usuarios XML.
Campos | Acción | |
---|---|---|
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. |
Elementos de registro
OCLCPersonas y Persona
complexType | Atributo / Elemento | Tipo | 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. |
|
||
nota | Nota | Opcional Repetible |
Opcional Repetible |
|
||
additionalInfo | KeyValuePair | Opcional Repetible |
Opcional Repetible |
|
||
photoURL | cualquierURL | Opcional No repetible |
Opcional No repetible |
|
8,192 | |
institutionId (atributo) |
numérico | Requerido No repetible |
Requerido No repetible |
|
NameInfo y WMSCircPatronInfo
complexType | Atributo / Elemento | Tipo | 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 |
|
ContactInfo y PostalAddress
complexType | Atributo / Elemento | Tipo | 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 | Teléfono | 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 | |
país | 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 |
|
EmailAddress, Phone, CorrelationInfo, Note, KeyValuePair, NotificationDeliveryDestination y WSILLInfo
complexType | Atributo / Elemento | Tipo | 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 |
|
||
Teléfono 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 |
|
||
valor | 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 |
Registros de muestras
Informes de tratamiento de los ficheros de datos de los usuarios