Saltar al contenido principal
Servicio de soporte de OCLC

Carga de datos de clientes delimitados por tabulaciones

  1. Última actualización
  2. Guardar como PDF
Esta documentación explica los requisitos de los ficheros de datos de los usuarios delimitados por tabuladores, las normas y requisitos para enviar datos de los usuarios en formato delimitado por tabuladores y proporciona una plantilla para su fichero de datos de usuarios.
Archivo Descripción
Plantilla de datos del patrón delimitada por tabulaciones (Microsoft Excel) Contiene 46 columnas. Guardar como archivo de texto delimitado por tabuladores (no se puede utilizar un archivo Excel para enviar datos).

Columnas

Utilice los siguientes criterios para crear columnas para sus datos:

  • El archivo de texto debe contener las 46 columnas delimitadas por tabuladores en el orden que se indica en la tabla siguiente.
  • La primera línea del fichero de texto es la cabecera y debe contener los nombres de las columnas separados por tabuladores.
  • Los nombres de los encabezados de columna no distinguen mayúsculas de minúsculas, pero deben escribirse correctamente.
  • Cada línea del archivo delimitado por tabuladores debe contener 45 caracteres de tabulación, que funcionan como separadores de columna.
  • Todos los valores de las columnas son cadenas (cadena de texto, cadena numérica, etc.).
  • Si no tiene datos que introducir en una columna, déjela vacía.

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.
  • Si utiliza una máquina que no sea Windows, guarde el archivo como un archivo de texto con formato Windows.

Ejemplo: OCLCsymbolpatrons.txt

Enviar datos del patrón

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 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

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. Esto no se aplica a los campos sourceSystem/idAtSource. Si se modifican esos campos, se añadirá una nueva entrada en el acordeón de la cuenta.
  • 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 bibliotecas, consulte Eliminación masiva de datos delimitados por tabulaciones.
  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.

Campos de registro

Columnas 1-17

Columna
número

 Nombre de columna Necesario para
Bibliotecas de circulación WorldShare		 Necesario para
Bibliotecas Tipasa		 Descripción Límite de caracteres
1 prefijo Opcional Opcional
  1. Prefijo o título, como Sra., Dr., Sr.
 254
2 givenName

Requerido

se requiere givenName o familyName

Requerido

se requiere givenName o familyName
  1. Nombre del patrón.
  2. givenName o familyName es obligatorio.
 50
3 middleName Opcional Opcional
  1. Segundo nombre del patrón.
 100
4 familyName

Requerido

se requiere givenName o familyName

Requerido

se requiere givenName o familyName
  1. Apellido del mecenas.
  2. givenName o familyName es obligatorio.
 50
5 sufijo Opcional Opcional
  1. Un indicador de generación como Jr, III, y/o un epíteto como PhD, FRS.
 254
6 apodo Opcional Opcional
  1. Nombre alternativo, no incluye saludo ni epítetos como doctorado.
  2. No se muestra en la ficha del usuario, pero se indexa para la búsqueda.
 50
7 canSelfEdit Opcional Opcional
  1. Indica que un usuario puede gestionar el nombre por sí mismo para futuras funcionalidades.
  2. Permite valores de:
    Verdadero
    Falso
  3. El valor por defecto es falso.
  
8 fechaDeNacimiento Opcional Opcional
  1. Fecha de nacimiento en formato año-mes-día: AAAA-MM-DD
  
9 género Opcional Opcional
  1. Si está presente, debe contener uno de estos valores:
    Mujer o F
    Masculino o M
    Desconocido o U
     

     Nota: Todos los valores distinguen entre mayúsculas y minúsculas.

  2. El valor por defecto es Desconocido si se deja en blanco.
  
10 institutionId Requerido Requerido
  1. El institutionId (también conocido como ID de registro WorldCat) es un identificador único de una biblioteca.
  2. Los grupos se apoyan permitiendo a las bibliotecas enviar un archivo en institutionIds.
  3. El institutionId es proporcionado por su Administrador de implementación de OCLC o puede encontrarse utilizando una búsqueda de símbolos de institución (identificadores).
  
