Carga de datos de usuario delimitados por tabuladores

Esta documentación explica los requisitos para los archivos de datos de usuario delimitados por tabuladores, las reglas y los requisitos para enviar datos de usuario en formato delimitado por tabuladores y proporciona una plantilla para su archivo de datos de usuario.
Archivo Descripción
Plantilla de datos de usuario delimitados por tabuladores (Microsoft Excel) Contiene 46 columnas. Guardar como archivo de texto delimitado por tabuladores (no se puede usar un archivo de Excel para enviar datos).

Columnas

Utilice los siguientes criterios para crear columnas para sus datos:

Nombre de archivo

La denominación de archivo debe seguir reglas específicas:

Ejemplo: OCLCsymbolpatrons.txt

Enviar datos de usuario

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

Actualizaciones de carga de usuario en curso

  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.

Campos de registro

Columnas 1 a 17

Columna
número

 Nombre de columna Obligatorio para
Bibliotecas de circulación de WorldShare		 Obligatorio para
Bibliotecas Tipasa		 Descripción Límite de caracteres
1 prefijo Opcional Opcional
  1. Prefijo o título, como Sra., Dr., Señor.
 254
2 giveName

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
  1. Primer nombre del usuario.
  2. Se debe especificar un nombre determinado o un nombre de familia.
 50
3 middleName Opcional Opcional
  1. Segundo nombre del usuario.
 100
4 familyName

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
  1. Apellido del usuario.
  2. Se debe especificar un nombre determinado o un nombre de familia.
 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 PhD.
  2. No se muestra en el registro de usuario pero está indizado para realizar búsquedas.
 50
7 canSelfEdit Opcional Opcional
  1. Indica que un usuario puede administrar el nombre por sí mismo para futuras funcionalidades.
  2. Valores de permisos de:
    Verdadero
    Falso
  3. El valor predeterminado es falso.
  
8 dateOfBirth 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:
    Femenino o F
    Masculino o M
    Desconocido o U
     

     Nota: Todos los valores no distinguen mayúsculas de minúsculas.

  2. El valor predeterminado es Desconocido si se deja en blanco.
  
10 InstitutionId Obligatorio Obligatorio
  1. El ID de institución (también conocido como ID de registro de WorldCat ) es un identificador único de una biblioteca.
  2. Se admiten grupos al permitir que las bibliotecas envíen un archivo con los ID de institución.
  3. El InstitutionId lo proporciona el Gerente de Implementación de OCLC , o se puede encontrar mediante una búsqueda de símbolo de institución (identificadores).
  
11 Código de barras Obligatorio No corresponde (el código de barras se puede enviar como illId)
  1. Solo la funcionalidad de Circulación de WorldShare.
  2. Un identificador único por usuario.
  3. Puede contener letras o números.
  4. Se aceptan espacios dentro de la cadena del código de barras, pero los espacios iniciales y finales son problemáticos.
  5. La búsqueda de coincidencias en las actualizaciones de usuarios comienza con idAtSource y sourceSystem (si se proporciona) y luego coincide con el código de barras.
  6. Para obtener más información, véase Referencia del archivo de datos de usuario.
 20
12 idAtSource

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
  1.  ID de un usuario en el sistema externo (p. ej., ILS, PeopleSoft, Banner, CAS) desde el que se migran los datos.
  2. Si su sistema no distingue mayúsculas de minúsculas, estas deben ser únicas y estar en minúsculas.
  3. Si está presente, sourceSystem también debe estar presente.
  4. Para obtener más información, véase Referencia del archivo de datos de usuario.
 50
13 sourceSystem

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 .
  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 (p. ej. Shibboleth).
  3. Si está presente, idAtSource también debe estar presente.
  4. Para obtener más información, véase Referencia del archivo de datos de usuario.
 255
14 prestaterCategory Obligatorio No corresponde (se puede usar illPatronType)
  1. Solo la funcionalidad de Circulación de WorldShare.
  2. Categoría de prestatario (tipo de usuario) proporcionada por la biblioteca.
  3. Se utiliza para establecer políticas de circulación.
  4. Se pueden proporcionar nuevos valores en los archivos de actualización de usuarios y también se pueden agregar en la Configuración del servicio de OCLC .
  5. Ejemplos: estudiante, adulto, profesorado, personal, etc.
 30
