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. |
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) |
|---|---|
| & | & |
| < | < |
| > | > |
| " | " |
La denominación de archivo debe seguir 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.
| Directorio | Usar para |
|---|---|
| /xfer/wms/test/in/patron |
Datos en evaluación para cargas de datos automatizadas Nota: para asegurarse de que su archivo de prueba se administre de manera adecuada, notifique a Soporte de OCLC después de cargar un archivo al directorio de prueba y brinde una explicación del análisis requerido. |
| /xfer/wms/in/usuario | Datos aprobados para cargas automatizadas de datos |
| 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. |
| 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 |
|
| 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 |
|
| 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 |
| 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 |
Los informes de datos de usuarios están disponibles en el directorio de intercambio de archivos wms/reports y se pueden descargar mediante un cliente SFTP de código abierto o mediante el uso de comandos SFTP.
Esta tabla muestra los directorios para descargar archivos e informes.
| Tipo de archivo | Ubicación del directorio de archivos SFTP | Nota |
|---|---|---|
| Informe de excepción de usuario | /xfer/wms/reports | Muestra una lista de los registros de usuarios que no se pueden cargar en WMS y también la razón del error. El informe de excepciones solo se ejecutará si hay al menos un registro de usuario que no se pudo cargar en WMS dentro de un archivo de usuario. |
| Informe resumido de usuario | /xfer/wms/reports | Se ejecuta después de que se haya cargado un archivo de usuario en WMS e indica cuántos usuarios del archivo fueron leídos, procesados, correctos (cargados), incorrectos (no cargados), nuevos y actualizados. |