11 código de barras Requerido No aplicable (el código de barras puede enviarse como illId)
  1. Sólo funcionalidad WorldShare Circulation.
  2. Un identificador único por usuario.
  3. Puede contener letras o números.
  4. Los espacios dentro de la cadena del código de barras son aceptables, pero los espacios iniciales y finales son problemáticos.
  5. La búsqueda de coincidencias en las actualizaciones de clientes comienza con idAtSource y sourceSystem (si se suministran) y luego busca coincidencias en el código de barras.
  6. Para obtener más información, consulte Referencia del archivo de datos del patrón.
 20
12 idAtSource

Opcional

Obligatorio si se utiliza un sistema de autenticación que no seaOCLC.

Opcional

Obligatorio si se utiliza un sistema de autenticación que no seaOCLC
  1.  ID de un usuario en el sistema externo (p. ej. ILS, PeopleSoft, Banner, CAS) desde el que se están migrando los datos.
  2. Si su sistema no distingue entre mayúsculas y minúsculas, éstas deben ser únicas y estar en minúsculas.
  3. Si está presente, sourceSystem también debe estarlo.
  4. Para obtener más información, consulte Referencia del archivo de datos del patrón.
 50
13 sourceSystem

Opcional

Obligatorio si se utiliza un sistema de autenticación que no seaOCLC.

Opcional

Obligatorio si se utiliza un sistema de autenticación que no seaOCLC.
  1. URN que identifica el sistema de autenticación externo (p. ej. urn:mace:oclc:idm:testlibrary.ldap).
  2. Suministrado por OCLC (p. ej. LDAP) o institución (por ejemplo Shibboleth).
  3. Si está presente, idAtSource también debe estarlo.
  4. Para obtener más información, consulte Referencia del archivo de datos del patrón.
 255
14 prestatarioCategoría Requerido No aplicable (puede utilizarse illPatronType)
  1. Sólo funcionalidad WorldShare Circulation.
  2. Categoría de prestatario (tipo de cliente) proporcionada por la biblioteca.
  3. Se utiliza para establecer políticas de circulación.
  4. Los nuevos valores se pueden proporcionar en los archivos de actualización de clientes y también se pueden agregar en la Configuración del servicio de OCLC.
  5. Ejemplos: Estudiante, Adulto, Profesor, Personal, etc.
 30
15 circRegistrationDate Opcional No aplicable

  1. Sólo funcionalidad SGA.

  2. Fecha de creación de la cuenta de cliente.

  3. Utilice este formato para la fecha:
    AAAA-MM-DD 2016-12-31

  4. Si no se proporciona ninguna fecha, se añadirá por defecto la fecha en la que se añadió el registro.

  

16

 oclcFechaExpiración Opcional Opcional
  1. Si está utilizando la autenticación básica de WorldShare, la fecha en que expira el acceso a ciertos servicios proporcionados por OCLC; el usuario ya no estará autenticado ni se le permitirá utilizar servicios como circulación o ILL después de esta fecha. Nota: Si utiliza autenticación de terceros (por ejemplo, LDAP/CAS/SAML), este campo no tiene ningún efecto. 
  2. Utilice este formato de fecha y hora:
    AAAA-MM-DDThh:mm:ss
    2016-12-31T00:00:00
  3. Si no se ha configurado ningún periodo de caducidad por defecto, no aparecerá ninguna fecha de caducidad.
  4. Si se ha configurado un periodo de caducidad por defecto, pero no se proporciona ninguna fecha, la fecha de caducidad se establecerá por defecto en 60 meses (cinco años).
  5. Si se incluye un componente de marca de tiempo, se descartará, ya que la oclcExpirationDate se almacena como una fecha sin componente de marca de tiempo.
  6. Si está presente, esta fecha también puede ser utilizada por WorldShare Circulation para calcular la fecha de vencimiento del artículo durante el pago.
  
