Cargando XML de datos de usuario
Nota: Esta información presupone un conocimiento básico de XML. Debido a que los sistemas y prácticas locales de las bibliotecas varían ampliamente, es mejor utilizar este documento como una descripción general de alto nivel.
Archivo | Descripción |
---|---|
XSD de usuario | Plantilla para crear un archivo XML de datos de usuario. |
Símbolos y código HTML
Los archivos XML deben contener un código HTML válido. Estos símbolos, si están presentes en los datos de usuario, deben reemplazarse como código HTML (referencias de entidad), como se muestra a continuación:
Símbolo | Código HTML (referencias de entidad) |
---|---|
& | & |
< | < |
> | > |
" | " |
Nombre de archivo
La denominación de archivo debe seguir 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 de archivo XML .
Ejemplo: OCLCsymbolpatrons.xml
Enviar datos de usuario
Actualizaciones de carga de usuario en curso
- Si se incluyen datos nuevos en un registro de actualización, todos serán reemplazados con información nueva.
- La información de nombre y dirección postal se trata como un grupo; si anteriormente había una dirección completa y el registro de actualización solo incluye el país, la Dirección postal se sobrescribirá con solo el país. Si no se proporciona nada nuevo en el registro de actualización, se mantendrá la dirección anterior.
- Si una actualización de registro 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 los registros de usuarios de la biblioteca, consulte Eliminación masiva de datos XML de usuarios.
Campos | Acción | |
---|---|---|
Para Circulación de WorldShare, si alguno de estos campos está presente > | barcode, homeBranch, prestaterCategory, circRegistrationDate > | Se tratará como un registro de Circulación de WorldShare y se supondrá que los campos obligatorios de Circulación de WorldShare están presentes. |
Para Tipasa, si está presente alguno de los campos ILL > | illId, illApprovalStatus, illPatronType, illPickupLocation > | Se tratará como un registro ILL y se supondrá que los campos obligatorios de ILL están presentes. |
Para Circulación de WorldShare, si falta algún campo obligatorio de Circulación de WorldShare > | giveName OR familyName,stitutionId,barcode,crediterCategory,homeBranch > | Se ignorará el registro. |
Si falta algún campo de Tipasa > | giveName OR familyName, InstitutionId, illId, al menos una información de contacto (dirección postal, teléfono o correo electrónico) > | Se ignorará el registro. |
Si los campos de Circulación de WorldShare y Tipasa están presentes > | Admitirá requisitos para ambos tipos de registros. |
Elementos del registro
OCLCPersonas y Persona
complexType | Atributo/Elemento | Tipo | Obligatorio/repetible para las bibliotecas de circulación de WorldShare | Obligatorio/repetible para las bibliotecas Tipasa | Descripción | Límite de caracteres |
---|---|---|---|---|---|---|
OCLCPersonas | persona | Persona |
Obligatorio |
Obligatorio |
|
|
Persona | correlaciónInfo | CorrelationInfo |
Opcional Obligatorio si se utiliza un sistema de autenticación que no es de OCLC . |
Opcional Obligatorio si se utiliza un sistema de autenticación que no es de OCLC . |
|
|
oclcUserName | cadena | Opcional No repetible |
Opcional No repetible |
|
50 | |
oclcExpirationDate | dateTime | Opcional No repetible |
Opcional No repetible |
|
||
nameInfo | NameInfo | Obligatorio No repetible |
Obligatorio No repetible |
|
||
apodo | cadena | Opcional No repetible |
Opcional No repetible |
|
50 | |
dateOfBirth | Fecha | Opcional No repetible |
Opcional No repetible |
|
||
género | cadena | Opcional No repetible |
Opcional No repetible |
|
||
wmsCircPatronInfo | WmsCircPatron Información |
Obligatorio No repetible |
Obligatorio No repetible |
|
||
wsILLInfo | WsILLInfo | No corresponde |
Obligatorio |
|
||
contactInfo | ContactInfo |
Opcional |
Obligatorio Repetible |
|
||
notificación |
Notificación |
No corresponde |
Opcional Nota: si un número de móvil está presente en este campo (cuando se combina con el valor de deliveryService SMS) no valida, se rechazará la carga del usuario. |
|
||
nota | Nota | Opcional Repetible |
Opcional Repetible |
|
||
AdditionalInfo | KeyValuePair | Opcional Repetible |
Opcional Repetible |
|
||
URL de la foto | cualquierURL | Opcional No repetible |
Opcional No repetible |
|
8.192 | |
InstitutionId (Atributo) |
numérico | Obligatorio No repetible |
Obligatorio No repetible |
|
NameInfo y WMSCircPatronInfo
complexType | Atributo/Elemento | Tipo | Obligatorio/repetible para las bibliotecas de circulación de WorldShare | Obligatorio/repetible para las bibliotecas Tipasa | Descripción | Límite de caracteres |
---|---|---|---|---|---|---|
NameInfo | prefijo | cadena | Opcional No repetible |
Opcional No repetible |
|
254 |
giveName | cadena |
Obligatorio Se debe especificar el nombre de pila o el nombre de familia |
Obligatorio Se debe especificar el nombre de pila o el nombre de familia |
|
50 | |
middleName | cadena | Opcional No repetible |
Opcional No repetible |
|
100 | |
familyName | cadena |
Obligatorio Se debe especificar el nombre de pila o el nombre de familia |
Obligatorio Se debe especificar el nombre de pila o el nombre de familia |
|
50 | |
sufijo | cadena | Opcional No repetible |
Opcional No repetible |
|
254 | |
canSelfEdit | Booleano | Opcional No repetible |
Opcional No repetible |
|
||
WMSCircPatronInfo | Código de barras | cadena | Obligatorio No repetible |
No corresponde (el código de barras se puede enviar como illID) |
|
20 |
PIN | cadena | Opcional No repetible |
No corresponde |
|
||
prestaterCategory | cadena | Obligatorio No repetible |
No corresponde (Se puede utilizar illPatronType) |
|
30 | |
circRegistration Fecha |
dateTime | Opcional No repetible |
No corresponde |
|
||
Sucursal principal | cadena | Obligatorio No repetible |
No corresponde |
|
||
isCircBlocked | Booleano | Opcional No repetible |
No corresponde |
|
||
isCollectionExempt | Booleano | Opcional No repetible |
No corresponde |
|
||
Está exento de multas | Booleano | Opcional No repetible |
No corresponde |
|
||
está verificado | Booleano |
Opcional |
No corresponde |
|
||
storeCheckout Historia |
Booleano | Opcional No repetible |
No corresponde |
|
ContactInfo y PostalAddress
complexType | Atributo/Elemento | Tipo | Obligatorio/repetible para las bibliotecas de circulación de WorldShare | Obligatorio/repetible para las bibliotecas Tipasa | Descripción | Límite de caracteres |
---|---|---|---|---|---|---|
ContactInfo Nota: se debe especificar al menos un dato, una dirección postal, un correo electrónico o un número de teléfono. |
Opción: dirección postal | PostalAddress | Opcional Repetible |
Opcional Repetible |
|
|
Opción: correo electrónico | EmailAddress | Opcional Repetible |
Opcional Repetible |
|
||
Opción: teléfono | Teléfono | Opcional Repetible |
Opcional Repetible |
|
||
Etiqueta | cadena | Opcional No repetible |
Opcional No repetible |
|
||
no es válido | Booleano | Opcional No repetible |
Opcional No repetible |
|
||
PostalAddress Nota: se debe especificar al menos un dato de contacto, una dirección postal, un correo electrónico o un número de teléfono. |
streetAddressLine1 | cadena | Opcional No repetible |
Opcional No repetible |
|
120 |
streetAddressLine2 | cadena | Opcional No repetible |
Opcional No repetible |
|
120 | |
cityOrLocality | cadena | Opcional No repetible |
Opcional No repetible |
|
50 | |
stateOrProvince | cadena | Opcional No repetible |
Opcional No repetible |
|
120 | |
postalCode | 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 |
|
||
esPermanente | 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 circulación de WorldShare | Obligatorio/repetible para las bibliotecas Tipasa | Descripción | Límite de caracteres |
---|---|---|---|---|---|---|
EmailAddress Nota: se debe especificar al menos un dato de contacto, una dirección postal, un correo electrónico o un número de teléfono. |
emailAddress | cadena | Opcional No repetible |
Opcional No repetible |
254 | |
isPrimary | Booleano | Opcional No repetible |
Opcional No repetible |
|
||
Teléfono Nota: se debe especificar al menos un dato de contacto, una dirección postal, un correo electrónico o un 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 es de OCLC . |
Opcional Obligatorio si se utiliza un sistema de autenticación que no es de OCLC . |
|
255 |
idAtSource | cadena |
Opcional Obligatorio si se utiliza un sistema de autenticación que no es de OCLC . |
Opcional Obligatorio si se utiliza un sistema de autenticación que no es de 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 | |
NotificationDelivery Nota: si la notificación es de entrega |
deliveryService | cadena | No corresponde |
Opcional |
|
|
destino | cadena | No corresponde | Opcional No repetible |
|
4.096 | |
WsILLInfo | illId | cadena | No corresponde | Obligatorio No repetible |
|
254 |
illApprovalStatus | cadena | No corresponde | Opcional No repetible |
|
||
illPatronType | cadena | No corresponde | Opcional No repetible |
|
50 | |
illPickupLocation | cadena | No corresponde | Opcional No repetible |
|
1000 |
Registros de muestra
Informes de procesamiento de archivo de datos de usuario