15 circRegistrationDate Opcional No corresponde

  1. Solo funcionalidad WMS.

  2. Fecha en que se creó la cuenta del usuario.

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

  4. Si no se proporciona una fecha, se agregará de manera predeterminada la fecha en que se agregó el registro.

  

16

 oclcExpirationDate Opcional Opcional
  1. Si está utilizando la autenticación básica de WorldShare, la fecha en la que caduca el acceso a determinados servicios proporcionados por OCLC; el usuario ya no estará autenticado ni se le permitirá usar servicios como los de circulación o ILL después de esta fecha. Nota: si está utilizando la autenticación de terceros (p. ej., LDAP/CAS/SAML), este campo no surtirá 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 un período de vencimiento predeterminado, no aparecerá ninguna fecha de vencimiento.
  4. Si se ha configurado un período de vencimiento predeterminado, pero no se proporciona ninguna fecha, la fecha de vencimiento se establecerá de manera predeterminada en 60 meses (cinco años).
  5. Si se incluye un componente de marca de tiempo, se descartará, ya que oclcExpirationDate se almacena como una fecha sin componente de marca de tiempo.
  6. Si está presente, esta fecha también puede ser utilizada por Circulación de WorldShare para calcular la fecha de vencimiento del material durante el préstamo.
  
17 Sucursal principal Obligatorio No corresponde
  1. Solo la funcionalidad de Circulación de WorldShare.
  2. ID de sucursal de la sucursal principal del usuario, que es un código numérico (no el código de existencias de la biblioteca).
  3. Las ID de sucursal las proporciona el Gerente de Implementación de OCLC .
  4. Este valor se puede encontrar en Configuración de servicios de OCLC > WorldCat Discovery y WorldCat Local > Tabla de traducción de códigosde existencias
  

 

Columnas 18 a 35

Columna
número

 Nombre de columna Obligatorio para
Bibliotecas de circulación de WorldShare		 Obligatorio para
Bibliotecas Tipasa		 Descripción Límite de caracteres
Se debe especificar al menos un dato de contacto, una dirección postal, un correo electrónico o un número de teléfono.
18 primariaStreetAddressLine1 Opcional Opcional
  1. Línea 1 de la dirección principal.
 120
19 primariaStreetAddressLine2 Opcional Opcional
  1. Dirección principal, línea 2, si corresponde.
 120
20 primaryCityOrLocality Opcional Opcional
  1. Ciudad o ubicación 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 los Estados Unidos.
 120
22 primaryPostalCode Opcional Opcional
  1. Código postal de EE. UU. o código postal fuera de EE. UU. primario.
 20
23 "primaryCountry" Opcional Opcional
  1. País primario.
  2. No abrevie. Use Estados Unidos, no Estados Unidos de América o EE. UU.
 120
24 primaryPhone Opcional Opcional
  1. Número de teléfono principal.
  2. Puede utilizar cualquier formato.
 50
25 secundarioStreetAddressLine1 Opcional Opcional
  1. Línea 1 de la dirección de una calle secundaria.
 120
26 secundarioStreetAddressLine2 Opcional Opcional
  1. Línea 2 de la dirección de una calle secundaria.
 120
27 secundarioCiudadOrLocalidad Opcional Opcional
  1. Ciudad o ubicación secundaria.
 50
28 "secondaryStateOrProvince" Opcional Opcional
  1. Estado o provincia secundario.
  2. Para los estados de EE. UU., utilice las abreviaturas de la oficina de correos de los Estados Unidos.
 120
29 secundarioPostalCode Opcional Opcional
  1. Código postal de EE. UU. secundario o código postal de otro país.
 20
30 "secundaryCountry" Opcional Opcional
  1. País secundario.
  2. No abrevie. Use Estados Unidos, no Estados Unidos de América o EE. UU.
 120
31 secundario Opcional Opcional
  1. Número de teléfono secundario.
 50
32 emailAddress Opcional Opcional
  1. Se requiere una dirección de correo electrónico para acceder al usuario a través de la autenticación de OCLC .
  2. Para los usuarios que no tengan direcciones de correo electrónico, es mejor proporcionar un valor predeterminado (pueden utilizar cualquier valor).
 254