17 InicioSucursal Requerido No aplicable
  1. Sólo funcionalidad WorldShare Circulation.
  2. ID de la sucursal de origen del usuario, que es un código numérico (no el código de la biblioteca de depósito).
  3. Las ID de sucursal son proporcionadas por su Gerente de implementación de OCLC.
  4. Este valor se encuentra en Configuración del servicio de OCLC > WorldCat Discovery y WorldCat Local > Tabla de traducción de códigos de existencias
  

 

Columnas 18-35

Columna
número

 Nombre de columna Necesario para
Bibliotecas de circulación WorldShare		 Necesario para
Bibliotecas Tipasa		 Descripción Límite de caracteres
Se requiere al menos una información de contacto, dirección postal, correo electrónico o número de teléfono.
18 primaryStreetAddressLine1 Opcional Opcional
  1. Dirección principal línea 1.
 120
19 primaryStreetAddressLine2 Opcional Opcional
  1. Dirección principal, línea 2, si procede.
 120
20 ciudad principal Opcional Opcional
  1. Ciudad o localidad principal.
 50
21 primaryStateOrProvince Opcional Opcional
  1. Estado o provincia principal.
  2. Para los estados de EE.UU., utilice las abreviaturas de la Oficina de Correos de Estados Unidos.
 120
22 primaryPostalCode Opcional Opcional
  1. Código postal principal de EE.UU. o código postal no estadounidense.
 20
23 primaryCountry Opcional Opcional
  1. País principal.
  2. No abrevie. Utilice Estados Unidos, no Estados Unidos de América o USA.
 120
24 Teléfono principal Opcional Opcional
  1. Número de teléfono principal.
  2. Puede utilizar cualquier formato.
 50
25 secondaryStreetAddressLine1 Opcional Opcional
  1. Dirección secundaria línea 1.
 120
26 secondaryStreetAddressLine2 Opcional Opcional
  1. Dirección secundaria línea 2.
 120
27 ciudad secundaria Opcional Opcional
  1. Ciudad o localidad secundaria.
 50
28 secondaryStateOrProvince Opcional Opcional
  1. Estado o provincia secundaria.
  2. Para los estados de EE.UU., utilice las abreviaturas de la Oficina de Correos de Estados Unidos.
 120
29 código postal secundario Opcional Opcional
  1. Código postal secundario de EE.UU. o código postal no estadounidense.
 20
30 país secundario Opcional Opcional
  1. País secundario.
  2. No abrevie. Utilice Estados Unidos, no Estados Unidos de América o USA.
 120
31 Teléfono secundario Opcional Opcional
  1. Número de teléfono secundario.
 50
32 dirección de correo electrónico Opcional Opcional
  1. Se requiere una dirección de correo electrónico para el acceso de los usuarios a través de la Autenticación de OCLC.
  2. Para los usuarios sin dirección de correo electrónico, es mejor proporcionar un valor por defecto (puede utilizar cualquier valor).
 254
33 teléfono móvil Opcional Opcional
  1. Número de teléfono móvil.
 50
34 notificationEmail No aplicable Opcional
  1. Sólo funcionalidad Tipasa.
 4,096
35 notificationTextTeléfono No aplicable

Opcional

 Nota: Si hay un número de móvil en este campo y no se valida, se rechazará la carga del usuario.
  1. Sólo funcionalidad Tipasa.
  2. Se requiere el formato internacional completo, incluido el código de país (p. ej. +1 232-456-5678 para un número estadounidense, +44 20 4961 5678 para un número británico o +61 (0) 3 9929 0800 para un número australiano). Para más información, consulte Notación de números de teléfono, direcciones de correo electrónico y direcciones web nacionales e internacionales.
 4,096

 

Columnas 36-46

Columna
número

 Nombre de columna Necesario para
Bibliotecas de circulación WorldShare		 Necesario para
Bibliotecas Tipasa		 Descripción Límite de caracteres
36 patronNotes Opcional Opcional
  1. Las notas de las cargas de datos en curso que sean idénticas a las notas cargadas anteriormente se ignoran.
  2. Se añaden las notas de las cargas de datos en curso que no son idénticas a las notas cargadas anteriormente.
 255
37 photoURL Opcional Opcional
  1. URL que muestra o enlaza con la foto del usuario.
  2. La foto se muestra en el perfil del usuario en los módulos WorldShare Admin y Circulation.
  3. Actualmente, OCLC no almacena fotos.
  4. La institución puede garantizar la seguridad de la foto alojándola en un servidor seguro. Consulte las políticas de su institución en relación con la seguridad de los archivos fotográficos vinculados.
 8,192
38 datospersonalizados1 Opcional Opcional
  1. Puede coincidir con valores predefinidos en la Configuración del servicio de OCLC o ser texto libre (no ingresado en la Configuración del servicio de OCLC).
  2. Los campos de datos personalizados de las cargas de datos en curso que no sean idénticos a los campos cargados anteriormente sustituirán al valor cargado anteriormente.
  3. Los campos de datos personalizados de las cargas de datos en curso que son idénticos a los campos cargados anteriormente se ignoran.
  4. Los campos de datos personalizados que se dejan en blanco en las cargas de datos en curso se ignoran y se mantiene el valor anterior, si existe.
  5. Los campos de datos personalizados pueden eliminarse en los módulos WorldShare Admin o Circulation.
 8,192
39 datospersonalizados2 Opcional Opcional
40 datospersonalizados3 Opcional Opcional
41 datospersonalizados4 Opcional Opcional
42 nombre de usuario Opcional Opcional
  1. Este es el nombre de inicio de sesión del usuario para uso exclusivo en la autenticación mantenida por OCLC.
  2. Sólo debe indicarse si la institución no utiliza el código de barras como nombre de usuario.
  3. Dependiendo de la configuración de su institución, el código de barras y el nombre de usuario pueden estar vinculados.
  4. Se ignora si la autenticación la realiza la institución o un tercero (en cuyo caso OCLC no almacena las credenciales de inicio de sesión).
  5. Debe ser único.
 50
43 illId No aplicable Requerido
  1. Sólo funcionalidad Tipasa.
  2. Un identificador único para el usuario en el sistema Tipasa.
  3. Puede ser, aunque no necesariamente, el código de barras de la biblioteca del usuario.

     Nota: La integración WMS Circ-Tipasa sólo funciona si el illld del usuario y el valor del código de barras coinciden.

  4. Para obtener más información, consulte Referencia del archivo de datos del patrón.
 254
44 illApprovalStatus No aplicable Opcional
  1. Sólo funcionalidad Tipasa.
  2. Permite a las bibliotecas preaprobar o bloquear usuarios para Tipasa a través de la carga de usuarios o cambiar el estado de aprobación de los usuarios para Tipasa.
  3. Los valores admitidos son:
    Nuevo
    Aprobado
    Bloqueado
  4. Si el valor se deja en blanco en la primera carga de un patrón y hay un valor illId en el archivo del patrón, el valor por defecto se establecerá en "Nuevo".
  5. Si el valor se deja en blanco en las actualizaciones de los usuarios existentes, se conservará el valor existente en la base de datos.
  
45 illPatronType No aplicable Opcional
  1. Sólo funcionalidad Tipasa.
  2. Este valor se rellenará automáticamente en el campo Estado de los formularios de solicitud de cliente si los valores del campo están configurados allí para coincidir con los valores enviados en los registros de datos del cliente.
  3. Si se incluye el campo de estado del usuario en los formularios de solicitud de usuarios, los datos de illPatronType se capturan en las estadísticas de uso del préstamo interbibliotecario.
 50
46 illPickupLocation No aplicable Opcional
  1. This value will automatically populate in the Pickup Location field on Patron Request Workforms.
  2. Si una biblioteca tiene varias ubicaciones, es aconsejable utilizar exactamente los mismos valores para illPickupLocation en la carga de usuarios que se utilizan en los formularios de solicitud de usuarios.
 1,000

Informes de tratamiento de los ficheros de datos de los usuarios

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.
Informe resumido de los usuarios /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.