33 mobilePhone Opcional Opcional
  1. Número de teléfono móvil.
 50
34 NotificationEmail No corresponde Opcional
  1. Solo funcionalidad Tipasa.
 4.096
35 notificaciónTextPhone No corresponde

Opcional

 Nota: si un número de móvil está presente en este campo y no se valida, se rechazará la carga del usuario.
  1. Solo funcionalidad Tipasa.
  2. Se debe especificar el formato internacional completo, incluido el código de país (p. ej., +1 232-456-5678 para números de EE. UU., +44 20 4961 5678 para números del Reino Unido o +61 (0) 3 9929 0800 para números de Australia). Para obtener 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 a 46

Columna
número

 Nombre de columna Obligatorio para
Bibliotecas de circulación de WorldShare		 Obligatorio para
Bibliotecas Tipasa		 Descripción Límite de caracteres
36 Notas del usuario Opcional Opcional
  1. Se ignoran las notas de las cargas de datos en curso que sean idénticas a las notas cargadas anteriormente.
  2. Se agregan las notas de las cargas de datos en curso que no son idénticas a las notas cargadas anteriormente.
 255
37 URL de la foto Opcional Opcional
  1. Una URL que muestra la foto del usuario o enlaza con ella.
  2. La foto se muestra en el perfil del usuario en los módulos Administración de WorldShare y Circulación.
  3. Actualmente, OCLC no almacena fotos.
  4. La institución puede garantizar la seguridad de la fotografía alojándola en un servidor seguro. Consulte las políticas de su institución con respecto a la seguridad de los archivos de fotos vinculados.
 8.192
38 customdata1 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 cargas de datos en curso que no sean idénticos a los campos cargados previamente reemplazarán el valor cargado anteriormente.
  3. Se ignoran los campos de datos personalizados de cargas de datos en curso que sean idénticos a los campos cargados previamente.
  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 se pueden borrar en los módulos Administración o Circulación de WorldShare.
 8.192
39 customdata2 Opcional Opcional
40 customdata3 Opcional Opcional
41 customdata4 Opcional Opcional
42 nombredeusuario Opcional Opcional
  1. Este es el nombre de inicio de sesión del usuario para usar únicamente en la autenticación mantenida por OCLC.
  2. Solo debe proporcionarse si la institución no utiliza un código de barras como nombre de usuario.
  3. Según la configuración de su institución, es posible que el código de barras y el nombre de usuario estén 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 corresponde Obligatorio
  1. Solo 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 de WMS Circ-Tipasa solo funciona si el valor de la ILLD y del código de barras del usuario son iguales.

  4. Para obtener más información, véase Referencia del archivo de datos de usuario.
 254
44 illApprovalStatus No corresponde Opcional
  1. Solo funcionalidad Tipasa.
  2. Permite a las bibliotecas preaprobar o bloquear usuarios para Tipasa mediante 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 se deja un valor en blanco en la primera carga de un usuario y hay un valor illId en el archivo de usuario, el valor predeterminado será "Nuevo".
  5. Si se deja el valor en blanco en las actualizaciones de usuarios existentes, se conservará el valor existente establecido en la base de datos.
  
45 illPatronType No corresponde Opcional
  1. Solo funcionalidad Tipasa.
  2. Este valor se completará automáticamente en el campo Estado en los formularios de trabajo de solicitud de usuario si los valores de campo están configurados allí para que coincidan con los valores enviados en los registros de datos de usuario.
  3. Si el campo de estado del usuario está incluido en los formularios de trabajo de solicitud del usuario, los datos de illPatronType se capturan en las estadísticas de uso de ILL.
 50
46 illPickupLocation No corresponde Opcional
  1. Este valor se completará automáticamente en el campo Ubicación de retirada en los formularios de trabajo de solicitud del usuario.
  2. Si una biblioteca tiene varias ubicaciones, se recomienda utilizar en la carga para usuarios los mismos valores de illPickupLocation que se utilizan en los formularios de solicitud de usuarios.
 1000

Registros de muestra

Informes de procesamiento de archivo de datos de usuario

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.